Téléchargement de CedulaVE API - Téléchargement du code source CedulaVE API

CedulaVE API

Autres catégories

v1.1.2

Télécharger

CedulaVE API

CedulaVE API est un script écrit en PHP pour consulter les données personnelles des résidents vénézuéliens enregistrés au CNE via leur carte d'identité.

? Contribution

Les contributions, problèmes et demandes de fonctionnalités sont les bienvenus. N'hésitez pas à consulter les numéros si vous souhaitez contribuer.

? Facilité

Le moyen le plus simple d'installer CedulaVE API consiste à utiliser Composer

composer require megacreativo/cedulave-api

Exemple PHP

La méthode info est disponible pour exécuter la requête, la réponse est obtenue par défaut au format JSON

Interroger l'API

Pour voir plus d'exemples, allez aux exemples

 /**
 * 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 );

Réponse réussie

{
    "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
        )

)

Réponses aux erreurs

Erreur 404 L'identifiant consulté n'est pas enregistré au 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 "
    }
}

Erreur 301 Les données reçues ne sont pas correctes, Erreur de nationalité. Valeurs autorisées [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] "
    }
}

Erreur 302 Les données reçues ne sont pas correctes. Un caractère non numérique a été saisi

{
    "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 "
    }
}

Erreur 303 Les données reçues ne sont pas correctes. Un caractère non numérique a été saisi

{
    "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 "
    }
}