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:

  1. v cestě požadavku (uri query, metody GETPOSTPUT a DELETE)
  2. v obsahu zprávy (application/x-www-form-urlencoded, metody POST a PUT)
  3. 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ů:

  1. 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-.
  2. 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).