Ukendt felt

Hvad det betyder

Forespørgslens indhold havde et felt, som endpointet ikke kender, så det blev afvist i stedet for at blive ignoreret.

Endpoints, der accepterer delvise opdateringer, behandler et manglende felt som “lad det være”. Et feltnavn, de ikke kender, kan ikke skelnes fra et manglende felt, så hvis det i stilhed blev ignoreret, ville de svare 200 på en ændring, der aldrig skete. Disse endpoints afviser derfor hele forespørgslen i stedet.

Eksempler på detail-beskeder, der returneres med denne fejl:

• Unrecognised field(s): “securityAutomerge” (did you mean “security_automerge”?). Accepted fields are: enabled, automerge_patch, automerge_minor, major_approval, security_automerge, schedule, pr_hourly_limit, pr_concurrent_limit.
• Unrecognised field(s): “automerge_everything”. Accepted fields are: enabled, automerge_patch, automerge_minor, major_approval, security_automerge, schedule, pr_hourly_limit, pr_concurrent_limit.

Hvad du skal gøre

Læs detail: den angiver hvert felt, der ikke blev genkendt, og viser de felter, endpointet accepterer.

Tjek først skrivemåden. Felter i forespørgsler er i snake_case og svarer til de underliggende kolonnenavne. Flere endpoints serialiserer deres svar i camelCase, så at kopiere et feltnavn fra et svar og sende det tilbage er den mest almindelige årsag til denne fejl. Hvis det felt, du sendte, er en camelCase-stavning af et rigtigt felt, angiver detail den korrekte stavemåde.

// rejected - camelCase, as returned in a response body
{ "securityAutomerge": true }

// accepted
{ "security_automerge": true }

Ellers kan du sammenligne indholdet med forespørgselsskemaet i OpenAPI-specifikationen.

Svarets form

Alle fejl fra fremforges API er RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/unknown-field",
  "title": "Bad Request",
  "status": 400,
  "detail": "..."
}

Lad din kode træffe beslutninger ud fra type, ikke ud fra title eller detail – de er skrevet til mennesker og kan blive omformuleret.