错误目录
每个错误都是一个 RFC 9457 问题文档，其 type 指向本页的一个条目，code 即该条目的名称。instance 携带请求 id；联系支持时请提供它。
- 400
invalid_request - 请求格式错误：未知的查询参数、无法读取的请求体、端点不接受的参数，或格式错误的
Idempotency-Key。请修正请求；不要原样重试。 - 400
invalid_cursor cursor格式错误、已超过 24 小时，或是为不同的筛选条件签发的；匹配记录流的since_cursor只有在超过 30 天匹配保留期后才会过期。请从第一页重新开始列举（不带游标的记录流）。- 401
unauthenticated - 该端点需要密钥，但请求未携带。响应会设置
WWW-Authenticate: Bearer realm="api.tuneping.com"。 - 401
invalid_api_key - 密钥格式不对或无法识别。请检查是否被截断，以及
tp_live_/tp_test_前缀。 - 401
key_revoked - 密钥已被轮换或吊销；
revoked_at给出时间。请使用当前的密钥。 - 401
token_invalid - 授权令牌（合作方应用）：令牌格式错误或签名无法识别。
- 401
token_expired - 授权令牌：令牌已过期，超出允许的时钟偏差。刷新一次即可。
- 401
token_audience - 授权令牌：令牌的受众或签发方不是本 API。
- 403
forbidden_tier - 该端点或参数值需要更高的套餐，例如历史记录的
from早于你套餐的深度，或批量 id 数超过套餐允许的数量。required_tier给出所需套餐，upgrade_url链接到价格页面。 - 403
forbidden_scope - 密钥存在，但签发时未包含此操作所需的作用域（
wishlists或webhooks；使用webhook投递的心愿单还需要webhooks，且先于套餐检查）；required_scope给出所需作用域，WWW-Authenticate携带error="insufficient_scope"。请使用具有该作用域的密钥；除非签发时指定了更窄的列表（例如只读），密钥默认拥有全部作用域，GET /v1/me会列出密钥的作用域。 - 403
entitlement_revoked - 授权令牌验证通过，但其许可证已被吊销。通行证已失效；刷新也无济于事。
- 403
livemode_mismatch - 将
tp_test_密钥用于仅限正式环境的操作，例如测试主机（webhook.site）以外的 Webhook 端点。 - 404
not_found - 不存在该电台、曲目、艺人或资源，或尚未观察到该电台的实时标题。
- 404
station_opted_out - 该电台存在于目录中，但已要求不被收录。Tuneping 不说明原因。请将其视为永久不可用。
- 406
not_acceptable Accept请求头中没有任何受支持的媒体类型。响应体仍为application/problem+json。- 409
conflict - 资源重复，例如第二个使用相同 URL 的 Webhook 端点。
- 409
idempotency_in_progress - 使用相同
Idempotency-Key的请求仍在执行。请在Retry-After秒后重试，以获取它的响应。 - 410
endpoint_sunset - 该端点已在公布的
Sunset日期之后停用；Link响应头指向对应的更新日志条目。 - 413
payload_too_large - 请求体限制为 64 KiB；
PUT /v1/wishlists最多可接受 1 MiB。 - 422
validation_failed - 一个或多个参数的值无效。
errors[]为每一项列出field、code和一条可读的message。 - 422
idempotency_key_reused - 该
Idempotency-Key在过去 24 小时内已用于另一个不同的请求（方法、路径、查询或请求体不同）。新请求请使用新的键。 - 429
rate_limited - 每秒令牌桶已空。请等待
Retry-After秒；RateLimit响应头给出已耗尽的策略。 - 429
too_many_connections - 该密钥打开的事件流已达到套餐允许的上限（Developer 1 个、Pro 5 个、Business 20 个、Tapelark 每台设备 1 个）。请先关闭一个。
- 429
quota_exceeded - 每日或每月配额已用完。
Retry-After和quota_resets_at给出重置时间；upgrade_url链接到价格页面。 - 500
internal_error - 我们这边出了故障。请带退避重试；如果问题持续，请把请求 id 发给我们。
- 数据库不可用或服务正在维护，或者带
Idempotency-Key的请求在 20 秒后仍在执行，已被取消且未做任何更改。请在Retry-After秒后重试，该值也以retry_after_seconds给出（被取消的请求为 1；请用相同的键重试）。