POST

A POST módszer arra kéri a cél erőforrást, hogy a kérelemben szereplő reprezentációt az erőforrás saját szemantikája szerint dolgozza fel. A POST például (többek között) a következő funkciókhoz használatos:

• Adatblokk, például egy HTML űrlapba beírt mezők átadása egy adatfeldolgozó folyamatnak;
• Üzenet küldése egy hirdetőtáblára, hírcsoportba, levelezőlistára, blogba vagy hasonló cikkcsoportba;
• Új erőforrás létrehozása, amelyet a kiindulási kiszolgálónak még azonosítania kell; és
• Adatok hozzáadása egy erőforrás meglévő reprezentációjához (reprezentációihoz).

A származási kiszolgáló a POST-kérelem feldolgozásának eredményétől függően a megfelelő állapotkód kiválasztásával jelzi a válasz szemantikáját; a POST-ra adott válaszban az ebben a specifikációban meghatározott állapotkódok szinte mindegyike érkezhet (a kivételek a 206 (Részleges tartalom), 304 (Nem módosítva) és 416 (Tartomány nem kielégíthető)).

Ha a POST-kérelem sikeres feldolgozásának eredményeként egy vagy több erőforrás jött létre a kiindulási kiszolgálón, a kiindulási kiszolgálónak KELL egy 201 (Created) választ küldenie, amely egy Location fejlécmezőt tartalmaz, amely a létrehozott elsődleges erőforrás azonosítóját adja meg (7. szakasz.1.2), valamint egy olyan reprezentációt, amely leírja a kérés állapotát, miközben az új erőforrás(ok)ra hivatkozik.

A POST-kérésekre adott válaszok csak akkor gyorsítótárba helyezhetők, ha explicit frissességi információt tartalmaznak (lásd az [RFC7234] 4.2.1. szakaszát). A POST gyorsítótárazást azonban nem valósítják meg széles körben. Azokban az esetekben, amikor a kiindulási kiszolgáló azt szeretné, hogy az ügyfél képes legyen a POST eredményét úgy gyorsítótárba helyezni, hogy azt egy későbbi GET újra felhasználhassa, a kiindulási kiszolgáló MAGYON egy 200 (OK) választ küld, amely tartalmazza az eredményt és egy Content-Location fejlécmezőt, amelynek értéke megegyezik a POST tényleges kérési URI-jával (3. szakasz.1.4.2.).

Ha a POST feldolgozásának eredménye egy meglévő erőforrás reprezentációjával lenne egyenértékű, a kiindulási kiszolgáló MAGYON átirányíthatja a felhasználói ügynököt erre az erőforrásra egy 303 (Lásd más) válasz elküldésével, a Location mezőben a meglévő erőforrás azonosítójával. Ennek az az előnye, hogy a felhasználó ügynök számára egy erőforrás-azonosítót biztosít, és a reprezentációt egy olyan módszerrel továbbítja, amely alkalmasabb a megosztott gyorsítótárazásra, bár ez egy további kérés árán történik, ha a felhasználó ügynök még nem tárolta a reprezentációt.