Referencia API

Códigos de Error

Referencia completa de cada código de error que la API de TokSpan puede devolver, con descripciones y pasos para solucionarlos.

Códigos de Estado HTTP

CódigoSignificadoAcción
200ÉxitoSolicitud completada normalmente
400Solicitud IncorrectaRevise el cuerpo de la solicitud por JSON mal formado o campos obligatorios faltantes
401No AutorizadoVerifique que su clave API sea correcta y esté activa en el panel
402Pago RequeridoSaldo insuficiente — recargue en el panel de facturación
404Modelo No EncontradoVerifique el ID del modelo — consulte los modelos disponibles
429Límite de Tasa ExcedidoImplemente backoff exponencial — consulte los límites de tasa
500Error InternoProblema del lado de TokSpan — reintente con backoff o contacte al soporte
502Gateway IncorrectoError del proveedor upstream — la conmutación automática puede activarse
503Servicio No DisponibleSobrecarga temporal — reintente después del valor del header Retry-After

Formato de Respuesta de Error

json
{
  "error": {
    "message": "Invalid API key",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}