POST-meetod: toote lisamine

Saad teada, kuidas administraator lisab veebipoe kataloogi uue toote. Vaatame, kuidas toimib POST-päring, mida sisaldab päringu keha, mida tähendab edukat loomist näitav olekukood 201 ning kuidas uus toode andmebaasi salvestatakse.

Tootest

Alex, QA tiimijuht

Tere! Sa juba tead, kuidas ostja BB Foodi kataloogi laadib. Nüüd vaatame teist poolt: poel on admin-paneel, kus administraator lisab uusi tooteid. Siin klient enam ainult ei loe andmeid, vaid saadab neid serverisse.

Lühiviide

POST-meetod

POST /api/v1/products tähendab „loo“. Klient saadab andmed päringu kehas ja server salvestab need andmebaasi. Erinevalt GET-ist muudab POST serveris andmeid.

Päringu keha

Andmed, mida klient serverile saadab, enamasti JSON-vormingus. Uue toote puhul on need nimi ja hind.

Kood 201 Created

Edukas vastus loomisele. Vastuse kehas tagastab server tavaliselt loodud objekti, juba identifikaatoriga.

Identifikaator (id)

Klient seda ei saada: uue kirje unikaalse numbri annab andmebaas.

POST-i kordamine

Iga POST loob uue kirje, seega annab kordus samade andmetega duplikaadi. GET-il sellist probleemi pole: see ainult loeb andmeid.

Mida testija kontrollib

Vastuse kood on 201 (või see, milles meeskond kokku leppis). Vastuses on id ning nimi ja hind on samad, mis sisestati. Andmebaasi ilmus uus rida ja ostja näeb toodet kataloogis.