AQNAB API接続ガイド

リセラーは統合APIを使用してカタログを同期し、注文を作成し、進捗を追跡できます。公開ドキュメントには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接続ページには独立したシークレットキーがあります。分站のキーは、その供給站でプリペイドした調達残高を使用し、当站の価格で注文します。他の站や主站の残高は使用しません。各レベルの調達残高が不足している場合は、全額引き落としを拒否します。顧客のチャージは、その供給站に設定された收款口座に入金されます。

博客发布、目录和图片接口

代理发布接口支持创建草稿、预览、修改、发布、列表和删除,使用独立发布密钥,限定到主站或指定分站。请先测试草稿再发布正式文章。

查看完整代理接口文档与字段表 →

密钥管理

AQNAB API V2

開発者向けAPIドキュメント

サービスカタログから番号と現在のアカウント価格を取得し、同じキーで注文と照会を行います。

HTTPメソッド
POST
API URL
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文字列单个订单号;批量使用 orders,逗号分隔。
リクエストボディ(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単位あたりの米ドル販売価格です。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

現在のアカウントの注文のみ照会できます。バッチ照会には最大100件の注文をカンマ区切りで渡してください。バッチ結果は注文IDでインデックスされます。ステータスには「保留中」「処理中」「完了」「一部完了」「キャンセル済み」があります。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アクセスセンターでアカウント条件に基づいて注文キーを生成できます。ブログ公開には独立した公開キーを使用し、指定の分站に限定できます。このキーで注文の支払い(デビット)はできません。

代理店は直接ブログを公開できますか?

公開APIを使用して下書きを作成し、プレビューを確認した後、publishedに更新できます。リスト、変更、削除、画像アップロードをサポートしています。完全なフィールドと頻度制限はAPIドキュメントを参照してください。

なぜサービスIDを任意に置き換えることができないのですか?

各サービスIDは特定のサービスと回線に対応しており、価格、ターゲットリンク、範囲、アフターサービスが異なる場合があります。まずカタログを同期し、返されたIDとリンク形式に従って送信してください。番号を推測しないでください。

サービスカタログ · API詳細ガイド · ホワイトラベル分站