Manejo de errores

La API de Proctorio utiliza códigos de estado HTTP estándar y devuelve respuestas de error estructuradas.

Códigos de estado HTTP

Código	Significado
200	Éxito — la solicitud se completó y se generó la URL
400	Solicitud incorrecta — la validación falló en uno o más campos
401	No autorizado — clave de API no válida o faltante
429	Demasiadas solicitudes — se excedió el límite de velocidad
500	Error del servidor — error interno, reintente con retroceso exponencial

Formato de respuesta de error

Los errores de validación (400) devuelven un arreglo de objetos de error:

[
  {
    "memberNames": ["launch_url"],
    "errorMessage": "The launch_url field is required."
  },
  {
    "memberNames": ["exam_settings"],
    "errorMessage": "exam_settings is required."
  }
]

Códigos de error 401

Código	Descripción
2154	Cuenta no activa — contacte a su gerente de cuenta
2155	Región incorrecta — utilice el endpoint regional correcto
2655	Clave de API no válida — verifique el valor de su clave

Mejores prácticas

• Siempre valide el cuerpo de su solicitud antes de enviarla
• Implemente lógica de reintento con retroceso exponencial para errores 5xx
• Registre el cuerpo completo de la respuesta de error para depuración
• Nunca exponga su clave de API en código del lado del cliente