Írásban api gem különböző struktúrákat és eszközöket, cikkek programozás mkdev
DevOps tanácsadó, szakértő AWS, OpenStack, Puppet, Ansible, programozó Ruby and Go, CTO és alapítója mkdev.me.
Először is azt fogja adni a lehetőséget, hogy hitelesítse a NIS + kéréseket GrooveHQ API. és írjuk be a szükséges minimális kódot egy listát az összes jegyet. Szerencsére, az API dokumentációt a szolgáltatás részletes és világos, így, hogy egy munka GET-kérés nem lesz.
vékony kliens
Ha tudod képzelni, mi az API és miért van szükség rá, majd a szünet öt percig, és olvassa el a cikket ebben a témában.
Kezdjük azzal, hogy írnék egy kis osztály GrooveHQ :: Client. Ki lesz végrehajtásáért felelős az API kéréseket. A kivitelező veszi a hozzáférési token.
Hogyan lehet elérni az API
Most kell, hogy kitaláljuk, hogyan lehet hozzáférni az API. Egészen addig a pillanatig még soha nem használt httparty gem lekérdezések. Saját tapasztalat korlátozódik könyvtárak RestClient és Faraday. Nem hiszem, hogy van sok különbség, amit könyvtárat használja, hanem hogy a folyamat sokkal érdekesebb választani httparty. Különösen azért, mert ő volt a sok csillag GitHubról :)
Tény, hogy nem bírom Faraday.
Azt hozzá az alábbi sort a groovehq.gemspec:
és végre csomag telepítéséhez. Továbbra is csak a csatlakozni httparty belül ./lib/groovehq.rb:
Tesszük az első kérés, hogy az API
Ellenőrizze, hogy minden működik, ahogy kellene végre egy mappában hem parancs köteg exec irb. Ezután egyesével, hajtsa végre a következő kódot:
Ennek eredményeképpen, ha a helyes hozzáférési tokent kap a konzol hash ami így néz ki:
Úgy tűnik, hogy van egy minimum üzemi változata hem! Változtatások véglegesítéséhez itt: f7d9eef.
nem több, mint létrehozni hibakeresés #perform_request módszer, ezért nem tartalmaz több, mint a jobb kapcsolatok létrejöttét sorokban.
összeadás struktúra
Miután megvizsgálta a dokumentációt httparty. Láttam ezt a gem írhatunk egyszerű és érdekes osztályok elvégzéséért felelős kéréseket. Megadhatja a globális beállításokat minden egyes kérelem (bázis uri, fejlécek, stb), és az egyes módszerek az osztály feladata lesz egy adott kérést.
Újraírt GrooveHQ :: Client így néz ki (#perform_request módszer már nincs szükség):
Most meg kell adni külön módszert minden egyes API pontokat. Annak elkerülése érdekében, város több tucat módszerek osztályba GrooveHQ :: Client. Eltöröm őket az egyes modulok, ahol mindegyik modul felel meg egy adott erőforrás.
Ugyanígy azt végrehajtani hem octokit. ahol benézett ezt a megközelítést.
Add a mappa lib / groovehq / ügyfélnek a fájl tickets.rb:
Kísérlet irb mutatta, hogy minden úgy működik, ahogy kell, és az első API-végpont hem csomagolva, és használatra kész.
Mi a következő lépés?
A következő feladat az, hogy adjunk annyi források lehető követően az API dokumentációt. A probléma, hogy én találkoztam a folyamat - a következő cikkben.
Többet a témáról
- Írásban API gem: Mi Hypermedia API és hogyan kell barátkozni
- PostgreSQL: Miért és hogyan
- Egy nélkülözhetetlen készség: a naplót
Végül úgy döntöttem, hogy képezzük magunkat?
Ezután indítsa el az ingyenes útmutató a világ a webes fejlesztés. Belül egy csomó tippet és anyagok az önálló tanuláshoz.
hogy a könyv