Inicio › Documentación

Documentación

Guía de integración con las APIs de API Access Nacional: autenticación, formato de peticiones, límites de consumo y manejo de errores.

Primeros pasos

  1. Revisa el catálogo de APIs y sus requisitos.
  2. Solicita acceso según tu tipo de institución.
  3. Tras la aprobación, genera tus API Keys en el Panel de desarrolladores.
  4. Realiza tu primera llamada usando el ejemplo de cada API.

Autenticación

Todas las peticiones requieren una API Key válida en el encabezado Authorization con el esquema Bearer. Las llamadas sin credencial válida responden 401 Unauthorized.

Authorization: Bearer <API_KEY>

La comunicación es únicamente sobre HTTPS. No compartas tu API Key ni la incluyas en código del lado del cliente.

Peticiones

Las APIs siguen un estilo REST y responden en JSON. El dominio base es:

https://apiaccess.gob.mx/v1/…

Ejemplo de una consulta:

curl -H "Authorization: Bearer <API_KEY>" \ https://apiaccess.gob.mx/v1/identidad/curp/XEXX010101HNEXMPA4

Límites de consumo

Cada credencial tiene un límite de consultas asignado según el convenio de acceso. La respuesta incluye tu saldo:

Al superar el límite, las peticiones responden 429 Too Many Requests.

Errores

Los errores usan códigos HTTP estándar y un cuerpo JSON con el detalle en el campo error.

CódigoSignificado
200Consulta exitosa.
400Parámetro inválido o mal formado.
401API Key ausente o inválida.
404Registro no encontrado.
429Límite de consultas superado.
503Fuente oficial no disponible temporalmente.

APIs disponibles

Consulta la referencia detallada de cada endpoint en el catálogo: