Kein Konto

API

Dieselben Prüfungen wie auf den Seiten, als JSON, für Ihre Skripte und CI-Pipelines. Kein Schlüssel und kein Konto; auf 30 Aufrufe pro Minute und Adresse begrenzt. Nichts wird gespeichert.

POST /api/v1/analyse

Prüft eine SAML-Antwort (XML, Base64 oder Formular-Body). Felder: response (erforderlich), entity_id, acs_url, issuer, request_id, cert (PEM). Liefert ok, checks (Status, Titel, Detail), nameId und 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

Analysiert Metadaten (a) und, wenn b angegeben ist, beide. Liefert Typ, Felder, Zertifikate (Fingerabdruck, Gültigkeit) und Warnungen.

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

POST /api/v1/diagnostic

Findet die wahrscheinliche Ursache einer Fehlermeldung (Feld error).

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

API personnelle Pro

Mit einem Token, erstellt unter Mein Konto (Pläne Pro und Max), lesen Ihre Skripte Ihre Tests und führen die Status-Prüfungen aus. Senden Sie Authorization: Bearer idk_….

GET /api/v1/me/tests?limit=20: Ihre letzten Tests (SAML und OpenID Connect) mit ihrem Ergebnis.
GET /api/v1/me/health: der Status Ihrer Elemente, mit den Problemen und ihrer Lösung.
POST /api/v1/me/health/run: führt die Prüfungen jetzt aus.

Beispiel für GitHub Actions: Der Job schlägt fehl, wenn eine Prüfung nicht in Ordnung ist.

- 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'

In CI verwenden

Lassen Sie die Pipeline fehlschlagen, wenn ok false ist: … | jq -e '.ok'.