Вы здесь

апи средство связи

h5mru55
апи средство связи

Это краткий перевод основных тезисов из брошюры «Web API Design. Crafting Interfaces that Developers Love» Брайана Маллоя из компании Apigee Labs. Apigee занимается разработкой различных API-сервисов и консталтингом. Кстати, среди клиентов этой компании засветились такие гиганты, как Best Buy, Cisco, Dell и Ebay.

В тексте попадаются комментарии переводчика, они выделены курсивом.

Собираем API-интерфейсы, которые понравятся другим разработчикам

Понятные URL для вызовов API

Первый принцип хорошего REST-дизайна — делать вещи понятно и просто. Начинать стоит с основных URL адресов для ваших вызовов API.

Ваши адреса вызовов должны быть понятными даже без документации. Для этого возьмите себе за правило описывать любую сущность с помощью коротких и ясных базовых URL адресов, содержащих максимум 2 параметра. Вот отличный пример:

/dogs для работы со списком собак

/dogs/12345 для работы с отдельной собакой

Существительные — это хорошо, а глаголы — плохо

SKR
Аватар пользователя SKR
Интересная информация. Хоть с

Интересная информация. Хоть с API я раньше не работал (было дело, но пользовался готовыми решениями), все ровно заинтересовало. Помимо, даже потянулся искать в сети мануалы и курить. Не знаю, пригодится ли в будущем, но почитать и познакомится поближе все таки решил.

tornado5
Аватар пользователя tornado5
Конечно, информация нужная.

Конечно, информация нужная. Но место ли ей на форуме? Возможно лучше было бы разместить её в блоге? Слишком крупный пост. который вряд ли подавляющее большинство форумчан сможет осилить, к тому же человек не разбирающегося в теме, все равно мало что поймет.

dollyleony32
Аватар пользователя dollyleony32
Ох сколько полезной

Ох сколько полезной информации. Разобраться бы теперь в ней. :) Я все думала, что обозначает слово API. Теперь, спасибо вам, знаю и на мой взгляд больше, чем нужно. ;) Все-таки программирование и связь, это не для меня. Уж очень все запутанным кажется. А какую брошюру вы имели ввиду, интересно.

Добавить комментарий

Full HTML

  • Допустимые HTML-теги: <a> <iframe><i> <tr> <em> <u> <br> <p> <ul> <ol> <li> <hr> <img><strong><b>
  • Адреса страниц и электронной почты автоматически преобразуются в ссылки.
  • Строки и абзацы переносятся автоматически.
  • External links will be redirected to a page that tells the user that they are about to leave the site.

Реклама