CedulaVE API 다운로드 - CedulaVE API 소스 코드 다운로드

CedulaVE API

기타 카테고리

v1.1.2

다운로드

CedulaVE API

CedulaVE API 는 신분증을 통해 CNE 에 등록된 베네수엘라 거주자의 개인 데이터를 참조하기 위해 PHP 로 작성된 스크립트입니다.

? 기부금

기여, 문제 및 기능 요청을 환영합니다. 기여하고 싶다면 자유롭게 문제를 확인해 보세요.

? 시설

CedulaVE API 설치하는 가장 쉬운 방법은 Composer를 이용하는 것입니다.

composer require megacreativo/cedulave-api

PHP 예

info 메소드를 사용하여 쿼리를 실행할 수 있으며 응답은 기본적으로 JSON 형식으로 가져옵니다.

API 쿼리

더 많은 예시를 보려면 예시로 이동하세요.

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

성공적인 응답

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

)

오류 응답

오류 404 문의한 ID가 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 "
    }
}

오류 301 수신된 데이터가 정확하지 않습니다. 국적 오류입니다. 허용되는 값 [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] "
    }
}

오류 302 수신된 데이터가 올바르지 않습니다. 숫자가 아닌 문자를 입력했습니다

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

오류 303 수신된 데이터가 올바르지 않습니다. 숫자가 아닌 문자를 입력했습니다

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