
Ako čitate ovaj članak, verovatno ste već upoznati sa mogućnostima koje se otvaraju korišćenjem API-ja (Interfejs Programskog Aplikacija).
Dodavanjem jednog od mnogih otvorenih API-ja u svoju aplikaciju, možete proširiti funkcionalnost te aplikacije ili je dopuniti potrebnim podacima. Ali šta ako ste razvili jedinstvenu funkciju koju želite podeliti sa zajednicom?
Odgovor je jednostavan: treba .
Iako to na početku deluje kao složen zadatak, zapravo je sve jednostavno. Objasnićemo kako to da uradite pomoću Pythona.
Šta je potrebno za početak rada
Za razvoj API-ja su potrebni:
- Python 3;
- — jednostavan i lak za korišćenje okvir za izradu veb aplikacija;
- — dodatak za Flask koji omogućava brzu izradu REST API-ja uz minimalnu konfiguraciju.
Instalacija se vrši komandama:
pip install flask-restfulPreporučujemo besplatni intenzivni kurs programiranja za početnike:
— 26–28. avgusta. Besplatan intenzivni kurs koji pomaže da se razume kako rade pomoćni botovi, specifičnosti rada sa Telegram API-jem i druge nijanse. Troje najboljih učesnika dobiće od Skillbox-a 30 000 rubalja..
Pre nego što počnemo
Planiramo da razvijemo RESTful API sa osnovnom .
Da bismo potpuno razumeli zadatak, hajde da razjasnimo dva pomenuta pojma.
Šta je REST?
REST API (Represenativni Pristup Transfera) je API koji koristi HTTP zahteve za razmenu podataka.
REST API treba da zadovolji određene kriterijume:
- Arhitektura klijent-server: klijent komunicira sa korisničkim interfejsom, dok server komunicira sa backend-om i skladištem podataka. Klijent i server su nezavisni, bilo koji od njih može biti zamenjen odvojeno od drugog.
- Bez stanja — nikakvi podaci klijenta se ne čuvaju na serveru. Stanje sesije se čuva na strani klijenta.
- Keširanje — klijenti mogu da keširaju odgovore servera kako bi poboljšali ukupnu performansu.
Šta je CRUD?
CRUD je koncept programiranja koji opisuje četiri osnovne radnje (create, read, update i delete).
U REST API-ju, tipovi zahteva i metode zahteva odgovaraju aktivnostima kao što su post, get, put, delete.
Sada kada smo se upoznali sa osnovnim pojmovima, možemo da pređemo na izradu API-ja.
Razvoj
Hajde da kreiramo repozitorijum citata o veštačkoj inteligenciji. VI je jedna od najbrže rastućih tehnologija danas, a Python je popularan alat za rad sa VI.
Uz ovaj API, Python programer može brzo da dobije informacije o VI i inspiriše se novim dostignućima. Ako programer ima dragocene misli na ovu temu, može ih dodati u repozitorijum.
Počnimo sa uvozom potrebnih modula i podešavanjem Flaska:
from flask import Flask
from flask_restful import Api, Resource, reqparse
import random
app = Flask(__name__)
api = Api(app)U ovom snipetu, Flask, Api i Resource su klase koje su nam potrebne.
Reqparse je interfejs za parsiranje zahteva Flask-RESTful… Takođe će nam biti potreban modul random za prikaz slučajnog citata.
Sada ćemo kreirati repozitorijum citata o VI.
Svaka stavka repoa će sadržati:
- digitalni ID;
- ime autora citata;
- citati.
Pošto je ovo samo primer za učenje, sačuvaćemo sve stavke u listi Python. U pravoj aplikaciji, umesto toga, verovatno bismo koristili bazu podataka.
ai_quotes = [
{
"id": 0,
"author": "Kevin Kelly",
"quote": "Poslovni planovi sljedećih 10.000 startupa lako se predviđaju: " +
"Uzmite X i dodajte AI."
},
{
"id": 1,
"author": "Stephen Hawking",
"quote": "Razvoj pune umjetne inteligencije mogao bi " +
"značiti kraj ljudske rase… " +
"Ona će se sama razvijati i " +
"redizajnirati " +
"sve bržim tempom. " +
"Ljudi, koji su ograničeni sporom biološkom evolucijom, " +
"neće moći konkurirati i bit će nadjačani."
},
{
"id": 2,
"author": "Claude Shannon",
"quote": "Zamišljam vrijeme kada ćemo biti robotima ono što su " +
"psi ljudima, " +
"i navijam za mašine."
},
{
"id": 3,
"author": "Elon Musk",
"quote": "Tempo napretka u umjetnoj inteligenciji " +
"(ne mislim na usku AI) " +
"je nevjerojatno brz. Osim ako nemate direktno " +
"iskustvo sa grupama poput Deepminda, " +
"nemate pojma koliko brzo — raste " +
"brzinom koja se približava eksponencijalnom. " +
"Rizik od nečeg ozbiljno opasnog " +
"dogoditi će se u okviru pet godina." +
"Najviše 10 godina."
},
{
"id": 4,
"author": "Geoffrey Hinton",
"quote": "Uvijek sam bio uvjeren da je jedini način " +
"da umjetna inteligencija funkcioniše " +
"da se proračun radi na način sličan ljudskom mozgu. " +
"To je cilj kojeg se trudim ostvariti. Napredujemo, " +
"iako još uvijek imamo mnogo toga za naučiti o " +
"funkcionisanju mozga."
},
{
"id": 5,
"author": "Pedro Domingos",
"quote": "Ljude brine da će računari " +
"postati previše pametni i preuzeti svijet, " +
"ali pravi problem je što su previše glupi " +
"i već su preuzeli svijet."
},
{
"id": 6,
"author": "Alan Turing",
"quote": "Čini se vjerojatnim da kada je metoda " +
"misaonih mašina počela, neće proći dugo " +
"da nadmaše naše slabe sposobnosti… " +
"One će biti sposobne da komuniciraju " +
"jedna s drugom kako bi usavršile svoje umove. " +
"U nekom trenutku, stoga, trebali bismo " +
"očekivati da mašine preuzmu kontrolu."
},
{
"id": 7,
"author": "Ray Kurzweil",
"quote": "Umjetna inteligencija će dostići " +
"ljudske nivoe oko 2029. " +
"Ako pogledamo dalje, recimo, do 2045. godine, " +
"multipliciraćemo inteligenciju, " +
"ljudsku biološku mašinsku inteligenciju " +
"naše civilizacije milijardu puta."
},
{
"id": 8,
"author": "Sebastian Thrun",
"quote": "Niko to ne izražava na taj način, ali mislim " +
"da je umjetna inteligencija " +
"gotovo disciplina humanistike. To je stvarno pokušaj " +
"da se razume ljudska inteligencija i ljudska kognicija."
},
{
"id": 9,
"author": "Andrew Ng",
"quote": "Pravimo tu analogiju da je AI nova električna energija." +
"Električna energija je transformisala industrije: poljoprivredu, " +
"transport, komunikaciju, proizvodnju."
}
]Sada treba da kreiramo resursnu klasu Quote koja će definisati operacije krajnjih tačaka našeg API-ja. Unutar klase treba da napravimo četiri metode: get, post, put, delete.
Počnimo sa metodom GET
Ona omogućava dobijanje određene citate tako što se navodi njen ID ili nasumičnu citatu ako ID nije naveden.
class Quote(Resource):
def get(self, id=0):
if id == 0:
return random.choice(ai_quotes), 200
for quote in ai_quotes:
if(quote["id"] == id):
return quote, 200
return "Citat nije pronađen", 404Metoda GET vraća nasumičnu citatu ako ID ima podrazumevanu vrednost, tj. kada se metoda poziva bez zadatog ID-a.
Ako je zadat, metoda pretražuje među citatima i pronalazi onaj koji sadrži zadati ID. Ako ništa nije pronađeno, prikazuje se poruka "Citat nije pronađen, 404".
Zapamtite: metoda vraća HTTP status 200 u slučaju uspešnog zahteva i 404 ako zapis nije pronađen.
Sada da kreiramo POST metod za dodavanje nove citate u repository
On će primati identifikator svake nove citate prilikom unosa. Pored toga, POST će koristiti reqparse za analizu parametara koji će biti u telu zahteva (autor i tekst citata).
def post(self, id):
parser = reqparse.RequestParser()
parser.add_argument("author")
parser.add_argument("quote")
params = parser.parse_args()
for quote in ai_quotes:
if(id == quote["id"]):
return f"Citat sa id {id} već postoji", 400
quote = {
"id": int(id),
"author": params["author"],
"quote": params["quote"]
}
ai_quotes.append(quote)
return quote, 201U gornjem kodu, POST metoda je prihvatila ID citata. Zatim, koristeći reqparse, dobila je autora i citat iz zahteva, čuvajući ih u rečniku params.
Ako citat sa zadatim ID već postoji, metoda prikazuje odgovarajuću poruku i kod 400.
Ako citat sa zadatim ID još nije kreiran, metoda kreira novu stavku sa navedenim ID-em i autorom, kao i ostalim parametrima. Zatim dodaje stavku u listu ai_quotes i vraća stavku sa novom citatom uz kod 201.
Sada kreiramo PUT metodu za modifikaciju postojećeg citata u repository.
def put(self, id):
parser = reqparse.RequestParser()
parser.add_argument("author")
parser.add_argument("quote")
params = parser.parse_args()
for quote in ai_quotes:
if(id == quote["id"]):
quote["author"] = params["author"]
quote["quote"] = params["quote"]
return quote, 200
quote = {
"id": id,
"author": params["author"],
"quote": params["quote"]
}
ai_quotes.append(quote)
return quote, 201PUT metoda, slično prethodnom primeru, uzima ID i ulazne podatke i analizira parametre citata koristeći reqparse.
Ako citat sa navedenim ID-jem postoji, metoda će ga ažurirati novim parametrima, a zatim će prikazati ažurirani citat sa kodom 200. Ako citat sa datim ID-jem još ne postoji, biće kreiran novi zapis sa kodom 201.
Na kraju, hajde da kreiramo DELETE metodu za brisanje citata koji više ne inspiriše.
def delete(self, id):
global ai_quotes
ai_quotes = [quote for quote in ai_quotes if quote["id"] != id]
return f"Citat sa id-jem {id} je obrisan.", 200Ova metoda prima ID citata kao ulaz i ažurira listu ai_quotes koristeći globalnu listu.
Sada kada smo stvorili sve metode, sve što treba da uradimo je da jednostavno dodamo resurs API-u, postavimo putanju i pokrenemo Flask.
api.add_resource(Quote, "\/ai-quotes", "\/ai-quotes\/", "\/ai-quotes\/<int:id>")
if __name__ == '__main__':
app.run(debug=True)Naša REST API usluga je spremna!
Nakon toga možemo sačuvati kod u fajl app.py, pokrenuvši ga u konzoli pomoću komande:
python3 app.pyAko je sve u redu, dobićemo nešto poput ovoga:
* Debug mode: uključen
* Radi na :5000\/ (Pritisnite CTRL+C za izlaz)
* Ponovno pokretanje sa stat
* Debugger je aktivan!
* Debugger PIN: XXXXXXX
Testiramo API
Nakon što je API stvoren, potrebno ga je testirati.
To se može uraditi pomoću konzolne alatke curl ili Insomnia REST klijenta, ili objavljivanjem API-ja na Rapid API.

Objavljujemo naš API
RapidAPI je najveća svetska tržišna platforma sa više od 10.000 API-ja (i oko 1 milion programera).
RapidAPI ne samo da pruža jedinstven interfejs za rad sa spoljnim API-ima, već i omogućava brzo i lako objavljivanje vašeg vlastitog API-ja.
Da biste , prvo treba objaviti na nekom serveru u mreži. U našem slučaju koristićemo . Rad sa njim ne bi trebao izazvati nikakve komplikacije, ().
Kako objaviti vaš API na Heroku
1. Instaliramo Heroku.
Prvo što treba da uradimo je da se registrujemo i instaliramo Heroku Command Line Interface (CLI). Ovo funkcioniše na Ubuntu 16+.
sudo snap install heroku --classic
Zatim se prijavljujemo:
heroku login
2. Dodajemo potrebne fajlove.
Sada treba da dodamo fajlove za objavljivanje u folder našeg aplikacije:
- requirements.txt sa listom potrebnih Python modula;
- Procfile, koji označava koje komande treba izvršiti za pokretanje aplikacije;
- .gitignore — za isključivanje fajlova koji nisu potrebni na serveru.
Fajl requirements.txt će sadržavati sledeće redove:
- flask
- flask-restful
- za obradu web zahtjeva. Kada Quay primi zahtjev (putem našeg vlastitog API-ja ili putem Docker API-ja), dodjeljuje se gevent radnik. Obično taj radnik treba uspostaviti vezu s bazom podataka. Nakon prvog kvara otkrili smo da su se gevent radnici povezivali s bazom podataka koristeći postavke prema zadanim postavkama.
Molimo vas da obratite pažnju: dodali smo gunicorn (Python WSGI HTTP Server) na listu, jer je potrebno pokrenuti našu aplikaciju na serveru.
Procfile će sadržavati:
web: gunicorn app:app
Sadržaj .gitignore:
*.pyc
__pycache__/Sada kada su fajlovi kreirani, hajde da inicijalizujemo git repozitorij i napravimo commit:
git init
git add
git commit -m "Prvi API commit"3. Kreiramo novu aplikaciju na Heroku.
heroku createŠaljemo master granu u udaljeni repozitorij Heroku:
git push heroku masterSada možemo početi, otvarajući API uslugu pomoću komandi:
heroku ps:scale web=1
heroku open
API će biti dostupan na adresi .
Kako dodati vaš Python API na marketplace RapidAPI
Nakon što je API servis objavljen na Heroku, možete ga dodati na Rapid API. Ovde o ovoj temi.
1. Kreiramo RapidAPI nalog.
![]()
Registrujemo besplatni nalog — to možete uraditi putem Facebooka, Googlea, GitHuba.

2. Dodajemo API u kontrolnu ploču.

3. Zatim unosimo osnovne informacije o našem API-ju.

4. Nakon pritiska na "Add API", pojavljuje se nova stranica gde možete uneti informacije o našem API-ju.

5. Sada možete ili ručno uneti API krajnje tačke, ili učitati putem OpenAPI.

Sada treba da postavimo krajnje tačke našeg API-ja na stranici Endpoints. U našem slučaju krajnje tačke odgovaraju konceptu CRUD (get, post, put, delete).

Zatim treba da kreiramo GET AI Quote krajnju tačku, koja prikazuje nasumičnu citat (ukoliko je ID podrazumevan) ili citat za navedeni ID.
Da biste kreirali krajnju tačku, treba da pritisnete dugme "Create Endpoint".

Ponavljamo ovaj proces za sve ostale API krajnje tačke. To je to! Čestitam, objavili ste svoj API!
Ako je sve u redu, stranica API-ja će izgledati ovako:

Zaključak
U ovom članku smo istražili proces kreiranja vlastitog RESTful API Servisa na Pythonu, zajedno sa procesom objavljivanja API-ja u oblaku Heroku i dodavanjem u katalog RapidAPI.
Međutim, u testnoj verziji su prikazani samo osnovni principi razvoja API-ja — tako da nijanse kao što su bezbednost, otpornost i skalabilnost nisu razmatrane.
Kada razvijate stvarni API, sve ovo treba uzeti u obzir.
Izvor: habr.com
