许可激活(成员 JWT):激活码校验一次核销 + 绑定 + 审计同事务;issued→active

POST

/v1/org-licenses/activate

curl --request POST \
  --url https://api.tansr.com/v1/org-licenses/activate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example" }'

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

code

required

string

>= 1 characters <= 128 characters

Example^generated

{
  "code": "example"
}

Responses

200

激活后许可

Media typeapplication/json

object

license

required

object

id

required

string

appId

required

绑定 org 键(api_keys.public_id;UNIQUE 一键一照)

string

principalType

required

Any of:

string

string

Allowed value: member

string

string

Allowed value: service

memberUserId

required

Any of:

string

string

null

null

status

required

Any of:

string

string

Allowed value: issued

string

string

Allowed value: active

string

string

Allowed value: suspended

string

string

Allowed value: revoked

string

string

Allowed value: expired

activatedAt

required

Any of:

string

string

null

null

expiresAt

required

Any of:

string

string

null

null

sourceType

required

Any of:

string

string

Allowed value: approval

string

string

Allowed value: direct

null

null

sourceId

required

Any of:

string

string

null

null

epoch

required

许可纪元(revoke/suspend 递增;末端缓存失效锚)

integer

createdAt

required

string

Example

{
  "license": {
    "principalType": "member",
    "status": "issued",
    "sourceType": "approval"
  }
}

400

Validation_failed(码无效/已核销/过期)

Media typeapplication/json

object

error

required

object

code

required

错误码注册表单源派生(src/http/errors.ts ERROR_CODES;码稳定,消费方按码翻译)

string

Allowed values: adjudicator_not_authorized admin_forbidden admin_key_invalid app_disabled app_ip_denied app_key_invalid approval_self_forbidden asr_not_configured asr_quota_exceeded auth_channel_undelivered bad_request conflict content_blocked context_window_exceeded currency_not_supported device_code_denied device_code_expired device_code_pending device_code_slow_down egress_blocked endpoint_disabled envelope_key_undelivered fence_denied forbidden idempotency_conflict idp_untrusted image_not_supported imagegen_not_configured imagegen_quota_exceeded insufficient_balance internal_error invalid_api_key license_required limit_exceeded liquidation_not_enabled model_not_authorized model_not_found nonce_replayed not_found order_state_invalid org_byok_not_available org_ceiling_exceeded otp_invalid otp_rate_limited pay_amount_mismatch pay_channel_undelivered pay_signature_invalid payload_too_large payment_required plan_apps_exceeded plan_concurrency_exceeded plan_end_users_exceeded plan_gate_unavailable plan_members_exceeded plan_required plan_tier_insufficient policy_locked pool_signing_undelivered preflight_required pricing_guard_tripped principal_required protocol_unsupported quota_exceeded rate_limited refund_not_eligible section_not_deliverable session_archived signature_invalid stream_backpressure token_expired tts_not_configured tts_quota_exceeded unauthorized upstream_connect_timeout upstream_disconnected upstream_error upstream_idle_timeout upstream_timeout upstream_total_timeout upstream_ttfb_timeout validation_failed videogen_not_configured videogen_quota_exceeded websearch_not_configured websearch_quota_exceeded

message

required

string

requestId

required

string

detail

object

Example

{
  "error": {
    "code": "adjudicator_not_authorized"
  }
}

本文是否有帮助?

有帮助没帮助