ТЛ; ДР верзија

У једном од претходних постова, укратко смо разговарали о томе како је користити ГитХуб АПИ в3. Ова верзија је дизајнирана за међусобно повезивање као и било који други РЕСТ АПИ. Постоје крајње тачке за сваки ресурс којем требате приступити и / или изменити га. Постоје крајње тачке за сваког корисника, сваку организацију, свако спремиште и тако даље. На пример, сваки корисник има своју АПИ крајњу тачку на хттпс: // апи.гитхуб.цом / усерс / можете покушати да замените своје корисничко име уместо и унесите УРЛ у прегледач да бисте видели са чиме АПИ одговара.

ГитХуб АПИ в4, с друге стране, користи ГрапхКЛ где КЛ представља Куери Лангуаге. ГрапхКЛ је нови начин дизајнирања ваших АПИ-ја. Баш као што постоји много веб услуга које се нуде као РЕСТ АПИ-ји, не само оне које нуди ГитХуб, тако постоји много веб услуга које вам омогућавају да са њима повежете путем ГрапхКЛ.

Најјача разлика коју ћете приметити између ГрапхКЛ-а и РЕСТ АПИ-ја је та што ГрапхКЛ може радити на једној АПИ-јевој крајњој тачки. У случају ГитХуб АПИ в4, ова крајња тачка је хттпс: // апи.гитхуб.цом / грапхкл и то је то. Не морате да бринете о додавању дугих низова на крају основног УРИ-ја или давању додатних параметара низа упита за додатне информације. Једноставно шаљете аргумент попут ЈСОН-а овом АПИ-ју, тражећи само оно што вам треба, и добићете ЈСОН корисни терет са потпуно истим информацијама које сте тражили. Не морате да се бавите филтрирањем нежељених информација или патите од режијских трошкова због великих одговора.

Шта је РЕСТ АПИ?

Па, РЕСТ је скраћеница за Репрезентативни државни пренос, а АПИ скраћеница од Апплицатион Программинг Интерфаце (Интерфејс програмског програмирања). РЕСТ АПИ или „РЕСТфул“ АПИ постао је главна филозофија дизајна иза већине модерних клијент-сервер апликација. Идеја произлази из потребе за одвајањем различитих компоненти апликације попут корисничког интерфејса на страни клијента и логике на страни сервера.

Тако да је сесија између клијента и сервера обично без држављанства. Када се веб страница и повезане скрипте учитају, можете наставити да комуницирате с њима и када извршите неку радњу (попут притиска дугмета за слање), онда се шаље захтев за слање заједно са свим контекстуалним информацијама које су веб серверу потребне за обраду тог захтева ( попут корисничког имена, токена итд.). Апликација прелази из једног стања у друго, али без сталне потребе за везом између клијента и сервера.

РЕСТ дефинише скуп ограничења између клијента и сервера, а комуникација се може догодити само под тим ограничењима. На пример, РЕСТ преко ХТТП-а обично користи модел ЦРУД, што је скраћеница за Стварање, читање, ажурирање и брисање, а ХТТП методе попут ПОСТ, ГЕТ, ПУТ и ДЕЛЕТЕ помажу вам да сами извршите те операције и те операције. Старе технике упада као што су СКЛ ињекције нису могућност са нечим попут чврсто написаног РЕСТ АПИ-ја (иако РЕСТ није сигурносна панацеја).

Такође доста помаже програмерима корисничког интерфејса! Будући да све што примите од ХТТП захтева типично је ток текста (понекад форматиран као ЈСОН), лако можете применити веб страницу за прегледаче или апликацију (на вашем жељеном језику), без бриге о архитектури на страни сервера. Прочитали сте АПИ документацију за услуге попут Реддит-а, Твиттер-а или Фацебоок-а и можете писати екстензије за њих или независне клијенте на језику по вашем избору, јер вам је загарантовано да ће понашање АПИ-ја и даље бити исто.

Супротно томе, сервера не занима да ли је фронт-енд написан у Го, Руби или Питхон. Било да се ради о прегледачу, апликацији или ЦЛИ-у. Само „види“ захтев и одговара на одговарајући начин.

Шта је ГрапхКЛ?

Као и било шта у свету рачунара, РЕСТ АПИ-ји су постали већи и сложенији, а истовремено су људи желели да их имплементирају и троше на бржи и једноставнији начин. Због тога је Фацебоок дошао на идеју ГрапхКЛ-а и касније је отворио. КЛ у ГрапхКЛ-у је скраћеница од Куери Лангуаге.

ГрапхКЛ омогућава клијентима да дају врло специфичне АПИ захтеве, уместо да упућују круте АПИ позиве са унапред дефинисаним параметрима и одговорима. Много је једноставније јер сервер тада одговара тачно подацима које сте тражили, без ичега вишка.

Погледајте овај РЕСТ захтев и његов одговарајући одговор. Овај захтев је намењен само јавној биографији корисника.