AQNAB API 연동 가이드

딜러는 통합 API로 카탈로그를 동기화하고 주문을 생성하며 진행 상황을 추적할 수 있습니다. 공개 문서에는 키가 포함되지 않으며, 주문 시 계정 잔액이 사용됩니다. 키는 서버에 안전하게 저장하세요.

서비스 동기화 및 주문

  1. services를 호출하면 서비스 ID, 천 개당 가격, 최소·최대 수량, 수량 감소 보충 조건과 링크 형식을 확인할 수 있습니다.
  2. 서비스 유형에 따라 공개 프로필 또는 지정 콘텐츠 링크를 입력하고, add를 호출하여 제출하세요. 주문 시 수량, 링크, 잔액을 다시 확인합니다.
  3. 반환된 AQNAB 주문 번호를 저장하고, status를 호출하여 실제 상위 동기화 후 상태, 시작 수량 및 남은 수량을 확인하세요.
  4. 시간 초과 또는 결과가 불확실한 경우 먼저 조회하고 수동으로 확인한 후, 바로 다른 경로로 재주문하지 마세요. 접수가 확인되지 않은 경우에만 다른 서비스를 선택해 다시 제출할 수 있습니다.

최소 호출 예시

curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'

API: POST /api/v2; 폼 또는 JSON 수락, JSON 반환. 잔액 조회 action=balance; 주문 action=add, service, link, quantity 전달; 진행 상황 조회 action=status, order 전달. 맞춤 리뷰는 comments 추가 전달, 키워드 서비스는 keywords 추가 전달.

보충, 취소 및 분점 구매

status는 orders 일괄 조회(최대 100건)를 지원합니다; refill은 order 또는 orders를 전달하고, refill_status는 refill 또는 refills를 전달하며, cancel은 orders를 전달합니다. 보충 및 취소는 서비스가 지원하는 경우에만 접수되며, 신청은 비동기 큐에 들어가고 취소 신청이 환불을 의미하지는 않습니다.

각 하위 사이트 API 액세스 페이지는 별도의 비밀 키를 제공합니다. 하위 사이트 키는 해당 공급업체 사이트에 미리 충전한 구매 잔액을 사용하며 해당 사이트의 요율로 주문을 진행합니다. 다른 사이트나 메인 사이트의 잔액은 사용되지 않습니다. 어느 단계에서든 구매 잔액이 부족하면 전체 차감이 거부됩니다. 고객 충전금은 해당 공급업체 사이트에 설정된 수금 계정으로 입금됩니다.

블로그 게시, 디렉터리 및 이미지 API

에이전트 게시 API는 초안 작성, 미리보기, 편집, 게시, 목록 조회, 삭제를 지원합니다. 별도의 게시 키를 사용하며, 메인 사이트 또는 특정 하위 사이트로 제한할 수 있습니다. 최종 기사를 게시하기 전에 초안을 테스트하세요.

전체 대리점 API 문서 및 필드 표 보기 →

키 관리

AQNAB API V2

개발자 API 문서

서비스 카탈로그에서 번호와 현재 계정 판매가를 확인한 후, 동일한 키로 주문과 조회를 진행하세요.

HTTP 메서드
POST
API 주소
https://aqnab.com/api/v2
요청 형식
JSON 또는 폼(application/x-www-form-urlencoded)
응답 형식
JSON · 과금 단위 USD
인증 방식
요청 본문에 전달key. 키는 서버에만 저장됩니다.

재충전 요청 refill

refill=true로 표시되고 이미 업스트림에 제출된 본 계정의 주문만 지원합니다. 신청은 먼저 대기열에 들어갑니다. 공급업체 응답이 불분명하면 확인을 기다리며 중복 제출하지 마세요. orders에 1~100개의 주문 번호를 일괄 전송할 수 있습니다.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 refill。
order문자열단일 주문 ID; 일괄 주문 시 쉼표로 구분하여 입력하세요.
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
성공 응답 예시
{
  "refill": "AQR-EXAMPLE"
}

보충 진행 상황 refill_status

Pending, Completed, Rejected 또는 Pending review를 반환합니다. refills는 1–100개의 보충 번호를 일괄 전송할 수 있습니다.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 refill_status。
refill문자열보충 신청 시 반환되는 번호, 일괄 사용 시 refills 사용.
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
성공 응답 예시
{
  "status": "Pending"
}

취소 요청 cancel

cancel=true인 비종료 상태 주문만 지원합니다. 반환 1은 신청이 대기열에 들어갔음을 의미하며, 취소나 환불을 의미하지 않습니다. 계속 주문 상태를 확인하세요.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 cancel。
orders문자열1–100개의 주문 번호, 쉼표로 구분.
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
성공 응답 예시
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

서비스 목록 services

현재 계정에서 사용 가능한 판매 카탈로그를 반환합니다. service 문자열로 주문하세요. rate는 1,000단위당 USD 판매 가격입니다. required가 나타나면 해당 목록에 따라 주문 매개변수를 전달하세요. refill/cancel 표시는 해당 상품이 보충 및 취소 신청을 지원하는지 여부를 나타냅니다.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 services。
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
성공 응답 예시
[
  {
    "service": "AQ1-123",
    "name": "TikTok 粉丝",
    "type": "Default",
    "category": "TikTok - 粉丝",
    "rate": "0.900",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false
  },
  {
    "service": "AQ2-456",
    "name": "TikTok 自定义评论",
    "type": "Custom Comments",
    "category": "TikTok - 评论",
    "rate": "8.00",
    "min": 1,
    "max": 100,
    "refill": false,
    "cancel": false,
    "required": [
      "link",
      "comments"
    ]
  }
]

잔액 조회 balance

현재 API 키에 속한 계정의 사용 가능한 잔액을 반환합니다. 잔액은 소수점 4자리 문자열입니다.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 balance。
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "balance"
}
성공 응답 예시
{
  "balance": "12.5000",
  "currency": "USD"
}

주문 생성 add

실제 주문을 생성하고 잔액이 차감됩니다. 총 금액 = 수량 ÷ 1,000 × 현재 천 건당 판매가이며, 소수점 넷째 자리까지 표시됩니다. 주문 번호를 받은 후 저장해 두고 이후 조회에 사용하세요. 요청 시간 초과 시 콘솔에서 먼저 주문을 확인하여 중복 제출을 피하세요.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 add。
service문자열필수. services에서 반환된 서비스 번호를 사용하세요. 예: AQ1-123.
link문자열필수. 공개적으로 접근 가능한 http 또는 https 대상 링크.
quantity정수일반 서비스는 필수이며 min과 max 사이여야 합니다. 맞춤 댓글은 유효한 줄 수로 계산됩니다.
comments문자열사용자 정의 댓글은 필수이며, 각 줄에 하나씩, 총 최대 20,000자입니다. 빈 줄은 수량에 포함되지 않습니다.
keywords문자열사용자 지정 키워드가 필요한 서비스는 필수이며 최대 2,000자입니다. 다른 서비스는 필요하지 않습니다.
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
성공 응답 예시
{
  "order": "API-EXAMPLE-4ABC"
}
사용자 정의 댓글 및 키워드 요청 예시
사용자 정의 댓글
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
사용자 정의 키워드
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

주문 상태 조회 status

현재 계정의 주문만 조회할 수 있습니다. orders를 전달하면 최대 100개 주문을 일괄 조회할 수 있으며(쉼표로 구분), 일괄 반환은 주문 번호로 인덱싱된 결과입니다. 상태는 Pending, In progress, Completed, Partial, Canceled를 포함합니다. start_count와 remains는 상위 공급자 상태 동기화에서 오며, 아직 반환되지 않으면 null입니다. 상위 공급자 상태는 실제 전달의 독립적 증명이 아닙니다.

매개변수유형설명
key문자열필수. 귀하의 AQNAB API 키.
action문자열必填。固定为 status。
order문자열필수. 주문 생성 시 반환되는 order 필드.
요청 본문(JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
성공 응답 예시
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

오류 처리

HTTP 상태설명
400매개변수 오류, 서비스 불가 또는 잔액 부족.
401키가 유효하지 않거나 취소되었습니다.
404이 계정에 대한 주문이 없습니다.
500 / 502서비스를 일시적으로 사용할 수 없습니다. 주문 요청이 실패하면 먼저 주문과 잔액을 확인해 주세요.
오류 응답 예시
{
  "error": "Insufficient funds"
}
cURL 폼 예시
curl -X POST https://aqnab.com/api/v2 \
  --data-urlencode "key=YOUR_KEY" \
  --data-urlencode "action=services"

登录后管理下单密钥. 게시 키는 사이트 관리자가 SEO 최적화 섹션에서 별도로 생성하여 안전하게 전달합니다.

자주 묻는 질문

API로 어떤 작업을 할 수 있나요?

현재 /api/v2는 services, balance, add, status를 지원합니다. 서비스 동기화는 현재 소매 가격과 범위를 읽는 데 사용되며, add는 실제 유료 주문을 생성하고, status는 업스트림 동기화 후 진행 상황을 조회합니다.

시간 초과가 발생하면 바로 서비스를 전환할 수 있나요?

아니요. 시간 초과는 이미 접수되었을 수 있으므로, 먼저 원래 주문을 조회하고 수동으로 확인한 후 새 주문을 생성할지 결정해야 합니다. 현재 시스템은 불확실한 제출 결과에서 자동으로 회선을 전환하여 반복 구매하지 않습니다.

키는 어떻게 얻나요?

로그인 후 API 연동 센터에서 계정 조건에 따라 주문 키를 생성할 수 있습니다. 블로그 게시는 별도의 게시 키를 사용하며, 지정된 리셀러 패널로 제한할 수 있고, 결제 주문에는 사용할 수 없습니다.

대리인이 블로그를 직접 게시할 수 있나요?

게시 API를 사용하여 초안을 만들고, 미리보기를 확인한 후 published로 업데이트할 수 있습니다. 목록 조회, 수정, 삭제, 이미지 업로드를 지원합니다. 전체 필드와 빈도 제한은 API 문서를 참조하세요.

서비스 ID를 임의로 교체할 수 없는 이유는 무엇인가요?

각 서비스 ID는 특정 서비스와 라인에 해당하며, 가격, 대상 링크, 범위, 사후 지원이 다를 수 있습니다. 먼저 카탈로그를 동기화하고, 반환된 ID와 링크 형식에 따라 제출하세요. 번호를 추측하지 마세요.

서비스 카탈로그 · API 상세 가이드 · 화이트 라벨 분점