Superintendencia Nacional de los Registros Públicos (SUNARP) consulta vehicular - Peru
Para integrar el servicio de Superintendencia Nacional de los Registros Públicos (SUNARP) consulta vehicular - Peru en su sistema. Primero, obtenga su API key de Apitude, luego envíe una solicitud POST a Aptitude ... ¡Y eso es todo!.
Esa solicitud POST debe devolver lo siguiente
{
"message": "Request processed successfully",
"url": "/api/v1.0/requests/sunarp-vehicle-pe/e0606c19-a32d-410f-b2eb-d57a665677bc/",
"request_id": "e0606c19-a32d-410f-b2eb-d57a665677bc"
}
Esta respuesta contendrá un ID de solicitud único que debe utilizar enviando un GET de la siguiente manera
¿Cómo se ve la respuesta?
{
"result": {
"data": {
"sede": "TRUJILLO",
"color": "ROJO",
"found": true,
"marca": "WANXIN",
"estado": "EN CIRCULACION",
"modelo": "WX110-9",
"no_vin": "LB411P1038C010016",
"no_motor": "152FMH08010016",
"no_placa": "T11750",
"no_serie": "LB411P1038C010016",
"check_type": [
"document_number"
],
"anotaciones": "NINGUNA",
"propietarios": [
"VASQUEZ VARGAS, ESTEBAN JUAN"
],
"placa_vigente": "T11750",
"placa_anterior": "MD24778"
},
"error": "",
"end_at": "2024-03-25 06:27:20.027521",
"status": 200,
"message": "successful",
"queried_by": "testUser",
"service_name": "sunarp-vehicle-pe"
},
"message": "Request completed"
}
Ok, pero ¿qué significa cada campo en ese JSON?
Las partes generales:
message:
El mensaje es unstring
generado por Aptitude con un texto informativo sobre la solicitud..result:
El resultado contiene la parte principal de la solicitud..result.error:
El error es unstring
generado por Aptitude para la solicitud. Si todo funcionó, estará en blanco.result.message:
El mensaje es unstring
con dos opcionessuccessful
ounsuccessful
dependiendo de cómo terminó su solicitud.result.queried_by:
El campo queried_by es unstring
que indica que usuario creo la solicitud.result.end_at:
El campo end_at es unstring formatted date
que indica en qué momento la solicitud terminó en Apitude.result.service_name:
El campo service_name es unstring
que retorna el servicio llamado. Para este servicio siempre serásunarp-vehicle-pe
.result.status:
El campo estado, es unentero
cuyo valor representa si el servicio retorno informacion para la solicitud enviada. Puede tomar alguno de los siguientes valores:200
: El servicio devolvió datos con la respuesta para la información que se envió en la solicitud.404
: El servicio no devolvió datos con la respuesta para la información que se envió en la solicitud.400
: El servicio no se inició porque su entrada no era válida.500
: Apitude intentó ejecutar tu solicitud, sin embargo, el servicio que utiliza Apitude para ejecutar su solicitud no funciona. Espera un poco y vuelve a intentarlo, Apitude no te cobrará solicitudes con este código.
Dependiendo del servicio, quieres que devuelva diferente códigos. Por ejemplo, si está pasando al usuario por un proceso de vinculación y desea que este quede en su lista blanca, debe buscar un
404
, porque un200
significaría que el usuario está de hecho en la lista. Otros casossin embargo, como crear objetos con el nombre de un usuario, desea que el código sea200
, ya que implicará que la creación fue un éxito.
Los datos en la respuesta:
Consulte los documentos oficiales de este servicio en línea para obtener más información sobre qué datos se devuelven.
Sobre este servicio
El servicio permite al usuario tener acceso directo y confiable via API a ciertos datos relacionados a las caracteristicas de los vehiculos registrados a nivel nacional, asi como el o los titulares del vehiculo.
¿A quién puede consultar utilizando este servicio?:
Este servicio (sunarp-vehicle-pe) está disponible para consultar tanto individuos, como empresas / negocios.
Get API Access