Catálogo de erros

Todo erro é um documento de problema RFC 9457 cujo type aponta para uma entrada desta página e cujo code é o nome da entrada. instance traz o id da requisição; informe-o ao suporte.

400 invalid_request

A requisição está malformada: um parâmetro de query desconhecido, um corpo ilegível, um parâmetro que o endpoint não aceita ou um Idempotency-Key malformado. Corrija a requisição; não repita como está.

400 invalid_cursor

O cursor está malformado, tem mais de 24 horas ou foi emitido para outros filtros; um since_cursor do feed de correspondências só expira quando fica mais antigo que a retenção de 30 dias das correspondências. Recomece a listagem pela primeira página (um feed sem cursor).

401 unauthenticated

O endpoint precisa de uma chave e nenhuma foi enviada. WWW-Authenticate: Bearer realm="api.tuneping.com" é definido.

401 invalid_api_key

A chave tem o formato errado ou não é conhecida. Verifique se ela não foi truncada e o prefixo tp_live_ / tp_test_.

401 key_revoked

A chave foi rotacionada ou revogada; revoked_at diz quando. Use a chave atual.

401 token_invalid

Tokens de direito de acesso (apps parceiros): o token está malformado ou sua assinatura é desconhecida.

401 token_expired

Tokens de direito de acesso: o token expirou além da tolerância de relógio permitida. Renove-o uma vez.

401 token_audience

Tokens de direito de acesso: o público (audience) ou o emissor do token não é esta API.

403 forbidden_tier

O endpoint ou o valor do parâmetro exige um plano superior, por exemplo um from de histórico mais antigo que a profundidade do seu plano ou mais ids no lote do que o plano permite. required_tier indica o plano, upgrade_url aponta para os preços.

403 forbidden_scope

A chave existe, mas foi emitida sem o escopo de que esta operação precisa (wishlists ou webhooks; uma lista de desejos com entrega por webhook também precisa de webhooks, verificado antes do plano); required_scope indica qual e WWW-Authenticate traz error="insufficient_scope". Use uma chave com o escopo; as chaves têm todos os escopos, a menos que tenham sido emitidas com uma lista mais restrita, por exemplo somente leitura, e GET /v1/me lista os escopos de uma chave.

403 entitlement_revoked

O token de direito de acesso é válido, mas sua licença foi revogada. O passe expirou; renovar não vai adiantar.

403 livemode_mismatch

Uma chave tp_test_ foi usada em uma operação exclusiva do modo live, por exemplo um endpoint de webhook fora dos hosts de teste (webhook.site).

404 not_found

Estação, faixa, artista ou recurso inexistente, ou nenhum título ao vivo foi observado para a estação ainda.

404 station_opted_out

A estação existe no diretório, mas pediu para não ser indexada. O Tuneping não diz por quê. Trate-a como permanentemente indisponível.

406 not_acceptable

O cabeçalho Accept não lista nenhum dos tipos de mídia suportados. O corpo continua sendo application/problem+json.

409 conflict

Recurso duplicado, por exemplo um segundo endpoint de webhook com a mesma URL.

409 idempotency_in_progress

Uma requisição com o mesmo Idempotency-Key ainda está em execução. Tente de novo após Retry-After segundos para receber a resposta dela.

410 endpoint_sunset

O endpoint foi desativado após a data de Sunset anunciada; um cabeçalho Link aponta para a entrada do changelog.

413 payload_too_large

Os corpos de requisição são limitados a 64 KiB; PUT /v1/wishlists aceita até 1 MiB.

422 validation_failed

Um ou mais parâmetros têm valores inválidos. errors[] lista field, code e uma message legível para cada um.

422 idempotency_key_reused

O Idempotency-Key já foi usado nas últimas 24 horas para uma requisição diferente (método, caminho, query ou corpo). Envie uma nova chave para uma nova requisição.

429 rate_limited

O token bucket por segundo está vazio. Espere Retry-After segundos; o cabeçalho RateLimit indica a política esgotada.

429 too_many_connections

A chave já tem tantos streams de eventos abertos quanto o plano permite (Developer 1, Pro 5, Business 20, Tapelark 1 por dispositivo). Feche um primeiro.

429 quota_exceeded

A cota diária ou mensal foi esgotada. Retry-After e quota_resets_at dizem quando ela é renovada; upgrade_url aponta para os preços.

500 internal_error

Algo falhou do nosso lado. Tente de novo com backoff e envie-nos o id da requisição se o erro persistir.

503 unavailable

O banco de dados está indisponível ou o serviço está em manutenção, ou uma requisição com um Idempotency-Key ainda estava em execução após 20 segundos e foi cancelada sem nenhuma alteração. Tente de novo após Retry-After segundos, também informado como retry_after_seconds (1 para a requisição cancelada; repita-a com a mesma chave).

Voltar para a referência da API