TL; DR verzió

Az egyik korábbi bejegyzésben röviden megvitattuk, milyen a GitHub API v3 használata. Ezt a verziót úgy tervezték, hogy bármilyen más REST API-hoz hasonlóan interfész legyen. Minden erőforráshoz vannak végpontok, amelyekhez hozzáférni és / vagy módosítani kell. Minden felhasználónak, szervezetnek, minden adattárnak és így tovább vannak végpontjai. Például minden felhasználó API-végpontja a https: // api címen található.github.com / users / megpróbálhatja helyettesíteni a felhasználónevét a helyett és írja be az URL-t egy böngészőbe, hogy lássa, mire válaszol az API.

A GitHub API v4 viszont a GraphQL-t használja, ahol a QL jelentése Query Language. A GraphQL az API-k tervezésének új módja. Csakúgy, mint sok REST API-ként kínált webszolgáltatást, nem csak a GitHub által kínáltakat, sok olyan webszolgáltatás is létezik, amelyek lehetővé teszik, hogy a GraphQL-en keresztül kapcsolódjon velük.

A legnagyobb különbség, amelyet észrevesz a GraphQL és a REST API között, az, hogy a GraphQL egyetlen API-végpontot képes kezelni. A GitHub API v4 esetében ez a végpont a https: // api.github.com / graphql és ennyi. Nem kell aggódnia a hosszú karakterláncok csatolásával a gyökér URI végén, vagy további információkért meg kell adnia egy lekérdezési karakterlánc-paramétert. Egyszerűen elküld egy JSON-szerű argumentumot ennek az API-nak, és csak a szükséges dolgokat kéri, és egy JSON hasznos terhet kap vissza pontosan ugyanazokkal az információkkal, amelyeket kért. Nem kell foglalkoznia a nemkívánatos információk kiszűrésével, vagy a nagy válaszok miatt teljesítmény-rezsi miatt kell szenvednie.

Mi a REST API?

Nos, a REST a reprezentatív állapotátvitel, az API pedig az alkalmazásprogramozási felület. A REST API vagy egy „RESTful” API vált a legtöbb modern kliens-szerver alkalmazás mögött álló tervezési filozófiává. Az ötlet abból adódik, hogy el kell különíteni az alkalmazás különböző összetevőit, például az ügyféloldali felhasználói felületet és a szerveroldali logikát.

Tehát az ügyfél és a szerver közötti munkamenet általában hontalan. Miután a weboldal és a kapcsolódó szkriptek betöltődtek, folytathatja a műveletet velük, és amikor végrehajt egy műveletet (például megnyom egy küldési gombot), akkor küld egy küldési kérelmet az összes kontextusinformációval együtt, amelyre a webszervernek szüksége van a kérés feldolgozásához ( például felhasználónév, tokenek stb.). Az alkalmazás áttér az egyik állapotról a másikra, de nem szükséges állandó kapcsolat az ügyfél és a kiszolgáló között.

A REST korlátozások halmazát határozza meg az ügyfél és a kiszolgáló között, és a kommunikáció csak ezeken a korlátozásokon keresztül valósulhat meg. Például a REST HTTP felett általában a CRUD modellt használja, amely a Létrehozás, Olvasás, Frissítés és Törlés rövidítéseket jelenti, és az olyan HTTP módszerek, mint a POST, GET, PUT és DELETE, segítenek ezeknek a műveleteknek és ezeknek a műveleteknek a végrehajtásában. A régi behatolási technikák, például az SQL injekciók, nem jelentenek lehetőséget a szorosan megírt REST API-val (bár a REST nem biztonsági csodaszer).

A felhasználói felület fejlesztőinek is nagyon sokat segít! Mivel csak egy HTTP-kérésből érkezik, tipikus szövegfolyam (néha JSON formátumban van), könnyen megvalósíthat egy weboldalt a böngészőkhöz vagy egy alkalmazást (a kívánt nyelven), anélkül, hogy aggódna a szerveroldali architektúra miatt. Olvassa el az olyan szolgáltatások API-dokumentációját, mint a Reddit, a Twitter vagy a Facebook, és írhat bővítményeket nekik vagy külső ügyfeleknek az Ön által választott nyelven, mivel garantáltan garantálja, hogy az API viselkedése továbbra is ugyanaz lesz.

Ezzel szemben a szervert nem érdekli, hogy a kezelőfelület Go, Ruby vagy Python nyelven íródott-e. Legyen szó böngészőről, alkalmazásról vagy CLI-ről. Csak „látja” a kérést és megfelelően reagál.

Mi a GraphQL?

Mint bármi más a számítógépek világában, a REST API-k is nagyobbak és összetettebbek lettek, ugyanakkor az emberek gyorsabb és egyszerűbb módon akarták őket bevezetni és fogyasztani. Ezért a Facebook felvetette a GraphQL ötletét, majd később megnyitotta. A GraphQL QL jelentése Query Language.

A GraphQL lehetővé teszi az ügyfelek számára, hogy nagyon specifikus API-kéréseket tegyenek, ahelyett, hogy merev API-hívásokat végeznének előre meghatározott paraméterekkel és válaszokkal. Sokkal egyszerűbb, mert a szerver ezután pontosan azokkal az adatokkal válaszol, amelyeket Ön kért, semmi fölösleggel.

Vessen egy pillantást erre a REST kérésre és a hozzá tartozó válaszra. Ez a kérés csak a felhasználó nyilvános életrajzát hivatott megtekinteni.