小羊云商サプライチェーンプラットフォーム API

概要

このスキルは、小羊 LegendShop サプライチェーンプラットフォームの API 呼び出し機能を提供し、認証トークンを自動的に取得し、商品リストと商品詳細 API を自律的に呼び出すことができます。返されるコンテンツは、明確で簡潔な構造化されたコンテンツに整理されます。

使用シナリオ:

• ユーザーが商品リスト、供給元リストを尋ねる
• 商品価格、在庫情報を照会する
• ドロップシッピング商品の詳細を理解する
• 商品選定の参考：サプライチェーン商品を表示する

API 基本情報

• ゲートウェイアドレス: https://open.legendshop.cn
• API アドレス: https://openapi.legendshop.cn
• 認証方法: Client Credentials + scope=shop
• 認証情報: client_id と client_secret は事前に設定済みです

コアインターフェース

1. 認証トークンの取得

エンドポイント: POST /portal/login/getToken

アドレス: https://openapi.legendshop.cn/portal/login/getToken

リクエストパラメータ: | パラメータ | タイプ | 必須 | 説明 | |------|------|------|------| | client_id | String | はい | クライアントID | | client_secret | String | はい | クライアントシークレット | | scope | String | はい | 固定で shop を渡します（V2インターフェース） |

レスポンスパラメータ: | パラメータ | タイプ | 説明 | |------|------|------| | access_token | String | アクセストークン | | expires_in | Number | 有効期限（秒） | | scope | String | 権限範囲 |

アクセストークンは自動的に取得され、手動で管理する必要はありません。

2. 開発者資金口座残高の照会

エンドポイント: POST /open/v2/captital/getAccount

環境:

• 本番環境: https://openapi.legendshop.cn/open/v2/captital/getAccount
• テスト環境: http://openapi.legendmall.cn/open/v2/captital/getAccount

リクエストヘッダー: | パラメータ | タイプ | 必須 | 説明 | |------|------|------|------| | Authorization | String | はい | Bearer Token、getToken インターフェースで取得 |

リクエストパラメータ: なし

レスポンスパラメータ: | パラメータ | タイプ | 説明 | |------|------|------| | status | Number | ステータスコード、1は成功、その他は失敗を表します | | success | Boolean | 成功したかどうか、trueは成功、falseは失敗を表します | | message | String | 返される情報メッセージ | | data | Number | 開発者資金残高 |

リターンコード: | コード | 説明 | |------|------| | 2001 | ユーザー権限が不足しています。開発者アカウントの開設を申請する必要があります | | 0000 | 操作成功 |

レスポンス例:

{
  "status": "1",
  "success": "true",
  "message": "メッセージ",
  "data": "100.10"
}

3. 商品プールページング照会

エンドポイント: POST /open/v2/product/queryProdPage

アドレス: https://openapi.legendshop.cn/open/v2/product/queryProdPage

リクエスト方式: POST

リクエストヘッダー: | パラメータ | タイプ | 必須 | 説明 | |------|------|------|------| | Authorization | String | はい | Bearer Token | | Content-Type | String | はい | application/x-www-form-urlencoded |

リクエストパラメータ: | パラメータ | タイプ | デフォルト値 | 説明 | |------|------|--------|------| | pageNum | integer | 1 | ページ番号 | | pageSize | integer | 12 | 1ページあたりの数量 |

レスポンスパラメータ: | パラメータ | タイプ | 説明 | |------|------|------| | success | Boolean | 成功したかどうか | | status | String | ステータスコード | | data.prods | Array | 商品IDリスト | | data.totals | Number | 合計数 |

レスポンス例:

{
  "success": true,
  "status": "0000",
  "message": "操作成功",
  "data": {
    "prods": ["1249846", "1249848", "1249849"],
    "offset": "1249849",
    "totals": 214427
  }
}

4. 商品詳細照会

エンドポイント: POST /open/v2/product/getDetail

アドレス: https://openapi.legendshop.cn/open/v2/product/getDetail

リクエスト方式: POST

リクエストヘッダー: | パラメータ | タイプ | 必須 | 説明 | |------|------|------|------| | Authorization | String | はい | Bearer Token | | Content-Type | String | はい | application/x-www-form-urlencoded |

リクエストパラメータ: | パラメータ | タイプ | 必須 | 説明 | |------|------|------|------| | prodId | String | はい | 商品ID（queryProdPage から取得した prodId、仕入れ商品IDではありません） |

レスポンスパラメータ: | パラメータ | タイプ | 説明 | |------|------|------| | prodId | String | 商品ID | | supplierSpuId | String | サプライヤーSPU ID | | name | String | 商品名 | | price | String | 価格 | | skuDtoList | Array | SKUリスト | | images | Array | 商品画像 | | parameters | Array | 商品パラメータ |

リターンコード: | コード | 説明 | |------|------| | 1005 | 商品IDは空にできません | | 2004 | 商品プールの権限が不足しています |

使用手順

標準呼び出し手順

1. トークンの自動取得: api_client.py token を呼び出してアクセストークンを取得します
2. 商品リストの照会: api_client.py list [page] [size] を呼び出して商品リストを取得します
3. 商品詳細の取得: spuId に基づいて api_client.py detail <spuId> を呼び出して詳細を取得します
4. 資金残高の照会: api_client.py balance を呼び出して開発者資金口座残高を取得します

クイック照会例

# 1. トークンの取得
python scripts/api_client.py token

# 2. 商品リストの取得（1ページ目、1ページあたり12件）
python scripts/api_client.py list 1 12

# 3. 商品詳細の取得
python scripts/api_client.py detail <spuId>

# 4. 資金口座残高の照会
python scripts/api_client.py balance

出力形式

API 呼び出し後、返されるデータは以下の形式に整理されます。

商品リスト形式

**商品リスト** (合計 {total} 件の商品、{page}/{pages} ページ)

| # | 商品名称 | 価格 | 在庫 | 操作 |
|---|---------|------|------|------|
| 1 | {name} | ¥{price} | {stock} | [詳細を見る] |
| 2 | ... | ... | ... | ... |

商品詳細形式

**商品詳細**: {name}

| 項目 | 内容 |
|------|------|
| 商品ID | {spuId} |
| 価格 | ¥{price} |
| 在庫 | {stock} |
| 説明 | {description} |

**SKU 規格**:
| 規格 | 価格 | 在庫 |
|------|------|------|
| {spec} | ¥{price} | {stock} |

資金口座残高形式

**開発者資金口座残高**

| 項目 | 内容 |
|------|------|
| ステータス | {status} |
| 成功したかどうか | {success} |
| メッセージ | {message} |
| 残高 | ¥{data} |

注意事項

1. 実データのみを返す: 商品情報、価格、在庫を捏造することは禁止されています
2. リストを先に、詳細を後に: まず商品リストインターフェースを呼び出し、詳細が必要な場合にのみ単品資料を呼び出します
3. 構造化された返信: 返されるコンテンツは、明確で簡潔な構造化された形式に整理されます
4. エラー処理: API 呼び出しが失敗した場合は、ユーザーに後で再試行するよう促します
5. 資金照会: 資金口座残高インターフェースには有効な認証トークンが必要です。リターンコード 2001 は権限不足を示します

リソース

scripts/

• api_client.py: API 呼び出しスクリプト。トークン取得、商品リスト照会、商品詳細照会、資金残高照会をサポートします

references/

• api_spec.yaml: OpenAPI 3.0 仕様ドキュメント。完全な API 定義とフィールド説明が含まれています