- Máme rozsáhlou API dokumentaci v Apiary (více souborů, rozdělená struktura). https://iucto.docs.apiary.io/
- Potřebujeme ji přepsat do OpenAPI, aby byla:
- validní a strojově čitelná,
- zachovávala stávající struktury (objekty, varianty, např. rozdíly mezi plátcem/neplátcem DPH),
- přehledná a vhodná pro další využití (např. v Make, Zapier apod.).
- Pečlivý převod z Apiary do OpenAPI (ne jen automatický konvertor, ale ruční kontrola a úpravy).
- Zachování kvality původní dokumentace (nesmí to být jen copy–paste endpointů).
- Výsledek v podobě validního OpenAPI souboru.
- Zkušenost s API dokumentací (Apiary, OpenAPI/Swagger).
- Znalost JSON/YAML a schopnost psát přehledné specifikace.
- Samostatnost a smysl pro detail.
- Jednorázový projekt (odhadem práce na pár dní).
- Odměna dle dohody (pár tisíc Kč, ideální brigáda s referencí).
- Možnost navazující spolupráce (úprava a implementace v Make).
