REST API endpoint-i
Caution
Demo stranica - Ovo je demo stranica koja prikazuje funkciju dokumentacije sa više kartica. Ovaj sadržaj služi isključivo kao ilustracija.
Naš REST API pruža endpoint-e za pristup podacima i njihovu obradu. Svi endpoint-i vraćaju podatke u JSON formatu.
Osnovni URL
Svi API zahtevi treba da se šalju na sledeći osnovni URL:
https://api.example.com/v1Endpoint-i za korisnike
Preuzimanje svih korisnika
GET /usersVraća listu svih korisnika. Podržava parametre paginacije.
Parametri upita:
| Parametar | Tip | Opis |
|---|---|---|
| page | integer | Broj stranice (podrazumevano: 1) |
| limit | integer | Broj zapisa po stranici (podrazumevano: 50, maksimalno: 100) |
| sort | string | Polje po kojem se sortira (npr. “name”, “created_at”) |
Odgovor:
{ "data": [ { "id": "user_123", "name": "John Doe", "created_at": "2023-01-15T08:30:00Z" }, // More users... ], "meta": { "total": 250, "page": 1, "limit": 50 }}Preuzimanje korisnika po ID-u
GET /users/{id}Vraća jednog korisnika po ID-u.
Odgovor:
{ "data": { "id": "user_123", "name": "John Doe", "created_at": "2023-01-15T08:30:00Z", "profile": { "bio": "Software developer", "location": "New York", "avatar_url": "https://example.com/avatars/john.jpg" } }}Endpoint-i za proizvode
Preuzimanje svih proizvoda
GET /productsVraća listu svih proizvoda. Podržava filtriranje i paginaciju.
Parametri upita:
| Parametar | Tip | Opis |
|---|---|---|
| category | string | Filtriranje po kategoriji |
| min_price | number | Filtriranje po minimalnoj ceni |
| max_price | number | Filtriranje po maksimalnoj ceni |
| page | integer | Broj stranice (podrazumevano: 1) |
| limit | integer | Broj zapisa po stranici (podrazumevano: 50, maksimalno: 100) |
Odgovor:
{ "data": [ { "id": "prod_123", "name": "Example Product", "description": "This is an example product", "price": 49.99, "category": "electronics" }, // More products... ], "meta": { "total": 350, "page": 1, "limit": 50 }}Rukovanje greškama
Svi endpoint-i prate standardne HTTP statusne kodove i, kada je to primereno, sadrže detaljne poruke o grešci:
| Statusni kod | Opis |
|---|---|
| 200 | OK - Zahtev je uspeo |
| 400 | Bad Request - Neispravni parametri |
| 401 | Unauthorized - Potrebna je autentifikacija |
| 403 | Forbidden - Nedovoljne dozvole |
| 404 | Not Found - Resurs ne postoji |
| 429 | Too Many Requests - Prekoračeno ograničenje broja zahteva |
| 500 | Internal Server Error - Došlo je do greške na serveru |
Odgovori sa greškom sadrže poruku koja objašnjava šta je pošlo naopako:
{ "error": { "code": "invalid_parameter", "message": "The parameter 'email' is not a valid email address", "request_id": "req_abc123" }}