Phenquestions
Kāpēc LIETOT REST API:
Pieņemsim, ka tradicionālajās tīmekļa lietojumprogrammās vienkāršs PHP tīmekļa serveris,
- Jūs pieprasāt lapu (pieņemsim, ka php) no servera.
- Serveris atrod skripta failu (php), kas atbilst jūsu pieprasītajai lapai, un sāk to izpildīt. Skripts izveido savienojumu ar datu bāzi, meklē nepieciešamo informāciju, ievieto informāciju lapā labi formatētā veidā (sajaucot HTML + CSS + JavaScript ar datiem), kas apmeklētājam izskatās ļoti pievilcīgs.
- Tad serveris to nosūta atpakaļ apmeklētājam.
Šajā modelī visa apstrāde tiek veikta servera pusē. Tātad serverim ir jāpaveic vairāk darba. Šeit dati nav atdalīti no lapas, tie ir dziļi iegremdēti lapā.
Ja nākotnē vēlaties savā vietnē izveidot Android vai iOS lietotni vai darbvirsmas lietotni, jums būs jāpaveic daudz vairāk. Jums būs jāveido savienojums ar datu bāzi tieši no katras no šīm lietotnēm, kas, iespējams, nav ļoti droša. Izstrādes laiks palielināsies, un radīsies problēmas ar pārnesamību.
Pieņemsim, ka esat veiksmīgi izveidojis darbvirsmas, Android un iOS lietotnes savā vietnē. Lietotāja pilns vārds katrā no tiem tiek parādīts ar mazajiem burtiem. Tagad jūs vēlaties to parādīt ar lielajiem burtiem. Lai to izdarītu, izstrādātājiem ir atsevišķi jāpārveido jūsu lietotnes darbvirsmas, Android un iOS versija. Kas prasa daudz laika. Reālajā pasaulē viss nebūs tik vienkārši kā šis. Tātad, vienā lietotnes versijā (pieņemsim, ka darbvirsmas versija) atjaunināšanas procesā var būt nopietna kļūda. Tā labošana vēlāk prasītu vairāk laika. Vai jūs varat redzēt, kā palielinās izstrādes laiks? Arī šis risinājums nav pārnēsājams.
Programmā REST API jūs jautājat API serverim to, kas jums nepieciešams, un tas jums nosūta tikai nepieciešamo informāciju, serverī netiek veikta papildu formatēšana. Lieka apstrāde serverī nav nepieciešama. Tātad jūsu vietnes un lietotņu veiktspēja, protams, tiek uzlabota. Tos pašus datus varat izmantot arī savā vietnē, darbvirsmas lietotnē, Android un iOS lietotnēs. Serveros veiktās izmaiņas tiks atspoguļotas lietotnēs, kas izmanto API. Tiks samazināts arī lietotnes izstrādes laiks un izmaksas.
Kā darbojas REST API:
REST API ir galapunkti. Galapunkts ir nekas cits kā URL, bet labi formatēts un nozīmīgs. Tas izmanto vietējos HTTP pieprasījumus (piemēram, GŪT, POST, PUT, DZĒST utt.), lai izlemtu, kā rīkoties, piekļūstot katram galapunktam. Par šiem runāšu vēlāk.
REST API izvades formāts ir JSON, kas pazīstams arī kā JavaScript objektu apzīmējums.
A izejas piemērs GŪT pieprasījums REST API / users / id / 12 var izskatīties šādi:
"id": 12,
"name": "David Smith",
"vecums": 42,
"tālruņi": ["124-211-2341", "889-211-4545"],
"valsts": "ASV"
Kā redzat, es izdarīju a GŪT pieprasījums / users / id / 12 beigu punktu pateikt REST API, lai viņš man sniedz informāciju par lietotāju, kuram ir id 12. Es saņēmu tikai nepieciešamo informāciju, ne vairāk, ne mazāk.
Pieņemsim, ka vēlaties saņemt informāciju par pēdējiem 10 lietotājiem, kuri reģistrējās jūsu vietnē. Jūs varat darīt: GŪT pieprasījums / lietotāji / jaunākais / 10 galapunkts.
Jūs varat pievienot jaunus datus savā serverī, izmantojot arī REST API. Parasti HTTP POST pieprasījums tiek izmantots, lai lūgtu REST API pievienot jaunus datus API serverim.
Piemēram, jūs varat veikt a POST pieprasījums / lietotāji gala punkts ar jaunā lietotāja datiem, un tas tiks pievienots jūsu API servera datu bāzei. Varat arī konfigurēt API, lai atgrieztu pieprasījuma statusu.
"statusCode": 400,
"statusText": "Lietotājs veiksmīgi pievienots.",
"dati":
"id": 13,
"name": "Mary Smith",
"vecums": 35,
"tālruņi": ["124-211-2341", "889-211-4545"],
"valsts": "ASV"
Kā redzat, statusCode un statusText JSON objekta rekvizīts paziņo API klientam, ka lietotājs ir veiksmīgi pievienots. Pievienotos datus atgriež arī dati objekta JSON rekvizīts. Jūs varat konfigurēt savu API tieši tā, kā vēlaties.
Esošo ierakstu var atjaunināt arī no API servera datu bāzes. The PUT HTTP pieprasījums tiek izmantots API galapunktā, lai atjauninātu esošos datus jūsu API servera datu bāzē.
Piemēram, pieņemsim, ka vēlaties atjaunināt lietotāja tālruņa numuru ar ID 13. Jūs varat darīt a PUT pieprasījums par API galapunktu / user / id / 13.
"statusCode": 200,
"statusText": "Lietotājs ir atjaunināts.",
"old_data":
"id": 13,
"name": "Mary Smith",
"vecums": 35,
"tālruņi": ["124-211-2341", "889-211-4545"],
"valsts": "ASV"
,
"new_data":
"id": 13,
"name": "Mary Smith",
"vecums": 35,
"tālruņi": ["100-211-1111", "140-211-1145"],
"valsts": "ASV"
Kā redzat, atjaunināšanas darbība ir veiksmīga. Vecie un jaunie dati tiek atgriezti vecie_dati un jaunie_dati attiecīgi JSON objekta rekvizīts.
Varat arī izdzēst datus no API servera datu bāzes, izmantojot HTTP DZĒST pieprasījums par API galapunktu.
Piemēram, lai izdzēstu lietotāju ar ID 12, varat: DZĒST pieprasījums par API galapunktu / user / id / 12.
"statusCode": 150,
"statusText": "Lietotājs noņemts.",
"dati":
"id": 12,
"name": "David Smith",
"vecums": 42,
"tālruņi": ["124-211-2341", "889-211-4545"],
"valsts": "ASV"
Kā redzat, lietotājs tiek izdzēsts un izdzēstie lietotāja dati tiek atgriezti dati objekta JSON rekvizīts.
Esmu izskaidrojis standarta lietošanas veidu GŪT, POST, PUT un DZĒST HTTP pieprasījums API galapunktiem veikt CRUD (izveide, lasīšana, atjaunināšana un dzēšana) darbību, izmantojot REST API. Bet jūs varat konfigurēt savu API, lai veiktu noteiktas darbības pēc noteikta HTTP pieprasījuma. Šeit nekas nav labots. Piemēram, jūs varat atjaunināt API, izmantojot GŪT HTTP pieprasījums. Jums nav jāizmanto PUT. Tas ir atkarīgs no API dizainera.
Jūs izstrādājat arī API galapunktus. Nozīmīgu vārdu piešķiršana jūsu API galapunktiem padara jūsu REST API daudz vieglāk lietojamu.
REST API lietojumprogrammas:
API padara lietotņu izstrādi vieglāku un modulārāku. Ar REST API palīdzību jūs varat viegli pārvietot savu lietotni uz dažādām platformām.
Viss, kas jums jādara, ir noformēt un izstrādāt savas lietojumprogrammas REST API. Tad jūs varat izmantot savu REST API no savas vietnes, Android lietotnes, iOS lietotnes, Windows darbvirsmas lietotnes un Linux lietotnes utt. Tādējādi visas jūsu lietotnes dažādās platformās izmantos to pašu loģiku, un jūsu izstrādes laiks un izmaksas tiks samazinātas. Arī lietotnes būs vieglāk pārvaldīt. Arī mūsdienās REST API ātri tiek izmantotas vienas lapas tīmekļa lietojumprogrammās.
Esmu uzrakstījis rakstu par REST API rakstīšanu, izmantojot Python. Paldies, ka izlasījāt šo rakstu.
