În cazul în care contul dvs. nu are deja unul dezvoltat o aplicație folosind API-ul REST sau se pot crea API-ul REST, probabil ați auzit de poștaș. În acest post vreau să arăt câteva exemple de funcționalitatea de bază a cererii pentru ceilalți - cei care au început să se angajeze în astfel de proiecte.
V-ați creat un API REST? Sau aplicațiile care utilizează un API REST terță parte? Dacă ați răspuns afirmativ la oricare dintre aceste întrebări, atunci vei înțelege durerea mea.
- Copiați interogarea dorită dintr-un fișier
- Vom efectua o cerere de jeton-o
- Copiați următoarea interogare dintr-un fișier
- Copiați token-ul într-o nouă interogare
- Efectuați o solicitare de date
Elementele 3-5 poate dura câteva ori. În cazul în care acest lucru este o sarcină o singură dată, nu există nici o problemă - realizată și uitate. Cu toate acestea, dacă utilizați acest API în aplicația dvs. sau de a face un dezvoltator API, pentru a efectua această interogare este necesar ambalaj multiplu și de a face devine neplăcut. În acest moment, se pare OH - Poștașul.
Creatorii Poștașul descrie proiectul său:
Poștașul este Elvețian cuțit armata de instrumente API, permițându-vă pentru a proiecta, construi, de testare, documente și să monitorizeze serviciile, toate într-un singur loc. *
Pe scurt, și în limba rusă, Poștașul - este procesorul, care vă permite să creați și să execute interogări, documente și să monitorizeze serviciile într-un singur loc.
La momentul scrierii acestui articol, a existat, de asemenea, o versiune pentru Google Chrome, care vor fi discutate în acest articol.
Funcția de bază este destul de simplu: pentru a efectua interogări de bază suficiente:
- selectați tipul de cerere
- conduce cererea în câmpul corespunzător ...
- ... sau completați opțiunile prin intermediul formularului
- apăsați butonul „Trimite“
Dacă este făcută corect, atunci partea de jos a ferestrei afișează rezultatul interogării executate. În cazul meu - o cerere de familiar de la precedenta StackOverflow posturi API:
„Acest exemplu este primitiv și este mai ușor de a efectua .eveloper-Tools-Fav-browser%!“ - va spune nimănui și aș fi de acord cu asta. Cu toate acestea, există cel puțin un „dar“: cererea poate fi salvat și a alerga doar prin schimbarea setărilor relevante în viitor. În plus, cererile pot fi grupate într-o colecție.
Thetvdb.com site-ul oferă posibilitatea de a obține informații cu privire la diferite serii de televiziune prin API-ul lor REST. Cu toate acestea, fiecare cerere trebuie să conțină antete obținute de jetonul de autentificare. Astfel, în scopul de a obține informații cu privire la seria „Walking Dead“ este necesar să-și îndeplinească două cereri: pentru a obține un simbol, și de căutare.
pentru token:
Prin completarea formularului cu antete așa cum sa menționat mai sus în imagine și adăugați corpul dorit și cererea JSON pentru a schimba tipul de prime (apikey, numele de utilizator și userkey disponibile din zona personală după înregistrarea pe site-ul de mai sus):
În momentul de față, este suficient și puteți apăsa din nou pe „Send“. Ca răspuns la această solicitare, trebuie să fel de JSON
Ca răspuns, puteți vedea JSON obținut din telenovelele: „The Dead Walking“ și „Temeți the Dead Walking“ descriere si de scurta durata lor (2).
Pentru a putea găsi în continuare că aceste cereri - păstrați-le în meniul „Save As ...“ și se adaugă la colecția „TheTVDB“:
Acum, în panoul din stânga, vom avea o nouă colecție de „TheTVDB“.
Secțiunea anterioară a arătat că este posibil să se simplifice performanța acțiunilor de rutină pentru a salva interogarea si sa le execute cu parametrii preparate. Cu toate acestea, după 2-3 cicluri repetitive:
- Obțineți jeton
- Copiați token-ul în antetul solicitării
- Interogați API
Acesta începe să deranjeze.
Și apoi vine pentru a ajuta un poștaș oportunitate nebun - interoghează colecții cu adăugarea unor mici (dar pot fi mai multe) script-uri.
Îmbunătățirea solicitărilor anterioare, astfel încât, atunci când nu au fost necesare pentru solicitarea unui jeton cu caracter personal în întrebările următoare pentru a copia. Pentru a face acest lucru, există o grămadă de file Teste, medii (Mediu) și variabilele mediului.
În primul rând, aveți nevoie pentru a crea un mediu nou în secțiunea relevantă:
Nici chei nu va fi adăugată - acum nu avem nevoie de ea.
Crearea unui mediu trebuie să fie selectat în lista derulantă corespunzătoare:
În al doilea rând, cererea deschisă pentru un jeton și pentru a trece pe la fila Teste (a se vedea captura de ecran de mai sus.) Și se adaugă următorul cod:
Acest script convertește doar șirul în JSON și este stocată în mediul actual „jeton“ proprietatea jeton a obiectului rezultat.
De fapt, această filă este un pic pentru alte scopuri (pentru teste de scriere, dintr-o dată), dar acum nu vom vorbi despre asta. Poate time'll următoare ajunge la asta.
În al treilea rând, cererea de schimbare pentru serialul TV „Walking Dead“ listă ca token-ul este obținut din variabile de mediu. Este suficient în șirul de jetoane antet Autorizarea se înlocuiește cu fragmentul>:
Puteți verifica dacă totul funcționează corect prin rularea întregului cererile de colectare prin colectarea corespunzătoare a meniului:
În meniul care se deschide, selectați colecția dorită și apăsați pe butonul albastru mare „Start Test“, care îndeplinesc toate cererile de colectare selectate în ordinea în care acestea sunt stocate:
După cum puteți vedea în captura de ecran toate cererile au fost finalizate cu succes. Din păcate, conținutul răspunsurilor acestor cereri nu pot fi aici pentru a vedea. Acesta și este corect - abilitatea de a interoga colectarea este de așteptat pentru a testa API, în primul rând.
Și, în sfârșit, aș dori să menționez un postas fiche foarte abruptă - codul generat de cerere. Lista de limbaje de programare acceptate (și nu numai) este destul de largă: de la OCaml si ghemuieste la Swift și Go.
Exemplu de cod generat pentru Poștașul StackOverflow căutare pe Golang:
Și, în plus față de Python folosind biblioteci de Cereri:
După cum văd eu, codul este mai mult decât acceptabil și este destul de potrivit ca un punct de plecare pentru măcinare ulterioară.
Doar o singură concluzie - dacă nu utilizați în Poștaș lor de munca de zi cu zi, probabil va începe în curând. Dacă nu, atunci, probabil, este că nu aveți și doresc mai multă suferință.
*) Poștașul - este elvețian cuțit armata pentru a lucra cu API, care vă permite să creați, de testare, documentul, și să monitorizeze serviciile dintr-un singur loc.