跳转到内容

网关出口登记读面(网关限流档):该 App 登记的出口 CIDR 全量(稳定序 createdAt 升序→cidr 字典序);语义:app_user 令牌径请求客户端 IP ∈ 登记出口 → 账套级限流键由 k<apiKeyId> 切为每终端用户 g<apiKeyId>:<endUserIdHash>(独立 60s 滑窗,上限恒 = 平台缺省 120/min,即每个终端用户拿到与一把直连 key 相同的额度;quota.rpm 只作 App 总闸 appq;该档 429 携 detail.scope:"endUser")且该 IP 豁免全局 IP 档 600/min;未登记 IP / 双头径 / compat 径限流行为与信封字节不变;他人/非 app 键恒 404

GET
/v1/apps/{id}/gateway-egress
x-tansr-org
string

Org 作用域声明(org 公开 id);服务端校验成员资格与角色,非成员恒 404、角色不够 403

登记全量({data:[{cidr,label,createdAt}]};无登记 = [])

Media typeapplication/json
object
data
required
Array<object>
object
cidr
required
string
label
required
Any of:
string
createdAt
required

ISO;PUT 同批同刻

string
Examplegenerated
{
"data": [
{
"cidr": "example",
"label": "example",
"createdAt": "example"
}
]
}

Not_found(不泄露存在性)

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"
}
}