API-03: Only apply standard HTTP methods en Azure APIM

[aziz.errafay.fin]

Ik loop bij het implementeren van die API Design rules tegen het volgende aan :
Onze API wordt via Azure Api Management ( APIM ) ontsloten.
APIM ondersteunt alleen de gangbare HTTP Verbs :
GET,POST,PUT,DELETE,HEAD,OPTIONS,PATCH,TRACE

Bij een “LINK” geeft APIM een 404 terug omdat er geen resourcehandler is gevonden voor deze verb.
Hierdoor kunnen we niet aan deze rule voldoen.

Is het mogelijk dat een 404 ook geldig kan zijn voor de apr-validator? Omdat deze verb niet wordt ondersteunt door APIM.

[joostfarla]

@aziz.errafay.fin je zou kunnen proberen om dit met inbound policies voor elkaar te krijgen.

Zie bijv:

• Azure API Management limitation workaround: Return 404 instead of 405 when the HTTP method not match - Microsoft Community Hub
• How to setup 405 Method Not Allowed for each of the methods in APIs using azure API Management - Stack Overflow

Zou je dat eens kunnen proberen?

[aziz.errafay.fin]

Hoi Joost.
Dank je wel. De tweede had ik al geprobeerd, maar die werkt niet omdat APIM een “OperationNotFound” genereert, voordat de inbound policy wordt verwerkt. Door de conditie in een onError te plaatsen met een check op “OperationNotFound” en een lijstje notsupported methods werkt het goed.

[dvhees]

Ik vind API-03 hierin erg onduidelijk. Hoe ik het lees staat er dat je gewoon de standaard methods moet gebruiken voor je API (design), maar niet expliciet dat andere methods een 405 moet teruggeven? In Gitlab zijn er veel vergelijkbare issues met deze regel en is te lezen dat de werkgroep hierover ging nadenken. Wat is hieruit gekomen?