跳转到内容
tansr 资料站

读取应用的私有逻辑缓存能力与限制

GET
/t1/cache/v1/capabilities
curl --request GET \
  --url https://api.tansr.com/t1/cache/v1/capabilities \
  --header 'x-tansr-app-token: <x-tansr-app-token>'

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

只读当前能力和 operationEpoch，不创建或续期 epoch。audience 恒为 gateway-cache，gateway 恒为 not-applicable；无有效 epoch 时 features 为空。能力协商不保证供应商缓存命中或费用降低。

Authorizations

Section titled “Authorizations”

Responses

Section titled “Responses”

200

Section titled “200”

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

Media typeapplication/json
object
protocol
required
Allowed value: sdk2-cache-v1
audience
required
Allowed value: gateway-cache
features
required
Array
0 <= 1 items
gateway
required
string
Allowed values: confirmed unsupported unavailable not-applicable
availability
required
Allowed value: legacy-complete
revision
required

Canonical unsigned decimal 0..2^63-1. Never parse through IEEE754 Number.

string
<= 19 characters /^(0|[1-9][0-9]{0,17}|[1-8][0-9]{18}|9[0-1][0-9]{17}|92[0-1][0-9]{16}|922[0-2][0-9]{15}|9223[0-2][0-9]{14}|92233[0-6][0-9]{13}|922337[0-1][0-9]{12}|92233720[0-2][0-9]{10}|922337203[0-5][0-9]{9}|9223372036[0-7][0-9]{8}|92233720368[0-4][0-9]{7}|922337203685[0-3][0-9]{6}|9223372036854[0-6][0-9]{5}|92233720368547[0-6][0-9]{4}|922337203685477[0-4][0-9]{3}|9223372036854775[0-7][0-9]{2}|922337203685477580[0-6]|9223372036854775807)$/
limits
required
object
controlBytes
required
integer
>= 4096 <= 65536
exchangeBytes
required
integer
>= 1024 <= 33554432
projectionBytes
required
integer
>= 1024 <= 262144
projectionSegments
required
integer
>= 1 <= 64
ticketTtlMs
required
integer
>= 60000 <= 604800000
mappingIdleMs
required
integer
>= 60000 <= 604800000
mappingLifetimeMs
required
integer
>= 60000 <= 2592000000
bindingsPerLogical
required
integer
>= 1 <= 16
mappingsPerUser
required
integer
>= 1 <= 1000
mappingsPerApplication
required
integer
>= 1 <= 10000
mappingsGlobal
required
integer
>= 1 <= 100000
mappingBytes
required
integer
>= 1024 <= 16384
receiptsGlobal
required
integer
>= 1 <= 100000
receiptBytes
required
integer
>= 1024 <= 32768
receiptRetentionMs
required
integer
>= 60000 <= 604800000
epochLifetimeMs
required
integer
>= 60000 <= 86400000
diagnosticRowsPerUser
required
integer
>= 1 <= 1000
diagnosticRowsPerApplication
required
integer
>= 1 <= 10000
diagnosticRowsGlobal
required
integer
>= 1 <= 100000
diagnosticBytes
required
integer
>= 1024 <= 4096
diagnosticRetentionMs
required
integer
>= 60000 <= 86400000
diagnosticSamplePerMillion
required
integer
<= 1000000
diagnosticsPageRows
required
integer
>= 1 <= 100
negotiatedTtlMs
required
integer
>= 1000 <= 60000
retainedRowsPerUser
required
integer
>= 1 <= 10000
retainedRowsPerApplication
required
integer
>= 1 <= 100000
retainedRowsGlobal
required
integer
>= 1 <= 1000000
retainedBytesPerUser
required
integer
>= 1 <= 16777216
retainedBytesPerApplication
required
integer
>= 1 <= 268435456
retainedBytesGlobal
required
integer
>= 1 <= 2147483648
operationEpoch
required
Any of:
object
id
required
string
>= 1 characters <= 128 characters /^[A-Za-z0-9][A-Za-z0-9._~-]*$/
issuedAt
required
string format: date-time
expiresAt
required
string format: date-time
state
required
Allowed value: active
Example
{
  "protocol": "sdk2-cache-v1",
  "audience": "gateway-cache",
  "features": [
    "private-logical-cache-v1"
  ],
  "gateway": "confirmed",
  "availability": "legacy-complete",
  "operationEpoch": {
    "state": "active"
  }
}

Headers

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

400

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

401

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

403

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

409

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

410

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

413

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

422

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

429

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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

503

Section titled “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

Section titled “Headers”
Cache-Control
required
string
Allowed value: no-store

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