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

Что такое API v3?

Продвинутый поисковый API для глубокого поиска информации. Поддерживает постраничный поиск и получение полной информации по record_id.

Методы API v3

searchПоиск по запросу с пагинацией

Пример поиска

HTTP

GET /api/v3?key=KRAMPUS_DEMO_KEY&search=+79991234567&page=1

Параметр Описание

key Ваш API ключ KRAMPUS (обязательно)

search Поисковый запрос (обязательно)

page Номер страницы результатов (по умолчанию: 1)

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

JSON

{
  "success": true,
  "results": [
    {
      "name": "Иванов Иван Иванович",
      "phone": "+79991234567",
      "email": "[email protected]",
      "region": "Москва"
    }
  ]
}

Коды ошибок

401Unauthorized — неверный или истёкший API ключ

400Bad Request — отсутствует параметр 'search'

404Not Found — данные не найдены в базе

500Server Error — внутренняя ошибка сервера

Примеры кода

Python

import requests

url = "http://krampus-ink.icu/api/v3"
params = {
    "key": "YOUR_API_KEY",
    "search": "+79991234567",
    "page": 1
}

response = requests.get(url, params=params)
data = response.json()
print(data)

JavaScript (fetch)

JavaScript

const url = new URL('http://krampus-ink.icu/api/v3');
url.searchParams.set('key', 'YOUR_API_KEY');
url.searchParams.set('search', '+79991234567');
url.searchParams.set('page', '1');

fetch(url)
  .then(res => res.json())
  .then(data => console.log(data))
  .catch(console.error);

cURL

Bash

curl "http://krampus-ink.icu/api/v3?key=YOUR_API_KEY&search=+79991234567&page=1"