Ga naar inhoud
Methodologie

API-foutresponses

ia.api-errors · 4.22

Handelen ZOU MOETEN Aanbeveling AR-ACT-02

Waarom het belangrijk is

Agents roepen API's programmatisch aan en kunnen niet herstellen van een HTML-foutpagina. Een JSON problem-details-body met een code en een bericht laat ze op fouten reageren.

Zo los je het op

Geef RFC 9457 problem details als JSON terug bij API-fouten.

  1. Geef application/problem+json terug voor elke 4xx- en 5xx-response van de API.

    {"type": "https://example.com/problems/not-found", "title": "Not found", "status": 404, "detail": "No such resource"}

Controleren

curl -s https://{domain}/api/isagentready-missing-check | jq -e '.status or .error'

Verwacht: exitcode 0

Start een nieuwe scan voor dit checkpoint:

isagentready results {domain} --checkpoint ia.api-errors
Details Koppeling, levenscyclus en bronnen
AR-koppeling
Gedeeltelijke match
Bron van het bewijs
agentready.org AR-ACT-02
Rol in de score
Kern
Toegevoegd
2026-08-25
Methodologieversie
2026-10-22

Checkpointdata (JSON)