김도현
API 붙이는 데 한 시간
서비스 목록을 불러와서 제 패널에 연결하는 데 한 시간 정도 걸렸습니다. 응답 형식이 업계 표준이라 기존 코드에서 손볼 게 거의 없었어요.
SMM 패널 API: 주문을 자동화하세요
표준 리셀러 API로 서비스 목록을 가져오고, 주문을 넣고, 상태와 잔액을 조회하세요. 엔드포인트 하나에 JSON 응답이라 기존 패널 소프트웨어에 몇 분이면 연결됩니다.
엔드포인트 1개 · 액션 7개 · JSON 응답
4.4리뷰 1,506개업계 표준 리셀러 API
이 API는 업계에서 널리 쓰이는 표준 리셀러 형식을 따릅니다. 시중의 패널 소프트웨어와 스크립트 대부분은 API 주소와 키만 바꾸면 PanelFollows에서 바로 동작합니다.
엔드포인트 하나
모든 요청이 하나의 URL로 갑니다. 추가 경로나 버전 관리가 필요 없고, 어떤 작업을 할지는 action 파라미터로 정합니다.
form-encoded POST
파라미터는 form-encoded POST 요청으로 보내며 JSON 본문도 받습니다. 표준 HTTP 라이브러리 외에 별도의 도구가 필요 없습니다.
JSON 응답
모든 요청은 JSON을 반환합니다. 오류는 error 필드 하나로 돌아오므로 예외 처리가 단순하고 예측 가능합니다.
키 기반 인증
인증은 key 파라미터 하나면 끝입니다. 서명이나 토큰, OAuth 흐름을 구현할 필요가 없습니다.
POST https://panelfollows.com/api/v2
Content-Type: application/x-www-form-urlencoded
key=API_KEY&action=balance
# 응답
{ "balance": "25.4300", "currency": "USD" }주문이 패널 안에서 어떻게 흘러가는지는 이용 방법 페이지에서, 리셀러 모델은 SMM 리셀러 패널 페이지에서 다룹니다.
지원하는 액션
API는 현재 7개의 액션을 지원합니다. 모든 요청은 같은 엔드포인트로 가며, 수행할 작업은 action 파라미터로 선택합니다.
services
key, action
활성 서비스 카탈로그를 반환합니다. 서비스 ID, 이름, 카테고리, 1000개당 단가, 최소 및 최대 수량과 함께 리필, 취소, dripfeed 지원 여부가 들어 있습니다.
add
key, action, service, link, quantity [, runs, interval]
새 주문을 만들고 주문 번호를 반환합니다. dripfeed 서비스에서는 runs와 interval을, 사용자 지정 댓글 서비스에서는 comments 파라미터를 사용하세요.
status
key, action, order | orders
주문 상세를 반환합니다. charge, start_count, 상태, 남은 수량(remains)이 포함됩니다. orders 파라미터에 쉼표로 구분한 목록을 넘기면 여러 주문을 한 번에 조회합니다.
balance
key, action
계정 잔액을 USD로 반환합니다. 주문 금액도 같은 통화로 계산됩니다.
refill
key, action, order | orders
리필을 지원하는 서비스의 완료된 주문에 리필 요청을 열고, 추적용 리필 ID를 반환합니다. 여러 주문은 쉼표로 구분해 보낼 수 있습니다.
refill_status
key, action, refill | refills
리필 요청의 현재 상태를 반환합니다. refills 파라미터로 여러 건을 한 번에 조회할 수 있습니다.
cancel
key, action, orders
대기 중이거나 진행 중인 주문을 취소하고 금액을 잔액으로 환불합니다. 쉼표로 구분한 여러 주문 번호를 받습니다.
주문 상태는 Pending, In progress, Completed, Partial, Canceled 값으로 반환됩니다.
API를 직접 연결하는 대신 완성된 판매 화면을 원하시나요? 하위 패널 페이지를 살펴보세요.
코드 예제
아래 예제는 curl을 사용합니다. API_KEY 부분만 패널에서 발급한 키로 바꾸면 됩니다.
서비스 목록 가져오기
# 서비스 목록 가져오기
curl -X POST https://panelfollows.com/api/v2 \
-d "key=API_KEY" \
-d "action=services"
# 응답
[
{
"service": "1201",
"name": "Instagram Followers",
"type": "Default",
"category": "Instagram",
"rate": "1.2000",
"min": "10",
"max": "100000",
"refill": true,
"cancel": true,
"dripfeed": false
}
]주문 넣기
# 새 주문 생성
curl -X POST https://panelfollows.com/api/v2 \
-d "key=API_KEY" \
-d "action=add" \
-d "service=1201" \
-d "link=https://instagram.com/username" \
-d "quantity=1000"
# 응답
{ "order": 23501 }어떻게 시작하나요?
- 1
무료 계정을 만드세요
이메일로 몇 초 만에 가입하세요. API 접근은 모든 계정에 추가 비용 없이 포함됩니다.
- 2
API 키를 발급하세요
패널의 API 페이지에서 클릭 한 번으로 키를 만들고 복사하세요. 언제든 다시 발급할 수 있습니다.
- 3
연동하세요
발급받은 키로 소프트웨어를 엔드포인트에 연결하고, 서비스 목록을 가져온 뒤 API로 첫 주문을 넣어 보세요.
키 생성과 관리는 대시보드의 API 페이지에서 하시면 됩니다.
API 키를 안전하게 지키세요
API 키는 계정을 대신해 주문을 넣을 수 있으므로 비밀번호처럼 다뤄야 합니다. 서버 쪽에서만 사용하고, 공개 저장소나 클라이언트 코드, 화면 캡처에 노출되지 않도록 하세요.
키가 유출된 것 같다면 패널의 API 페이지에서 클릭 한 번으로 다시 발급하세요. 기존 키는 즉시 무효가 됩니다. 남용을 막기 위해 API는 키당 분당 240회 요청으로 제한됩니다.
자주 묻는 질문
SMM 패널 API는 무료인가요?
네. API 접근은 모든 PanelFollows 계정에 포함되며 추가 요금이나 별도 요금제가 없습니다. 실제로 넣은 주문의 서비스 금액만 지불하시면 됩니다.
응답은 어떤 형식인가요?
모든 액션이 JSON을 반환합니다. 잔액과 주문 금액은 USD 기준이며, 오류는 error 필드 하나로 돌아오기 때문에 처리하기가 간단합니다.
기존 패널 스크립트와 호환되나요?
네. 이 API는 업계에서 널리 쓰이는 표준 리셀러 형식을 따르므로, 시중의 패널 소프트웨어와 스크립트 대부분은 API 주소와 키만 바꾸면 됩니다.
요청 제한이 있나요?
네. API 키당 분당 240회까지 허용되며, 초과한 요청은 JSON 오류 메시지와 함께 거절됩니다. 일반적인 자동화 작업에는 충분한 수치입니다.
API로 dripfeed와 리필도 쓸 수 있나요?
네. dripfeed를 지원하는 서비스에서는 add 액션에 runs와 interval 파라미터를 더하면 됩니다. 리필을 지원하는 서비스에서는 refill 액션으로 요청을 열고 refill_status로 추적합니다.
고객 리뷰
이 서비스를 이용한 고객들이 직접 쓴 실제 경험입니다.
강도윤
대량 주문이 살렸습니다
고객 계정 12개 분량을 대량 주문 양식에 한 번에 붙여 넣었는데 전부 통과됐어요. 예전에는 하나씩 넣느라 한 시간을 썼는데 이제 2분이면 끝납니다.
박지훈
리필이 진짜 되네요
한 달쯤 지나서 팔로워가 조금 빠졌길래 리필을 눌렀더니 이틀 만에 원래 숫자로 돌아왔습니다. 설명에만 리필이라고 적어두는 곳들과는 확실히 다릅니다.
김유찬
구독자 서비스 만족
리필이 되는 구독자로 골라서 샀는데 두 달이 지나도 숫자가 그대로 유지되고 있습니다. 채널 신뢰도 때문에 여기는 아끼면 안 되겠더라고요.
이준영
하위 패널을 열었습니다
도메인을 연결하니까 인증서까지 알아서 붙었고, 결제는 제 계정으로 직접 받으니 정산이 깔끔합니다. 준비하는 데 하루도 안 걸렸어요.
노지훈
리셀러로 먹고삽니다
제 사이트 손님한테 인스타 팔로워만 골라서 팔고 있는데 원가가 낮아서 마진을 붙여도 시장 가격보다 쌉니다. 재고 걱정이 없는 장사라 부담도 적어요.