Sin cuenta

API

Las mismas comprobaciones que las páginas, en JSON, para sus scripts y pipelines de CI. Sin clave ni cuenta; limitado a 30 llamadas por minuto por dirección. No se guarda nada.

POST /api/v1/analyse

Verifica una respuesta SAML (XML, base64 o cuerpo de formulario). Campos: response (obligatorio), entity_id, acs_url, issuer, request_id, cert (PEM). Devuelve ok, checks (estado, título, detalle), nameId y attributes.

curl -s https://idkit.idkit.workers.dev/api/v1/analyse \
  -H 'content-type: application/json' \
  -d '{"response":"<samlp:Response …","entity_id":"https://mon-app/saml","cert":"-----BEGIN CERTIFICATE-----…"}'

POST /api/v1/metadata

Analiza unos metadatos (a) y, si se proporciona b, ambos. Devuelve el tipo, los campos, los certificados (huella, validez) y las advertencias.

curl -s https://idkit.idkit.workers.dev/api/v1/metadata \
  -H 'content-type: application/json' \
  -d '{"a":"<EntityDescriptor …"}'

POST /api/v1/diagnostic

Encuentra la causa probable de un mensaje de error (campo error).

curl -s https://idkit.idkit.workers.dev/api/v1/diagnostic \
  -H 'content-type: application/json' \
  -d '{"error":"AADSTS700016 invalid audience"}'

API personnelle Pro

Con un token creado en Mi cuenta (planes Pro y Max), sus scripts leen sus pruebas y ejecutan las comprobaciones de Estado. Envíe Authorization: Bearer idk_….

• GET /api/v1/me/tests?limit=20: sus últimas pruebas (SAML y OpenID Connect), con su resultado.
• GET /api/v1/me/health: el estado de sus elementos, con los problemas y su solución.
• POST /api/v1/me/health/run: ejecuta las comprobaciones ahora.

Ejemplo para GitHub Actions: el job falla si una comprobación no es correcta.

- name: Contrôle ID-Kit
  run: |
    curl -s -X POST https://id-kit.com/api/v1/me/health/run -H "Authorization: Bearer $IDKIT_TOKEN"
    curl -s https://id-kit.com/api/v1/me/health -H "Authorization: Bearer $IDKIT_TOKEN" | jq -e '.ok'

Usar en CI

Haga fallar el pipeline si ok es false: … | jq -e '.ok'.