En caso de error, se espera que el DPA muestre un código de estado HTTP junto con una respuesta HTTP que DEBE incluir un objeto JSON con más información sobre el error. El cuerpo de la respuesta de error DEBE contener una instancia de ErrorResponse.
{
"errorMessage": string,
"cause": enum(ErrorCause)
}
La respuesta de error de APD DEBE corresponder a lo siguiente:
- Actualmente, el usuario está en roaming y la búsqueda de APD está inhabilitada para este usuario. La APD muestra un error 403 con USER_ROAMING como la causa del error.
- La APD muestra un código de error 404 NOT_FOUND que indica a GTAF que la clave del usuario no es válida (es decir, no existe una clave del usuario) con INVALID_NUMBER.
- El DPA muestra un código de error 410 GONE con BAD_CPID como causa del error, lo que le indica a GTAF que el cliente debe obtener una clave de usuario nueva si key_type = CPID y el CPID caducó.
- La APD muestra un código de error 501 NOT_IMPLEMENTED que indica que no admite esta llamada con la causa de error SERVICE_UNAVAILABLE.
- La APD muestra una causa de error 429 TOO MANY REQUESTS con TOO_MANY_REQUESTS, con el encabezado Retry-After que indica que GTAF realiza demasiadas solicitudes a la APD.
- La APD muestra un error 409 CONFLICT que indica que la solicitud no se puede completar debido a un conflicto con el estado actual de la APD.
- El servicio no está disponible en este momento. La APD muestra un 503 SERVICE UNAVAILABLE, con el encabezado Retry-After que indica cuándo se puede intentar una nueva solicitud.
- El DPA muestra un código de error 500 INTERNAL SERVER ERROR para todos los demás errores no especificados ERROR_CAUSE_UNSPECIFIED como la causa del error.
En el caso de errores detectados durante una compra, los siguientes códigos de error representan resultados de transacciones fallidos:
- La APD muestra un código de error 400 BAD REQUEST que le indica a GTAF que el ID del plan comprado no es válido.
- La APD muestra un código de error 402 PAYMENT REQUIRED que indica a GTAF que el usuario no tiene saldo suficiente para completar la compra.
- La APD muestra un código de error 409 CONFLICT que indica a GTAF que el plan que se comprará no es compatible con la combinación de productos actual del usuario. Por ejemplo, si la política del plan de datos del operador no permite combinar planes pospagos y prepagos, intentar comprar un plan prepagado para un usuario pospago generará un error 409 CONFLICT.
- La APD muestra un código de error 403 FORBIDDEN que indica a GTAF que la transacción actual es un duplicado de una transacción emitida con anterioridad. El ADP debería mostrar los siguientes errores como respuesta:
- Si la transacción anterior fue un error, la causa del error indica el motivo del error.
- Si la transacción anterior se realizó correctamente, DUPLICATE_TRANSACTION.
- Si la transacción anterior sigue en cola, REQUEST_QUEUED.