Inicio

Todo lo que necesitas saber antes de hacer tu primera consulta.

URL base

Todos los endpoints de esta referencia son relativos a una URL base. Hay dos formas válidas de llegar a la API — ambas sirven exactamente las mismas rutas, elige la que prefieras:

URL base	Notas
`https://api.apiperu.dev`	Subdominio dedicado a la API. Recomendado — URL más corta, sin el `/api` de en medio.
`https://apiperu.dev`	Dominio principal (compartido con el sitio web). Sigue funcionando indefinidamente — es la forma en que ya te estás conectando si empezaste antes de que existiera el subdominio dedicado. Aquí antepones `/api` a la ruta de cada endpoint (así ya lo hacen los sistemas existentes).

Un endpoint como /dni en esta documentación se arma pegando la URL base que elijas + la ruta del endpoint, por ejemplo:

https://api.apiperu.dev/dni
https://apiperu.dev/api/dni

(mismo endpoint, misma respuesta — solo cambia el host, y si va o no el /api). Los ejemplos de código de cada endpoint (cURL, PHP, JavaScript, Python) en esta referencia usan https://api.apiperu.dev — si prefieres la URL legacy, cambia esa parte y agrega /api antes de la ruta del endpoint.

Autenticación

Todas las peticiones requieren un token en el header Authorization:

Authorization: Bearer TU_TOKEN

Genera tu token desde el panel, en Api Tokens.

Colección de Postman

Descarga la colección con todos los endpoints de esta referencia ya armados (variables URL_BASE y TOKEN incluidas — solo configúralas una vez en Postman y quedan aplicadas a toda la colección).

Descargar colección