Testscenario /core/http-methods
#629
Labels
Status: proposal
proposal for change, to be discussed in wg
STD: ADR
Standaard: API Design Rules
WG: Normatieve rules
issues regarding the normative part of the API design rules
Milestone
Stap 1 van alle 3 scenario's gaat uit van een valid OAS. Zoals ook in de Note beschreven is, staat OAS alleen GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS en TRACE toe. Als een andere method als scope van de API wordt gedefinieerd is de OAS niet valid, dus kan stap 2 van de scenario's niet uitgevoerd worden.
Genoemde RFC 7231 gaat over het HTTP protocol an sich, en is niet per se onderdeel van de scope van de API. Een request buiten de scope van de API zegt dus niets over de API Design Rules; we mogen niet verwachten dat bijvoorbeeld een bovenliggende infrastructuur laag wordt aangepast om een ADR test te kunnen laten slagen die bovendien niets zegt over het doel van de regel, in dit geval "gebruik geen exotische methods, maar gewoon de gangbare" (zelfde motivatie als OAS hanteert).
"How to test" is in deze context dan ook niets anders dan "zorg ervoor dat OAS valid is", en dit kan ook automatisch zo getest worden door de ADR validator.
Zie ook #628
The text was updated successfully, but these errors were encountered: