Integración API

Cualquier software puede consumir Searchpe a travéz de REST.

API

Puedes ver todos los REST endpoint disponibles en:

• Openapi

Consumo del API

Puedes utilizar cualquier lenguage de programación para consumir el API de Searchpe lo único que necesitas tener en cuenta es siempre enviar tus credenciales en cada petición tal y como se explica en la sección Seguridad.

Consulta DNI/RUC

Probablemente el endpoint más importante es /api/contribuyentes/{numeroDocumento} ya que este es usado para consultar personas natural o jurídicas a travéz de su número de DNI o RUC.

Javascript

fetch('http://localhost:8180/api/contribuyentes/{numeroDocumento}', {
  method: "GET",
  headers: {
    "Content-type": "application/json",
    "Authorization": "Basic bXlVc2VybmFtZTpteVBhc3N3b3Jk",
  }
})
.then(response => console.log(response));
.catch(error => console.log(error));

Java

HttpClient client = HttpClients.custom().build();
HttpUriRequest request = RequestBuilder.get()
  .setUri("http://localhost:8180/api/contribuyentes/{numeroDocumento}")
  .setHeader("Content-type", "application/json")
  .setHeader("Authorization", "Basic bXlVc2VybmFtZTpteVBhc3N3b3Jk")
  .build();
client.execute(request);

PHP

$httpClient = HttpClient::create();
$response = $httpClient->request('GET', 'http://localhost:8180/api/contribuyentes/{numeroDocumento}', [
    'headers' => [
        'Content-type' => 'application/json',
        'Authorization' => 'Basic bXlVc2VybmFtZTpteVBhc3N3b3Jk'
    ]
]);

versionId	integer <int64>
ruc	string
dni	string
nombre	string
estado	string
condicionDomicilio	string
ubigeo	string
tipoVia	string
nombreVia	string
codigoZona	string
tipoZona	string
numero	string
interior	string
lote	string
departamento	string
manzana	string
kilometro	string

{

• "versionId": 0,
• "ruc": "string",
• "dni": "string",
• "nombre": "string",
• "estado": "string",
• "condicionDomicilio": "string",
• "ubigeo": "string",
• "tipoVia": "string",
• "nombreVia": "string",
• "codigoZona": "string",
• "tipoZona": "string",
• "numero": "string",
• "interior": "string",
• "lote": "string",
• "departamento": "string",
• "manzana": "string",
• "kilometro": "string"

}