Skip to content

CedulaVE API es un script escrito en PHP para consultar datos personales de habitantes de Venezuela inscritos en el CNE mediante su Cédula de Identidad.

License

Notifications You must be signed in to change notification settings

MegaCreativoTeam/CedulaVE-API

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

👋 CedulaVE API

GitHub issues GitHub forks GitHub license StyleCI

CedulaVE API es un script escrito en PHP para consultar datos personales de habitantes de Venezuela inscritos en el CNE mediante su Cédula de Identidad.

🤝 Contibución

ko-fi

Contribuciones, problemas y solicitudes de funciones son bienvenidos. Siéntase libre de consultar los issues si quieres contribuir.

💽 Instalación

La forma más fácil de instalar CedulaVE API es a través de Composer

composer require megacreativo/cedulave-api

📜 Ejemplo PHP

El método info está disponible para ejecutar la consula, las respuesta se obtiene por defecto en formato JSON

Consultar la API

Para ver más ejemplos valla a examples

/**
 * Estructura de parametros
 * 
 * @param string   $nac     Tipo de Nacionalidad. Valores permitidos [V|E]. Cualquier otro valor producirá un Error 301
 * @param string   $cedula  Número de Cédula de Identidad a consultar
 * @param boolean  $json    (Opcional) Si es true devolver JSON como respuesta, en caso contrario devuelve un ARRAY. Valor por defecto TRUE
 * @param boolean  $pretty  (Opcional) Se devuelve un JSON, este parametro establece si se aplica JSON_PRETTY_PRINT. Valor por defecto FALSE
 */
function info(string $nac, string $cedula, bool $json = true, bool $pretty = false)


/**
 * Ejemplos de uso
 **/
// Retorna un JSON
CedulaVE::info('V', '12345678');

// Retorna un Array
CedulaVE::info('V', '12345678', false);

// Retorna un JSON formateado 
vCedulaVE::info('V', '12345678', true, true);

Respuesta exitosa

{
    "status": 200,
    "version": "1.1.1",
    "website": "https://api.megacreativo.com/public/cedula-ve/v1",
    "response":
    {
        "nac": "V", /* Nacionalidad. [V|E] */
        "dni": "12345678", /* Cédula de identidad */
        "name": "Jhon Alfred", /* Primer y segundo nombre */
        "lastname": "Doe Law", /* Primer y segundo apellido */
        "fullname": "Jhon Alfred Doe Law", /* Nombre completo */
        "state": "Estado", /* Estado donde se encuentra el Centro de votación */
        "municipality": "Municipio", /* Municipio del Centro de votación */
        "parish": "Parroquia", /* Parroquia del Centro de votación */
        "voting": "Centro de votación", /* Nombre del Centro de votación */     
        "address": "Direccion" /* Dirección del Centro de votación */
    }
}
Array
(
    [status] => 200
    [version] => 1.1.1
    [api] => https://api.megacreativo.com/public/cedula-ve/v1
    [data] => Array
        (
            [nac] => V
            [dni] => 12345678
            [name] => JHON ALFRED
            [lastname] => DOE LAW
            [fullname] => JHON ALFRED DOE LAW
            [state] => ESTADO
            [municipality] => MUNICIPIO
            [parish] => PARROQUIA
            [voting] => CENTRO DE VOTACION
            [address] => DIRECCION DEL CENTRO
        )

)

Respuestas de error

Error 404 La cédula consultada no está inscrita en el CNE

{
    "status": 404,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 404,
        "message": "No se encontró la cédula de identidad"
    }
}

Error 301 Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos [V|E]

{
    "status": 301,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 301,
        "message": "Los datos recibidos no son correctos, Error en la nacionalidad. Valores permitidos [V|E]"
    }
}

Error 302 Los datos recibidos no son correctos. Se introdujo un caracter no numerico

{
    "status": 302,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 302,
        "message": "Los datos recibidos no son correctos. Se introdujo un caracter no numerico"
    }
}

Error 303 Los datos recibidos no son correctos. Se introdujo un caracter no numerico

{
    "status": 303,
    "version": "1.1.1",
    "api": "https://api.megacreativo.com/public/cedula-ve/v1",
    "data": {
        "code": 303,
        "message": "Debe ingresar una cedula de indetidad válida. Sólo se permiten caracteres numéricos"
    }
}

👤 Author

Brayan Rincón

  • Github: [@bracodev][link-bracodev]

📌 Versiones

We use SemVer for versioninWg. For all available versions, look at the tags in this repository.

📝 Licencia

The software is distributed under the MIT license. Copyright © 2018-2020. Made with ❤️ by Brayan Rincon & MegaCreativo https://megacreativo.com

About

CedulaVE API es un script escrito en PHP para consultar datos personales de habitantes de Venezuela inscritos en el CNE mediante su Cédula de Identidad.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages