Мощный и простой 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_request400 — тело запроса не является корректным JSON или у поля неверный тип.unauthorized401 — заголовок Authorization отсутствует, имеет неверный формат или ключ/секрет неверны.insufficient_balance402 — на балансе недостаточно средств. Вerror.detailsуказаны стоимость и баланс.not_found404 — такого эндпоинта нет. Проверьте путь и префикс/v1.method_not_allowed405 — неверный HTTP-метод; правильный указан в заголовкеAllow.validation_failed422 — поле отсутствует или некорректно; какое именно, указано вerror.message.internal_error500 — сбой на нашей стороне. Повторите запрос, затем обратитесь в поддержку.provider_rejected502 — оператор отклонил сообщение или звонок; средства не списаны.service_unavailable503 — зависимый сервис временно недоступен. Повторите запрос с увеличивающейся задержкой.
{
"error": {
"code": "insufficient_balance",
"message": "Insufficient balance.",
"details": {
"cost": 0.0906,
"balance": 0.02
}
}
}
Подключите ИИ-ассистента (MCP)
5 toolsMCP-сервер 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-ключ?
Как пройти аутентификацию?
Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET в каждом запросе. Храните секрет на своём сервере — никогда в браузере или мобильном приложении.Сколько стоит запрос?
POST /v1/sms и POST /v1/calls списывают средства по тем же ценам, что и в кабинете, — они указаны в разделе «Покрытие и цены» и в GET /v1/prices.