API pública

Documentación de la API

Consulta e integra los datos legislativos de Open Perú en investigaciones, aplicaciones y herramientas de análisis.

Cómo usar la API

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.

Referencia de la API (Swagger)

Úsala para explorar los endpoints, revisar parámetros y respuestas, y realizar pruebas puntuales desde el navegador.

  1. Abre la Referencia de la API.
  2. Selecciona Authorize.
  3. Ingresa tu API key y prueba una solicitud.

Integración desde tu aplicación

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.

Autenticación y primera solicitud

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.

Ejemplo: obtener los 50 proyectos de ley más recientes

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.

Endpoints disponibles

Swagger contiene el detalle completo de parámetros, formatos y respuestas. Estos son los recursos disponibles actualmente:

GET /v1/bills

Lista 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-members

Lista congresistas y permite filtrar por nombre, bancada, región, condición y comisiones.

GET /v1/health

Devuelve 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.

Paginación y límites de uso

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.

Errores habituales

CódigoSignificadoQué hacer
401La key falta, no es válida, venció o fue revocada.Verifica el encabezado Authorization y solicita ayuda si tu key ya no está activa.
403La key no tiene el permiso requerido.Contacta a Open Perú e indica el uso que necesitas.
404El recurso solicitado no existe.Revisa el identificador y los parámetros de la URL.
422Uno o más parámetros no son válidos.Consulta los requisitos del endpoint en Swagger.
429Se excedió el límite de solicitudes.Espera el tiempo indicado por RateLimit-Reset antes de reintentar.

Ayuda y condiciones de uso

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.