API (Application Programming Interface) to jedno z najważniejszych pojęć we współczesnym programowaniu. Jeśli dopiero zaczynasz przygodę z IT, na pewno spotkałeś ten skrót w ofertach pracy, kursach czy dokumentacji technicznej. W tym artykule wyjaśnię czym jest REST API, jak działa i pokażę praktyczny przykład użycia w JavaScript.
Czym jest API?
API to zestaw reguł i protokołów, które pozwalają różnym aplikacjom komunikować się ze sobą. Można to porównać do menu w restauracji – menu (API) definiuje co możesz zamówić (jakie dane możesz pobrać), ale nie musisz wiedzieć jak kuchnia to przygotowuje (jak działa backend).
W praktyce, kiedy używasz aplikacji pogodowej na telefonie, logowania przez Google czy płacisz kartą online – za każdym razem aplikacja komunikuje się z serwerem poprzez API.
REST API – najpopularniejszy standard
REST (Representational State Transfer) to najpopularniejszy styl architektoniczny do tworzenia API. REST API opiera się na protokole HTTP i wykorzystuje standardowe metody:
- GET – pobieranie danych
- POST – wysyłanie nowych danych
- PUT – aktualizacja danych
- DELETE – usuwanie danych
REST API zwraca dane najczęściej w formacie JSON, który jest czytelny zarówno dla człowieka jak i maszyny.
Kluczowe pojęcia
Endpoint to konkretny adres URL, pod którym dostępna jest określona funkcjonalność API. Na przykład:
- https://api.example.com/users – lista użytkowników
- https://api.example.com/users/123 – dane konkretnego użytkownika
Request (żądanie) to wywołanie API – wysłanie zapytania do serwera. Request zawiera metodę HTTP, nagłówki i opcjonalnie dane.
Response (odpowiedź) to to, co serwer zwraca po przetworzeniu żądania. Zawiera kod statusu (np. 200 OK, 404 Not Found) oraz dane w formacie JSON.
Praktyczny przykład w JavaScript
Zobaczmy jak pobrać dane z REST API używając fetch() – wbudowanej funkcji JavaScript:
javascript
// Pobieranie listy użytkowników
fetch(’https://jsonplaceholder.typicode.com/users’)
.then(response => response.json())
.then(data => {
console.log(data);
// Wyświetl imiona użytkowników
data.forEach(user => console.log(user.name));
})
.catch(error => console.error(’Błąd:’, error));
Ten kod:
- Wysyła GET request do API
- Konwertuje odpowiedź na JSON
- Wyświetla dane w konsoli
- Obsługuje ewentualne błędy
Przykład z POST – wysyłanie danych
javascript
// Tworzenie nowego użytkownika
fetch(’https://jsonplaceholder.typicode.com/users’, {
method: 'POST’,
headers: {
'Content-Type’: 'application/json’,
},
body: JSON.stringify({
name: 'Jan Kowalski’,
email: 'jan@example.com’
})
})
.then(response => response.json())
.then(data => console.log(’Utworzono:’, data))
.catch(error => console.error(’Błąd:’, error));
Najczęstsze błędy początkujących
- Brak obsługi błędów: Zawsze używaj .catch() – API może zwrócić błąd (serwer nie odpowiada, brak internetu, etc.).
- Zapomnienie o async/await:Alternatywna, czystsza składnia:
javascript
async function getUsers() {
try {
const response = await fetch(’https://api.example.com/users’);
const data = await response.json();
console.log(data);
} catch (error) {
console.error(’Błąd:’, error);
}
}
- Ignorowanie kodów statusu:Sprawdzaj response.status- czasem API zwraca status 200 ale z błędem w treści.
Autoryzacja i bezpieczeństwo
Większość produkcyjnych API wymaga autoryzacji – najczęściej poprzez API key lub token JWT. Przykład:
javascript
fetch(’https://api.example.com/data’, {
headers: {
'Authorization’: 'Bearer YOUR_TOKEN_HERE’
}
})
Ważne: Nigdy nie commituj kluczy API do repozytorium Git! Używaj zmiennych środowiskowych.
Gdzie się uczyć więcej?
Praca z REST API to fundamentalna umiejętność fullstack developera. Jeśli chcesz to opanować od podstaw, warto rozważyć kursy programowania, które uczą zarówno frontendu (jak wywoływać API) jak i backendu (jak tworzyć własne API).
W programie Devstock Academy znajdują się dedykowane moduły do pracy z REST API – od podstaw przez zaawansowane wzorce, aż po tworzenie własnych endpointów w Node.js i Express.
Jeśli chcesz pogłębić wiedzę teoretyczną, szczegółowa analiza dostępna w artykule: REST API: Co to jest i jak działa? Przykłady zastosowań, gdzie znajdziesz więcej przykładów i zaawansowanych technik.
Podsumowanie
REST API to fundament współczesnej aplikacji webowej. Opanowanie fetch(), async/await i podstaw HTTP to must-have dla każdego developera. Zaczynaj od prostych publicznych API (JSONPlaceholder, OpenWeather), eksperymentuj, popełniaj błędy i ucz się na praktyce. To najlepsza droga do opanowania tego tematu.
Zakodowany Gdańsk: Gdy Twój zespół potrzebuje resetu, a Excel to za mało Czy kiedykolwiek miałeś wrażenie, że Twój zespół Czytaj dalej
Dla wielu uczniów i rodziców sam egzamin ósmoklasisty jest mniej stresujący niż niejasna punktacja i sposób przeliczania wyników. Pojawiają się Czytaj dalej
