딜러는 통합 API로 카탈로그를 동기화하고 주문을 생성하며 진행 상황을 추적할 수 있습니다. 공개 문서에는 키가 포함되지 않으며, 주문 시 계정 잔액이 사용됩니다. 키는 서버에 안전하게 저장하세요.
서비스 동기화 및 주문
services를 호출하면 서비스 ID, 천 개당 가격, 최소·최대 수량, 수량 감소 보충 조건과 링크 형식을 확인할 수 있습니다.
서비스 유형에 따라 공개 프로필 또는 지정 콘텐츠 링크를 입력하고, add를 호출하여 제출하세요. 주문 시 수량, 링크, 잔액을 다시 확인합니다.
반환된 AQNAB 주문 번호를 저장하고, status를 호출하여 실제 상위 동기화 후 상태, 시작 수량 및 남은 수량을 확인하세요.
시간 초과 또는 결과가 불확실한 경우 먼저 조회하고 수동으로 확인한 후, 바로 다른 경로로 재주문하지 마세요. 접수가 확인되지 않은 경우에만 다른 서비스를 선택해 다시 제출할 수 있습니다.
최소 호출 예시
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는 초안 작성, 미리보기, 편집, 게시, 목록 조회, 삭제를 지원합니다. 별도의 게시 키를 사용하며, 메인 사이트 또는 특정 하위 사이트로 제한할 수 있습니다. 최종 기사를 게시하기 전에 초안을 테스트하세요.
현재 계정에서 사용 가능한 판매 카탈로그를 반환합니다. service 문자열로 주문하세요. rate는 1,000단위당 USD 판매 가격입니다. required가 나타나면 해당 목록에 따라 주문 매개변수를 전달하세요. refill/cancel 표시는 해당 상품이 보충 및 취소 신청을 지원하는지 여부를 나타냅니다.
현재 계정의 주문만 조회할 수 있습니다. orders를 전달하면 최대 100개 주문을 일괄 조회할 수 있으며(쉼표로 구분), 일괄 반환은 주문 번호로 인덱싱된 결과입니다. 상태는 Pending, In progress, Completed, Partial, Canceled를 포함합니다. start_count와 remains는 상위 공급자 상태 동기화에서 오며, 아직 반환되지 않으면 null입니다. 상위 공급자 상태는 실제 전달의 독립적 증명이 아닙니다.