Kif jimmappjaw l-HTTP methods mas-CRUD, u xi jfissru safe u idempotent?

Eżempji

PUT /users/42 jibgħat ir-representation sħiħa u jibdilha; PATCH /users/42 jibgħat biss il-fields li jridu jinbidlu (eż. { "email": "[email protected]" }).

Safe vs idempotent

Dawn huma żewġ proprjetajiet differenti:

• Safe — il-method ma jimmodifikax l-istat tas-server (read-only). GET, HEAD, OPTIONS huma safe.
• Idempotent — li tagħmel l-istess request N darbiet għandu l-istess effett bħal meta tagħmlu darba. GET, PUT, DELETE, HEAD huma idempotent.

Għaliex huwa importanti

L-intervistaturi jistaqsu dan biex jaraw jekk tifhimx is-semantika tal-HTTP biżżejjed tajjeb biex tibni APIs affidabbli. Id-distinzjoni safe/idempotent mhijiex akkademika: tirregola direttament dak li l-clients, il-proxies, u s-CDNs huma permessi jagħmlu. Il-methods safe jistgħu jiġu cached u prefetched b'mod liberu; il-methods idempotent jistgħu jerġgħu jiġu ppruvati (retried) awtomatikament wara timeout tan-network mingħajr riskju li jiddupplikaw side effects — u għalhekk client jista' b'mod sikur jerġa' jipprova PUT jew DELETE imma jrid joqgħod attent bir-retry ta' POST (jista' joħloq żewġ orders). L-iżball klassiku huwa li tuża GET biex tiskatta side effects (eż. GET /users/42/delete), li jkisser il-caching u jħalli lill-crawlers imexxu d-data bl-addoċċ. Li tagħżel il-method it-tajjeb — u tirrispetta l-kuntratt tas-safety u l-idempotency tiegħu — huwa dak li jagħmel API prevedibbli u sikur biex tibni tooling madwaru.