нужны указатели, чтобы начать работу с API

Question

Большинство приложений в наши дни предоставляют API ... будь то твиттер, gmail, fb и другие миллионы.

Я понимаю, что API-дизайн не может быть объяснен только в ответ, но мне хотелось бы получить некоторые рекомендации о том, как начать работу с API-дизайном. Может быть, какой-то учебник/книга, которая делает приложение, и содержит некоторые главы о том, как продвигать API для этого. Я в основном разработчик java (обучение Groovy), но я открыт и для других языков, если вам легче начать работу с дизайном API на этом языке.

Как примечание, прежде чем мне было интересно узнать о различии между API и веб-сервисом. Но теперь, насколько я понимаю, webservice - это всего лишь форма API

Answer 1

У меня нет больших ресурсов, однако я хочу подчеркнуть, насколько корректен этот API - интерфейс прикладного программирования, и это просто механизм того, как вы выставляйте свою заявку другим потребителям. Будь то из сценария, веб-сервиса (мыло или отдых), Win32 API Style Calls ....

Около 10 лет назад, когда мы говорили API API, казалось, что все чувствовали, что все API-интерфейсы похожи на Win32, и все. Один из наиболее интересных, над которым я работал, - это API с системой управления на основе PICK. В этом случае мы написали XML-процессор в PICK и были очисткой экрана XML взад и вперед по сеансу telnet.

Первое, что вам нужно решить, - как вы хотите разоблачить свои данные. Вы собираетесь разоблачить через Интернет? Или ваше приложение является настольным приложением? Как я бы структурировал API для межкоммутаторной связи, как правило, отличается, если API работает в одном процессе или даже на одной машине.

Я бы также начал с написания тестового клиента. Вам нужно понять, как будет использоваться ваш API, и попытаться сделать его максимально простым. Если вы погружаетесь прямо в реализацию, вы можете потерять перспективу и сделать предположения, которые может быть у клиента-разработчика.