...
Používateľov je možné rozdeliť do 2 skupín. Prvou skupinou sú používatelia, ktorí chcú aktívne využívať API preto hľadajú príručky, príklady kódu. Ďalšou skupinou sú používatelia, ktorých zaujímajú ceny, obmedzenia, bezpečnosť. Sú to napr. produktoví manažéri.
Prístupové Url na dokumentáciu sú definované v metadátach API. (DCAT štandard)
Dokumentácia k API by mala preto obsahovať:
1, možnosti autentifikácie (ako získať API kľúč, ako používať OAuth 2.0)
...
8, aktuálnosť dokumentácie
Užitočné linky:
https://spec.openapis.org/oas/latest.html
https://blog.hubspot.com/website/api-documentation
https://golemioapi.docs.apiary.io/#introduction/description