REST API kliens

Közzétéve 2015-05-09 14:00
írta Volenszki Sándor
Cimkék: Chrome API GET POST REST
Olvasva 3737 alkalommal

Aki dolgozott már API-val, az tudja, hogy egy új alkalmazás fejlesztésében, ami külső alkalmazással kommunikál (pl.:Google Map API, vagy a Számlázz.hu API-ja), az egyik mérföldkő, mikor szóra bírjuk az API-t.

Ha ezt saját alkalmazásból tesszük és nincs válaszunk az API-tól, vagy a válasz nem olyan, mint amire számítottunk, akkor megy a találgatás, hogy hol is van a hiba. Nagyon sok időt lehet megspórolni, ha egy általános API klienst használunk ahhoz, hogy kitapasztaljuk az API-nk viselkedést, majd a megszerzett tapasztalatok alapján lényegesen gyorsabban illeszthetjük az eljárást saját alkalmazásunkhoz.

A napokban egy ügyfelünkkel folytatott együttműködés irányította a figyelmemet az Advanced REST kliens Google Chrome bővítményre, ami gyakorlatilag egy egyszerű, univerzális API kliens.

https://chrome.google.com/webstore/detail/advanced-rest-client/hgmloofddffdnphfgcellkdfbfbjeloo

Chrome-ból betöltve a linket egy kattintással telepítheted is a böngésződbe, amit aztán az alkalmazások között megtalálsz.

Indítás után az alábbi képernyő fogad, amin a következő főbb egységek találhatóak:

  • URL: ide írjuk az API URL-jét, ahova a kéréseinket küldeni kell.

  • Attól függően, hogy milyen parancsost akarunk küldeni, válasszunk a GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS lehetőségekből (vagy használjuk az Other opciót). Én kiválasztottam a POST-ot, a képen ez látszik.

  • Headers: fejléc értékek definiálhatóak. Vannak esetek, amikor az API megköveteli, hogy például az API kulcsot ne csak az URL-be (vagy ott egyáltalán ne) kapja meg, hanem a kérés fejlécében is. Például a Partnerkövető Cégfigyelő szolgáltatása (https://partnerkoveto.hu) a PK-API-KEY header változóban is várja az API kulcsot és GET-ben is.

  • Payload: a kérésben küldött változók és értékeik (mint az űrlap mezők és azok tartalma egy átlagos űrlap beküldésnél).

  • A „Content-Type” akkor változtatandó, ha az beküldendő adatok között találhatóak speciálisak (pl.: fájl).

  • Send: a kérés küldése.

Nézzünk egy tesztet!

A Google GeoCode API-ját fogjuk tesztelni. Ez GET üzemmódban működik, ami annyit tesz, hogy az URL beviteli mezőbe állítjuk össze a teljes URL-t, amive meg kell hívni az API-t. (Ha nem megy a GET, POST közötti különbség, akkor valószínűleg eltévedtél, keress szakirodalmat).

A Google GeoCode API URL-je:

https://maps.googleapis.com/maps/api/geocode/json

Az API-nak küldött címsorban kell két GET paraméter:

  • a második pedig az API kulcsot, ami alapján a Google megmondja, hogy van-e jogunk lekérdezni, vagy sem (API kulcsot itt lehet igényelni: https://console.developers.google.com/). Ha nem gond, nem írom ki ide az én kulcsomat, kiikszeltem belőle a karaktereket! :)

Az összeállított Api URL-ünk így fog kinézni, ha a keresett cím Budapest Déli pályaudvar:

https://maps.googleapis.com/maps/api/geocode/json?address=Budapest+D%C3%A9li+p%C3%A1lyaudvar&key=XXxxXxXX_xXXxXxXXXxxX

Illesszük be az URL-t a REST API kliens URL mezőjébe, állítsuk a kérést GET-re és nyomjuk meg a Send gombot!

A végeredmény, ha mindent jól csináltunk, akkor JSON formátumú szöveg lesz, ami tartalmazza az összes adatot a keresett címre vonatkozóan (egy részlete):

        ...
        "formatted_address" : "Budapest, Budapest-Déli Pályaudvar"
        "geometry" : {
                "bounds" : {              
                        "northeast" : {                 
                                "lat" : 47.500481,
                                "lng" : 19.0259874
                         },
                        "southwest" : {
                                "lat" : 47.4987079,
                                "lng" : 19.0242229
                        }
              },
              ... 

Ezzel az egyszerű kis Google Chrome kiegészítővel könnyedén megszólíthatjuk az API-t, amit majd a fejlesztendő alkalmazásunkban is használni akarunk.

Nem akar lemaradni az új bejegyzésekről?
Regisztráljon és e-mailben értesítjük új bejegyzés esetén!
Regisztráció itt >>

0 hozzászólás

Hozzászóláshoz be kell jelentkezni.
Még nem regisztrált? Regisztráció itt!

Bejelentkezés

Regisztráció

Értesítés új bejegyzésekről

  • Ha nem akar lemaradni egyetlen hasznos információról sem, amit vállalkozásában azonnal kamatoztathat, regisztráljon és a következő bejegyzésnél értesítjük e-mailben!

    Kérek bejegyzés értesítőt! >>

Legújabb bejegyzések

Legújabb hozzászólások

  • Update

    Frissítettem a bejegyzést a változtatásoknak megfelelően.....

  • nem működik

    Kedves Sándor!

    Ez így sajnos nem működik! A \"Küldés a következőn keresztül: Gmail\"....

  • facebook-kép

    Sziasztok,

    A facebook oldalra elhelyezett kép is beilleszthető. Képen jobb kattintá....

  • Kép feltöltése más szolgáltatóhoz

    A minap jelezte egy kedves olvasónk, hogy a Google Drive-ba feltöltött képekre nem lehet direkt linken hivatkozni, ezért másik szolgáltató bevonása szükséges.

    Ahogy n....

  • Csekk nyivántartó

    Én is használom, szerintem tök jó. Mindig jön az értesítő levél, hogy milyen csekkeket kell fizetnem.....

Facebook

Cimkék

 (27)   (20)   (20)   (14)   (14)   (7)   (6)   (6)   (5)   (5)   (4)   (4)   (4)   (3)   (3)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (2)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)   (1)