Documentación Qrnet

Enpoint para obtención de cógidos de carnet de usuario por número de Cédula

La siguiente petición POST, tiene como responsabilidad informar cuál es el Código de 6 dígitos del carnet del usuario introducido en la variable cedula.

Respuestas a esperar

Una petición POST exitosa devuelve normalmente un código de respuesta 200 Found/Ok.

Una petición POST no exitosa por causa de la variable introducida con algún error de formato devuelve normalmente un código de respuesta 422 Unprocessable Entity.

Una petición POST no exitosa devuelve normalmente un código de respuesta 404 Not Found.

Una petición POST no exitosa también puede fallar por otras razones, por lo cual devolverá un código de respuesta 500 Internal Server Error.

Nota: Un error 500, es directamente un fallo interno que será resuelto apenas sea notificado o identificado.

Logra la conexión en 3 pasos

Pasos

A continuación se detalla el proceso y los requisitos para realizar una solicitud exitosa al endpoint de obtención de cédula a través de QRNet.

Endpoint La URL base a la cual se deben dirigir las peticiones es la siguiente.

El método HTTP requerido es POST https://api.dataemergencia.com/v2/codes/qrnet/get-cedula

Cabeceras (Headers) La solicitud debe incluir obligatoriamente las siguientes cabeceras para ser procesada correctamente.

Content-Type: application/json

X-Application-Identifier: Identificador único de la aplicación o trabajo que realiza la solicitud.

Autenticación

La autenticación se gestiona a través de un Bearer Token en la cabecera Authorization.

Authorization: Bearer {{registration_token_job}}

Authorization: Contiene el token de autenticación. Reemplace {{registration_token_job}} con el token de registro válido proporcionado.

Cuerpo de la Solicitud (Request Body)
La solicitud debe incluir un cuerpo en formato JSON con el siguiente campo:

cedula: Número de cédula que se desea consultar.

Ejemplos de Implementación

`Laravel - PHP`

`PHP`

A continuación, se muestra un ejemplo simple utilizando cURL en PHP para realizar la solicitud al endpoint.

`Consulta desde terminal`

Consideraciones Finales

location: Sigue las redirecciones si el servidor responde con una.

request POST: Especifica que se está utilizando el método HTTP POST.

header '...': Define cada una de las cabeceras necesarias para la solicitud.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "meta": {
        "timestamp": "2025-06-10T14:29:48+00:00",
        "api_version": "v2.0.0",
        "status": 200,
        "copyright": "© 2025 api.dataemergencia.com. All rights reserved."
    },
    "data": {
        "type": "response",
        "id": "success|bPsHbq8LpALNlAQHdXTanOznXxKiWEqI",
        "attributes": {
            "caa": "qeidyi"
        }
    }
}

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Code Carnet QR Getter

Documentación Qrnet#

Enpoint para obtención de cógidos de carnet de usuario por número de Cédula#

Respuestas a esperar#

Logra la conexión en 3 pasos#

Pasos#

Ejemplos de Implementación#

Laravel - PHP#

PHP#

Consulta desde terminal#

Consideraciones Finales#

Request