Šiomis dienomis visur yra „REST“ arba „RESTful“ API. Gali būti, kad jį naudojote net nieko apie tai nežinodami.  Šiame straipsnyje kalbėsiu apie REST API. Aptarsiu, kaip jie veikia, jų taikymą ir daugelį kitų. Pradėkime.

Kodėl NAUDOTI REST API:

Tarkime, tradicinėse žiniatinklio programose paprastas PHP žiniatinklio serveris,

• Jūs prašote puslapio (tarkime php) iš serverio.
• Serveris randa scenarijaus failą (php), atitinkantį jūsų prašomą puslapį, ir pradeda jį vykdyti. Scenarijus prisijungia prie duomenų bazės, ieško reikiamos informacijos, gražiai suformatuoja informaciją (maišydamas HTML + CSS + JavaScript su duomenimis) į puslapį, kuris atrodo labai patrauklus lankytojui.
• Tada serveris siunčia jį atgal lankytojui.

Šiame modelyje visas apdorojimas atliekamas serverio pusėje. Taigi serveris turi atlikti daugiau darbų. Čia duomenys nėra atskirti nuo puslapio, jie yra giliai įdėti į puslapį.

Jei ateityje norėsite savo svetainėje sukurti „Android“ arba „iOS“ programą arba „Desktop“ programą, turėsite atlikti daug daugiau darbo. Turėsite prisijungti prie duomenų bazės tiesiogiai iš kiekvienos iš šių programų, o tai gali būti nelabai saugu. Kūrimo laikas pailgės ir kils perkėlimo problemų.

Tarkime, kad sėkmingai sukūrėte „Desktop“, „Android“ ir „iOS“ programas savo svetainėje. Vartotojo vardas ir pavardė kiekviename iš jų rodomi mažosiomis raidėmis. Dabar norėtumėte jį rodyti didžiosiomis raidėmis. Na, kūrėjai turi atskirai modifikuoti jūsų programos „Desktop“, „Android“ ir „iOS“ versijas, kad tai padarytų. Tai užima daug laiko. Realiame pasaulyje viskas nebus taip paprasta, kaip šis. Taigi, vienoje programos versijoje (tarkime, darbalaukio versija) gali būti rimta naujinimo proceso klaida. Vėliau ją išspręsti prireiktų daugiau laiko. Ar matote, kaip ilgėja kūrimo laikas? Šis sprendimas taip pat nėra nešiojamas.

REST API klausiate API serverio, ko jums reikia, ir jis jums atsiunčia tik jūsų prašomą informaciją, serveryje nėra atliekamas papildomas formatavimas. Nereikia nereikalingo apdorojimo serveryje. Taigi natūraliai pagerėja jūsų svetainės ir programų našumas. Be to, tuos pačius duomenis galite naudoti savo svetainėje, darbalaukio programoje, „Android“ ir „iOS“ programose. Serveriuose atlikti pakeitimai bus rodomi programose, kurios naudoja API. Taip pat sumažės programos kūrimo laikas ir išlaidos.

Kaip veikia REST API:

REST API turi galinių taškų. Galutinis taškas yra ne kas kita, kaip URL, bet gražiai suformatuotas ir prasmingas. Jis naudoja įprastas HTTP užklausas (pvz., GAUTI, POST, ĮDĖK, IŠTRINTI ir tt) nuspręsti, ką daryti, kai pasiekiate kiekvieną galinį tašką. Apie tai kalbėsiu vėliau.

REST API išvesties formatas yra JSON, taip pat žinomas kaip „JavaScript Object Notation“.

A išvesties pavyzdys GAUTI užklausa REST API / users / id / 12 galutinis rezultatas gali atrodyti taip:

„id“: 12,
„vardas“: „Davidas Smithas“,
„amžius“: 42,
"telefonai": ["124-211-2341", "889-211-4545"],
„šalis“: „JAV“

Kaip matote, aš padariau a GAUTI prašymas dėl / users / id / 12 galutinis taškas pasakyti REST API, kad ji pateiktų man informaciją apie vartotoją, kuris turi id 12. Gavau tik informaciją, kurios prašiau, nieko daugiau ir mažiau.

Tarkime, kad norite informacijos apie paskutinius 10 jūsų svetainėje užsiregistravusių vartotojų. Jūs galite padaryti GAUTI prašymas dėl / vartotojai / naujausias / 10 galutinis taškas.

Naujus duomenis savo serveryje galite pridėti naudodami REST API. Paprastai HTTP POST užklausa naudojama prašyti REST API pridėti naujus duomenis į API serverį.

Pavyzdžiui, galite padaryti POST prašymas dėl / vartotojai pabaigos taškas su naujo vartotojo duomenimis ir jis bus pridėtas prie jūsų API serverio duomenų bazės. Taip pat galite sukonfigūruoti API, kad būtų grąžinta užklausos būsena.

„statusCode“: 400,
"statusText": "Vartotojas sėkmingai pridėtas.",
„duomenys“:
„id“: 13,
„vardas“: „Mary Smith“,
„amžius“: 35,
"telefonai": ["124-211-2341", "889-211-4545"],
„šalis“: „JAV“

Kaip matote, statusCode ir statusText JSON objekto ypatybė praneša API klientui, kad vartotojas sėkmingai pridėtas. Pridėti duomenys taip pat grąžinami į duomenis JSON objekto nuosavybė. Galite sukonfigūruoti savo API taip, kaip norite.

Esamą įrašą galite atnaujinti ir iš API serverio duomenų bazės. The ĮDĖK HTTP užklausa naudojama API galiniame taške, norint atnaujinti esamus duomenis jūsų API serverio duomenų bazėje.

Pavyzdžiui, tarkime, kad norite atnaujinti vartotojo telefono numerį su ID 13. Jūs galite padaryti ĮDĖK užklausą dėl API pabaigos taško / user / id / 13.

„statusCode“: 200,
"statusText": "Vartotojas atnaujintas.",
"seni_duomenys":
„id“: 13,
„vardas“: „Mary Smith“,
„amžius“: 35,
"telefonai": ["124-211-2341", "889-211-4545"],
„šalis“: „JAV“
,
"nauji_duomenys":
„id“: 13,
„vardas“: „Mary Smith“,
„amžius“: 35,
"telefonai": ["100-211-1111", "140-211-1145"],
„šalis“: „JAV“

Kaip matote, atnaujinimo operacija yra sėkminga. Senieji duomenys ir nauji duomenys grąžinami į seni_duomenys ir nauji_duomenys atitinkamai JSON objekto ypatybė.

Taip pat galite ištrinti duomenis iš API serverio duomenų bazės naudodami HTTP IŠTRINTI užklausą dėl API pabaigos taško.

Pavyzdžiui, jei norite ištrinti naudotoją, kurio ID yra 12, galite padaryti IŠTRINTI užklausą dėl API pabaigos taško / user / id / 12.

„statusCode“: 150,
"statusText": "Vartotojas pašalintas.",
„duomenys“:
„id“: 12,
„vardas“: „Davidas Smithas“,
„amžius“: 42,
"telefonai": ["124-211-2341", "889-211-4545"],
„šalis“: „JAV“

Kaip matote, vartotojas ištrinamas, o ištrinti vartotojo duomenys grąžinami į duomenis JSON objekto nuosavybė.

Aš paaiškinau standartinį naudojimo būdą GAUTI, POST, ĮDĖK ir IŠTRINTI HTTP užklausa dėl API galinių taškų atlikti CRUD (kūrimas, skaitymas, atnaujinimas ir ištrynimas) operaciją naudojant REST API. Bet jūs galite sukonfigūruoti savo API atlikti tam tikrus veiksmus pagal tam tikrą HTTP užklausą. Čia nieko nėra sutvarkyta. Pavyzdžiui, galite atnaujinti API naudodami GAUTI HTTP užklausa. Jums nereikia naudoti ĮDĖK. Tai priklauso nuo API dizainerio.

Jūs taip pat kuriate API galinius taškus. Suteikdami prasmingų API galinių taškų pavadinimus, savo REST API galite naudoti daug lengviau.

„REST API“ programos:

API palengvina ir modulinį programų kūrimą. Naudodamiesi REST API, galite lengvai perkelti savo programą į skirtingas platformas.

Viskas, ką jums reikia padaryti, tai suprojektuoti ir sukurti savo programos REST API. Tada galite naudoti savo REST API iš savo svetainės, „Android“ programos, „iOS“ programos, „Windows“ darbalaukio programos ir „Linux“ programos ir kt. Tokiu būdu visos jūsų programos, esančios skirtingoje platformoje, naudos tą pačią logiką, o jūsų kūrimo laikas ir išlaidos bus sumažintos. Programas taip pat bus lengviau valdyti. „REST“ API greitai naudojamos ir vieno puslapio interneto programose.

Parašiau straipsnį apie REST API rašymą naudojant Python.  Dėkojame, kad perskaitėte šį straipsnį.