SMM 패널 API v2 문서
1PANEL PLUS는 표준 SMM 패널 API v2를 사용해요. API 키와 action을 담아 POST 요청을 보내면 모든 응답은 JSON으로 와요. 가격과 잔액은 웹사이트와 같아요.
기본 정보
- 엔드포인트
- https://1panelplus.com/api/v2
- 메서드
- POST
- 파라미터
- 폼 필드 또는 JSON 본문
- API 키
- 대시보드의 API 키 페이지에서 발급
- 요청 한도
- 키당 분당 300회
요청 예시
curl -X POST https://1panelplus.com/api/v2 \ -d key=YOUR_API_KEY \ -d action=balance
서비스 목록
활성 서비스 전체를 보여 줘요. rate는 1,000개당 가격(USD)이고, type이 Package이면 패키지 1개 가격이에요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | services |
응답 예시
[
{
"service": 1204,
"name": "YouTube Views - 30 Days Refill",
"type": "Default",
"category": "YouTube - Views (30 Days Refill)",
"rate": "1.5600",
"min": "100",
"max": "1000000",
"refill": true,
"cancel": false
}
]주문 넣기
주문을 넣고 가격만큼 잔액에서 차감해요. Custom Comments는 quantity 대신 comments(한 줄에 하나씩)를 보내 주세요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | add |
| service | 서비스 ID |
| link | 동영상, Shorts, 라이브 또는 채널 링크 |
| quantity | 수량 (Custom Comments, Package 제외) |
| comments | Custom Comments 전용: 한 줄에 댓글 하나 |
응답 예시
{
"order": 23501
}주문 상태
주문 하나의 상태예요. charge는 결제한 금액(USD)이에요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | status |
| order | 주문 ID |
응답 예시
{
"charge": "1.560000",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}여러 주문 상태
최대 100개 주문의 상태를 쉼표로 구분해 조회해요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | status |
| orders | 주문 ID 목록 (예: 1,10,100) |
응답 예시
{
"1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}리필
리필 서비스의 완료 또는 부분 완료된 주문에 리필을 요청해요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | refill |
| order | 주문 ID |
응답 예시
{
"refill": 412
}리필 상태
리필 요청의 상태예요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | refill_status |
| refill | 리필 ID |
응답 예시
{
"status": "Completed"
}잔액
USD 기준 잔액이에요.
| 파라미터 | 설명 |
|---|---|
| key | API 키 |
| action | balance |
응답 예시
{
"balance": "100.840000",
"currency": "USD"
}주문 상태
| Pending | 접수됨, 시작 대기 중 |
| In progress | 전달 중 |
| Completed | 전부 전달 완료 |
| Partial | 일부 전달, 나머지는 잔액으로 환불 |
| Canceled | 전달 안 됨, 전액 환불 |
오류
오류는 error 메시지가 담긴 JSON으로 와요. 예시:
{
"error": "Not enough funds on balance"
}| Invalid API key | 키가 없거나, 틀렸거나, 새 키로 바뀌었어요 |
| Incorrect service ID | 이 ID의 활성 서비스가 없어요 |
| Incorrect link | 링크가 비어 있거나 웹 주소가 아니에요 |
| Quantity out of range | 서비스의 최소 수량보다 적거나 최대 수량보다 많아요 |
| Not enough funds on balance | 먼저 충전해 주세요 |
| Too many requests | 1분에 300회를 넘게 요청했어요 |