Skip to main content

API интеграция

Обзор API​

TDS.SO предоставляет REST API для программного управления всеми функциями системы. API поддерживает создание редиректов, управление доменами, получение статистики и другие операции.

Базовый URL​

https://dashboard.tds.so/api/v2/

Аутентификация​

Все запросы к API должны содержать параметр token - ваш API ключ, который можно получить в разделе настроек панели.

Важно

Храните API ключ в безопасном месте и не передавайте его третьим лицам.

Методы API​

Создание шаблона​

Endpoint: POST /create/template

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
setting_nameДаstringНазвание шаблона
setting_descriptionНетstringОписание шаблона
redirect_typeНетstringТип редиректа (meta, js, 301, 302, iframe и др.)
redirect_delayНетintegerЗадержка редиректа (1-10 сек)
POST /api/v2/create/template
token=your_api_key&setting_name=Test_Template&redirect_type=meta

Создание редиректа​

Endpoint: POST /create/redirect

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
redirect_domainsДаstringДомены для редиректа (через запятую)
link_listsДаstringЦелевые URL (через запятую)
templateНетstring/intID или название шаблона
POST /api/v2/create/redirect
token=your_api_key&redirect_domains=domain1.com,domain2.com&link_lists=https://target1.com

Получение данных​

Список ссылок​

Endpoint: GET /get/links

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
offsetНетintegerКоличество записей (1-100)
template_idНетintegerID шаблона

Список доменов​

Endpoint: GET /get/domains

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
template_idНетintegerID шаблона

Управление доменами​

Проверка доменов​

Endpoint: POST /domains/check

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
domains_listДаstringСписок доменов через запятую
check_vkНетbooleanПроверка бана ВК

Удаление доменов​

Endpoint: POST /domains/delete

Параметры:

ПараметрОбязательныйТипОписание
tokenДаstringAPI ключ
domains_listДаstringСписок доменов через запятую

Обработка ошибок​

Все ошибки возвращаются в формате JSON с полями error и error_id:

{
  "error": "Invalid token",
  "error_id": 2
}

Коды ошибок​

error_idОписание
0Закончился срок панели
1Не заполнено обязательное поле
2Невалидный API ключ
3Неправильное название метода
4Пустой ответ
5Ошибка валидации параметров

Примеры использования​

PHP​

$token = 'your_api_key';
$url = 'https://dashboard.tds.so/api/v2/create/template';

$data = [
    'token' => $token,
    'setting_name' => 'Test Template',
    'redirect_type' => 'meta'
];

$response = file_get_contents($url . '?' . http_build_query($data));
$result = json_decode($response, true);

Python​

import requests

token = 'your_api_key'
url = 'https://dashboard.tds.so/api/v2/create/template'

data = {
    'token': token,
    'setting_name': 'Test Template',
    'redirect_type': 'meta'
}

response = requests.post(url, data=data)
result = response.json()

JavaScript​

const token = 'your_api_key';
const url = 'https://dashboard.tds.so/api/v2/create/template';

const data = {
    token: token,
    setting_name: 'Test Template',
    redirect_type: 'meta'
};

fetch(url + '?' + new URLSearchParams(data))
    .then(response => response.json())
    .then(result => console.log(result));

Рекомендации по использованию​

  1. Обработка ошибок
  • Всегда проверяйте наличие поля error в ответе
  • Добавьте повторные попытки для сетевых ошибок
  • Используйте таймауты для запросов
  1. Оптимизация
  • Кэшируйте результаты где возможно
  • Группируйте запросы при массовых операциях
  • Используйте пагинацию для больших списков
  1. Безопасность
  • Храните API ключ в защищенном месте
  • Используйте HTTPS для всех запросов
  • Ограничьте доступ к API ключу
Совет

Начните с тестирования API в небольшом масштабе, прежде чем внедрять его в производственную среду.