...
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.
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://blog.hubspot.com/website/api-documentation
https://golemioapi.docs.apiary.io/#introduction/description