AE のデータ接続
対象は AliExpress 日本向けアフィリエイトです。淘宝・天猫・DS の仕様ではありません。商品候補の取得、指定 SKU の確認、公式転リンク、成果計測を別工程として扱います。
公式 API の経路
- AliExpress Portals 登録後、Tools → API から申請。同じアカウントで Open Platform の Affiliates アプリを作成し、審査・オンライン化・権限を確認します。
- 各インターフェースの公共パラメータ・署名・認可を確認します。/auth/token/create は認可コードを token に交換する API。全 Affiliate API がこの認可を必要とするとは限りません。任意の
app_signatureとシステム署名signは別です。 - 日本向けは言語
JA、通貨JPY、配送国JPを各 API の仕様に従って指定。言語欄に JP を入れたり、別 API に同じ国パラメータ名をコピーしたりしません。 - 返った候補を、同じ商品・SKU・配送先・購入条件で再確認してから 01 取り込みへ。取得できない値は不明のまま残します。
実際に使い分ける Affiliate API用途・権限・限界
| 公式インターフェース | 役割 | 公開前の追加確認 |
|---|---|---|
product.query | キーワード・カテゴリ等で商品候補検索。国引数は ship_to_country | アフィリエイト商品とマーケティング対象商品は同じ集合ではない。検索に出ないだけで非対象・下架と判定しない |
productdetail.get | 商品 ID の詳細。国引数は country | 商品レベルの価格・販売数は選択 SKU の価格・在庫ではない |
hotproduct.query | マーケティング対象の候補 | 人気という選定情報は、在庫・日本配送・最終価格の保証ではない |
product.sku.detail.getproduct.shipping.getproduct.smartmatch | SKU 詳細、配送、推薦。2025 年ガイドでは追加権限の申請対象 | アプリの現行権限とレスポンスを確認。基本 API だけで全 SKU 在庫が取得できるとは書かない。smartmatch の個人情報項目を無断収集しない |
featuredpromo.getfeaturedpromo.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 を現行上限として固定せず、使用するインターフェースの最新仕様を確認してください。
API 未開通:商品ページと Portals
- 自分のアカウントで通常どおり商品ページを開き、配送先を日本、通貨を JPY にして指定 SKU を選択。商品 ID と SKU ID は文字列で記録します。
- 同じ SKU の表示価格・販売可能在庫・日本配送・送料・確認時刻を確認。商品全体の最低価格や全 SKU 合計在庫で代用しません。
- 必要な場合は F12 の Network / Preview で、自分に利用が許諾された正常な商品レスポンスの必要項目だけ確認。Cookie・Token・認証ヘッダー・HAR 全体を AI や公開ファイルに渡しません。
- Portals の通常の確認機能で現在のアフィリエイト資格を確認し、公式リンクを生成。商品ページの URL とは別に保存します。
- 通信失敗・ログイン切れ・仕様変更・CAPTCHA・利用制限が出たら停止し、通常の再ログインや人手確認に戻ります。固定 Token、ログイン偽装、署名偽装、制限回避コードを配布・実行しません。
F12 レスポンスを安全に解析する送信・認証なし
以下は保存済み JSON のローカル解析器です。現行レスポンスで構造が違えば unknown。リクエスト発行やブラウザ API の再送はしません。F12 にコピーすると AESourceNormalizer を利用できます。返却値は完成 dataset ではありません。
| 観察済みの構造 | 解析の条件 |
|---|---|
PRICE.skuIdStrPriceInfoMap[sku_id].salePriceLocal | 指定 SKU のキーのみ。通貨設定の証拠は別途確認。小数を勝手に整数へ丸めない |
SKU.skuPaths[].skuIdStr / skuId / skuStock | 完全一致する SKU の非負整数在庫。複数レコードが矛盾したら unknown。明示的 0 のみ在庫切れ |
isSuccess / isAffiliateItem | Portals ページ応答。isSuccess=true かつ資格値が明示された時だけ Y / N。それ以外は unknown。安定した公開 Open API とは扱わない |
'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 / 下架に置換しません。
実レスポンス → キットの契約
| 取得元 | キットへの取り込み | 取り違えないもの |
|---|---|---|
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 を許可しない数値は仮値で埋めず、不足を報告して下書きに留めます。公開ゲートは根拠の実在やアカウント権限そのものをオンライン検証する機能ではありません。
公式リンクと S2S
通常:Portals/公式転リンク API の返却を原本として保存し、無加工で使用。公式原本に存在するクエリを一律に削除しません。既定の許可ホストは s.click.aliexpress.com。未知の公式形態は原本を保って人が確認します。
S2S:Portals の S2S 設定で自分の受信サーバーとフィールドを設定した場合、公式に許可された透伝を利用できます。静的 HTML だけでは受信できません。
| パラメータ | 用途・条件 |
|---|---|
af | SID。サブアフィリエイト登録済みの場合のみ |
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を区別。現在の仕様で確認します。 - 接続テストはサーバー到達・マッピング確認。実際の帰属・無効注文・精算結果は自分の許諾されたレポートで別に確認します。
運用は 成果レビューへ。内部報告、他パートナーの非公開数値、社内システムの照会方法、認証情報は外部向け生成物に含めません。
根拠と更新範囲
参考:API Product Guidance(English、2025-03-07 更新)、S2S Product Guidance(English、2024-10-11 更新)の外部提供可能な技術事項。原資料の内部リンク・識別子・連絡先・認証例は転載していません。公開ドキュメント確認日:2026-11-18。SKU 詳細本文にはログインが必要なため、現行の全フィールドを取得・実行確認したとはしていません。
公式 Getting Started / 公式 HTTP ガイド。使用時は最新仕様・アカウント権限・利用規約を再確認してください。