Мощный и простой REST API

Интегрируйте, автоматизируйте и доставляйте с уверенностью.

Отправляйте SMS, совершайте звонки с подменой номера, проверяйте баланс и получайте актуальные цены из своего кода. Пять эндпоинтов, один ключ, JSON на входе и выходе — те же цены и баланс, что и в кабинете.

Песочница API

ЗАПРОС

curl https://app.spoofcallerid.com/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
curl https://app.spoofcallerid.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
curl https://app.spoofcallerid.com/v1/prices?type=all \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
curl -X POST https://app.spoofcallerid.com/v1/sms \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "text": "Your code is 4821",
    "sender_id": "Spoof",
    "country": "GB"
  }'
curl -X POST https://app.spoofcallerid.com/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "caller_id": "+18005550199",
    "to_country": "GB",
    "record": false
  }'
curl -X POST https://app.spoofcallerid.com/v1/sms \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "text": "Your code is 4821",
    "sender_id": "Spoof",
    "country": "GB"
  }'

ОТВЕТ

{
    "id": 1042,
    "username": "you",
    "email": "[email protected]",
    "balance": 25.5,
    "currency": "EUR",
    "status": "active"
}
{
    "balance": 25.5,
    "currency": "EUR"
}
{
    "success": true,
    "type": "all",
    "count": 200,
    "cached_ttl": 3600,
    "data": [
        {
            "country": "United Kingdom",
            "iso": "GB",
            "prefix": "44",
            "call": 0.1,
            "call_initblock": 1,
            "call_billingblock": 1,
            "call_tiers": [
                {
                    "rate": 0.1,
                    "routes": 1
                },
                {
                    "rate": 0.4,
                    "routes": 1
                },
                {
                    "rate": 0.85,
                    "routes": 1
                }
            ],
            "sms": 0.0906,
            "sms_routes": [
                {
                    "name": "Route 1",
                    "rate": 0.0906
                },
                {
                    "name": "Route 2",
                    "rate": 0.0924
                }
            ],
            "hlr": null,
            "currency": "EUR"
        }
    ]
}
{
    "success": true,
    "message": "SMS sent successfully.",
    "data": {
        "cost": 0.0906,
        "newBalance": 25.4094,
        "segments": 1,
        "encoding": "gsm7",
        "route": "",
        "batchId": "7f3c2a91"
    }
}
{
    "success": true,
    "message": "Call placed successfully.",
    "data": {
        "id": 318,
        "status": "dialing",
        "cost": 0.5,
        "newBalance": 25.0,
        "currentBalance": 25.0,
        "estimatedMinutes": 5,
        "toNumber": "+447700900123",
        "displayNumber": "+18005550199",
        "ami_ref": "spoof_1042_1763190000"
    }
}
{
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient balance.",
        "details": {
            "cost": 0.0906,
            "balance": 0.02
        }
    }
}
Важное уведомление о безопасности

Храните API-ключ и секрет в тайне. Используйте их только на своём сервере и никогда — в клиентском коде. В случае утечки сгенерируйте их заново в разделе «Аккаунт → API и ключи» — старая пара сразу перестанет работать.

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

Каждый запрос передаёт ваш ключ и секрет в одном заголовке через двоеточие. Запросы и ответы — JSON по HTTPS.

Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET

Базовый URL: https://app.spoofcallerid.com/v1

Данные аккаунта
GET /v1/me

Возвращает аккаунт, которому принадлежит ключ: id, имя пользователя, email, баланс и статус.

curl https://app.spoofcallerid.com/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
{
    "id": 1042,
    "username": "you",
    "email": "[email protected]",
    "balance": 25.5,
    "currency": "EUR",
    "status": "active"
}
Баланс
GET /v1/balance

Ваш текущий баланс в евро. Запрос дешёвый — выполните его перед крупной отправкой.

curl https://app.spoofcallerid.com/v1/balance \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
{
    "balance": 25.5,
    "currency": "EUR"
}
Цены
GET /v1/prices

Актуальные цены на звонки и SMS по всем направлениям — тот же список, что в разделе «Покрытие и цены». Кешируется на один час.

Параметры:
  • type: необязательно. all (по умолчанию), sms или voice.
curl https://app.spoofcallerid.com/v1/prices?type=all \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET"
{
    "success": true,
    "type": "all",
    "count": 200,
    "cached_ttl": 3600,
    "data": [
        {
            "country": "United Kingdom",
            "iso": "GB",
            "prefix": "44",
            "call": 0.1,
            "call_initblock": 1,
            "call_billingblock": 1,
            "call_tiers": [
                {
                    "rate": 0.1,
                    "routes": 1
                },
                {
                    "rate": 0.4,
                    "routes": 1
                },
                {
                    "rate": 0.85,
                    "routes": 1
                }
            ],
            "sms": 0.0906,
            "sms_routes": [
                {
                    "name": "Route 1",
                    "rate": 0.0906
                },
                {
                    "name": "Route 2",
                    "rate": 0.0924
                }
            ],
            "hlr": null,
            "currency": "EUR"
        }
    ]
}
Отправка SMS
POST /v1/sms

Отправляет одно SMS с выбранным вами Sender ID и списывает средства с баланса за каждый сегмент сообщения.

Параметры:
  • to: обязательно. Номер получателя с кодом страны, например +447700900123.
  • text: обязательно. Текст сообщения, до 160 символов.
  • sender_id: обязательно. Имя или номер отправителя, 1–20 букв или цифр.
  • country: необязательно. ISO-код страны (например, GB), если в to нет кода страны.
  • route: необязательно. Конкретный маршрут для направления; по умолчанию используется самый дешёвый.
curl -X POST https://app.spoofcallerid.com/v1/sms \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "text": "Your code is 4821",
    "sender_id": "Spoof",
    "country": "GB"
  }'
{
    "success": true,
    "message": "SMS sent successfully.",
    "data": {
        "cost": 0.0906,
        "newBalance": 25.4094,
        "segments": 1,
        "encoding": "gsm7",
        "route": "",
        "batchId": "7f3c2a91"
    }
}
Звонок с подменой номера
POST /v1/calls

Совершает звонок с выбранным вами номером звонящего. Ориентировочная стоимость резервируется на балансе в момент начала звонка.

Параметры:
  • to: обязательно. Номер для звонка в международном формате или в местном вместе с to_country.
  • caller_id: обязательно. Номер, который увидит вызываемый абонент.
  • to_country: необязательно. ISO-код страны для to, например GB.
  • caller_country: необязательно. ISO-код страны для caller_id.
  • record: необязательно. true — записать звонок. По умолчанию false.
  • plan: необязательно. ID тарифа звонка. Каждый тариф тарифицирует по своей цене и шагу; по умолчанию Worldwide.
curl -X POST https://app.spoofcallerid.com/v1/calls \
  -H "Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+447700900123",
    "caller_id": "+18005550199",
    "to_country": "GB",
    "record": false
  }'
{
    "success": true,
    "message": "Call placed successfully.",
    "data": {
        "id": 318,
        "status": "dialing",
        "cost": 0.5,
        "newBalance": 25.0,
        "currentBalance": 25.0,
        "estimatedMinutes": 5,
        "toNumber": "+447700900123",
        "displayNumber": "+18005550199",
        "ami_ref": "spoof_1042_1763190000"
    }
}
Ошибки
4xx / 5xx

При любой ошибке возвращается указанный ниже HTTP-статус и JSON-тело с постоянным error.code, на который можно опираться в логике.

  • invalid_request 400 — тело запроса не является корректным JSON или у поля неверный тип.
  • unauthorized 401 — заголовок Authorization отсутствует, имеет неверный формат или ключ/секрет неверны.
  • insufficient_balance 402 — на балансе недостаточно средств. В error.details указаны стоимость и баланс.
  • not_found 404 — такого эндпоинта нет. Проверьте путь и префикс /v1.
  • method_not_allowed 405 — неверный HTTP-метод; правильный указан в заголовке Allow.
  • validation_failed 422 — поле отсутствует или некорректно; какое именно, указано в error.message.
  • internal_error 500 — сбой на нашей стороне. Повторите запрос, затем обратитесь в поддержку.
  • provider_rejected 502 — оператор отклонил сообщение или звонок; средства не списаны.
  • service_unavailable 503 — зависимый сервис временно недоступен. Повторите запрос с увеличивающейся задержкой.
{
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient balance.",
        "details": {
            "cost": 0.0906,
            "balance": 0.02
        }
    }
}
Подключите ИИ-ассистента (MCP)
5 tools

MCP-сервер Spoofcallerid превращает каждый эндпоинт в инструмент для Claude или любого MCP-клиента: get_account, get_balance, get_prices, send_sms и make_spoof_call. Один файл, без зависимостей, Node.js 18+. Два инструмента, расходующие баланс, сначала запрашивают подтверждение.

Скачать MCP-сервер · JSON-манифест

{
    "mcpServers": {
        "spoofcallerid": {
            "command": "node",
            "args": [
                "/path/to/spoofcallerid-mcp.mjs"
            ],
            "env": {
                "SPOOFCALLERID_API_KEY": "YOUR_API_KEY:YOUR_API_SECRET"
            }
        }
    }
}

Часто задаваемые вопросы

Где получить API-ключ?
Войдите в кабинет и откройте «Аккаунт → API и ключи». При повторной генерации создаются новые ключ и секрет; секрет показывается один раз, а старая пара сразу перестаёт работать.
Как пройти аутентификацию?
Передавайте Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET в каждом запросе. Храните секрет на своём сервере — никогда в браузере или мобильном приложении.
Сколько стоит запрос?
Получение данных аккаунта, баланса и цен бесплатно. POST /v1/sms и POST /v1/calls списывают средства по тем же ценам, что и в кабинете, — они указаны в разделе «Покрытие и цены» и в GET /v1/prices.
Какой длины может быть SMS?
До 160 символов за запрос. Текст в GSM-7 помещается в один сегмент по 160 символов; эмодзи или нелатинские буквы переключают кодировку на Unicode — 70 символов на сегмент, и каждый сегмент оплачивается.
Может ли ИИ-ассистент использовать API?
Да. Скачайте MCP-сервер Spoofcallerid, укажите свой ключ — и Claude или любой MCP-клиент сможет проверять баланс и цены, отправлять SMS и совершать звонки. Инструменты, расходующие средства, сначала запрашивают подтверждение.