Kapitola 3

Šepoty ve tmě

═══════════════════════════════════════════════════════════════════ KAPITOLA 3: ŠEPOTY VE TMĚ ═══════════════════════════════════════════════════════════════════ Výslechy odhalily fragmenty - podivné rozpočtové položky, poškozené záznamy, řeči o "unikajících cookies." Nyní musíš aktivně vyšetřovat: předložit důkazy k analýze, podat hlášení, prohledat archivy. Královská laboratoř čeká na tvé nálezy. Stará Margot v archivech mluví v hádankách, ale její záznamy nelžou. Čas POSTnout své objevy a zjistit, co tma odhalí. ═══════════════════════════════════════════════════════════════════

Naučíš se: POST těla, JSON, Form data, Nahrávání souborů, PUT, DELETE, Async polling

Vlož svůj token pro sledování postupu:

curl -X POST https://httpqueen.net/investigators/register -H "Content-Type: application/json" -d '{"name": "YourName"}'

3-1 Předložení důkazů

Nesplněno

Zadání

Královská laboratoř může analyzovat fyzické důkazy. Předlož fragment roztrženého pergamenu k analýze.

Příkaz

curl -X POST https://httpqueen.net/laboratory/submit \
  -H "Authorization: Bearer TVUJ-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type": "parchment_fragment", "description": "roztržená poznámka z místa činu"}'

Co se naučíš

POST s JSON tělem je standardní způsob odesílání strukturovaných dat. Content-Type říká serveru, jak parsovat tělo.

Stará Margot šeptem: "POSTni důkaz s JSON popisujícím, co předkládáš."

3-2 Podání hlášení

Nesplněno

Zadání

Seržant Timothy potřebuje tvé denní hlášení ve starém formátu - form data, ne JSON. Palácová byrokracie to vyžaduje.

Příkaz

curl -X POST https://httpqueen.net/reports/daily \
  -H "Authorization: Bearer TVUJ-TOKEN" \
  -d "day=3&suspect=redirect&finding=vyhybavý"

Co se naučíš

application/x-www-form-urlencoded je nejstarší POST formát, jako HTML formuláře. Data jsou páry klíč=hodnota spojené &.

Stará Margot šeptem: "Použij form-urlencoded formát: -d 'klíč=hodnota&klíč2=hodnota2'"

3-3 Dotaz do archivu

Nesplněno

Zadání

Stará Margot střeží archivy. Hledej záznamy zmiňující 'cookies' - roztržený pergamen je zmiňoval.

Příkaz

curl --json '{"query": "cookies", "date_range": "recent"}' \
  https://httpqueen.net/archives/search \
  -H "Authorization: Bearer TVUJ-TOKEN"

Co se naučíš

Přepínač --json kombinuje -H 'Content-Type: application/json' -H 'Accept: application/json' -d dohromady. Pohodlí!

Stará Margot šeptem: "POSTni vyhledávací dotaz. Přepínač --json je zkratka pro Content-Type: application/json."

3-4 Výsledky z laboratoře

Nesplněno

Zadání

Laboratorní analýza by měla být dokončena. Zkontroluj výsledky předloženého důkazu.

Příkaz

curl https://httpqueen.net/laboratory/results \
  -H "Authorization: Bearer TVUJ-TOKEN"

Co se naučíš

Async API: POST spustí úlohu, vrátí ID. GET s tím ID získá výsledky. Polling kontroluje, zda je hotovo.

Stará Margot šeptem: "GETni endpoint s výsledky. Některé operace jsou asynchronní - POSTneš pro spuštění, GETneš pro kontrolu výsledků."

3-5 Objev

Nesplněno

Zadání

Předlož své úplné nálezy: analýzu inkoustu, rozpočtové nesrovnalosti, spojení s cookies. Sestav případ.

Příkaz

curl -X POST https://httpqueen.net/evidence/compile \
  -H "Authorization: Bearer TVUJ-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"findings": [{"type": "ink_analysis", "points_to": "security_office"}, {"type": "budget", "item": "session_tokens"}, {"type": "access_control", "controller": "duchess_athena"}]}'

Co se naučíš

Komplexní POSTy nesou více souvisejících datových bodů. Strukturuj JSON tak, aby reprezentoval vztahy mezi důkazy.

Stará Margot šeptem: "Komplexní POST s více kusy důkazů. Zahrň vše, co jsi zjistil."

3-6 Nahrání náčrtu

Nesplněno

Zadání

Svědek viděl někoho poblíž Pembertonových komnat. Dvorní umělec udělal náčrt. Nahraj ho do archivu důkazů pro porovnání tváří.

Příkaz

curl -X POST https://httpqueen.net/evidence/upload \
  -H "Authorization: Bearer TVUJ-TOKEN" \
  -F "[email protected]" \
  -F "description=Náčrt svědka z noci vraždy" \
  -F "witness=stráž_komnat"

Co se naučíš

Přepínač -F odesílá multipart/form-data, používaný pro nahrávání souborů. Na rozdíl od -d (form-urlencoded) může -F přenášet binární soubory. Použij -F 'pole=@názevsouboru' pro nahrání souboru.

Stará Margot šeptem: "Použij -F pro nahrávání souborů. Toto odesílá multipart/form-data, formát pro nahrávání souborů přes HTTP."

3-7 Oprava hlášení

Nesplněno

Zadání

Tvé dřívější denní hlášení mělo chybu - napsal jsi 'redirect' ale myslel jsi 'authenticate' jako podezřelého. Aktualizuj existující hlášení.

Příkaz

curl -X PUT https://httpqueen.net/reports/daily/3 \
  -H "Authorization: Bearer TVUJ-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"day": 3, "suspect": "authenticate", "finding": "ví_příliš_mnoho", "status": "opraveno"}'

Co se naučíš

PUT nahradí celý zdroj na URL. Je idempotentní - volání vícekrát má stejný efekt jako jednou. Použij PUT, když máš kompletní aktualizovaný zdroj.

Stará Margot šeptem: "Použij PUT pro aktualizaci existujícího zdroje. Na rozdíl od POST (vytvořit nový), PUT nahradí zdroj na konkrétní URL."

3-8 Odstranění falešné stopy

Nesplněno

Zadání

Dřívější důkazy naznačovaly, že zahradník byl zapojen. Byla to slepá ulička - odstraň tuto falešnou stopu ze seznamu aktivních důkazů, aby vyšetřování zůstalo soustředěné.

Příkaz

curl -X DELETE https://httpqueen.net/evidence/false-leads/zahradnik \
  -H "Authorization: Bearer TVUJ-TOKEN"

Co se naučíš

DELETE odstraňuje zdroj. Servery typicky odpovídají 200 (s tělem), 204 (bez těla), nebo 202 (přijato k odstranění). Stejně jako PUT je DELETE idempotentní.

Stará Margot šeptem: "Použij DELETE pro odstranění zdroje. Server potvrdí odstranění s 200 nebo 204."