Návrh REST API

Question 1

Které tvrzení o idempotenci HTTP metod je správné?

Accepted Answer

PUT a DELETE jsou idempotentní — opakované volání má stejný výsledný stav jako jedno

Question 2

Klient chce jedním voláním změnit jediné pole zdroje. Kterou metodu zvolit a proč?

Accepted Answer

PATCH — je určená pro částečnou úpravu; PUT sémanticky nahrazuje celý zdroj, takže poslání jen jednoho pole může ostatní vynulovat

Question 3

Klient odešle POST, který na serveru vytvoří nový zdroj. Jaký stavový kód je nejsprávnější?

Accepted Answer

201 Created, ideálně s hlavičkou Location odkazující na nový zdroj

Question 4

Data v požadavku neprojdou validací (např. e-mail v chybném formátu). Jaký stavový kód vrací Laravel u JSON API standardně?

Accepted Answer

422 Unprocessable Entity

Question 5

Klient chce vytvořit zdroj, který ale koliduje se stávajícím stavem serveru — třeba e-mail už je zaregistrovaný nebo verze záznamu se rozešla. Který kód vyjadřuje tuto situaci nejpřesněji?

Accepted Answer

409 Conflict — požadavek je v rozporu s aktuálním stavem zdroje

Question 6

Přihlášený uživatel volá endpoint, ke kterému nemá oprávnění. Jaký kód je správný a jak se liší od 401?

Accepted Answer

403 Forbidden — identita je známá, ale chybí oprávnění; 401 Unauthorized naopak znamená chybějící nebo neplatnou autentizaci

Question 7

POST vytváří platbu. Kvůli timeoutu sítě klient požadavek zopakuje a hrozí, že vznikne platba dvakrát. Jak umožnit bezpečné opakování, aniž byste porušili sémantiku POST?

Accepted Answer

Zavést hlavičku Idempotency-Key — server podle ní rozpozná opakování a vrátí výsledek původního požadavku místo vytvoření duplicitní platby

Question 8

K čemu slouží Eloquent API Resources?

Accepted Answer

K transformaci modelů do konzistentní JSON struktury nezávislé na podobě databáze

Question 9

API Resource vrací 'author' => new AuthorResource($this->author). Ve výpisu 50 zdrojů se objeví N+1 na tabulce autorů. Jak to čistě vyřešit?

Accepted Answer

Vztah author eager-loadovat už v controlleru (with('author')) a v resource ho vydávat přes whenLoaded('author')

Question 10

Endpoint vrací desítky tisíc záznamů a je pomalý. Jaký návrhový krok je nejvhodnější?

Accepted Answer

Zavést stránkování přes paginate()

Question 11

Nekonečný feed s miliony záznamů, do kterého navíc průběžně přibývají nové položky. Proč je zde offsetové stránkování (paginate) problematické a co je vhodnější?

Accepted Answer

Vysoký offset je pomalý a vkládání nových řádků posouvá stránky, takže se záznamy duplikují nebo přeskakují; vhodnější je cursor (keyset) stránkování přes cursorPaginate()

Question 12

Které tvrzení o principu bezstavovosti (statelessness) v REST je správné?

Accepted Answer

Server nemá mezi požadavky držet klientský stav; každý požadavek nese vše potřebné včetně autentizace