/api-docs · public api · v1

Public API

Endpoints REST públicos del IAC. Verificación de credenciales, corpus técnico y estado operativo. Sin autenticación, sin claves, sin onboarding. Conforme a OpenAPI 3.1.

Base URL

https://www.accreditationcenter.org

Protocol

HTTPS only · TLS 1.3 · HSTS preload · DNSSEC

Auth

Sin autenticación · endpoints públicos

Rate limit

60 req/min/IP · header X-RateLimit-Remaining

Format

JSON (default) · Atom (feeds) · ETag soportado

Encoding

UTF-8

Versioning

No versioning en path · backward-compatible aditivo · breaking via header X-API-Deprecation

CORS

Access-Control-Allow-Origin: * en endpoints públicos

quickstart · verificar un código

curl -s 'https://www.accreditationcenter.org/registry/verify?c=IAC-2026-REF-00001' \
  -H 'Accept: application/json'

Trust Registry

Verificación pública de credenciales acreditadas. Sin autenticación. Rate-limit 60/min por IP.

GET /registry/verify

parámetros

c: string · código IAC
sig: string · prefix HMAC

response

200 OK · payload firmado · ETag soportado

errores

410 Gone · registro revocado
invalid_signature · payload alterado

ejemplo

GET /registry/verify?c=IAC-2026-REF-00001&sig=0ccace812c6b91a2

GET /registry

parámetros

q: string · término de búsqueda
limit: int · max 50
tipo: profesional | organizacion | programa

response

200 OK · array paginable de fichas

errores

429 · rate-limit excedido

ejemplo

GET /registry?q=ISO%2017021&limit=20

GET /registry/health

response

200 OK · { status, uptime, version, region }

errores

503 · servicio degradado

ejemplo

GET /registry/health

Standards & Research

Acceso al corpus técnico citable. Sin autenticación. Rate-limit 60/min.

GET /standards/publicaciones.json

parámetros

categoria: string · filtro categoría
estado: Published | Open for comments | Superseded

response

200 OK · listado paginable

ejemplo

GET /standards/publicaciones.json?estado=Published

GET /standards/publicaciones/<id>.json

parámetros

id: string · identificador estable

response

200 OK · documento individual · ETag · payload firmado

errores

404 · no encontrado

ejemplo

GET /standards/publicaciones/STD-001.json

GET /standards/feed.atom

response

200 OK · Atom XML

ejemplo

GET /standards/feed.atom

Status & Health

Estado operativo del sistema. Sin autenticación. Sin rate-limit.

GET /status.json

response

200 OK · { state, summary, services, uptime[90] }

ejemplo

GET /status.json

GET /status/feed.atom

response

200 OK · Atom XML · incidentes + cambios de estado

ejemplo

GET /status/feed.atom

Códigos de respuesta

El sistema responde con códigos HTTP estándar. Algunos códigos llevan información adicional en headers (Retry-After, X-API-Deprecation, ETag).

200 OK Request exitoso. Payload en body.

304 Not Modified ETag matched. Sin cambios desde última request.

400 Bad Request Parámetro inválido o faltante.

404 Not Found Recurso no existe en el registro.

410 Gone Recurso revocado · estado terminal · no volverá a estar disponible.

429 Too Many Requests Rate limit excedido. Retry-After header.

503 Service Unavailable Componente degradado. Ver /status.

Especificación OpenAPI 3.1

La especificación machine-readable está disponible para importar en Postman, Insomnia, cualquier cliente que consuma OpenAPI 3.1 o generadores de SDK.

GET /api-docs/openapi.json OpenAPI 3.1 spec · JSON

GET /api-docs/openapi.yaml OpenAPI 3.1 spec · YAML

GET /api-docs/postman.json Postman collection · importable