Web programiranje → Osnove weba → Šta je API i kako se razmenjuju podaci (JSON)

Šta je API i kako se razmenjuju podaci (JSON)

API: konobar između frontenda i backenda

U restoranu ne ulaziš u kuhinju – narudžbinu predaješ konobaru prema jelovniku. API je takav jelovnik: piše koje adrese postoje, šta im se šalje i šta vraćaju.

Ovakav stil – adrese su „stvari“ (resursi), a HTTP metode su „radnje“ – zove se REST. Isti backend tako služi i sajtu i mobilnoj aplikaciji.

JSON: format podataka

JSON (JavaScript Object Notation) je tekstualni zapis podataka koji lako čitaju i ljudi i programi:

{
  "ime": "Ana",
  "razred": 7,
  "takmicar": true,
  "rezultati": [100, 85, 92],
  "skola": { "naziv": "OŠ Vuk Karadžić", "grad": "Pančevo" }
}

Pozivanje API-ja iz JavaScript-a

U pregledaču se API poziva funkcijom fetch. Primer koristi besplatan API za vremensku prognozu Open-Meteo (bez registracije):

<p>Temperatura u Pančevu: <span id="temp">…</span> °C</p>
<script>
  const url = "https://api.open-meteo.com/v1/forecast?latitude=44.87&longitude=20.64&current=temperature_2m";
  fetch(url)                                  // pošalji GET zahtev
    .then(odgovor => odgovor.json())          // pretvori JSON tekst u objekat
    .then(podaci => {
      document.getElementById("temp").textContent = podaci.current.temperature_2m;
    })
    .catch(greska => console.log("Greška:", greska));   // npr. nema interneta
</script>

Otvori F12 → Network → filter Fetch/XHR: videćeš zahtev ka API-ju i JSON odgovor u tabu Response.

Pozivanje API-ja iz Python-a

U Python-u se JSON pretvara u rečnik modulom json, a zahtevi se najčešće šalju bibliotekom requests:

import json

tekst = '{"ime": "Ana", "razred": 7, "rezultati": [100, 85, 92]}'
ucenik = json.loads(tekst)               # JSON tekst -> rečnik
print(ucenik["ime"], ucenik["razred"])
print("prosek:", sum(ucenik["rezultati"]) / len(ucenik["rezultati"]))

ucenik["razred"] = 8
print(json.dumps(ucenik, ensure_ascii=False))   # rečnik -> JSON tekst

import requests                          # instalacija: pip install requests

url = "https://api.open-meteo.com/v1/forecast"
parametri = {"latitude": 44.87, "longitude": 20.64, "current": "temperature_2m"}
odgovor = requests.get(url, params=parametri, timeout=10)
print(odgovor.status_code)               # 200 ako je sve u redu
podaci = odgovor.json()                  # JSON -> rečnik
print(podaci["current"]["temperature_2m"], "°C")

API ključevi i ograničenja

• Mnogi API-ji traže ključ (API key) – tajni niz znakova po kome znaju ko ih poziva. Ključ se ne objavljuje u kodu na GitHub-u i ne stavlja u frontend.
• Postoje ograničenja (npr. 1000 zahteva dnevno); posle toga server vraća 429 Too Many Requests.
• Pregledač ne dozvoljava da stranica sa jednog domena slobodno čita podatke sa drugog, osim ako taj server to izričito dozvoli (pravilo CORS). Zato neki API-ji rade iz Python-a, a iz pregledača ne.

Proveri znanje