2.2 Parametry požadavků
Prakticky všechny funkce HTTP API mohou mít parametry. Parametry jsou pojmenované (switch, action, width, height, blob-image apod.) a jsou uvedeny v popisu příslušné funkce HTTP API. Parametry je možné v požadavku předávat třemi způsoby, které lze navzájem kombinovat:
- v cestě požadavku (uri query, metody GET, POST, PUT a DELETE)
- v obsahu zprávy (application/x-www-form-urlencoded, metody POST a PUT)
- v obsahu zprávy (multipart/form-data, metody POST a PUT) – RFC-1867
V případě, že jednotlivé metody předávání parametrů se navzájem kombinují, může nastat situace, kdy je parametr v požadavku uveden vícekrát. V tomto případě se dává přednost poslednímu výskytu parametru.
Parametry funkcí HTTP API jsou dvou typů:
- Parametr s jednoduchou hodnotou (switch, action apod.) může být předán pomocí všech třech výše uvedených metod. Tyto parametry nemají v názvu prefix blob-.
- Parametr obsahující velká data (např. konfiguraci, firmware, obrázky apod.). Tyto parametry začínají vždy prefixem blob- a lze je předávat pouze pomocí poslední metody (multipart/form-data).