Вы здесь

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

4 сообщения / 0 новое
Последняя публикация
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. Теперь, спасибо вам, знаю и на мой взгляд больше, чем нужно. ;) Все-таки программирование и связь, это не для меня. Уж очень все запутанным кажется. А какую брошюру вы имели ввиду, интересно.

Реклама