AliExpress 日本向け SOP
ALIEXPRESS · JAPAN

AE のデータ接続

対象は AliExpress 日本向けアフィリエイトです。淘宝・天猫・DS の仕様ではありません。商品候補の取得、指定 SKU の確認、公式転リンク、成果計測を別工程として扱います。

API 開通済み
公式 API から候補を取得
アプリ・権限を確認し、指定 SKU と日本配送を照合。
API 未開通
商品ページ+Portals で確認
通常操作と許諾されたレスポンスのローカル解析。
計測を接続
公式転リンク/S2S
商品取得ではなく、リンク生成と支払通知の経路。
i
このキットはデータ整形・検証・静的表示を提供します。あなたの API アプリを開通したり、実データへ自動接続したりした状態ではありません。認証・署名・S2S 受信には別途サーバー側の実装が必要です。
01

公式 API の経路

候補取得と、公開できる商品かの確認を分ける
  1. AliExpress Portals 登録後、Tools → API から申請。同じアカウントで Open Platform の Affiliates アプリを作成し、審査・オンライン化・権限を確認します。
  2. 各インターフェースの公共パラメータ・署名・認可を確認します。/auth/token/create は認可コードを token に交換する API。全 Affiliate API がこの認可を必要とするとは限りません。任意の app_signature とシステム署名 sign は別です。
  3. 日本向けは言語 JA、通貨 JPY、配送国 JP を各 API の仕様に従って指定。言語欄に JP を入れたり、別 API に同じ国パラメータ名をコピーしたりしません。
  4. 返った候補を、同じ商品・SKU・配送先・購入条件で再確認してから 01 取り込みへ。取得できない値は不明のまま残します。
実際に使い分ける Affiliate API用途・権限・限界
公式インターフェース役割公開前の追加確認
product.queryキーワード・カテゴリ等で商品候補検索。国引数は ship_to_countryアフィリエイト商品とマーケティング対象商品は同じ集合ではない。検索に出ないだけで非対象・下架と判定しない
productdetail.get商品 ID の詳細。国引数は country商品レベルの価格・販売数は選択 SKU の価格・在庫ではない
hotproduct.queryマーケティング対象の候補人気という選定情報は、在庫・日本配送・最終価格の保証ではない
product.sku.detail.get
product.shipping.get
product.smartmatch
SKU 詳細、配送、推薦。2025 年ガイドでは追加権限の申請対象アプリの現行権限とレスポンスを確認。基本 API だけで全 SKU 在庫が取得できるとは書かない。smartmatch の個人情報項目を無断収集しない
featuredpromo.get
featuredpromo.products.get
キャンペーン情報/その商品候補キャンペーン情報と商品一覧を分離。商品プールを永久保存したまま公開しない
link.generate元の商品 URL と Tracking ID で公式リンク生成source_values・tracking_id・promotion_link_type を確認。返却の promotion_link を保存
order.get / order.list / order.listbyindex自分の許諾された成果の確認支払・精算、注文状態、金額単位、時刻定義をそろえる。非公開数値を外部記事に転記しない

表の各名称には aliexpress.affiliate. が付きます。古いガイドの取得件数・QPS を現行上限として固定せず、使用するインターフェースの最新仕様を確認してください。

02

API 未開通:商品ページと Portals

ブラウザで確認できた事実だけを取り込む
  1. 自分のアカウントで通常どおり商品ページを開き、配送先を日本、通貨を JPY にして指定 SKU を選択。商品 ID と SKU ID は文字列で記録します。
  2. 同じ SKU の表示価格・販売可能在庫・日本配送・送料・確認時刻を確認。商品全体の最低価格や全 SKU 合計在庫で代用しません。
  3. 必要な場合は F12 の Network / Preview で、自分に利用が許諾された正常な商品レスポンスの必要項目だけ確認。Cookie・Token・認証ヘッダー・HAR 全体を AI や公開ファイルに渡しません。
  4. Portals の通常の確認機能で現在のアフィリエイト資格を確認し、公式リンクを生成。商品ページの URL とは別に保存します。
  5. 通信失敗・ログイン切れ・仕様変更・CAPTCHA・利用制限が出たら停止し、通常の再ログインや人手確認に戻ります。固定 Token、ログイン偽装、署名偽装、制限回避コードを配布・実行しません。
F12 レスポンスを安全に解析する送信・認証なし

以下は保存済み JSON のローカル解析器です。現行レスポンスで構造が違えば unknown。リクエスト発行やブラウザ API の再送はしません。F12 にコピーすると AESourceNormalizer を利用できます。返却値は完成 dataset ではありません。

観察済みの構造解析の条件
PRICE.skuIdStrPriceInfoMap[sku_id].salePriceLocal指定 SKU のキーのみ。通貨設定の証拠は別途確認。小数を勝手に整数へ丸めない
SKU.skuPaths[].skuIdStr / skuId / skuStock完全一致する SKU の非負整数在庫。複数レコードが矛盾したら unknown。明示的 0 のみ在庫切れ
isSuccess / isAffiliateItemPortals ページ応答。isSuccess=true かつ資格値が明示された時だけ Y / N。それ以外は unknown。安定した公開 Open API とは扱わない
F12 にコピー/Node.js で実行:ローカル解析器
'use strict';

function idText(value) {
  if (typeof value === 'number' && !Number.isSafeInteger(value)) return null;
  var text = typeof value === 'string' || typeof value === 'number' ? String(value) : '';
  return /^[0-9]{6,25}$/.test(text) ? text : null;
}
function explicitBool(value) {
  if (value === true || value === 1 || value === 'true' || value === '1') return true;
  if (value === false || value === 0 || value === 'false' || value === '0') return false;
  return null;
}
function integerStock(value) {
  if (typeof value !== 'number' && typeof value !== 'string') return null;
  if (typeof value === 'string' && !/^\d+$/.test(value)) return null;
  var n = Number(value);
  return Number.isSafeInteger(n) && n >= 0 ? n : null;
}
function jpyPrice(value) {
  if (typeof value === 'number') return Number.isFinite(value) && value > 0 ? value : null;
  if (typeof value !== 'string') return null;
  var text = value.trim().replace(/,/g, '');
  var m = text.match(/^(?:JPY\s*|[¥¥]\s*)?(\d+(?:\.\d+)?)(?:\s*円)?$/i);
  var n = m ? Number(m[1]) : NaN;
  return Number.isFinite(n) && n > 0 ? n : null;
}
function normalizePortal(data) {
  var success = explicitBool(data && data.isSuccess);
  var affiliate = explicitBool(data && data.isAffiliateItem);
  return {
    source: 'portal_page_response',
    affiliate_status: success === true && affiliate !== null ? (affiliate ? 'affiliate' : 'non_affiliate') : 'unknown',
    business_success: success,
    missing_fields: success !== true || affiliate === null ? ['current_affiliate_confirmation'] : []
  };
}
function normalizePdp(data, skuId) {
  var sku = idText(skuId);
  if (!sku) throw new Error('sku_id must be an exact decimal string');
  var map = data && data.PRICE && data.PRICE.skuIdStrPriceInfoMap;
  var info = map && Object.prototype.hasOwnProperty.call(map, sku) ? map[sku] : null;
  var paths = data && data.SKU && data.SKU.skuPaths;
  var matches = Array.isArray(paths) ? paths.filter(function (p) { return p && idText(p.skuIdStr != null ? p.skuIdStr : p.skuId) === sku; }) : [];
  var stocks = matches.map(function (p) { return integerStock(p.skuStock); });
  var stock = stocks.length && stocks.every(function (n) { return n !== null && n === stocks[0]; }) ? stocks[0] : null;
  var price = info ? jpyPrice(info.salePriceLocal) : null;
  var missing = ['jp_delivery_confirmation', 'currency_context_JPY', 'current_affiliate_confirmation', 'official_promotion_link', 'captured_at'];
  if (price === null) missing.push('selected_sku_price');
  if (stock === null) missing.push('selected_sku_stock');
  if (price !== null && !Number.isInteger(price)) missing.push('integer_JPY_price_confirmation');
  return { source: 'product_page_response', sku_id: sku, observed_local_price: price, observed_sku_stock: stock,
    stock_status: stock === null ? 'unknown' : stock > 0 ? 'in_stock' : 'out_of_stock', missing_fields: missing };
}
function normalizeApi(data) {
  if (!data || typeof data !== 'object' || Array.isArray(data)) throw new Error('pass one product object, not the response envelope');
  var item = idText(data.product_id);
  var currency = typeof data.target_sale_price_currency === 'string' ? data.target_sale_price_currency : null;
  var price = currency === 'JPY' ? jpyPrice(data.target_sale_price) : null;
  return {
    source: 'affiliate_api_product_object', item_id: item,
    title_ja_candidate: typeof data.product_title === 'string' ? data.product_title : null,
    api_price_candidate: price, api_price_currency: currency,
    product_page_url: typeof data.product_detail_url === 'string' ? data.product_detail_url : null,
    promotion_link_candidate: typeof data.promotion_link === 'string' ? data.promotion_link : null,
    sku_id: null, stock_status: 'unknown', ship_to_jp: null, affiliate_status: 'unknown',
    missing_fields: ['successful_response_context', 'selected_sku_price_stock', 'jp_delivery_confirmation', 'current_affiliate_confirmation', 'image_rights', 'captured_at'].concat(item ? [] : ['exact_product_id'])
  };
}
var sourceNormalizer = { normalizePortal: normalizePortal, normalizePdp: normalizePdp, normalizeApi: normalizeApi };
if (typeof module === 'object' && module.exports) module.exports = sourceNormalizer;
else globalThis.AESourceNormalizer = sourceNormalizer;

if (typeof require === 'function' && require.main === module) {
  try {
    var args = process.argv.slice(2);
    if (!['portal', 'pdp', 'api'].includes(args[0]) || !args[1]) throw new Error('usage: node source-normalizer.js portal|pdp|api saved.json [sku_id]');
    var data = JSON.parse(require('fs').readFileSync(args[1], 'utf8'));
    var result = args[0] === 'portal' ? normalizePortal(data) : args[0] === 'pdp' ? normalizePdp(data, args[2]) : normalizeApi(data);
    console.log(JSON.stringify(result, null, 2));
  } catch (e) {
    console.error(e.message);
    process.exitCode = 1;
  }
}
node source-normalizer.js pdp saved-pdp.json 指定SKU_ID
node source-normalizer.js portal saved-check.json
node source-normalizer.js api saved-product.json

F12 では、保存した必要部分をオブジェクト変数にして AESourceNormalizer.normalizePdp(商品応答, "指定SKU_ID") または normalizePortal(Portals応答) を呼びます。解析結果の不足項目・根拠・公式リンクを 01 で契約へ取り込みます。確認できない値を 0 / N / 下架に置換しません。

03

実レスポンス → キットの契約

独自 JSON を「AE のネイティブ API 仕様」と呼ばない
取得元キットへの取り込み取り違えないもの
product_id同じ商品を照合して item_id に文字列保存SKU ID、JavaScript の精度が失われた長い数値
product_detail_url / promotion_link商品ページ証拠/affiliate_url・link_policy.original_url商品ページをそのまま成果リンクと呼ばない
sale_price / app_sale_price / target_sale_price候補価格。指定 SKU と購入条件を確認して page_price へ最終決済額、全ユーザー共通価格、券の自動重複適用
lastest_volume / code_quantity販売数/Code 残数として別に扱うstock_status へ転記しない
現在の資格/マーケティング対象affiliate_status・affiliate_verified_at/is_hot_product過去注文の資格値を現在の商品資格の証拠にしない。検索欠落も非対象の証明ではない
券の利用条件・実際の決済確認offers と scenario。適用しない特典は条件付き表示本キットの順次割引モデルを AE 全券共通のルールと呼ばない

契約のキーが未確認でも保存可能とは限りません。null を許可しない数値は仮値で埋めず、不足を報告して下書きに留めます。公開ゲートは根拠の実在やアカウント権限そのものをオンライン検証する機能ではありません。

04

公式リンクと S2S

遷移できること、計測できること、報酬が精算されたことは別

通常:Portals/公式転リンク API の返却を原本として保存し、無加工で使用。公式原本に存在するクエリを一律に削除しません。既定の許可ホストは s.click.aliexpress.com。未知の公式形態は原本を保って人が確認します。

S2S:Portals の S2S 設定で自分の受信サーバーとフィールドを設定した場合、公式に許可された透伝を利用できます。静的 HTML だけでは受信できません。

パラメータ用途・条件
afSID。サブアフィリエイト登録済みの場合のみ
cn / cvキャンペーン/クリエイティブ識別。受信側の対応フィールドを設定する
dp動的識別子。クリック ID の透伝に使える。メール・会員 ID 等の個人情報を公開 URL に入れない

キットでは link_policy.mode=s2s、s2s_configured=true、af 利用時は sub_affiliate_registered=true。原本を変更せず許可キーだけ追加し、未知・重複・空値を拒否します。値の文字種・長さ制限は本キット独自の保守的なゲートであり AE の全仕様ではありません。

支払通知と精算を混ぜないS2S / 注文 API
  • S2S の order_id は子注文 ID。親注文・買い手 ID と同一視しません。
  • effect_pay_time は米国太平洋時間の処理時刻で、実支払時刻から遅れる場合があります。America/Los_Angeles で夏時間を考慮。全 API の日時を一律 PST と決めつけません。
  • order_amount は USD、dollars / cents は設定で確認。local_order_amout は原フィールドの綴りのまま受信し、通貨と単位を別に記録します。
  • commission_fee は支払時点の見込報酬。exchange_rate の 0 / 1 を実際の為替レートとして計算しません。
  • API の支払ベースは PaymentCompletedTime と対象状態、精算は CompletedSettlementTime + CompletedSettlement を区別。現在の仕様で確認します。
  • 接続テストはサーバー到達・マッピング確認。実際の帰属・無効注文・精算結果は自分の許諾されたレポートで別に確認します。

運用は 成果レビューへ。内部報告、他パートナーの非公開数値、社内システムの照会方法、認証情報は外部向け生成物に含めません。

05

根拠と更新範囲

資料の記載と、現行アプリでの実行確認を分ける

参考:API Product Guidance(English、2025-03-07 更新)、S2S Product Guidance(English、2024-10-11 更新)の外部提供可能な技術事項。原資料の内部リンク・識別子・連絡先・認証例は転載していません。公開ドキュメント確認日:2026-11-18。SKU 詳細本文にはログインが必要なため、現行の全フィールドを取得・実行確認したとはしていません。

公式 Getting Started / 公式 HTTP ガイド。使用時は最新仕様・アカウント権限・利用規約を再確認してください。