Mis on PUT?
PUT-meetodit kasutatakse serveris saadaoleva ressursi värskendamiseks. Tavaliselt asendab see kõik, mis on siht-URL-il, millegi muuga. Saate seda kasutada uue ressursi loomiseks või olemasoleva ülekirjutamiseks. PUT taotleb, et suletud üksus tuleb salvestada tarnitud taotletud URI (Uniform Resource Identifier) alla.
Selles õpetuses saate teada:
- Mis on PUT?
- Mis on POST?
- Näide PUT-st
- POSTi näide
- PUT ja POST erinevus
- API testimine PUT-päringutega
- API testimine POST-päringutega
- PUT-meetodi eelised
- POST-meetodi eelised
Mis on POST?
POST on meetod, mida toetavad HTTP ja
kujutab, et veebiserver aktsepteerib sõnumi põhiosa andmeid, mida nõutakse. POST-i kasutab World Wide Web sageli kasutaja loodud andmete veebiserverisse saatmiseks või faili üleslaadimisel.
PÕHISED VAHED:
- PUT-meetodit kutsutakse juhul, kui peate muutma ühte ressurssi, POST-meetodit aga siis, kui peate lisama ressursi.
- PUT-meetodi vastust saab vahemällu salvestada, kuid te ei saa PUT-meetodi vastuseid vahemällu salvestada.
- PUT-is saate kasutada UPDATE-päringut, POST-is saate kasutada loomist.
- PUT-meetodi puhul otsustab klient, milline URI-ressurss peaks olema, ja POST-meetodi korral otsustab server, milline URI-ressurss peaks olema.
- PUT töötab sama konkreetselt, POST aga abstraktsena.
- Kui saadate sama PUT-i taotlust mitu korda, jääb tulemus samaks, kuid kui saadate sama POST-i taotlust mitu korda, saate erinevaid tulemusi.
- PUT-meetod on idempotentne, samas kui POST-meetod pole idempotentne.
Näide PUT-st
Siin on PUT-meetodi veebiserveri näide:
HTTP PUT http://www.google.com/users/234
HTTP PUT http://www.google.com/users/234/accounts/567
Taotlus
PUT /new.html HTTP/1.1Host: example.comContent-type: text/htmlContent-length: 20New File
Vastused
Kui sihtressurss, millel on praegune esitus ja mida muudetakse lisatud kujutise olekuga, peaks server saatma kaks vastust. Esimene vastuskood on 200 (OK) ja teine vastuskood on 204 (sisu puudub).
Kui sihtressursil pole ühtegi kujutist, peaks server sellest kasutajat teavitama, saates vastuse 201 (loodud).
HTTP/1.1 201 CreatedContent-Location: /new.html
POSTi näide
Siin on POST-meetodi näide:
HTTP POST http://www.google.com/users
HTTP POST http://www.google.com/users/234/accounts
Vorm, mis kasutab vaikerakendust / x-www-vorm-urlenkodeeritud sisutüüpi:
POST /test HTTP/1.1Host: abc.exampleContent-Type: application/x-www-form-urlencodedContent-Length: 40field1=value1&field2=value2
PUT ja POST erinevus
Siin on oluline erinevus PUT ja POST meetodi vahel:
PANE | POSTITA |
See meetod on idempotentne. | See meetod pole idempotentne. |
PUT-meetod on kõne, kui peate muutma ühte ressurssi, mis on juba ressursside kogumise osa. | POST-meetod on kõne, kui peate ressursside kogumise alla lisama lapse ressursi. |
RFC-2616 kujutab, et meetod PUT saadab päringu suletud üksuse kohta, mis on salvestatud tarnitud päringu URI-sse. | See meetod nõuab, et server aktsepteeriks päringusse lisatud üksuse. |
PUT-meetodi süntaks on PUT / questions / {question-id} | POST-meetodi süntaks on POST / küsimused |
PUT-meetodi vastuse saab vahemällu salvestada. | PUT-meetodi vastuseid ei saa vahemällu salvestada. |
PUT / vi / juice / order / 1234 näitab, et värskendate ressurssi, mille tähistab tähis "1234". | POST / vi / juice / order näitab, et loote uut ressurssi ja tagastate ressursi kirjeldamiseks identifikaatori. |
Kui saadate sama taotluse mitu korda, jääb tulemus samaks. | Kui saadate sama POST-päringu rohkem kui ühe korra, saate erinevaid tulemusi. |
PUT töötab spetsiifiliselt. | POSTITÖÖ abstraktsena. |
PUT-is kasutame UPDATE päringut. | POST-is kasutame loomise päringut. |
PUT-meetodi puhul otsustab klient, milline URI-ressurss peaks olema. | POST-meetodi puhul otsustab server, milline URI-ressurss peaks olema. |
API testimine PUT-päringutega
API testimiseks PUT-päringutega toimige järgmiselt.

1. samm. Värskendage ressursse PUT-päringuga.
2. samm. Kasutage ressursi jaoks GET-meetodit. Kui PUT-i taotlus õnnestub, saate uusi andmeid. See meetod nurjub, kui päringus esitatud andmed on valed. Seetõttu ei värskenda see midagi.
API testimine POST-päringutega
API testimiseks POST-päringutega toimige järgmiselt.

1. samm. Looge ressurss POST-i päringu abil ja veenduge, et see tagastaks 200 olekukoodi.
2. samm. Tehke selle ressursi jaoks GET-päring ja salvestage andmed õiges vormingus.
Samm 3) Peate lisama testid, mis tagavad, et POST-taotlused ebaõnnestuvad valede andmetega.
PUT-meetodi eelised
Siin on PUT-meetodi kasutamise plussid / eelised:
- See aitab teil kaasasolevat üksust säilitada kaasasoleva URI all
- Kui tarnitud olem on juba olemas, saate värskendustoimingu sooritada või selle URI-ga luua.
- Ressurssi saate luua nii mitu korda kui soovite.
- Ressursi loomine PUT-meetodiga on väga lihtne.
- Te ei pea kontrollima, kas kasutaja on mitu korda nuppu Esita klõpsanud või mitte.
- See suudab tuvastada päringule lisatud üksuse.
POST-meetodi eelised
Siin on POST-meetodi kasutamise plussid / eelised:
- See meetod aitab teil määrata ressursi URI.
- Uue ressursi asukoha päise määramine on asukohapäise abil väga lihtne.
- Võite saata taotluse üksuse aktsepteerimiseks ressursi uue alluvana, mille URI tuvastab.
- Saate kasutajate loodud andmeid veebiserverisse saata.
- Ressursside hoidmiseks on väga kasulik, kui te ei tea URL-i.
- Kasutage POSTi, kui vajate serverit, mis kontrollib teie ressursside URL-ide loomist.
- POST on turvaline meetod, kuna selle taotlused ei jää brauseri ajalukku.
- Postituse abil saate hõlpsalt edastada suurt hulka andmeid.
- Andmeid saate hoida privaatsena.
- Seda meetodit saab kasutada nii binaar- kui ka ASCII-andmete saatmiseks.