Witamy w API Swawola

Witaj w dokumentacji API Swawola. Znajdziesz tutaj wszystkie informacje potrzebne do integracji z naszym systemem.

Funkcje

• Architektura RESTful z intuicyjnymi endpointami
• Bezpieczne uwierzytelnianie za pomocą kluczy API (X-API-KEY i X-API-SECRET)
• Kompleksowa obsługa błędów i kodów statusu
• Limity żądań zapewniające sprawiedliwe użytkowanie

Pierwsze żądanie

Oto prosty przykład wykonania żądania GET w celu przetestowania połączenia z API:

curl -X GET "https://swawola.pl/api/hello" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json"

const API_KEY = 'your_api_key_here';
const API_SECRET = 'your_api_secret_here';

fetch('https://swawola.pl/api/hello', {
  method: 'GET',
  headers: {
    'X-API-KEY': API_KEY,
    'X-API-SECRET': API_SECRET,
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

<?php
$apiKey = 'your_api_key_here';
$apiSecret = 'your_api_secret_here';

$ch = curl_init('https://swawola.pl/api/hello');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: ' . $apiKey,
    'X-API-SECRET: ' . $apiSecret,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "Error: " . $httpCode;
}
?>

Otrzymasz odpowiedź JSON z wiadomością powitalną:

{
  "user": "Jan Kowalski",
  "email": "jan.kowalski@example.com",
  "message": "Hello from Swawola API"
}

Sprawdź endpoint GET /hello aby uzyskać więcej szczegółów.

Szybki start

Uruchom API Swawola w kilka minut. Wykonaj poniższe kroki, aby wykonać swoje pierwsze pomyślne wywołanie API.

Krok 1: Uzyskaj klucze API

Zarejestruj konto i wygeneruj parę kluczy API (API Key i API Secret) z panelu. Twoje klucze API służą do uwierzytelniania wszystkich żądań.

Krok 2: Wykonaj pierwsze żądanie

Możesz użyć dowolnego klienta HTTP. Oto przykłady dla popularnych języków programowania:

const API_KEY = 'your_api_key_here';
const API_SECRET = 'your_api_secret_here';
const BASE_URL = 'https://swawola.pl/api/';

fetch(`${BASE_URL}hello`, {
  method: 'GET',
  headers: {
    'X-API-KEY': API_KEY,
    'X-API-SECRET': API_SECRET,
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

<?php
$apiKey = 'your_api_key_here';
$apiSecret = 'your_api_secret_here';
$baseUrl = 'https://swawola.pl/api/';

$ch = curl_init($baseUrl . 'hello');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: ' . $apiKey,
    'X-API-SECRET: ' . $apiSecret,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "Error: " . $httpCode;
}
?>

Krok 3: Obsługa odpowiedzi

Wszystkie odpowiedzi są zwracane w formacie JSON. Pamiętaj o odpowiedniej obsłudze błędów poprzez sprawdzanie kodów statusu.

Uwierzytelnianie za pomocą kluczy API

Swawola używa pary kluczy API (API Key i API Secret) do uwierzytelniania żądań. Dołącz oba klucze w nagłówkach każdego żądania.

Uzyskanie kluczy API

Możesz wygenerować parę kluczy API (API Key i API Secret) z panelu po zarejestrowaniu się. Każda para kluczy jest unikalna i powinna być przechowywana w bezpiecznym miejscu.

Użycie kluczy API

Dołącz swoje klucze API w nagłówkach X-API-KEY i X-API-SECRET:

X-API-KEY: your_api_key_here
X-API-SECRET: your_api_secret_here

Oto pełny przykład:

curl -X GET "https://swawola.pl/api/rooms" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json"

Uwierzytelnianie

Ten endpoint wymaga uwierzytelnienia. Dołącz swoje klucze API w nagłówkach X-API-KEY i X-API-SECRET.

Przykładowe żądanie

curl -X GET "https://swawola.pl/api/hello" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json"

const API_KEY = 'your_api_key_here';
const API_SECRET = 'your_api_secret_here';

fetch('https://swawola.pl/api/hello', {
  method: 'GET',
  headers: {
    'X-API-KEY': API_KEY,
    'X-API-SECRET': API_SECRET,
    'Content-Type': 'application/json'
  }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

<?php
$apiKey = 'your_api_key_here';
$apiSecret = 'your_api_secret_here';

$ch = curl_init('https://swawola.pl/api/hello');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: ' . $apiKey,
    'X-API-SECRET: ' . $apiSecret,
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200) {
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "Error: " . $httpCode;
}
?>

Przykładowa odpowiedź

{
  "user": "Jan Kowalski",
  "email": "jan.kowalski@example.com",
  "message": "Hello from Swawola API"
}

Struktura odpowiedzi

Uwierzytelnianie

Ten endpoint wymaga uwierzytelnienia. Dołącz swoje klucze API w nagłówkach X-API-KEY i X-API-SECRET.

Przykładowe żądanie

curl -X GET "https://swawola.pl/api/rooms" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json"

Przykładowa odpowiedź

                                [
    {
        "title": "Dom z bajki",
        "user_rooms": [
            {
                "title": "pokój w domku z bajki",
                "uuid": "945a5b47-1729-4fd7-96de-XXXXXXXXXXXX",
                "status": "draft"
            }
        ]
    },
    {
        "title": "Domek letniskowy na kempingu",
        "user_rooms": [
            {
                "title": "Domek letniskowy",
                "uuid": "d9b3a6d5-6ff5-4d42-8957-XXXXXXXXXXXX",
                "status": "publish"
            },
            {
                "title": "Domek letniskowy 2",
                "uuid": "d9b3a6d5-6ff5-4d42-8957-XXXXXXXXXXXX",
                "status": "publish"
            }
        ]
    }
]
                            

Struktura odpowiedzi

Parametry zapytania (query)

Uwierzytelnianie

Ten endpoint wymaga uwierzytelnienia. Dołącz swoje klucze API w nagłówkach X-API-KEY i X-API-SECRET.

Przykładowe żądanie

curl -X GET "https://swawola.pl/api/availability?uuid=945a5b47-1729-4fd7-96de-fce8272ba8bf&start_date=2025-10-16&end_date=2025-10-29" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json"

Przykładowa odpowiedź

[
  {
    "date": "2025-10-16",
    "available": true
  },
  {
    "date": "2025-10-17",
    "available": false
  },
  {
    "date": "2025-10-18",
    "available": true
  },
  {
    "date": "2025-10-19",
    "available": true
  },
  {
    "date": "2025-10-20",
    "available": true
  },
  {
    "date": "2025-10-21",
    "available": true
  },
  {
    "date": "2025-10-22",
    "available": true
  },
  {
    "date": "2025-10-23",
    "available": true
  },
  {
    "date": "2025-10-24",
    "available": true
  }
]

Struktura odpowiedzi

Możliwe błędy

Parametry JSON (Body)

Uwierzytelnianie

Ten endpoint wymaga uwierzytelnienia. Dołącz swoje klucze API w nagłówkach X-API-KEY i X-API-SECRET.

Przykładowe żądanie - Typ 1 (cena za pokój)

curl -X POST "https://swawola.pl/api/set-availability" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "945a5b47-1729-4fd7-96de-fce8272ba8bf",
    "checkout_type": 1,
    "price": 250,
    "available": true,
    "start_date": "2025-12-01",
    "end_date": "2025-12-10"
  }'

Przykładowe żądanie - Typ 2 (cena według wieku)

curl -X POST "https://swawola.pl/api/set-availability" \
  -H "X-API-KEY: your_api_key_here" \
  -H "X-API-SECRET: your_api_secret_here" \
  -H "Content-Type: application/json" \
  -d '{
    "uuid": "945a5b47-1729-4fd7-96de-fce8272ba8bf",
    "checkout_type": 2,
    "price_adults": 300,
    "price_children": 150,
    "price_newborns": 50,
    "min_price": 200,
    "available": true,
    "start_date": "2025-12-01",
    "end_date": "2025-12-10"
  }'

Przykładowa odpowiedź

{"success": "Availability updated successfully"}

Możliwe błędy

Kody błędów

Swawola używa standardowych kodów statusu HTTP, aby wskazać powodzenie lub niepowodzenie żądań API.

Kody statusu HTTP