Një URI resource-i duhet të lexohet si një path i bazuar në emra drejt një gjëje, jo si një veprim. HTTP method tashmë e siguron foljen, prandaj URI-ja thjesht duhet ta identifikojë resource-in qartë dhe në mënyrë të qëndrueshme.
Një URI resource-i duhet të lexohet si një path i bazuar në emra drejt një gjëje, jo si një veprim. HTTP method tashmë e siguron foljen, prandaj URI-ja thjesht duhet ta identifikojë resource-in qartë dhe në mënyrë të qëndrueshme.
GET /users/42 — jo GET /getUser?id=42. Metoda (GET) është folja./users është collection-i; /users/42 është një anëtar. Të qëndruarit në shumës kudo e mban të parashikueshëm./users/42/orders = "orders që i përkasin user-it 42".kebab-case, me shkronja të vogla. /blog-posts, jo /blogPosts ose /Blog_Posts./users?role=admin&sort=-created_at./users collection of users
/users/42 a single user
/users/42/orders orders belonging to user 42 (sub-collection)
/users/42/orders/1001 a specific order of that user
/orders/1001 same order, addressable at top level too
GET /users/42/orders?status=shipped&sort=-created_at&page=2 HTTP/1.1
Accept: application/json
Shmang nesting-un e thellë përtej një ose dy niveleve — /users/42/orders/1001/items/5/reviews bëhet i brishtë. Sapo një order të ketë ID-në e vet, preferohu /orders/1001. Për veprime që nuk përshtaten me CRUD (p.sh. "send email"), një sub-resource i stilit controller është i pranueshëm: POST /users/42/verify-email.
Emërtimi i qëndrueshëm është ajo që e bën një API të duket intuitiv — një zhvillues që ka parë /users dhe /users/42 mund të hamendësojë saktë /products dhe /products/99 pa lexuar docs. Intervistuesit e përdorin këtë për të matur nëse mendon me resources (mentaliteti REST) sesa me RPC calls (/doThisThing). Anti-modelet më të zakonshme — folje në path, shumësi jokoherent, dhe URL të futura thellë — të gjitha e bëjnë një API më të vështirë për t'u mësuar e mirëmbajtur, dhe sinjalizojnë një zhvillues që nuk e ka brendësuar kufizimin uniform-interface të REST-it. Dizajni i mirë i URI-ve gjithashtu i mban shqetësimet të ndara: identiteti në path, filtering dhe pagination në query string, gjë që e mban caching-un dhe routing-un të pastër.
Një bibliotekë pyetjesh intervistash IT me përgjigje të detajuara — nga Junior te Senior.
Dhuro