Resource URI ya kamata a karanta shi kamar hanya bisa suna (noun) zuwa wani abu, ba aiki ba. HTTP method ya riga ya samar da kalmar aiki (verb), don haka URI kawai yana bukatar gane resource a fili kuma daidai.
Resource URI ya kamata a karanta shi kamar hanya bisa suna (noun) zuwa wani abu, ba aiki ba. HTTP method ya riga ya samar da kalmar aiki (verb), don haka URI kawai yana bukatar gane resource a fili kuma daidai.
GET /users/42 — ba GET /getUser?id=42 ba. Method (GET) shi ne kalmar aiki./users shi ne collection; /users/42 memba ɗaya ne. Zama a jam'i ko'ina yana sa ya kasance mai tsinkaya./users/42/orders = "orders na user 42".kebab-case, ƙananan haruffa. /blog-posts, ba /blogPosts ko /Blog_Posts ba./users?role=admin&sort=-created_at./users collection na users
/users/42 user guda
/users/42/orders orders na user 42 (sub-collection)
/users/42/orders/1001 wani order na wannan user
/orders/1001 order ɗin nan, ana iya kai shi a top level ma
GET /users/42/orders?status=shipped&sort=-created_at&page=2 HTTP/1.1
Accept: application/json
Ka guji nesting mai zurfi fiye da mataki ɗaya ko biyu — /users/42/orders/1001/items/5/reviews yana zama mai rauni. Da zarar order yana da nasa ID, ka fifita /orders/1001. Ga ayyukan da ba su dace da CRUD ba (misali "aika email"), sub-resource irin na controller abin karɓa ne: POST /users/42/verify-email.
Sanya suna daidai shi ne abin da ke sa API ya ji na dabi'a — mai haɓaka wanda ya ga /users da /users/42 zai iya hasashen /products da /products/99 daidai ba tare da karanta docs ba. Masu hira suna amfani da wannan don auna ko kana tunani cikin resources (tunanin REST) maimakon RPC calls (/doThisThing). Anti-patterns da suka fi kowa — verbs a path, jam'i mara daidaito, da URLs masu zurfin nesting — duk suna sa API mai wahalar koya da kiyayewa, kuma suna nuni ga mai haɓaka wanda bai ɗauki ƙuntatawar uniform-interface na REST a zuciya ba. Kyakkyawan ƙira na URI yana kuma raba abubuwan da suka shafa: shaida a path, filtering da pagination a query string, wanda ke sa caching da routing su tsaya tsaftace.
Ɗakin karatu na tambayoyin hira na IT tare da amsoshi cikakke — daga Junior zuwa Senior.
Ba da Gudummawa