Ba chóir go léifeadh URI acmhainne cosúil le conair ainmfhocalbhunaithe chuig rud, ní gníomh. Soláthraíonn an HTTP method an briathar cheana féin, mar sin ní gá don URI ach an acmhainn a aithint go soiléir agus go comhsheasmhach.
Ba chóir go léifeadh URI acmhainne cosúil le conair ainmfhocalbhunaithe chuig rud, ní gníomh. Soláthraíonn an HTTP method an briathar cheana féin, mar sin ní gá don URI ach an acmhainn a aithint go soiléir agus go comhsheasmhach.
GET /users/42 — ní GET /getUser?id=42. Is é an method (GET) an briathar./users an collection; is ball amháin é /users/42. Coinníonn fanacht san iolra i ngach áit intuartha é./users/42/orders = "orders a bhaineann le user 42".kebab-case, cás íochtair. /blog-posts, ní /blogPosts ná /Blog_Posts./users?role=admin&sort=-created_at./users collection úsáideoirí
/users/42 úsáideoir amháin
/users/42/orders orders a bhaineann le user 42 (fo-collection)
/users/42/orders/1001 order sonrach den úsáideoir sin
/orders/1001 an t-order céanna, inseolta ag an leibhéal barr freisin
GET /users/42/orders?status=shipped&sort=-created_at&page=2 HTTP/1.1
Accept: application/json
Seachain neadú domhain thar leibhéal nó dhó — éiríonn /users/42/orders/1001/items/5/reviews sobhriste. Chomh luath agus a bhíonn a ID féin ag order, is fearr /orders/1001. I gcás gníomhartha nach n-oireann do CRUD (m.sh. "send email"), tá fo-acmhainn i stíl controller inghlactha: POST /users/42/verify-email.
Is é ainmniú comhsheasmhach a fhágann go mbraitheann API iomasach — is féidir le forbróir a chonaic /users agus /users/42 buille faoi thuairim ceart a thabhairt faoi /products agus /products/99 gan doiciméid a léamh. Úsáideann agallóirí é seo chun a thomhas an smaoiníonn tú i dtéarmaí acmhainní (an meon REST) seachas glaonna RPC (/doThisThing). Fágann na frithphatrúin is coitianta — briathra sa path, iolrú neamhréireach, agus URLanna a bhfuil neadú domhain iontu — API níos deacra le foghlaim agus le cothabháil, agus comharthaíonn siad forbróir nár inmheánaigh srian uniform-interface REST. Coinníonn dea-dhearadh URI imní scartha freisin: aitheantas sa path, scagadh agus pagination sa query string, rud a choinníonn caching agus routing glan.
Leabharlann de cheisteanna agallaimh TF le freagraí mionsonraithe — ó Shóisearach go Sinsearach.
Síntiús