Edit me

Вместо того, чтобы подходить к теме публикации в перспективе, начнем с некоторых конкретных примеров и перейдем к формулированию общих принципов. Ниже приведено более 100 открыто доступных API-интерфейсов REST, которые можно просмотреть для изучения шаблонов и примеров. Много других API можно найти, просматривая programmableweb.com.

100+ сайтов с API документацией

Просмотрим некоторые из этих сайтов документации, чтобы получить представление о разнообразии, а также попытаемся определить общие закономерности. В этот список включены не только впечатляющие документы, но и документы, которые выглядят так, как будто они были созданы стажером отдела, изучающим HTML. Разнообразие в списке демонстрирует множество опций для публикации инструментов и подходов, а также терминологию. Кажется, что почти каждый делает свои документы API по-своему, со своим брендингом, организацией и стилем.

  1. Shopgate API docs
  2. Google Places API docs
  3. Twitter API docs
  4. Flickr API docs
  5. Facebook’s Graph API docs
  6. Youtube API docs
  7. eBay API docs
  8. Amazon EC2 API docs
  9. Twilio API docs
  10. Last.fm API docs
  11. Bing Maps docs
  12. gpodder.net Web Service docs
  13. Google Cloud API docs
  14. Foursquare Places API docs
  15. Walmart API docs
  16. Dropbox API docs
  17. Splunk API docs
  18. Revit API docs
  19. Docusign API docs
  20. Geonames docs
  21. Adsense API docs
  22. Box API docs
  23. Amazon API docs
  24. Linkedin REST API docs
  25. Instagram API docs
  26. Zomato API docs
  27. Yahoo Social API docs
  28. Google Analytics Management API docs
  29. Yelp API docs
  30. Lyft API docs
  31. Facebook API docs
  32. Eventful API docs
  33. Concur API docs
  34. Paypal API docs
  35. Bitly API docs
  36. Callfire API docs
  37. Reddit API docs
  38. Netvibes API docs
  39. Rhapsody API docs
  40. Donors Choose docs
  41. Sendgrid API docs
  42. Mailchimp docs
  43. Basecamp API docs
  44. Smugmug API docs
  45. NYTimes API docs
  46. USPS API docs
  47. NWS API docs
  48. Evernote API docs
  49. Stripe API docs
  50. Parse API docs
  51. Opensecrets API docs
  52. CNN API docs
  53. CTA Train Tracker API
  54. Amazon API docs
  55. Revit API docs
  56. Citygrid API docs
  57. Mapbox API docs
  58. Groupon API docs
  59. AddThis Data API docs
  60. Yahoo Weather API docs
  61. Glassdoor Jobs API docs
  62. Crunchbase API docs
  63. Zendesk API docs
  64. Validic API docs
  65. Ninja Blocks API docs
  66. Pushover API docs
  67. https://pushover.net/api
  68. Pingdom API docs
  69. Daily Mile API docs
  70. Jive docs
  71. IBM Watson docs
  72. HipChat API docs
  73. Stores API docs
  74. Alchemy API docs
  75. Indivo API 2.0 docs
  76. Socrata API docs
  77. Github API docs
  78. Mailgun API docs
  79. RiotGames API docs
  80. Basecamp API docs
  81. ESPN API docs
  82. Snap API docs
  83. SwiftType API docs
  84. Snipcart API docs
  85. VHX API docs
  86. Polldaddy API docs
  87. Gumroad API docs
  88. Formstack API docs
  89. Livefyre API docs
  90. Salesforce Chatter RESt API docs
  91. The Movie Database API docs
  92. Free Music Archive API docs
  93. Context.io docs
  94. CouchDB docs
  95. Smart Home API (Amazon Alexa) docs
  96. Coinbase docs
  97. Shopify API docs
  98. Authorize.net docs
  99. Trip Advisor docs
  100. Pinterest docs
  101. Uber docs
  102. Spotify API
  103. Trello API
  104. Yext API
  105. Threat Stack API docs
  106. Strava API
  107. Plaid API
  108. Paymill API
  109. Rundown API
  110. Zype API

Programmableweb.com: каталог сайтов документации API в открытой сети

Каталог сайтов документации API можно найти на Programmableweb.com docs. Там можно просматривать тысячи документов по веб-API в различных категориях.

catalog

На сайте Programmableweb только открытые веб-API, то есть API-интерфейсы, к которым можно получить доступ в Интернете (что также означает, что обычно это REST API). Здесь нет бесчисленных внутренних API-интерфейсов с брандмауэром, которые многие компании предоставляют платным клиентам. Есть еще много тысяч частных API, о которых большинство из нас никогда не узнает.

👨‍💻 Практическое занятие: Поиск общих паттернов на сайтах API документации

В этом упражнении попробуем определить общие шаблоны на сайтах документации API.

  1. Открываем наш список сайтов
  2. Выбираем 4-5 разных API (любые из списка)
  3. Ищем шаблоны или общие черты этих сайтов API. Например, можно поискать любой из следующих шаблонов:
  • структура;
  • брендинг (между документами и маркетинговым сайтом);
  • объемные примеры кода и подсветка синтаксиса;
  • длинные страницы;
  • интерактивность API (например, как API Explorer);
  • инструментарий docs-as-code;
  1. Обратим внимание на отклонения от шаблонов, такие как следующие:
  • PDF;
  • перевод;
  • видео инструкции;
  • функции комментирования;
  • множественные выводы для роли
  1. Сделаем заметки по своим наблюдениям на будущее.

В следующем разделе мы рассмотрим Шаблоны проектирования сайтов API документации Из сделанных заметок посмотрим, соответствуют ли выделенные шаблоны тем, которые мы наблюдали на выбранных сайтах API.

🔙

Go next ➡