读取私有逻辑缓存绑定诊断页

GET

/t1/cache/v1/bindings/{bindingId}/diagnostics

curl --request GET \
  --url 'https://api.tansr.com/t1/cache/v1/bindings/example/diagnostics?protocol=sdk2-cache-v1&limit=1' \
  --header 'x-tansr-app-token: <x-tansr-app-token>'

仅接受当前 app_user 短期令牌，并按当前应用、末端用户和原会话验证权限。此扩展默认关闭；未启用时不提供控制接口。GET 不接受请求体，所有查询参数只能出现一次；拒绝未知参数。POST 不接受查询串或 Content-Encoding。

当前 diagnosticSamplePerMillion 为 0，验证绑定可见性后返回 rows 为空、next 为 null。不会伪造供应商缓存命中或费用收益。limit 的 URL 值必须为 1..100 的规范十进制整数，拒绝前导零、小数和指数。

Authorizations

• appToken

Parameters

Path Parameters

bindingId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

Query Parameters

protocol

required

Allowed value: sdk2-cache-v1

after

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

limit

required

integer

>= 1 <= 100

Responses

200

成功；相同操作身份按原结果重放。

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

rows

required

array

0

next

required

null

Example

{
  "protocol": "sdk2-cache-v1"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

400

Invalid_request 或 protocol_version_mismatch

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

401

Unauthorized

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

403

Forbidden

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

409

Stale_revision、stale_generation、request_id_conflict 或 projection_stale

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

410

Ticket_expired、mapping_expired 或 receipt_expired

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

413

Payload_too_large

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

422

Unsupported_capability

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

429

Capacity_exceeded

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

503

Epoch_unavailable、mapping_unavailable 或 result_unknown；未知结果不得自动重新执行或回退旧接口。

Media typeapplication/json

object

protocol

required

Allowed value: sdk2-cache-v1

requestId

required

string

>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/

code

required

string

Allowed values: invalid_request protocol_version_mismatch unauthorized forbidden stale_revision stale_generation request_id_conflict projection_stale ticket_expired mapping_expired receipt_expired payload_too_large unsupported_capability capacity_exceeded epoch_unavailable mapping_unavailable result_unknown

status

required

integer

>= 400 <= 503

retryAction

required

string

Allowed values: none same-request query-status refresh-projection

fallback

required

Allowed value: none

message

required

string

>= 1 characters <= 256 characters

Example

{
  "protocol": "sdk2-cache-v1",
  "code": "invalid_request",
  "retryAction": "none",
  "fallback": "none"
}

Headers

Cache-Control

required

string

Allowed value: no-store

禁止缓存绑定、票据、状态及模型响应。

本文是否有帮助?

有帮助没帮助