API Документация
REST API для интеграции с вашими приложениями
Общая информация
Base URL
https://linkslot.cc/api/v1
Format
JSON (UTF-8)
Authentication
Bearer Token в заголовке
Authorization: Bearer ls_ваш_ключ
Rate Limit
10 запросов в минуту на ключ
Аутентификация
Все запросы к API требуют API-ключ в заголовке Authorization.
# Пример запроса с curl
curl -H "Authorization: Bearer ls_ваш_ключ" \
https://linkslot.cc/api/v1/balance
# Пример на PHP
$ch = curl_init('https://linkslot.cc/api/v1/balance');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ls_ваш_ключ'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
Коды ошибок
| Код | Описание |
|---|---|
| 401 | API-ключ отсутствует или недействителен |
| 403 | Нет доступа (неверный тип аккаунта) |
| 404 | Ресурс не найден |
| 429 | Превышен лимит запросов |
| 500 | Внутренняя ошибка сервера |
GET
/api/v1/balance
Текущий баланс и информация об аккаунте.
{
"success": true,
"data": {
"balance": 125.5000,
"account_type": "both",
"name": "Иван",
"email": "ivan@example.com",
"registered_at": "2025-01-15 10:30:00"
}
}
GET
/api/v1/stats/publisher
Сводная статистика вебмастера.
Query-параметры: period = 1day | 3days | 7days | 14days | 30days | 90days (по умолчанию: 7days)
{
"success": true,
"period": "7days",
"data": {
"clicks": 1250,
"earnings": 89.5000,
"active_websites": 5,
"active_slots": 12,
"avg_cpc": 0.0716,
"daily_avg": 12.7857
}
}
GET
/api/v1/stats/publisher/daily
Ежедневная разбивка кликов и дохода вебмастера.
Query-параметры: period
{
"success": true,
"period": "7days",
"data": [
{ "date": "2025-06-07", "clicks": 180, "earnings": 12.5000 },
{ "date": "2025-06-08", "clicks": 195, "earnings": 14.2000 },
...
]
}
GET
/api/v1/stats/publisher/sites
Статистика по каждому сайту вебмастера.
Query-параметры: period
{
"success": true,
"period": "7days",
"data": [
{
"id": 1,
"domain": "example.com",
"status": "active",
"clicks": 450,
"earnings": 32.1000,
"slots": 3
},
...
]
}
GET
/api/v1/stats/advertiser
Сводная статистика рекламодателя.
Query-параметры: period
{
"success": true,
"period": "7days",
"data": {
"clicks": 3200,
"spend": 256.0000,
"total_campaigns": 8,
"avg_cpc": 0.0800,
"daily_avg": 36.5714
}
}
GET
/api/v1/stats/advertiser/daily
Ежедневная разбивка кликов и расхода рекламодателя.
Query-параметры: period
{
"success": true,
"period": "7days",
"data": [
{ "date": "2025-06-07", "clicks": 450, "spend": 36.0000 },
...
]
}
GET
/api/v1/stats/advertiser/campaigns
Статистика по каждой кампании рекламодателя.
Query-параметры: period
{
"success": true,
"period": "7days",
"data": [
{
"id": 1,
"name": "Летняя кампания",
"status": "active",
"type": "banner",
"budget": 500.0000,
"clicks": 1200,
"spend": 96.0000
},
...
]
}
Ограничения (Rate Limiting)
Каждый API-ключ имеет лимит запросов в минуту (по умолчанию: 10 запросов/мин).
При превышении лимита API вернёт ошибку 429 Too Many Requests.
{
"error": "Rate limit exceeded. Максимум 10 запросов в минуту.",
"code": 429
}