Как се пише API

Пълен стак разработчик (Symfony, ъглови)

Членове липсват, със сигурност могат да пишат, но дали vryat-нещо-нова воля.

методи структура, която и как трябва да се върнат по-добре да обсъдят с разработчика IOS, които след това ще implemenit случай. Ако такава не е налице - максималната почивка на всички атомни операции, да опрости сътрудничество, мисля за себе си какви методи може да се наложи (представете си, че ти пиша API не е за някой, но, например, за страници, които всички vyderaet чрез AJAX).

За изпълнението - един банален сериализация вместо действителната оказване, вече няма разлики. Има един куп предварително създадени компоненти, които са много подходящи за сериализация насам-натам. Нейната такъв компонент също е писано достатъчно бързо.

Аз не съм виждал RESTfull API за тежки приложения tobish да, това е, че REST, но не напълно, така че не е необходимо да се притеснява. Обикновено достатъчно, за да се справят с някои основни функции и да получите / заявки POST. GET за проби - tobish данни в базата данни, когато заявката не се променя, освен че това, което има значение, и POST за създаване на записи в базата данни (за Фън Шуй функция резултат трябва да връща само на HTTP хедърите, които включват искане за стигнем до URI на новия обект, но на практика не изпотяване, и се връща на целия обект или част от него).

Разбира се, можете да използвате SOAP apishkami, но от опит мога да кажа, че това е валидно само в развитието на API oochen прост, и това не е от голямо полза. Ако даден клиент, разбира се, е приложение, написани на C # .NET - тогава не се колебайте да SOAP и само SOAP, вие в действителност различия в прилагането им (предлага се като част от времето), най-малко един клиент разработчик ще бъде много по-лесно. Но на IOS със сапун всички доста тъжен.

За да дам един пример за качество на страх, защото може да доведе до batthort в клон. )
Що се отнася до мен - има само един очевидни критерии за отличен API. То може да се формулира така: клиентът трябва да бъде абсолютно сигурен в това, което отговаря той получава от услугата още преди тя изпраща искането. Т.е. Никога не трябва да бъде ситуации, когато API връща неочаквано структура на данните, а не формата или странни грешки.

Връщайки се към Facebook - това не е pereuslozhnonnosti. Ето един пример за поведението на API, което аз паднах в ступор: ако поискате данни за дадено събитие обект, който е изтрит от страна на сървъра (е изтекъл, анулирана, и т.н.) - интуитивно очакваме нещо като масив от JSON код грешки или текст а ла "Целта е отстранен (не е намерен, отменя." Но Facebook ще се върне низа "Bad поискване", че не е достатъчно, че грешката не адекватно, така че все повече и за връщане формат - .. текст за такова "! дреболии "като непредвидими данни в рамките на свойствата на едни и същи видове обекти - не може да се спомене, че не прави Нико. да.)

Съгласен съм напълно, благодаря за подробния отговор. Мисля, че това е тривиална грешка FB разработчици.

Има една много добра единица за Node.js, което може да шпионира интересни идеи за прилагане RESTful API, - restify. Също така, аз съветвам да се търси как да се приложи API от Amazon. Имайте предвид, че това е изпълнението за корпоративна употреба, и реалния живот, можете да направите повече от прости решения, като например изхвърляне на нежелани HTTP заглавки.

Програмист, най-вече интернет

Доколкото ми е известно, най-популярният парадигма за създаване на API в момента е REST
От опит за създаване на API vskidku разбрах следното: 1. 2.

Според опита, бих казал, че има най-важно да се планира всичко правилно. Намерете проекта е възможно подобна на вашата целева която предоставя документацията на API, и го прочетете.