tuneping Obtén una clave

Catálogo de errores

Cada error es un documento de problema RFC 9457 cuyo type apunta a una entrada de esta página y cuyo code es el nombre de la entrada. instance lleva el id de la solicitud; indícalo al soporte.

400 invalid_request
La solicitud está mal formada: un parámetro de consulta desconocido, un cuerpo ilegible, un parámetro que el endpoint no admite o un Idempotency-Key mal formado. Corrige la solicitud; no la reintentes tal cual.
400 invalid_cursor
El cursor está mal formado, tiene más de 24 horas o se emitió para otros filtros; un since_cursor del feed de coincidencias solo caduca cuando supera la retención de coincidencias de 30 días. Vuelve a empezar el listado desde la primera página (un feed sin cursor).
401 unauthenticated
El endpoint necesita una clave y no se envió ninguna. Se envía WWW-Authenticate: Bearer realm="api.tuneping.com".
401 invalid_api_key
La clave tiene un formato incorrecto o no se conoce. Comprueba que no esté truncada y que tenga el prefijo tp_live_ / tp_test_.
401 key_revoked
La clave se rotó o se revocó; revoked_at indica cuándo. Usa la clave actual.
401 token_invalid
Tokens de derecho de uso (apps de socios): el token está mal formado o su firma es desconocida.
401 token_expired
Tokens de derecho de uso: el token caducó más allá del desfase permitido. Renuévalo una vez.
401 token_audience
Tokens de derecho de uso: la audiencia o el emisor del token no es esta API.
403 forbidden_tier
El endpoint o el valor del parámetro necesita un plan superior, por ejemplo un from de historial más antiguo que la profundidad de tu plan o más ids en un lote de los que permite el plan. required_tier indica el plan, upgrade_url enlaza a los precios.
403 forbidden_scope
La clave existe pero se emitió sin el ámbito que necesita esta operación (wishlists o webhooks; una lista de deseos con entrega por webhook también necesita webhooks, y se comprueba antes que el plan); required_scope lo indica y WWW-Authenticate lleva error="insufficient_scope". Usa una clave con ese ámbito; las claves tienen todos los ámbitos salvo que se emitieran con una lista más restringida, por ejemplo de solo lectura, y GET /v1/me muestra los ámbitos de una clave.
403 entitlement_revoked
El token de derecho de uso se verifica, pero su licencia se revocó. El pase ha vencido; renovarlo no servirá.
403 livemode_mismatch
Se usó una clave tp_test_ para una operación solo live, por ejemplo un endpoint de webhook fuera de los hosts de prueba (webhook.site).
404 not_found
No existe esa emisora, pista, artista o recurso, o todavía no se ha observado ningún título en vivo para la emisora.
404 station_opted_out
La emisora existe en el directorio pero pidió no ser indexada. Tuneping no dice por qué. Trátala como no disponible de forma permanente.
406 not_acceptable
La cabecera Accept no incluye ninguno de los tipos de medio admitidos. El cuerpo sigue siendo application/problem+json.
409 conflict
Recurso duplicado, por ejemplo un segundo endpoint de webhook con la misma URL.
409 idempotency_in_progress
Una solicitud con el mismo Idempotency-Key todavía está en curso. Reintenta pasados Retry-After segundos para recibir su respuesta.
410 endpoint_sunset
El endpoint se retiró después de la fecha Sunset anunciada; una cabecera Link apunta a la entrada del registro de cambios.
413 payload_too_large
Los cuerpos de solicitud están limitados a 64 KiB; PUT /v1/wishlists admite hasta 1 MiB.
422 validation_failed
Uno o más parámetros tienen valores no válidos. errors[] indica field, code y un message legible para cada uno.
422 idempotency_key_reused
El Idempotency-Key ya se usó en las últimas 24 horas para una solicitud distinta (método, ruta, consulta o cuerpo). Envía una clave de idempotencia nueva para cada solicitud nueva.
429 rate_limited
El token bucket por segundo está vacío. Espera Retry-After segundos; la cabecera RateLimit indica la política agotada.
429 too_many_connections
La clave ya tiene tantos flujos de eventos abiertos como permite su plan (Developer 1, Pro 5, Business 20, Tapelark 1 por dispositivo). Cierra uno primero.
429 quota_exceeded
La cuota diaria o mensual se ha agotado. Retry-After y quota_resets_at indican cuándo se restablece; upgrade_url enlaza a los precios.
500 internal_error
Algo falló de nuestro lado. Reintenta con espera progresiva y envíanos el id de la solicitud si persiste.
503 unavailable
La base de datos no está disponible o el servicio está en mantenimiento, o una solicitud con un Idempotency-Key seguía en curso tras 20 segundos y se canceló sin cambiar nada. Reintenta pasados Retry-After segundos, valor que también se da como retry_after_seconds (1 para la solicitud cancelada; reinténtala con la misma clave de idempotencia).

Volver a la referencia de la API