Http módszerek létrehozásához nyugodt szolgáltatások
HTTP ige képezik a fő része az „egységes felület”, amely korlátozza, és lehetővé teszi, hogy végezzen műveleteket érdemi forrás. Az elsődleges vagy leggyakrabban használt HTTP ige (vagy módszerek, ahogy néha nevezik) a POST, GET, PUT és DELETE. Ezek megfelelnek létrehozni, olvasni, frissítése és törlése (vagy együttesen - szifilisz). Aztán ott vannak más igék, de ezek ritkábban. Az alkalmazott módszerek ritkábban juttatott opciók és a fej
Az alábbiakban egy összefoglaló táblázatot ajánlások által visszaadott érték bázikus HTTP ige együtt URI az erőforrást:
Erőforrás (például / vevők)
Bíróság (például / vevők /)
200 (OK), az ügyfelek listáját. Használja oldalszámozás, rendezési és szűrési nagy listákat.
200 (OK), egy adott ügyfél. 404 (Nem található), ha nincs például a megadott azonosító, vagy ha ez nem megfelelő (és ha az ügyfél nem szabad tudni a rendelkezésre álló ez esetben).
404 (Nem található), ha volt egy kísérlet, hogy frissítse / cserélje ki a másolatot a teljes gyűjtemény.
200 (OK) vagy 204 (Nincs tartalom). 404 (Nem található), ha nincs például a megadott azonosító, vagy ha ez nem megfelelő (és ha az ügyfél nem szabad tudni a rendelkezésre álló ez esetben).
201 (létrehozva), a címe „Hely” kifejezés / ügyfelek /, ahol az ID - ID az új példány.
404 (Nem található), ha törölni szeretné a gyűjtemény teljes egészében, ami rendkívül kívánatos.
200 (OK) vagy 204 (Nincs tartalom). 404 (Nem található), ha nincs például a megadott azonosító, vagy ha ez nem megfelelő (és ha az ügyfél nem szabad tudni a rendelkezésre álló ez esetben).
A részletesebb tárgyalását az alap HTTP módszerek. A navigációs lapjain további információ a HTTP módszer érdekel.
A HTTP specifikáció, GET (valamint HEAD) kérelmek használata csak olvasni az adatokat, ezeket nem módosíthatja. Így a megállapodás betartását, azok biztonságosnak tekinthető. Azaz, fel lehet használni annak a veszélye nélkül adatváltozások, függetlenül attól, hogy, amennyiben az adatokat megkapta, vagy 10, vagy soha egyáltalán. A GET (valamint a fej) kérések idempotens (azonos), ami azt jelenti, egyre ideintichnyh adatok segítségével az egyik TER és ugyanazon lekérdezés (mint egy kezelés, és ismétlődő).
Ne használja a GET nem biztonságos műveletek az adatok, egy adott lekérdezés, akkor nem kell módosítani.
PUT eljárással tipikusan, hogy a frissítés a forrás. A kérelem szövege a PUT kérés küldése a meglévő forrás URI tartalmaznia kell a frissített adatokat az eredeti forrás (teljesen vagy csak frissített rész).
Ahhoz, hogy hozzon létre egy új erőforrás esetekben előnyös ispolzozvanie POST kérés. Ebben az esetben, amikor egy példány fog kapni a helyes identfikator forrás például a visszaadott adatok a példány.
A sikeres frissítés elvégzésével PUT kérés kódot ad vissza 200 (vagy 204, vagy ha a tartalmak testület nem továbbították). Ha fel létrehozásához használt egy példányát - általában visszatér egy HTTP 201 kód sikeres létrehozásához. Visszatérés adatok kérésére nem szükséges. Továbbá, nem feltétlenül visszatérni hivatkozás egy példányát az erőforrást `Location` cím annak a ténynek köszönhető, hogy az ügyfél, és így már a példányazonosító a forrást.
PUT művelet nem biztonságos, mivel a következménye annak végrehajtását módosítjuk (vagy létrehozása) erőforrás esetekben a szerver oldalon, de ez a módszer idempotens. Más szóval, a teremtés vagy erőforrás frissítés küldésével PUT kérés - erőforrás eltűnik, lesz található ugyanazon a helyen, ahol ez volt az első hívást, valamint ismételt végrehajtása ugyanazon PUT kérés nem változik az általános állapota a rendszer (kivéve az első alkalommal, de általában kihagyjuk venni)
POST kérés leggyakrabban használt új forrásokat. A gyakorlatban ez létrehozásához használt beágyazott forrásokat. Más szóval, amikor létrehoz egy új erőforrást, POST kérést küld a szülő erőforrás, és így a szolgáltatás felelősséget vállal, hogy létrejöjjön a kapcsolat létrehozásához források a szülő erőforrás rendelt új erőforrás-azonosító, stb
POST nem biztonságos, vagy idempotens kérelmet. Ezért javasoljuk, hogy használja a nem idempotens kéréseket. Ennek eredményeként az azonos POST kéréseket, feltéve nagyon hasonló, de nem ideintichnye adatokat.
Törlési kérés nagyon egyszerű megérteni. Ezt alkalmazzák, hogy eltávolítsuk a erőforrás által azonosított egy adott URI (ID).
A sikeres eltávolítása vissza 200 (OK) HTTP-kód, valamint a válasz törzse sodarzhaschim távoli erőforrás adatokat (negatív hatást gyakorol a gazdaságra, a forgalom) vagy a becsomagolt válaszok (lásd a „Return adatok”). Az is lehetséges, hogy egy HTTP-kód: 204 (Nincs tartalom) anélkül, hogy a válasz törzse.
A HTTP specifikáció, törlési kérés idempotens. Ha elvégzi a DELETE kérelmet az erőforrás, akkor el kell távolítani. Re-törlési kérés az erőforrás felett, mint: az erőforrás eltávolítjuk. Ha a törlési kérés használt csökkentse a számláló, DELETE kérés nem idempotens. Használja POST nem idempotens műveleteket.
Mindazonáltal van egy figyelmeztetés idempotencia DELETE. Re-törlési kérés az erőforrás gyakran kíséri 404 (nem található) HTTP-kód annak a ténynek köszönhető, hogy a forrás már eltávolították (például adatbázisból), és már nem elérhető. Ez teszi a DELETE művelet nem idempotens, de általánosan elfogadott kompromisszum az esetben, ha az erőforrás törölték az adatbázisból, és nem jelölt hagyni.