Приклади коду
Приклади cURL
Запит на вхід
curl -X POST https://landlordkeeper.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "password": "YourPassword123"}'
Отримати профіль
curl -X GET https://landlordkeeper.com/api/v1/user/profile \
-H "Authorization: Bearer YOUR_JWT_TOKEN"
Оновити профіль
curl -X PUT https://landlordkeeper.com/api/v1/user/profile \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-d '{"name": "New Name", "phone": "+380501234567"}'
Приклади JavaScript
Функція входу
// Login and get token
async function login(email, password) {
const response = await fetch('/api/v1/auth/login', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({ email, password }),
});
if (!response.ok) {
throw new Error('Login failed');
}
const data = await response.json();
localStorage.setItem('token', data.token);
return data.token;
}
Хелпер для автентифікованих запитів
// Make authenticated request
async function apiRequest(endpoint, options = {}) {
const token = localStorage.getItem('token');
const response = await fetch(`/api${endpoint}`, {
...options,
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`,
...options.headers,
},
});
if (response.status === 401) {
// Token expired - redirect to login
localStorage.removeItem('token');
window.location.href = '/login';
return;
}
return response.json();
}
// Usage
const profile = await apiRequest('/user/profile');
console.log(profile);
Приклади PHP
Використання Guzzle HTTP клієнта
<?php
use GuzzleHttp\Client;
$client = new Client(['base_uri' => 'https://landlordkeeper.com']);
// Login
$response = $client->post('/api/v1/auth/login', [
'json' => [
'email' => '[email protected]',
'password' => 'YourPassword123',
],
]);
$data = json_decode($response->getBody(), true);
$token = $data['token'];
// Get profile
$response = $client->get('/api/v1/user/profile', [
'headers' => [
'Authorization' => 'Bearer ' . $token,
],
]);
$profile = json_decode($response->getBody(), true);
print_r($profile);
Приклади Python
Використання бібліотеки requests
import requests
BASE_URL = "https://landlordkeeper.com"
# Login
response = requests.post(f"{BASE_URL}/api/v1/auth/login", json={
"email": "[email protected]",
"password": "YourPassword123"
})
token = response.json()["token"]
# Get profile
headers = {"Authorization": f"Bearer {token}"}
response = requests.get(f"{BASE_URL}/api/v1/user/profile", headers=headers)
profile = response.json()
print(profile)
# Update profile
response = requests.put(
f"{BASE_URL}/api/v1/user/profile",
headers=headers,
json={"name": "New Name"}
)
print(response.json())
Типовий робочий процес
Ось типовий робочий процес використання API:
1
Зареєструйтесь або увійдіть
Створіть новий акаунт або увійдіть з існуючими даними для отримання JWT-токена.
2
Збережіть токен
Збережіть JWT-токен у безпечному місці вашого додатку (localStorage, захищений cookie тощо).
3
Виконуйте API-запити
Включайте токен у заголовок Authorization для всіх захищених ендпоінтів.
4
Обробляйте закінчення токена
При отриманні помилки 401 перенаправте користувача на сторінку входу для отримання нового токена.