Saltar al contenido
ES
Obtener clave API
Explorar documentación

Referencia de la API

Errores y códigos de estado

Encuentra la causa de una solicitud fallida y decide si arreglarla, esperar o volver a entrar.

En esta página

Códigos de estado HTTP

Comience con el estado HTTP, luego lea el código de error y el mensaje para la causa específica.

SituaciónSignificadoQué hacer
400Solicitud inválidaArreglar la fuente, campos requeridos, tipos de parámetro o encabezados de respuesta antes de reintentar.
401Falló la autenticaciónCompruebe X-API-Key. Reemplazar una llave caducada o revocada; reiniciar la misma tecla no ayudará.
402Créditos insuficientesVerifique el saldo de la cuenta. Agregue créditos o deje que el propietario de la cuenta resuelva el acceso antes de enviar de nuevo.
403Acceso denegadoCompruebe los permisos de origen de la clave y el estado de cuenta o suscripción.
404No se encontróConsulta el URL, trabajo ID y cuenta. Trabajos fuera de tu cuenta o fuentes permitidas también pueden devolver 404.
406Tipo de respuesta no aceptableUse Accept: application/json o text/plain. Seleccione Markdown con X-Respond-With: marcador.
409Resultado no listo / conflictoEn un resultado leído, encuesta el trabajo existente hasta que se complete. Para otros puntos finales, resolver el conflicto descrito en el cuerpo.
410Resultado vencidoUsar una copia guardada. Reiniciar el resultado URL no puede restaurar un resultado vencido.
422Entrada inválida / trabajo fallidoArreglar los campos reportados. En un resultado leído, inspeccione job.error: un trabajo fallido no tiene resultado exitoso para buscar.
429Límite alcanzadoEspere a Retry-After o retry_after. Reduzca la tasa de solicitud; para una cola pendiente completa, espere a que los trabajos existentes terminen.
500 / 502 / 503 / 504Insuficiencia de servicio o aguas arribaRetry lee con el backoff atado. Para un POST o el tiempo de envío, compruebe si el trabajo fue aceptado antes de enviarlo de nuevo.

Lea una respuesta de error

Los errores de API usan JSON, incluso cuando usted solicita un texto plano. El cuerpo difiere por punto final. Rama en el estado y código HTTP cuando está presente; utilice el mensaje o el detalle para explicar el problema.

Los errores de consulta suelen incluir errores y mensajes; el código es opcional. Los errores de autenticación pueden usar el éxito: falso en lugar de error: verdadero.

400 · application/json
{
  "error": true,
  "code": "unsupported_representation",
  "message": "X-Respond-With supports markdown. Omit the header for the original result fields."
}

Estado de inspección, encabezados y cuerpo

Utilice curl --include para ver los tres. Este ejemplo comprueba su clave con una cuenta gratuita leída; no presenta una consulta. Establecer FLASHDATA_API_KEY en su entorno primero.

Inspeccionar una respuesta · cURL / Bash
curl --include --silent --show-error --max-time 20 \
  'https://api.flashdata.dev/v2/api-access/identity' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

Cuándo volver a entrar

Un POST repetido puede crear otra consulta facturable. Un tiempo de red no prueba que la primera solicitud fue rechazada. Guardar el trabajo ID tan pronto como lo recibas.

SituaciónSiguiente acción
Entrada inválida, clave, permiso o saldoParar. Arreglar el estado de solicitud o cuenta antes de reintentar; no aflore en estos errores.
429 con una pista de esperaHonor Retry-After (segundos o HTTP date), o el valor JSON retry_after en segundos. Si ambos están presentes, use el retraso más largo.
Solicitud de información: 429 / error temporal 5xx / redRetrocede el mismo GET. Sin una pista de espera, utilice demoras crecientes con jitter, un recuento máximo de intento y un límite de tiempo.
POST timeout o ambiguo 5xxMantenga el trabajo existente ID y compruebe su estado. Si no se recibió ID, inspeccione la historia del trabajo antes de decidir someterse de nuevo.

Revisar un trabajo de fondo

HTTP 200 desde el punto final del estado significa que la lectura tuvo éxito. Chequee job.status para saber si la tarea tuvo éxito. Establecer JOB_ID a su trabajo existente; este comando no presenta un reemplazo.

job.statusQué hacer
pending / processingEspera, luego encuesta el mismo trabajo. Un resultado lee devuelve 409 hasta la finalización.
completedRecuperar y guardar el resultado. Los resultados originales JSON devuelven una red de almacenamiento 302; los resultados formateados devuelven un cuerpo directamente.
failedDeja de votar e inspeccionar job.error. El punto final del resultado devuelve 422 con el código result_not_ready para un trabajo fallido.
Leer el estado de trabajo · cURL / Bash
curl --fail-with-body --silent --show-error --max-time 30 \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

Errores de formato de respuesta

Estado / códigoArreglos
400 · unsupported_representationEstablecer X-Respond-With para marcar, o eliminar el encabezado.
406 · not_acceptableEstablece Accept en application/json o text/plain. Si especificas un juego de caracteres, usa UTF-8.

Obtener ayuda con una solicitud

Enviar el punto final, UTC timestamp, HTTP status, código de error y solicitud o trabajo ID. Eliminar las teclas API, fichas y firmó URLs del informe.