SMM 패널 API 문서

SMM 패널 API란?

SMM 패널 API는 웹사이트 화면을 거치지 않고 프로그램에서 서비스 목록을 받고, 주문을 넣고, 진행 상태와 잔액을 확인하는 연결 방법이에요. 4SNS PLUS는 많은 패널과 봇이 쓰는 표준 SMM 패널 API v2 형식을 그대로 지원해서, 이미 다른 패널에 연결해 둔 코드도 주소와 키만 바꾸면 바로 쓸 수 있어요.

API의 가격과 잔액은 웹사이트와 같아요. services 응답의 rate는 가격표의 1,000개당 가격(미국 달러)과 같은 값이고, add로 넣은 주문은 웹에서 넣은 주문과 똑같이 잔액에서 빠지고 회원 화면 주문 내역에도 보여요. 취소나 부분 완료로 돌아온 금액도 같은 잔액으로 들어와요.

기본 정보

요청 예시

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

API 키는 어떻게 받나요?

API 키는 첫 충전이 잔액에 반영된 뒤 회원 화면의 API 키 메뉴에서 만들 수 있어요. 키는 만들 때 한 번만 보여 드리니 안전한 곳에 저장해 주세요. 새 키를 만들면 이전 키는 바로 쓸 수 없게 돼요.

키는 계정 토큰과 별개라서, 봇이나 서버에는 API 키만 넣고 계정 토큰은 넣지 마세요. 키가 노출됐다고 생각되면 API 키 화면에서 새로 만들면 돼요.

서비스 목록 (services)

주문할 수 있는 모든 서비스를 돌려줘요. rate는 1,000개당 가격(USD)이고, type이 Package이면 패키지 1개 가격이에요. type이 Custom Comments이면 수량 대신 댓글 목록을 보내요. category는 플랫폼 이름과 묶음 이름이에요.

응답 예시

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

주문 넣기 (add)

주문을 넣고 금액만큼 잔액에서 빼요. 금액은 1,000개당 가격에 수량을 곱한 값이고, Package는 패키지 가격, Custom Comments는 댓글 줄 수가 수량이에요. 첫 충전이 반영된 계정에서만 주문할 수 있어요. 응답의 order는 주문 번호예요.

응답 예시

{
  "order": 31877
}

주문 상태 (status)

주문 하나의 상태예요. charge는 환불을 뺀 실제 결제 금액(USD, 소수 6자리), start_count는 시작할 때의 숫자, remains는 아직 제공되지 않은 수량이에요.

응답 예시

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

여러 주문 상태 (status, orders)

주문 번호를 쉼표로 이어 최대 100개까지 한 번에 확인해요. 내 계정의 주문이 아니거나 없는 번호는 그 자리에 error가 와요.

응답 예시

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

리필 요청 (refill)

리필 기간이 있는 서비스의 주문이 완료나 부분 완료로 끝났을 때, 끝난 시점부터 리필 기간 안에서 요청해요. 열린 요청은 주문당 하나, 요청 사이에는 24시간 간격이 필요해요.

응답 예시

{
  "refill": 512
}

리필 상태 (refill_status)

리필 요청 하나의 상태예요.

응답 예시

{
  "status": "Completed"
}

잔액 (balance)

내 잔액(USD, 소수 6자리)이에요.

응답 예시

{
  "balance": "84.120000",
  "currency": "USD"
}

주문 상태 값

리필 상태 값

오류 메시지

오류는 HTTP 200 응답에 error 필드가 담긴 JSON으로 와요. 코드에서는 error 필드가 있는지 먼저 확인해 주세요.

{
  "error": "Not enough funds on balance"
}

텔레그램 봇에 SMM 패널 API를 연결하려면?