바이브 코더를 위한 SMS 게이트웨이 API

SMS8은 본인의 안드로이드를 기반으로 구축된 개발자용 SMS 게이트웨이입니다. Claude Code, Cursor, Windsurf 또는 curl에서 SMS, MMS, OTP, USSD를 발송할 수 있습니다. 키 하나, 베이스 URL 하나, JSON 입력과 JSON 출력.

샌드박스

여기서 바로 SMS 게이트웨이를 사용해 보세요. API 키를 붙여 넣고, 전화번호와 메시지를 입력한 뒤 발송 버튼을 누르세요. 사용자를 대신해 /services/send.php로 POST 요청을 보내고 실제 JSON 응답을 표시한 다음, 탭을 전환해 동일한 요청을 curl, PHP, JavaScript, Python 또는 Claude Code / Cursor 프롬프트로 가져갈 수 있습니다.

개요

SMS8 SMS 게이트웨이는 하나의 호스트에서 기능별로 단일 엔드포인트를 제공합니다. 경로 파라미터나 중첩 리소스가 없습니다. 모든 동작은 form-encoded 필드를 포함한 단일 POST입니다.

• 베이스 URL: https://app.sms8.io/services/
• 메서드: 모든 엔드포인트에서 POST
• 본문: application/x-www-form-urlencoded
• 응답: application/json
• 인증: 본문의 key=YOUR_SMS8_API_KEY

인증

모든 요청은 POST 본문에 API 키를 전송합니다. 키는 계정별이며 모든 엔드포인트에 대해 권한을 부여합니다. 대시보드의 API 페이지 app.sms8.io/api.php에서 키를 받을 수 있으며 언제든지 재생성할 수 있습니다. 이전 키는 즉시 무효화됩니다.

# 모든 요청에서
key=YOUR_SMS8_API_KEY

첫 SMS 보내기

페어링된 안드로이드의 기본 기기를 사용해 한 번호로 메시지를 보냅니다. YOUR_SMS8_API_KEY와 수신 번호를 교체하세요.

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "number=+11234567890" \
  -d "message=SMS8에서 보내는 메시지"

응답 형식

모든 엔드포인트의 응답은 success 래퍼에 페이로드를 감쌉니다.

{
  "success": true,
  "data": {
    "messages": [
      {
        "ID": "1",
        "number": "+11234567890",
        "message": "Hello from SMS8",
        "deviceID": "1",
        "simSlot": "0",
        "status": "Pending",
        "type": "sms",
        "sentDate": "2026-05-24T10:30:00+00:00",
        "deliveredDate": null,
        "groupID": "…"
      }
    ]
  }
}

오류

실패 시 success는 false이며 본문에는 구조화된 error 객체가 포함됩니다.

{
  "success": false,
  "error": {
    "code": 401,
    "message": "Invalid API key"
  }
}

SMS & MMS 발송

하나의 엔드포인트가 네 가지 발송 모드를 다룹니다. 단건 메시지, 배치(번호별로 다른 메시지), 연락처 목록 브로드캐스트, 그리고 첨부가 있는 MMS입니다. 어떤 필드를 보내느냐에 따라 모드가 결정됩니다.

한 번의 호출로 배치 발송

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d 'messages=[{"number":"+1...","message":"hi 1"},{"number":"+1...","message":"hi 2"}]' \
  -d "option=2"

연락처 목록에 브로드캐스트

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "listID=1" \
  -d "message=오늘 밤 세일 종료"

메시지 조회

# 기기 8의 SIM 0에서 지난 24시간 동안 수신된 SMS
curl https://app.sms8.io/services/read-messages.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "status=Received" \
  -d "deviceID=8" \
  -d "simSlot=0" \
  -d "startTimestamp=$(( $(date +%s) - 86400 ))"

재발송

read-messages와 동일한 필터 구조를 사용합니다. 단일 ID, 그룹 내 모든 메시지, 또는 지정한 시간 범위 내 특정 상태의 모든 메시지를 재시도할 수 있습니다.

연락처

기기

활성화된 모든 기기와 모델명, SIM 슬롯, 기본 기기 플래그를 반환합니다. 발송 호출에서 devices를 구성하기 전에 유용합니다.

USSD

페어링된 기기에서 통신사 USSD 코드를 실행하고 응답을 받아옵니다. 선불 요금 잔액 확인이나 통신사 메뉴에 유용합니다.

수신 웹훅

대시보드의 API 페이지에서 웹훅 URL을 설정하세요. SMS8은 수신된 모든 SMS를 HMAC-SHA256 서명과 함께 해당 URL로 POST합니다. 따라서 수신자는 페이로드가 SMS8에서 왔으며 변조되지 않았음을 검증할 수 있습니다.

AI 도구에서는 MCP의 create_webhook 도구를 통해 웹훅을 등록하세요. URL은 저장 전에 SSRF 차단 목록과 대조해 검증됩니다.

기기 & SIM 라우팅

모든 발송 엔드포인트는 동일한 라우팅 컨트롤을 사용합니다. 이를 조합해 여러 휴대폰과 SIM에 부하를 분산할 수 있습니다.

useRandomDevice=1로 설정하면 선택된 기기에서 무작위로 하나의 발신자를 고르며, OTP에 유용합니다.

예약 발송

schedule에 unix 타임스탬프를 전달하면 발송을 지연시킬 수 있습니다. 동일한 메시지를 여러 번호로 예약할 수도 있고, 배치를 미래 일정으로 예약할 수도 있습니다. 둘 다 가능합니다.

크레딧 잔액

/services/send.php를 key 필드만 포함해 호출하세요. 응답의 credits 필드는 남은 크레딧 또는 "Unlimited"를 반환합니다.

Claude Code, Cursor & Windsurf에서 사용하기

SMS8은 위 모든 REST 엔드포인트를 JSON-RPC 도구로 감싼 MCP 서버를 mcp.sms8.io에서 제공합니다. 동일한 API 키를 쓰며 별도의 계정이 필요 없습니다.

// ~/.config/claude/mcp-servers.json (Claude Code)
// ~/.cursor/mcp.json (Cursor)
// ~/.codeium/windsurf/mcp_config.json (Windsurf)
{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

PHP SDK

app.sms8.io/api.php 대시보드에서는 API 키가 미리 채워진 완전한 PHP 클래스를 렌더링합니다. sendSingleMessage, sendMessages, sendMessageToContactsList, getMessageByID, getMessagesByStatus, resendMessageByID, addContact, unsubscribeContact, getBalance, sendUssdRequest, getDevices 메서드를 포함합니다.

$msg = sendSingleMessage("+11234567890", "SMS8에서 보내는 메시지");

$msg = sendSingleMessage("+11234567890", "기기 1에서 발송", 1);

$msg = sendSingleMessage("+11234567890", "SIM 0에서 발송", "1|0");

$msg = sendSingleMessage("+11234567890", "2분 뒤 발송", null, strtotime("+2 minutes"));

C# SDK

완전한 C# API 클래스도 대시보드에 미리 채워져 있습니다. PHP SDK와 동일한 인터페이스를 제공하며 .NET / Unity / Xamarin 프로젝트에 바로 사용할 수 있습니다.

SMS.API.SendSingleMessage("+11234567890", "SMS8에서 보내는 메시지");

var msg = SMS.API.SendSingleMessage("+11234567890", "기기 1에서 발송", "1");

var msgs = SMS.API.SendMessages(messages, SMS.API.Option.USE_ALL_SIMS);

curl 레시피

# OTP 스타일 메시지를 우선순위로 발송
curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "number=+11234567890" \
  -d "message=인증번호는 482910입니다" \
  -d "prioritize=1" \
  -d "devices=1"

# 메시지 크레딧 확인
curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY"

# 연락처 추가, 이미 있으면 재구독
curl https://app.sms8.io/services/manage-contacts.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "listID=1" \
  -d "number=+11234567890" \
  -d "name=Alex" \
  -d "resubscribe=1"

FAQ

SMS8 SMS 게이트웨이 API란 무엇인가요?

SMS와 MMS 발송, 연락처 관리, USSD 실행, 인박스 조회를 수행하는 HTTP API입니다. 모든 엔드포인트는 https://app.sms8.io/services/ 하위의 POST이며 key 파라미터로 인증합니다. 메시지는 페어링된 안드로이드 휴대폰을 통해 라우팅되므로 A2P 10DLC나 메시지당 비용이 없습니다.

Claude Code, Cursor, Windsurf에서 어떻게 사용하나요?

mcp.sms8.io의 MCP 서버를 AI 도구에 추가하고 SMS8 API 키를 Bearer 토큰으로 사용하세요. MCP는 동일한 REST 엔드포인트를 send_sms, send_otp, verify_otp 같은 JSON-RPC 도구로 감쌉니다. AI 도구 섹션을 참고하세요.

Twilio 번호 없이 발송할 수 있나요?

네. SMS8은 본인의 안드로이드 휴대폰과 SIM 카드를 게이트웨이로 사용합니다. Twilio 번호, A2P 10DLC 등록, 통신사 메시지당 비용이 필요 없습니다.

수신 SMS를 어떻게 받나요?

대시보드의 API 페이지에서 웹훅 URL을 설정하세요. SMS8은 수신된 모든 SMS를 HMAC 서명과 함께 해당 URL로 POST하므로 페이로드를 검증할 수 있습니다.

어떤 속도 제한이 적용되나요?

SMS 처리량은 페어링된 기기의 속도와 요금제의 월간 사용량에 따라 결정됩니다. OTP 흐름에는 24시간당 번호별 5회 한도와 구성 가능한 재발송 쿨다운이 추가로 적용됩니다.

API 키를 어떻게 교체하나요?

대시보드 app.sms8.io/api.php에서 재생성하세요. 이전 키는 즉시 무효화됩니다.