Tu Identidad Service Platform
Tu Identidad is a platform that was born under the premise of making the processes of identifying people more efficient and evolutionary where we not only generate files digitally but also add value by validating each of the necessary documents or data technologically and against external sources. Through web services and mobile applications for entering the information to validate, each service reply with structured data that allows management and provides for the authorization and monitoring flows of the procedures that are defined. With high security standards, it manages permits and offers real-time reports for decision making.
Introduction
The platform it is structured up of different services that are available to companies that need to validate individuals or business, these services are designed to receive information, process it, and deliver a response quickly. We guarantee the quality of each of these, likewise, the availability and scalability of our services and infrastructure.
Production endpoint: web-prod01.tuidentidad.com
Authentication
The process of Tu Identidad is to assign an apikey to each company, unique and non-transferable. With this, they will have access to all the contracted services. These credentials are the unique identifier for each company, each transaction is registered to provide consumption reports.
Estandar Global Codes
Nuestra plataforma cuenta con un estandar de respuesta en los códigos HTTP que facilitan su manejo y la facturación, así mismo, cada API tiene sus própios mensajes de alerta que permiten mayor detalle para cada acontecimiento
| http code | Nombre | Descripción / Escenario de Aplicación | Facturación |
|---|---|---|---|
| 200 | OK | Todas las fuentes oficiales respondieron con éxito. Proceso completado sin errores. | Completa |
| 203 | Non-Authoritative Information | Éxito parcial: Al menos una fuente oficial respondió correctamente, pero otras fallaron, excedieron tiempo de espera o no estuvieron disponibles. La respuesta incluye un array de 'warnings'. | Mitad |
| 204 | No Content | La solicitud fue procesada correctamente pero no hay contenido que devolver. Usado en búsquedas sin resultados. | Completa |
| 400 | Bad Request | Error de validación en la solicitud: parámetros faltantes, formato incorrecto, estructura JSON inválida, o datos fuera de rango permitido. | Completa |
| 401 | Unauthorized | Credenciales inválidas o faltantes. El header 'apiKey' no fue proporcionado o es incorrecto. | Completa |
| 403 | Forbidden | Autenticación válida pero sin permisos para acceder al recurso o servicio específico. | Completa |
| 404 | Not Found | El recurso solicitado no existe. Puede ser un endpoint incorrecto, un ID de verificación inválido, o datos no encontrados en la fuente. | Completa |
| 405 | Method Not Allowed | El método HTTP utilizado no está permitido para el endpoint solicitado. | Completa |
| 413 | Payload Too Large | El archivo o payload excede el límite permitido. | Completa |
| 415 | Unsupported Media Type | El formato del archivo no es soportado o el Content-Type es incorrecto. | Completa |
| 422 | Unprocessable Entity | La sintaxis es correcta pero el contenido no puede ser procesado: imagen ilegible, borrosa, documento maltratado, o calidad insuficiente. | Completa |
| 429 | Too Many Requests | Se ha excedido el límite de operaciones por período de tiempo. | Completa |
| 500 | Internal Server Error | Error interno de infraestructura o lógica de negocio de TuIdentidad. Fallo no relacionado con fuentes externas. | No se cobra |
| 501 | Not Implemented | Funcionalidad solicitada no está implementada en la versión actual del servicio. | No se cobra |
| 502 | Bad Gateway | La fuente oficial externa devolvió una respuesta inválida o inesperada. El servicio de terceros respondió pero con datos corruptos o formato incorrecto. | No se cobra, no nos cobra proveedor |
| 503 | Service Unavailable | La fuente oficial externa no está disponible temporalmente. El servicio de terceros está en mantenimiento o caído. | No se cobra, no nos cobra proveedor |
| 504 | Gateway Timeout | Tiempo de espera agotado al conectar con la fuente oficial externa. El servicio de terceros no respondió dentro del tiempo límite. | No se cobra, no nos cobra proveedor |