개발자 문서

smmto.com API

강력한 REST API로 서비스를 플랫폼에 직접 연동하세요. 빠르고 안정적이며 구현이 쉽습니다. 나만의 성장 도구 또는 리셀러 패널을 오늘 만들어 보세요.

가동 시간 99.9%
응답 시간 <200ms
볼륨 50M+
API 키 받기 GitHub에서 보기

1. 시작하기

저희 API는 REST 원칙을 따릅니다. 표준 HTTP 응답 코드, 인증, 메서드를 사용합니다. 모든 요청은 기본 URL로 보내며 JSON 형식으로 응답합니다.

기본 URL: https://smmto.com/api/v2

2. 인증

요청을 인증하려면 고유 API 키를 모든 요청의 `key` 매개변수로 포함해야 합니다. API 키는 계정 대시보드에서 확인할 수 있습니다.

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

API 키를 비밀로 유지하세요. 공개 저장소, 클라이언트 코드, 문서에 공유하지 마세요. 유출되면 즉시 재발급하세요.

3. 주문 추가

POST /api/v2

플랫폼에서 이용 가능한 모든 소셜 미디어 서비스에 새 주문을 넣으세요.

매개변수 유형 필수 설명
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

요청 예제

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

응답 예제

{
  "order": 23501,
  "status": "success"
}

4. 주문 상태

POST /api/v2

이전에 넣은 주문의 상태와 진행 상황을 확인하세요.

매개변수 유형 필수 설명
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. 다중 주문

POST /api/v2

효율이 중요합니다. 벌크 엔드포인트로 한 번의 API 호출에 최대 100건의 주문을 넣으세요.

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. 오류 코드

API는 성공 또는 실패를 나타내기 위해 표준 HTTP 상태 코드를 사용합니다.

코드 메시지 설명
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDK 및 라이브러리

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

패널 API 메서드

Service list

POST /api/v2 services
매개변수 설명
key Your API key
action services

응답 예제

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

응답 예제

{
    "order": 23501
}

Order status

POST /api/v2 status
매개변수 설명
key Your API key
action status
order Order ID

응답 예제

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

POST /api/v2 multi_status
매개변수 설명
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

응답 예제

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
매개변수 설명
key Your API key
action refill
order Order ID

응답 예제

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
매개변수 설명
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

응답 예제

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
매개변수 설명
key Your API key
action refill_status
refill Refill ID

응답 예제

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
매개변수 설명
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

응답 예제

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
매개변수 설명
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

응답 예제

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
매개변수 설명
key Your API key
action balance

응답 예제

{
    "balance": "100.84292",
    "currency": "USD"
}
PHP 코드 예제
실시간 채팅 24/7 지원