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

Обзор API

DateRegBot API предоставляет разработчикам доступ к нашим инструментам определения дат регистрации пользователей Telegram. Наше API позволяет получить информацию о времени регистрации аккаунта с различной точностью, а также получать по username пользователей дополнительную информацию (стандартный resolveUsername).

API построено по принципам REST и возвращает данные в формате JSON. Все запросы должны содержать ваш API-ключ в параметре token.

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

Для использования API вам необходим API-ключ, который необходимо передавать в каждом запросе. API-ключ можно получить в боте @dateregbot в разделе API.

Ваш API-ключ должен оставаться секретным. Не передавайте его третьим лицам и не публикуйте в общедоступных репозиториях кода.

Как использовать API-ключ

Добавляйте ваш API-ключ в параметр token для каждого API-запроса:

Тарифы

API работает по модели pay-as-you-go. Вы платите только за успешно выполненные запросы и можете пополнять баланс на любую сумму от 1$.

Дополнительные методы, сотрудничество

Для высоконагруженных сервисов и B2B доступны индивидуальные тарифы и скидки при больших объёмах запросов, а также возможность получить скрытые методы или разработать индивидуальное решение. Для получения информации о корпоративных тарифах, пожалуйста, свяжитесь с нами: @gitapps или @liteapi.

Методы API

DateRegBot API предоставляет несколько методов. Ниже представлено подробное описание каждого из них.

{
  "user_id": 6362784873,
  "creation_date": "1.2024",
  "accuracy_text": "точная запись (100%)",
  "accuracy_percent": 100
}

{
  "user_id": 7308887716,
  "creation_date": "10.2024",
  "accuracy_text": "высокая (87%)",
  "accuracy_percent": 87
}

{
  "username": "filimono",
  "user_id": 678158951,
  "creation_date": "12.2018",
  "accuracy_text": "высокая (89%)",
  "accuracy_percent": 89
}

{
  "id": 6362784873,
  "is_self": false,
  "contact": false,
  "mutual_contact": false,
  "deleted": false,
  "bot": false,
  "bot_chat_history": false,
  "bot_nochats": false,
  "verified": false,
  "restricted": false,
  "min": false,
  "bot_inline_geo": false,
  "support": false,
  "scam": false,
  "apply_min_photo": true,
  "fake": false,
  "bot_attach_menu": false,
  "premium": true,
  "attach_menu_enabled": false,
  "bot_can_edit": false,
  "close_friend": false,
  "stories_hidden": false,
  "stories_unavailable": true,
  "contact_require_premium": false,
  "bot_business": false,
  "bot_has_main_app": false,
  "access_hash": 249769732980550720,
  "first_name": "Pavel",
  "last_name": null,
  "username": null,
  "phone": null,
  "photo": {
    "photo_id": 5.855126686557915e+18,
    "dc_id": 4,
    "has_video": false,
    "personal": false,
    "stripped_thumb": null
  },
  "status": {
    "by_me": false
  },
  "bot_info_version": null,
  "restriction_reason": null,
  "bot_inline_placeholder": null,
  "lang_code": null,
  "emoji_status": null,
  "usernames": [
    {
      "username": "gitapps",
      "editable": false,
      "active": true
    },
    {
      "username": "pvxdev",
      "editable": true,
      "active": true
    }
  ],
  "stories_max_id": null,
  "color": {
    "color": 12,
    "background_emoji_id": 5.841344801768739e+18
  },
  "profile_color": {
    "color": 12,
    "background_emoji_id": 5.980828026529649e+18
  },
  "bot_active_users": null
}

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

API использует стандартные HTTP коды состояния для индикации успеха или ошибки запроса. В дополнение к коду состояния, в случае ошибки, тело ответа будет содержать объект JSON с подробностями об ошибке.

Коды состояния HTTP

Примеры ошибок

{
  "detail": "Not Found"
}

{
  "detail": "Method not allowed or API key is blocked"
}

{
  "detail": "Insufficient balance"
}

Примеры кода

Ниже приведены примеры использования API на различных языках программирования.

import requests

API_TOKEN = "YOUR_API_TOKEN"
BASE_URL = "https://api.goy.guru/api/v1"

def get_creation_date(user_id):
    url = f"{BASE_URL}/users/getCreationDateSmart"
    params = {
        "token": API_TOKEN,
        "user_id": user_id
    }
    
    response = requests.get(url, params=params)
    data = response.json()
    
    if data["success"]:
        print(f"Дата регистрации: {data['creation_date']}")
        print(f"Точность: {data['accuracy_text']}")
    else:
        print(f"Ошибка: {data['error']['message']}")

get_creation_date(12345678)

const API_TOKEN = "YOUR_API_TOKEN";
const BASE_URL = "https://api.goy.guru/api/v1";

async function getCreationDateByUsername(username) {
    const url = `${BASE_URL}/users/getCreationDateByUsername`;
    const params = new URLSearchParams({
        token: API_TOKEN,
        username: username
    });
    
    try {
        const response = await fetch(`${url}?${params}`);
        const data = await response.json();
        
        if (data.success) {
            console.log(`Пользователь: ${data.username} (ID: ${data.user_id})`);
            console.log(`Дата регистрации: ${data.creation_date}`);
            console.log(`Точность: ${data.accuracy_text}`);
        } else {
            console.error(`Ошибка: ${data.error.message}`);
        }
    } catch (error) {
        console.error("Произошла ошибка при выполнении запроса:", error);
    }
}

getCreationDateByUsername("unbrokensociety");

<?php
$API_TOKEN = "YOUR_API_TOKEN";
$BASE_URL = "https://api.goy.guru/api/v1";

function resolveUsername($username) {
    global $API_TOKEN, $BASE_URL;
    
    $url = $BASE_URL . "/users/resolveUsername";
    $params = [
        "token" => $API_TOKEN,
        "username" => $username
    ];
    
    $url .= "?" . http_build_query($params);
    
    $response = file_get_contents($url);
    $data = json_decode($response, true);
    
    if ($data["success"]) {
        echo "Пользователь: " . $data["username"] . "\n";
        echo "ID: " . $data["user_id"] . "\n";
    } else {
        echo "Ошибка: " . $data["error"]["message"] . "\n";
    }
}

resolveUsername("unbrokensociety");
?>

Лимиты и ограничения

При использовании API, пожалуйса, соблюдайте принципы справедливого использования: не делайте нежелательных и излишних запросов к API; не используйте API для действий, противоречащих условиям использования Telegram или нарушающих законодательство; кэшируйте результаты запросов, когда это возможно. Администрация оставляет за собой право блокировать ключи и аннулировать балансы за нарушение текущих принципов и общепринятых моральных установок.

Поддержка

Мы не гарантируем бесперебойную работу и не компенсируем время простоя. Если у вас возникли вопросы, проблемы при использовании API или вам нужны индивидуальные решения с бесперебойной работой для высоконагруженных сервисов, вы можете связаться с нами: