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

Статус API

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

Что даёт интеграция

Телефон

Поиск по номеру телефона через доступные модули и источники.

Карты / BIN

Проверка BIN, банка‑эмитента и базовой информации по карте.

IP

Геолокация, провайдер и базовая информация по IP‑адресу.

Email

Проверка по утечкам и связанным сервисам, если доступны.

ФИО

Поиск по открытым и агрегированным источникам при наличии модулей.

VIN / авто

Данные по VIN и базовая информация по транспортному средству (если поддерживается).

Базовый эндпоинт

POST

/api/v1/search

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

Параметры запроса (тело JSON)

phone optional

Номер телефона в международном формате (+7XXXXXXXXXX).

card optional

Номер банковской карты или BIN для проверки.

ip optional

IP‑адрес для базового анализа.

email optional

Email для проверки по утечкам и связанным сервисам.

vin optional

VIN автомобиля.

inn optional

ИНН физического или юридического лица (если поддерживается на вашем уровне доступа).

fullname optional

ФИО для поиска.

tg optional

Telegram username (@username).

time optional

Режим поиска (например, "fast" для ускоренного ответа, если доступен).

key required

Ваш приватный API‑ключ. Выдаётся после согласования доступа.

// Пример тела запроса
{
  "phone": "+79991234567",
  "email": "[email protected]",
  "time": "fast",
  "key": "YOUR_API_KEY"
}

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

cURL

Телефон + email

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

curl -X POST https://your-endpoint.example.com/api/v1/search \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "+79991234567",
    "email": "[email protected]",
    "key": "YOUR_API_KEY"
  }'

Python

Базовый запрос

import requests

url = "https://your-endpoint.example.com/api/v1/search"
data = {
    "phone": "+79991234567",
    "key": "YOUR_API_KEY"
}

response = requests.post(url, json=data, timeout=30)
print(response.status_code)
print(response.json())

JavaScript

Fetch

const response = await fetch('https://your-endpoint.example.com/api/v1/search', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    phone: '+79991234567',
    key: 'YOUR_API_KEY'
  })
});

if (!response.ok) {
  throw new Error('Request failed');
}

const data = await response.json();

Доступ, ключи и лимиты

Приватное API

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

Лимиты

Базовые лимиты по запросам и скорости зависят от согласованного тарифа и могут быть изменены в одностороннем порядке.

Авторизация

Ключ передаётся в теле запроса (поле key). Распространение ключа третьим лицам запрещено.

Ошибки и блокировки

При превышении лимитов или нарушении политики возможны ответы 429/403 и временная или постоянная блокировка ключа.

Пример

Авторизованный запрос

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

{
  "phone": "+79991234567",
  "key": "your_api_key_here"
}

Как запросить доступ

Для получения приватного API‑доступа напишите в поддержку через Telegram: @cryvensupport или канал @cryvenbiz. В сообщении кратко опишите ваш кейс, предполагаемые объёмы запросов и требования к SLA.