Kompletna dokumentacja REST API dla aplikacji mobilnej | v2.0
Ostatnia aktualizacja: 2 listopada 2025
Base URL: https://api-app.standardy.pl/api
Format: JSON
Enkodowanie: UTF-8
Wersja API: v2.0 (2025-11-02)
X-API-Token zamiast standardowego Authorization.
Większość endpointów wymaga autoryzacji przez token API.
curl -H "X-API-Token: YOUR_TOKEN" https://api-app.standardy.pl/api/meSukces:
{
"status": "success",
"data": { ... },
"message": "Optional message"
}Błąd:
{
"status": "error",
"message": "Error description",
"errors": { ... }
}Opis: Rejestracja nowego użytkownika
Body:
{
"name": "Jan",
"nazwisko": "Kowalski",
"email": "jan@example.com",
"password": "haslo123",
"telefon": "+48123456789",
"nr_pwz": "1234567",
"specialization": "Kardiologia",
"title": "dr"
}Odpowiedź:
{
"status": "success",
"message": "Użytkownik został zarejestrowany",
"data": {
"user": { ... },
"token": "xxx..."
}
}Opis: Logowanie użytkownika
Body:
{
"email": "jan@example.com",
"password": "haslo123"
}Odpowiedź:
{
"status": "success",
"message": "Zalogowano pomyślnie",
"data": {
"user": { ... },
"token": "xxx..."
}
}Opis: Wylogowanie użytkownika (invalidacja tokenu)
Opis: Pobiera dane zalogowanego użytkownika
Opis: Lista książek z katalogu
Parametry query:
per_page - Liczba wyników na stronę (domyślnie: 20)search - Wyszukiwanie po nazwieOpis: Szczegóły pojedynczej książki
Opis: Książki kupione przez użytkownika
Opis: Historia zakupów użytkownika
Opis: Lista książek mobilnych z rozdziałami
Parametry query:
per_page - Liczba wyników (domyślnie: 20)search - WyszukiwanieOdpowiedź zawiera:
Opis: Szczegóły pojedynczej książki z rozdziałami
Opis: Książki i rozdziały kupione przez użytkownika
Odpowiedź zawiera:
Opis: Pobiera pełną książkę PDF
Weryfikacja: Sprawdza czy użytkownik kupił książkę
Zwraca: Plik PDF do pobrania
Opis: Pobiera PDF rozdziału
Weryfikacja: Sprawdza czy rozdział jest darmowy LUB czy użytkownik go kupił
Zwraca: Plik PDF rozdziału
Opis: Zakup książki lub rozdziału (legacy, używaj /mobile/payment/payu/create)
Opis: Status płatności PayU
Opis: Pobiera koszyk użytkownika
Odpowiedź zawiera:
Opis: Dodaje produkt do koszyka
Body:
{
"product_type": "chapter",
"product_id": 123,
"quantity": 1
}Typy produktów: chapter, book, package
Opis: Usuwa produkt z koszyka
Opis: Czyści cały koszyk
Opis: Aplikuje kupon rabatowy
Body:
{
"coupon_code": "PROMO2025"
}Opis: Waliduje kupon bez aplikowania
Opis: Usuwa zastosowany kupon
Opis: Finalizuje zakup koszyka przez PayU
Body:
{
"payment_method": "blik"
}Odpowiedź zawiera:
\OpenPayU_Retrieve::payMethods()) dla komunikacji z bramką płatniczą.
Opis: Pobiera dostępne metody płatności z PayU
Parametry query:
lang - Język (pl/en, domyślnie: pl)Zwraca 13 metod płatności:
Przykład odpowiedzi:
{
"status": "success",
"data": {
"pay_by_links": [
{
"value": "blik",
"name": "BLIK",
"brand_image_url": "https://static.payu.com/images/mobile/logos/pbl_blik.png",
"status": "ENABLED",
"min_amount": 1,
"max_amount": 4999999
}
],
"card_tokens": [],
"pbl_channels": []
}
}Opis: Tworzy płatność PayU
Body:
{
"book_id": 1,
"cart_id": 4,
"total_amount": 99.99,
"payment_method": "blik"
}Odpowiedź:
{
"status": "success",
"data": {
"redirectUri": "https://secure.payu.com/...",
"orderId": "ABC123",
"extOrderId": "ORDER_123"
}
}Opis: Generuje OAuth token PayU
SDK Method: \OpenPayU_OAuth::getAccessToken()
Opis: Webhook PayU - notyfikacje o zmianie statusu płatności
Uwaga: Ten endpoint jest wywoływany przez PayU, nie przez aplikację
SDK Method: \OpenPayU_Signature::verifySignature()
Opis: Lista aktualności
Parametry query:
per_page - Liczba wyników (domyślnie: 20)search - Wyszukiwaniecategory_id - Filtrowanie po kategoriiOpis: Szczegóły pojedynczej aktualności
Opis: Lista wszystkich kategorii aktualności
Opis: Lista artykułów naukowych
Parametry query:
per_page - Liczba wyników (domyślnie: 20)search - Wyszukiwanie w tytule i streszczeniuwork_type - Typ pracy (pogladowa, oryginalna, etc.)in_bookstore - Filtr księgarnia (true/false)Dane: 1,351 aktywnych opublikowanych artykułów
Opis: Szczegóły artykułu z autorami
Zawiera:
Opis: Lista typów prac
Zwraca 6 typów:
Opis: Lista autorów
Parametry query:
per_page - Liczba wyników (domyślnie: 20)search - Wyszukiwanie po imieniu/nazwiskuDane: 1,980 autorów
Opis: Profil autora z artykułami
Zawiera:
Opis: Lista dostępnych opcji prenumeraty
Opis: Prenumeraty użytkownika
Opis: Szczegóły prenumeraty
Opis: Zakup nowej prenumeraty
Opis: Lista kuponów rabatowych
Opis: Lista wszystkich zakupów
Opis: Aktualizacja książki
Opis: Health check endpoint
Odpowiedź:
{
"message": "Standardy API działa!",
"version": "2.0",
"timestamp": "2025-11-02T15:30:00+00:00"
}Opis: Serwuje obrazy produktów z CORS
Opis: Serwuje logo aplikacji
Opis: Debug endpoint - pokazuje nagłówki HTTP
| Kod | Status | Opis |
|---|---|---|
| 200 | OK | Żądanie wykonane pomyślnie |
| 201 | Created | Zasób utworzony pomyślnie |
| 400 | Bad Request | Nieprawidłowe żądanie (błędne parametry) |
| 401 | Unauthorized | Brak autoryzacji lub nieprawidłowy token |
| 404 | Not Found | Zasób nie znaleziony |
| 422 | Unprocessable Entity | Błąd walidacji danych |
| 500 | Internal Server Error | Błąd serwera |