SafeBase API Документация

Описание: Проверяет пользователя по его Telegram ID, возвращая информацию о его статусе и репутации в базе данных SafeBase. Требуется действительный API ключ в заголовке запроса.

Параметры:

• user_id (path, required): Telegram ID пользователя (целое число).
• api-key (header, required): Действительный API ключ.

Пример отправки запроса:

import requests

url = "https://safebase.site/api/check/1234567890"
headers = {"api-key": "your_api_key"}
response = requests.post(url, headers=headers)
print(response.json())

Пример ответа (пользователь - скамер):

{
    "exists": true,
    "status": "scam",
    "reputation": "🚨 Скамер",
    "description": "Известный мошенник",
    "search_count": 5,
    "warnings": 2,
    "checked_at": "2025-06-21 09:53:44"
}

Пример ответа (пользователь - админ):

{
    "exists": true,
    "status": "admin",
    "reputation": "Админ базы ✅",
    "description": null,
    "search_count": 3,
    "warnings": 0,
    "checked_at": "2025-06-21 09:53:44"
}

Возможные статусы:

• scam: Пользователь помечен как скамер.
• admin: Пользователь является администратором базы.
• garant: Пользователь является гарантом базы.
• none: Пользователь не найден в базе данных.

Коды ошибок:

• 401: Неверный или неактивный API ключ.

Описание: Возвращает список всех пользователей с меткой скамера из базы. Поддерживает опциональный параметр reputation для фильтрации по репутации (см. Коды репутаций). Требуется действительный API ключ в заголовке запроса.

Параметры:

• reputation (query, optional): Фильтр по репутациям (0, 1, 2, 3).
• api-key (header, required): Действительный API ключ.

Пример отправки запроса (все скамеры):

import requests

url = "https://safebase.site/api/scammers"
headers = {"api-key": "your_api_key"}
response = requests.get(url, headers=headers)
print(response.json())

Пример отправки запроса (скамеры с репутацией СКАММЕР):

import requests

url = "https://safebase.site/api/scammers?reputation=2"
headers = {"api-key": "your_api_key"}
response = requests.get(url, headers=headers)
print(response.json())

Пример ответа:

[
    {
        "user_id": 6677376689,
        "label": "scam",
        "warnings": 2,
        "description": "Украл 15 звёзд",
        "search_count": 5,
        "last_search": "2025-06-21 09:53:44"
    },
    {
        "user_id": 6837376462,
        "label": "scam",
        "warnings": 2,
        "description": "Обман на подарки",
        "search_count": 3,
        "last_search": "2025-06-20 15:30:22"
    }
]

Коды ошибок:

• 401: Неверный или неактивный API ключ.

Пояснение: Коды репутаций дают понять определение скамера (при "label": "scam"). Обозначаются цифрами от 0 до 3 в строке "warnings"

• 0 - Плохая репутация
• 1 - Потенциальный скамер
• 2 - СКАММЕР
• 3 - Петух