A REST vagy a RESTful API-k manapság mindenhol megtalálhatók. Lehet, hogy akkor is használta, ha nem tudott róla semmit.  Ebben a cikkben a REST API-król fogok beszélni. Megbeszélem a működésüket, az alkalmazásukat és még sok minden mást. Kezdjük el.

Miért érdemes használni a REST API-t:

A hagyományos webalkalmazásokban mondjuk egy egyszerű PHP webszervert,

• Ön kér egy oldalt (tegyük fel php) a szerverről.
• A szerver megtalálja a szkriptfájlt (php) megfelel az Ön által kért oldalnak, és elkezdi végrehajtani. A szkript csatlakozik az adatbázishoz, megkeresi a szükséges információkat, szépen formázva helyezi el az információkat az oldalon (a HTML + CSS + JavaScript keverése az adatokkal), ami nagyon vonzónak tűnik a látogató számára.
• Ezután a szerver visszaküldi a látogatónak.

Ebben a modellben az összes feldolgozás a szerver oldalon történik. Tehát a szervernek több munkát kell végeznie. Itt az adatok nincsenek elkülönítve az oldaltól, hanem mélyen be vannak ágyazva az oldalba.

Ha a jövőben szeretne Android-alkalmazást, iOS-alkalmazást vagy Asztali alkalmazást készíteni a webhelyéről, akkor sokkal több munkát kell végeznie. Ezen alkalmazások mindegyikéből közvetlenül csatlakoznia kell az adatbázishoz, ami nem biztos, hogy túl biztonságos. A fejlesztési idő megnő, és a hordozhatóság problémái merülnek fel.

Tegyük fel, hogy sikeresen elkészítette webhelye asztali, androidos és iOS-alkalmazásait. A felhasználó teljes neve kisbetűvel jelenik meg mindegyikben. Most nagybetűvel szeretné megmutatni. Nos, a fejlesztőknek ennek érdekében külön módosítaniuk kell az alkalmazás asztali, Android és iOS verzióját. Ami időigényes. A való világban a dolgok nem lesznek olyan egyszerűek, mint ez. Tehát az alkalmazás egyik verziójában (tegyük fel, hogy az Asztali verzió) komoly hiba lehet a frissítési folyamatban. Későbbi javítása több időt igényelne. Látja, hogyan növekszik a fejlesztési idő? Ez a megoldás sem hordozható.

A REST API-ban megkérdezi az API-kiszolgálót, amire szüksége van, és az csak a kért információkat küldi el Önnek, további formázás nem történik meg a kiszolgálón. Nincs szükség felesleges feldolgozásra a szerveren. Tehát a webhely és az alkalmazások teljesítménye természetesen javul. Ugyanezeket az adatokat felhasználhatja a webhelyén, az asztali alkalmazásban, az Android és az iOS alkalmazásokban is. A szervereken végrehajtott változtatások az API-t használó alkalmazásokban is megjelennek. Az alkalmazás fejlesztési ideje és költsége is csökken.

Hogyan működik a REST API:

A REST API-k végpontokkal rendelkeznek. A végpont nem más, mint URL, de szépen formázott módon és értelmes. A natív HTTP kéréseket használja (például KAP, POST, PUT, TÖRÖL stb.), hogy eldöntse, mit kell tennie az egyes végpontok elérésekor. Ezekről később beszélek.

A REST API kimeneti formátuma JSON, más néven JavaScript Object Notation.

Példa az a kimenetére KAP kérés a REST API-hoz / users / id / 12 a végpont a következőképpen nézhet ki:

"id": 12,
"name": "David Smith",
"kor": 42,
"telefonok": ["124-211-2341", "889-211-4545"],
"ország": "USA"

Mint láthatja, megtettem a KAP kérés / users / id / 12 végpont, hogy mondja meg a REST API-nak, hogy adjon információt arról a felhasználóról, aki rendelkezik az id 12. Csak azt az információt kaptam, amit kértem, se többet, se kevesebbet.

Tegyük fel, hogy információt szeretne kérni az utolsó 10 felhasználóról, aki feliratkozott a webhelyére. Megteheti a KAP kérés / users / latest / 10 végpont.

A REST API segítségével új adatokat is felvehet a szerverre. Általában a HTTP POST A kéréssel arra kérjük a REST API-t, hogy adjon hozzá új adatokat az API-kiszolgálóhoz.

Például megteheti a POST kérés / felhasználók végpont az új felhasználó adataival, és az hozzá lesz adva az API-kiszolgáló adatbázisához. Az API-t úgy is beállíthatja, hogy visszaadja a kérés állapotát.

"statusCode": 400,
"statusText": "A felhasználó sikeresen hozzáadva.",
"adatok":
"id": 13,
"név": "Mary Smith",
"életkor": 35,
"telefonok": ["124-211-2341", "889-211-4545"],
"ország": "USA"

Mint láthatja, a statusCode és statusText A JSON objektum tulajdonság értesíti az API klienst, hogy a felhasználót sikeresen hozzáadták. A hozzáadott adatokat a adat a JSON objektum tulajdonságát. Az API-t a kívánt módon konfigurálhatja.

Frissíthet egy meglévő rekordot az API-kiszolgáló adatbázisából is. A PUT A HTTP-kérést egy API-végponton használják az API-kiszolgáló adatbázisában lévő meglévő adatok frissítésére.

Tegyük fel például, hogy frissíteni szeretné a felhasználó telefonszámát a 13 azonosítóval. Megteheti a PUT kérés az API-végpontról / user / id / 13.

"statusCode": 200,
"statusText": "Felhasználó frissítve.",
"old_data":
"id": 13,
"név": "Mary Smith",
"életkor": 35,
"telefonok": ["124-211-2341", "889-211-4545"],
"ország": "USA"
,
"new_data":
"id": 13,
"név": "Mary Smith",
"életkor": 35,
"telefonok": ["100-211-1111", "140-211-1145"],
"ország": "USA"

Mint látható, a frissítési művelet sikeres. A régi és az új adatokat a rendszer visszaadja old_adatok és új_adatok a JSON objektum tulajdonságát.

Az API-kiszolgáló adatbázisából is törölhet adatokat a HTTP-vel TÖRÖL kérés az API-végpontról.

Például a 12 azonosítójú felhasználó törléséhez megteheti a TÖRÖL kérés az API-végpontról / user / id / 12.

"statusCode": 150,
"statusText": "Felhasználó eltávolítva.",
"adatok":
"id": 12,
"name": "David Smith",
"kor": 42,
"telefonok": ["124-211-2341", "889-211-4545"],
"ország": "USA"

Amint láthatja, a felhasználó törlődik, és a törölt felhasználói adatok a adat a JSON objektum tulajdonságát.

Elmagyaráztam a KAP, POST, PUT és TÖRÖL HTTP-kérés az API-végpontokon a CRUD (Létrehozás, Olvasás, Frissítés és Törlés) művelet elvégzéséhez a REST API használatával. De konfigurálhatja az API-t bizonyos dolgok végrehajtására bizonyos HTTP kérések esetén. Itt semmi nincs rögzítve. Például frissítheti az API-t a KAP HTTP kérés. Nem kell használni PUT. Az API tervezőjén múlik.

Megtervezi az API végpontokat is. Ha értelmes neveket ad az API-végpontoknak, akkor sokkal könnyebben használható a REST API.

A REST API alkalmazásai:

Az API-k megkönnyítik és modulárisan fejlesztik az alkalmazás fejlesztését. A REST API segítségével könnyedén portolhatja alkalmazását különböző platformokra.

Csak annyit kell tennie, hogy megtervezi és kifejleszti az alkalmazás REST API-ját. Ezután használhatja a REST API-t a webhelyéről, az Android alkalmazásból, az iOS alkalmazásból, a Windows asztali alkalmazásból és a Linux alkalmazásból stb. Így a különböző platformokon található összes alkalmazás ugyanazt a logikát fogja használni, és a fejlesztési idő és költség csökken. Az alkalmazásokat is könnyebb kezelni. A REST API-kat manapság is gyorsan használják az egyoldalas webalkalmazásokban.

Írtam egy cikket a REST API-k Python használatával történő írásáról.  Köszönjük, hogy elolvasta ezt a cikket.