Referencia de la API (Swagger)
Úsala para explorar los endpoints, revisar parámetros y respuestas, y realizar pruebas puntuales desde el navegador.
- Abre la Referencia de la API.
- Selecciona Authorize.
- Ingresa tu API key y prueba una solicitud.
API pública
Consulta e integra los datos legislativos de Open Perú en investigaciones, aplicaciones y herramientas de análisis.
Primero solicita acceso. Cuando tu solicitud sea aprobada, recibirás una API key individual. Esa misma key sirve para usar la API desde una aplicación y para probar solicitudes en Swagger.
Úsala para explorar los endpoints, revisar parámetros y respuestas, y realizar pruebas puntuales desde el navegador.
Usa la API desde el servidor de tu aplicación, un proceso de análisis o una integración segura. Envía la key en cada solicitud mediante el encabezado Authorization.
No incluyas la key en JavaScript del navegador, apps públicas ni repositorios.
Todos los endpoints de datos requieren una API key activa con el permiso api:read. Envíala como un token Bearer:
Authorization: Bearer TU_API_KEY
Por ejemplo, para obtener proyectos de ley:
curl "https://api.openperu.org.pe/v1/bills?per_page=10" \
-H "Authorization: Bearer TU_API_KEY"
El endpoint GET /v1/health no requiere autenticación y sirve para comprobar el estado del servicio.
La lista de proyectos está ordenada por fecha de presentación, de la más reciente a la más antigua. El siguiente ejemplo obtiene la primera página con 50 resultados desde el backend de una aplicación.
import json
import os
from urllib.request import Request, urlopen
url = "https://api.openperu.org.pe/v1/bills?per_page=50"
request = Request(
url,
headers={"Authorization": f"Bearer {os.environ['OPENPERU_API_KEY']}"},
)
with urlopen(request, timeout=20) as response:
data = json.load(response)
for proyecto in data["items"]:
print(proyecto["pley_id"], proyecto["title"])
Guarda la key como una variable de entorno, por ejemplo OPENPERU_API_KEY. La respuesta contiene los resultados en items y los datos de paginación en pagination.
Swagger contiene el detalle completo de parámetros, formatos y respuestas. Estos son los recursos disponibles actualmente:
GET /v1/billsLista proyectos de ley. Permite filtrar, entre otros, por título, autor, estado y fecha de presentación.
GET /v1/bills/pl/{period}/{pl_number}Obtiene el detalle de un proyecto de ley, incluidos sus autores, etapas y temas.
GET /v1/congress-membersLista congresistas y permite filtrar por nombre, bancada, región, condición y comisiones.
GET /v1/healthDevuelve el estado y la versión del servicio. No requiere API key.
Las páginas de mociones y votaciones existen en el sitio web, pero esos recursos todavía no están disponibles como endpoints JSON públicos.
Los endpoints de lista usan los parámetros page y per_page. La primera página es 1; per_page tiene un valor predeterminado de 50 y un máximo de 100.
El plan predeterminado permite 60 solicitudes por minuto por API key. Las organizaciones con un plan asignado pueden contar con hasta 300 solicitudes por minuto.
Las respuestas autenticadas incluyen los encabezados RateLimit-Limit, RateLimit-Remaining y RateLimit-Reset para que tu aplicación pueda manejar el consumo responsablemente.
| Código | Significado | Qué hacer |
|---|---|---|
401 | La key falta, no es válida, venció o fue revocada. | Verifica el encabezado Authorization y solicita ayuda si tu key ya no está activa. |
403 | La key no tiene el permiso requerido. | Contacta a Open Perú e indica el uso que necesitas. |
404 | El recurso solicitado no existe. | Revisa el identificador y los parámetros de la URL. |
422 | Uno o más parámetros no son válidos. | Consulta los requisitos del endpoint en Swagger. |
429 | Se excedió el límite de solicitudes. | Espera el tiempo indicado por RateLimit-Reset antes de reintentar. |
Revisa los Términos y condiciones de uso de la API y la Política de privacidad antes de solicitar acceso. Para consultas, escríbenos a info@openperu.org.pe.