Обзор Быстрый старт Эндпоинты Ошибки Примеры кода

Мощный поисковый API нового поколения

AirHunter API предоставляет продвинутые возможности поиска по миллионам записей. Интегрируйте мощный поиск в ваши приложения за считанные минуты.

Начать использование Примеры кода
99.9%
Аптайм
<100мс
Средний ответ
24/7
Поддержка
2 типа
Поиска

Возможности API

Мгновенный поиск

Высокоскоростной поиск по огромным объемам данных с минимальной задержкой ответа.

Защита и надежность

Защищенное соединение, DDoS защита и резервное копирование данных.

Гибкие типы поиска

Поиск по Telegram или полный поиск по всем типам утечек (leak).

Простая интеграция

Четкая документация, готовые примеры кода и быстрый старт.

Базовый URL

https://api.atlas-in.cc/air

Все запросы к API отправляются на этот базовый адрес методом POST. Для авторизации используется токен.

Быстрый старт

Формат запроса

Все запросы к API должны быть в формате JSON и отправляться методом POST с заголовком Content-Type: application/json.

HTTP Запрос
POST /air HTTP/1.1
Host: api.atlas-in.cc
Content-Type: application/json
Content-Length: 123

{
  "token": "ваш_api_токен",
  "type": "telegram", // или "leak" для всех типов утечек
  "search": "ваш_поисковый_запрос"
}

Параметр token

Обязательный - ваш уникальный API ключ для авторизации запросов.

Параметр type

Обязательный - тип поиска: "telegram" или "leak" для всех утечек.

Параметр search

Обязательный - поисковый запрос (телефон, email, имя и т.д.)

Эндпоинты API

POST

/air

Основной эндпоинт для выполнения поисковых запросов. Возвращает результаты поиска в зависимости от указанного типа.

Пример успешного ответа:

JSON Ответ
{
  "status": "success",
  "query": {
    "type": "telegram",
    "search": "+79161234567"
  },
  "results": [
    {
      "id": 12345,
      "source": "telegram",
      "match": "Найден пользователь с номером +79161234567...",
      "date": "2023-10-15T14:30:00Z",
      "confidence": 0.95
    }
  ],
  "total": 1,
  "time": 0.087
}

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

API возвращает стандартные HTTP коды статусов и подробные сообщения об ошибках в формате JSON для легкой отладки.

Неверный токен

HTTP 401 Unauthorized

Возникает при использовании несуществующего, недействительного или просроченного API токена.

{
  "error": "token not found",
  "code": 401,
  "message": "Неверный или отсутствующий API токен"
}

Неверный тип

HTTP 400 Bad Request

Возникает при указании недопустимого значения в параметре "type". Допустимые значения: "telegram", "leak".

{
  "error": "type not found",
  "code": 400,
  "message": "Неверный тип поиска. Используйте 'telegram' или 'leak'"
}

Другие ошибки API

400 Bad Request

Неверный формат запроса, отсутствие обязательных полей или неверный JSON.

429 Too Many Requests

Превышен лимит запросов для вашего токена. Попробуйте позже или увеличьте лимит.

500 Internal Server Error

Внутренняя ошибка сервера. Свяжитесь с поддержкой если ошибка повторяется.

Примеры кода

Python

Пример использования AirHunter API на Python с библиотекой requests и обработкой ошибок.

Python 3
# AirHunter API - Python пример # Установите библиотеку requests: pip install requests

import requests
import json

class AirHunterAPI:
  def __init__(self, token):
    self.base_url = "https://api.atlas-in.cc/air"
    self.token = token
    self.headers = {
      "Content-Type": "application/json"
    }

  def search(self, search_type, query):
    """Выполняет поисковый запрос"""
    data = {
      "token": self.token,
      "type": search_type, # "telegram" или "leak"
      "search": query
    }

    try:
      response = requests.post(
        self.base_url,
        json=data,
        headers=self.headers,
        timeout=30
      )
      response.raise_for_status()
      return response.json()
    except requests.exceptions.RequestException as e:
      return {"error": str(e)}

# Использование API if __name__ == "__main__":
  api = AirHunterAPI("ваш_api_токен")
  
  # Поиск в Telegram
  result = api.search("telegram", "+79161234567")
  
  if "error" not in result:
    print(f"Найдено результатов: {result.get('total', 0)}")
    for item in result.get("results", []):
      print(f"• {item.get('match', 'Нет данных')}")
  else:
    print(f"Ошибка: {result['error']}")

JavaScript (Node.js)

// AirHunter API - JavaScript пример (Node.js) // Установите axios: npm install axios

const axios = require('axios');

class AirHunterAPI {
  constructor(token) {
    this.baseUrl = 'https://api.atlas-in.cc/air';
    this.token = token;
  }

  async search(type, query) {
    const data = {
      token: this.token,
      type: type, // 'telegram' или 'leak'
      search: query
    };

    try {
      const response = await axios.post(this.baseUrl, data, {
        headers: { 'Content-Type': 'application/json' }
      });
      return response.data;
    } catch (error) {
      console.error('Ошибка API:', error.response?.data || error.message);
      return { error: error.message };
    }
  }
}

// Использование async function main() {
  const api = new AirHunterAPI('ваш_api_токен');
  const result = await api.search('telegram', '+79161234567');
  
  if (!result.error) {
    console.log(`Найдено результатов: ${result.total}`);
    result.results?.forEach(item => {
      console.log(`• ${item.match}`);
    });
  } else {
    console.error('Ошибка поиска:', result.error);
  }
}

main();

cURL

# AirHunter API - cURL пример # Поиск в Telegram
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
  "token": "ваш_api_токен",
  "type": "telegram",
  "search": "+79161234567"
}' \
  https://api.atlas-in.cc/air

# Поиск во всех утечках (leak)
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
  "token": "ваш_api_токен",
  "type": "leak",
  "search": "example@email.com"
}' \
  https://api.atlas-in.cc/air