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.
Global Standard Codes
Our platform follows a standardized HTTP response code structure that simplifies handling and billing processes. Additionally, each API includes its own alert messages, providing more detailed information for every event or situation.
| HTTP Code | Status | Description |
|---|---|---|
| 200 | OK | All official sources responded successfully. Process completed without errors. |
| 203 | Non-Authoritative Information | Partial success: At least one official source responded correctly, but others failed, timed out, or were unavailable. The response includes a warnings array. |
| 204 | No Content | The request was processed successfully, but there is no content to return. Used for searches with no results. |
| 400 | Bad Request | Request validation error: missing parameters, incorrect format, invalid JSON structure, or data outside the allowed range. |
| 401 | Unauthorized | Invalid or missing credentials. The apiKey header was not provided or is incorrect. |
| 403 | Forbidden | Valid authentication but insufficient permissions to access the specific resource or service. |
| 404 | Not Found | The requested resource does not exist. This may be due to an incorrect endpoint, an invalid verification ID, or data not found in the source. |
| 405 | Method Not Allowed | The HTTP method used is not allowed for the requested endpoint. |
| 413 | Payload Too Large | The file or payload exceeds the allowed limit. |
| 415 | Unsupported Media Type | The file format is not supported or the Content-Type is incorrect. |
| 422 | Unprocessable Entity | The syntax is correct, but the content cannot be processed: unreadable image, blurry image, damaged document, or insufficient quality. |
| 429 | Too Many Requests | The operation limit for the time period has been exceeded. |
| 500 | Internal Server Error | Internal infrastructure or business logic error in TuIdentidad. Failure unrelated to external sources. |
| 501 | Not Implemented | The requested functionality is not implemented in the current version of the service. |
| 502 | Bad Gateway | The external official source returned an invalid or unexpected response. The third-party service responded with corrupted data or an incorrect format. |
| 503 | Service Unavailable | The external official source is temporarily unavailable. The third-party service is under maintenance or down. |
| 504 | Gateway Timeout | Timeout occurred while connecting to the external official source. The third-party service did not respond within the time limit. |