update APIs 20260712

1 files changed, 554 insertions, 0 deletions

diff --git a/data/zh_cn/agentretailvision/2026-05-06/api-docs.php b/data/zh_cn/agentretailvision/2026-05-06/api-docs.php
new file mode 100644
index 0000000..acd9609
--- /dev/null
+++ b/data/zh_cn/agentretailvision/2026-05-06/api-docs.php
@@ -0,0 +1,554 @@
+<?php return [
+    'version' => '1.0',
+    'info' => ['style' => 'RPC', 'product' => 'AgentRetailVision', 'version' => '2026-05-06'],
+    'directories' => ['GenerateGroupImage', 'ImportProducts', 'QueryRecognitionResult', 'RecognizeOrder', 'RegisterWebhook', 'UpdateProduct'],
+    'components' => [
+        'schemas' => [],
+    ],
+    'apis' => [
+        'GenerateGroupImage' => [
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'GroupId',
+                    'in' => 'query',
+                    'schema' => ['title' => '调用方生成的组图请求ID', 'description' => '调用方生成的组图请求ID', 'type' => 'string', 'required' => false, 'example' => 'a5561c14-b5cd-49a4-ab79-01a63b10d99c'],
+                ],
+                [
+                    'name' => 'GroupType',
+                    'in' => 'query',
+                    'schema' => ['title' => '组图类型：1 = 单 SKU 多图组图；2 = 多 SKU 组图', 'description' => '组图类型：1 = 单 SKU 多图组图；2 = 多 SKU 组图', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'],
+                ],
+                [
+                    'name' => 'PlatformItemIdList',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '平台商品ID列表，对应 smart_retail_item.platform_item_id',
+                        'description' => '平台商品ID列表，对应 smart_retail_item.platform_item_id',
+                        'type' => 'array',
+                        'items' => ['description' => '平台商品ID', 'type' => 'string', 'required' => false, 'example' => '09b3c623e32d49aaba78c55ddcc7cb63'],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'CallbackUrl',
+                    'in' => 'query',
+                    'schema' => ['title' => '客户回调地址', 'description' => '客户回调地址', 'type' => 'string', 'required' => false, 'example' => 'https://xxx.com'],
+                ],
+                [
+                    'name' => 'CallbackSecret',
+                    'in' => 'query',
+                    'schema' => ['title' => '回调验签密钥', 'description' => '回调验签密钥', 'type' => 'string', 'required' => false, 'example' => 'your_secret_key'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '202'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                            'Data' => [
+                                'title' => '组图生成结果',
+                                'description' => '组图生成结果',
+                                'type' => 'object',
+                                'properties' => [
+                                    'GroupId' => ['title' => '组图请求ID', 'description' => '组图请求ID', 'type' => 'string', 'example' => 'a5561c14-b5cd-49a4-ab79-01a63b10d99c'."\n"],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => '组图',
+            'summary' => '组图接口，用于单item多图和多item生成组图',
+            'description' => '## 请求说明'."\n"
+                .'- `groupType=1`时，`platformItemIdList`必须只能包含一个元素'."\n"
+                .'- `groupType=2`时，`platformItemIdList`可以包含1-10个元素',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"202\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\",\\n  \\"Data\\": {\\n    \\"GroupId\\": \\"a5561c14-b5cd-49a4-ab79-01a63b10d99c\\\\n\\"\\n  }\\n}","type":"json"}]',
+        ],
+        'ImportProducts' => [
+            'summary' => '用于新增商品信息，导入成功后，平台返回全局唯一 platform_item_id，供后续更新和识别结果关联使用。',
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'ItemUniqueId',
+                    'in' => 'query',
+                    'schema' => ['title' => '业务方商品ID，同一业务方下唯一', 'description' => '业务方商品ID，同一业务方下唯一', 'type' => 'string', 'required' => false, 'example' => 'ITEM_001'],
+                ],
+                [
+                    'name' => 'ImageTitle',
+                    'in' => 'query',
+                    'schema' => ['title' => '商品标题', 'description' => '商品标题', 'type' => 'string', 'required' => false, 'example' => '可口可乐330ml'],
+                ],
+                [
+                    'name' => 'MainImage',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '商品主图图片URL列表，至少1张',
+                        'description' => '商品主图图片URL列表，至少1张',
+                        'type' => 'array',
+                        'items' => ['description' => '单房间多图情况下，是否为主图，默认true', 'type' => 'string', 'required' => false, 'example' => 'https://img.example.com/item1.jpg'],
+                        'required' => false,
+                        'example' => '["https://img.example.com/item1.jpg"]',
+                    ],
+                ],
+                [
+                    'name' => 'MultiViewImages',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'description' => '商品多角度图片列表',
+                        'type' => 'array',
+                        'items' => [
+                            'type' => 'object',
+                            'properties' => [
+                                'Url' => ['description' => '任务URL。', 'type' => 'string', 'required' => false, 'example' => 'https://img5-parcel.oss-cn-hangzhou.aliyuncs.com/2026/01/12/78568805914464s.jpeg?07'],
+                                'Angle' => ['description' => '数字人角度'."\n"
+                                    ."\n"
+                                    .'- 0: 正面，默认角度'."\n"
+                                    .'- 1: 左侧30度'."\n"
+                                    .'- 2: 右侧30度'."\n"
+                                    ."\n"
+                                    .'具体每个角度的效果预览可以参考：[3D数字人视频合成使用指南](https://help.aliyun.com/document_detail/447834.html#a989eb5075t9y)', 'type' => 'string', 'required' => false, 'example' => '0'],
+                            ],
+                            'required' => false,
+                            'description' => '',
+                        ],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'ExtraImages',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '其余可提供的图片URL列表',
+                        'description' => '其余可提供的图片URL列表',
+                        'type' => 'array',
+                        'items' => ['description' => '图片URL', 'type' => 'string', 'required' => false, 'example' => 'https://img.example.com/item1.jpg'],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'DeviceId',
+                    'in' => 'query',
+                    'schema' => ['title' => '设备号，用于建立设备商品向量关联', 'description' => '设备号，用于建立设备商品向量关联', 'type' => 'string', 'required' => false, 'example' => 'DEVICE_001'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '200'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                            'Data' => [
+                                'title' => '商品信息',
+                                'description' => '商品信息',
+                                'type' => 'object',
+                                'properties' => [
+                                    'ItemUniqueId' => ['title' => '业务方商品ID，同一业务方下唯一', 'description' => '业务方商品ID，同一业务方下唯一', 'type' => 'string', 'example' => 'ITEM_001'],
+                                    'PlatformItemId' => ['title' => '平台商品ID，全局唯一', 'description' => '平台商品ID，全局唯一', 'type' => 'string', 'example' => 'PLAT_001'],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => '商品库上传',
+            'description' => '## 请求说明'."\n"
+                .'- 该接口用于用户新增商品信息。'."\n"
+                .'- 用户导入商品库后，会存储至阿里云OSS，便于商品识别API直接调用召回检索。'."\n"
+                .'- 必须提供至少一张主图URL，并且`item_unique_id`在同一业务方下必须唯一。'."\n"
+                .'- 可选提供多角度视图和额外图片以提高识别精度。'."\n"
+                .'- `device_id`字段可用于建立设备与商品向量之间的关联，但非必填。',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"200\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\",\\n  \\"Data\\": {\\n    \\"ItemUniqueId\\": \\"ITEM_001\\",\\n    \\"PlatformItemId\\": \\"PLAT_001\\"\\n  }\\n}","type":"json"}]',
+        ],
+        'QueryRecognitionResult' => [
+            'summary' => '需要至少需要接入一种结果获取方式：webhook 回调或任务状态查询；两种方式可同时接入。'."\n"
+                .'	•	若用户选择 webhook 回调方式，需要提前准备好接收接口，并按以下入参和出参实现。'."\n"
+                .'	•	当识别任务结束后，平台将根据任务绑定的回调地址向业务方推送结果。',
+            'path' => '',
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'TaskId',
+                    'in' => 'query',
+                    'schema' => ['title' => '平台任务ID', 'description' => '平台任务ID', 'type' => 'string', 'required' => false, 'example' => 'TASK_001'],
+                ],
+                [
+                    'name' => 'OrderUniqueId',
+                    'in' => 'query',
+                    'schema' => ['title' => '业务方幂等请求ID', 'description' => '业务方幂等请求ID', 'type' => 'string', 'required' => false, 'example' => 'ORDER_001'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '200'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                            'Data' => [
+                                'title' => '任务详情',
+                                'description' => '任务详情',
+                                'type' => 'object',
+                                'properties' => [
+                                    'TaskId' => ['title' => '平台任务ID', 'description' => '平台任务ID', 'type' => 'string', 'example' => 'TASK_001'],
+                                    'OrderUniqueId' => ['title' => '业务方唯一幂等ID', 'description' => '业务方唯一幂等ID', 'type' => 'string', 'example' => 'ORDER_001'],
+                                    'TaskStatus' => ['title' => '任务状态', 'description' => '任务状态', 'type' => 'string', 'example' => 'COMPLETED'],
+                                    'Result' => [
+                                        'title' => '识别结果',
+                                        'description' => '识别结果',
+                                        'type' => 'object',
+                                        'properties' => [
+                                            'CheckoutInfo' => [
+                                                'title' => '结账信息',
+                                                'description' => '结账信息',
+                                                'type' => 'object',
+                                                'properties' => [
+                                                    'CheckoutStatus' => [
+                                                        'title' => '结账状态',
+                                                        'description' => '结账状态',
+                                                        'type' => 'string',
+                                                        'enumValueTitles' => ['TRUSTED：可直接结算' => 'TRUSTED：可直接结算', 'SUSPECT：建议人工复核' => 'SUSPECT：建议人工复核', 'ABNORMAL：无法处理' => 'ABNORMAL：无法处理'],
+                                                        'example' => 'TRUSTED',
+                                                    ],
+                                                ],
+                                            ],
+                                            'Items' => [
+                                                'title' => '识别到的商品列表',
+                                                'description' => '识别到的商品列表',
+                                                'type' => 'array',
+                                                'items' => [
+                                                    'description' => '请求ID。',
+                                                    'type' => 'object',
+                                                    'properties' => [
+                                                        'PlatformItemId' => ['title' => '平台商品ID', 'description' => '平台商品ID', 'type' => 'string', 'example' => '535c3daaee3b4b5382db4913413419bc2d'],
+                                                        'ItemUniqueId' => ['title' => '业务方商品ID', 'description' => '业务方商品ID', 'type' => 'string', 'example' => '690234524880781'],
+                                                        'Quantity' => ['title' => '商品数量', 'description' => '商品数量', 'type' => 'integer', 'format' => 'int32', 'example' => '1'],
+                                                    ],
+                                                ],
+                                            ],
+                                        ],
+                                    ],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => 'Webhook 回调API',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"200\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\",\\n  \\"Data\\": {\\n    \\"TaskId\\": \\"TASK_001\\",\\n    \\"OrderUniqueId\\": \\"ORDER_001\\",\\n    \\"TaskStatus\\": \\"COMPLETED\\",\\n    \\"Result\\": {\\n      \\"CheckoutInfo\\": {\\n        \\"CheckoutStatus\\": \\"TRUSTED\\"\\n      },\\n      \\"Items\\": [\\n        {\\n          \\"PlatformItemId\\": \\"535c3daaee3b4b5382db4913413419bc2d\\",\\n          \\"ItemUniqueId\\": \\"690234524880781\\",\\n          \\"Quantity\\": 1\\n        }\\n      ]\\n    }\\n  }\\n}","type":"json"}]',
+        ],
+        'RecognizeOrder' => [
+            'summary' => '用于智能识别场景， 需要上传购物视频 OSS 地址，平台创建异步识别任务并立即返回task_id, 通过webhook 通知，需要主动查询接口获取结果',
+            'path' => '',
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'OrderUniqueId',
+                    'in' => 'query',
+                    'schema' => ['title' => '业务方唯一幂等ID，同一业务方下唯一', 'description' => '业务方唯一幂等ID，同一业务方下唯一', 'type' => 'string', 'required' => false, 'example' => 'ORDER_001'],
+                ],
+                [
+                    'name' => 'VideoUrls',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '购物视频OSS地址列表（目前只支持一个）',
+                        'description' => '购物视频OSS地址列表（目前只支持一个）',
+                        'type' => 'array',
+                        'items' => ['description' => '录制视频的URL地址。', 'type' => 'string', 'required' => false, 'example' => 'https://oss.example.com/video1.mp4'],
+                        'required' => false,
+                        'example' => '["https://oss.example.com/video1.mp4"]',
+                    ],
+                ],
+                [
+                    'name' => 'DeviceId',
+                    'in' => 'query',
+                    'schema' => ['title' => '设备号', 'description' => '设备号', 'type' => 'string', 'required' => false, 'example' => 'DEVICE_001'],
+                ],
+                [
+                    'name' => 'CandidateItems',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '候选商品列表，建议传platform_item_id',
+                        'description' => '候选商品列表，建议传platform_item_id',
+                        'type' => 'array',
+                        'items' => ['description' => '候选商品', 'type' => 'string', 'required' => false, 'example' => '535c3daaadgaf5382db49a90969bc2d'],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'CallbackUrl',
+                    'in' => 'query',
+                    'schema' => ['title' => '本次任务回调地址；不传则使用已注册默认地址', 'description' => '本次任务回调地址；不传则使用已注册默认地址', 'type' => 'string', 'required' => false, 'example' => 'https://example.com/callback'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '200'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                            'Data' => [
+                                'title' => '识别任务信息',
+                                'description' => '识别任务信息',
+                                'type' => 'object',
+                                'properties' => [
+                                    'TaskId' => ['title' => '平台任务ID', 'description' => '平台任务ID', 'type' => 'string', 'example' => 'TASK_001'],
+                                    'OrderUniqueId' => ['title' => '业务方唯一幂等ID', 'description' => '业务方唯一幂等ID', 'type' => 'string', 'example' => 'ORDER_001'],
+                                    'TaskStatus' => ['title' => '任务状态', 'description' => '任务状态', 'type' => 'string', 'example' => 'PROCESSING'],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => '购物识别API',
+            'description' => '## 请求说明'."\n"
+                .'- 用户需提供`caller_uid`和`order_unique_id`作为必填参数。'."\n"
+                .'- `video_urls`参数支持mp4, avi, mov, mkv格式的视频文件，大小限制在100M以内，时长不超过3分钟，分辨率要求为480p至1080p之间，且满足特定的长宽比条件。'."\n"
+                .'- 至少需要提供`device_id`或`candidate_items`之一来指定识别范围；如果两者都提供，则先按设备商品库过滤，再根据候选商品列表进一步筛选。'."\n"
+                .'- 可选地，用户可以指定一个`callback_url`用于接收识别结果的通知。如果没有提供，则使用预先注册的默认webhook地址。'."\n"
+                .'- 如果使用相同的`order_unique_id`重复提交请求，系统将直接返回之前已存在的任务状态。',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"200\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\",\\n  \\"Data\\": {\\n    \\"TaskId\\": \\"TASK_001\\",\\n    \\"OrderUniqueId\\": \\"ORDER_001\\",\\n    \\"TaskStatus\\": \\"PROCESSING\\"\\n  }\\n}","type":"json"}]',
+        ],
+        'RegisterWebhook' => [
+            'summary' => '用于注册&更新默认webhook 回调地址',
+            'path' => '',
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'CallbackUrl',
+                    'in' => 'query',
+                    'schema' => ['title' => '默认回调地址，要求公网HTTPS', 'description' => '默认回调地址，要求公网HTTPS', 'type' => 'string', 'required' => false, 'example' => 'https://example.com/callback'],
+                ],
+                [
+                    'name' => 'CallbackSecret',
+                    'in' => 'query',
+                    'schema' => ['title' => '回调验签密钥', 'description' => '回调验签密钥', 'type' => 'string', 'required' => false, 'example' => 'your_secret_key'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '200'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => 'Webhook 地址注册API',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"200\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\"\\n}","type":"json"}]',
+        ],
+        'UpdateProduct' => [
+            'summary' => '用于更新平台内已存在的商品信息。',
+            'path' => '',
+            'methods' => ['post'],
+            'schemes' => ['https'],
+            'security' => [
+                [
+                    'AK' => [],
+                ],
+            ],
+            'operationType' => 'readAndWrite',
+            'deprecated' => false,
+            'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'paid', 'tenantRelevance' => 'tenant'],
+            'parameters' => [
+                [
+                    'name' => 'ItemUniqueId',
+                    'in' => 'query',
+                    'schema' => ['title' => '业务方商品ID，同一业务方下唯一', 'description' => '业务方商品ID，同一业务方下唯一', 'type' => 'string', 'required' => false, 'example' => 'ITEM_001'],
+                ],
+                [
+                    'name' => 'PlatformItemId',
+                    'in' => 'query',
+                    'schema' => ['title' => '平台商品ID，全局唯一', 'description' => '平台商品ID，全局唯一', 'type' => 'string', 'required' => false, 'example' => 'PLAT_001'],
+                ],
+                [
+                    'name' => 'ImageTitle',
+                    'in' => 'query',
+                    'schema' => ['title' => '商品标题', 'description' => '商品标题', 'type' => 'string', 'required' => false, 'example' => '可口可乐330ml'],
+                ],
+                [
+                    'name' => 'MainImage',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '商品主图图片URL列表，至少1张',
+                        'description' => '商品主图图片URL列表，至少1张',
+                        'type' => 'array',
+                        'items' => ['title' => '1', 'description' => '1', 'type' => 'string', 'required' => false, 'example' => 'https://img.example.com/item1.jpg'],
+                        'required' => false,
+                        'example' => '["https://img.example.com/item1.jpg"]',
+                    ],
+                ],
+                [
+                    'name' => 'MultiViewImages',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'description' => '商品多角度图片列表',
+                        'type' => 'array',
+                        'items' => [
+                            'type' => 'object',
+                            'properties' => [
+                                'Url' => ['description' => 'URL地址', 'type' => 'string', 'required' => false, 'example' => 'https://nova-tems.oss-cn-shanghai.aliyuncs.com/crop/33dfc602-c9a4-11f0-ac99-ee21a901d6ec.png?OSSAccessKeyId=****&Expires=1764058353&Signature=****'],
+                                'Angle' => ['description' => '数字人角度'."\n"
+                                    ."\n"
+                                    .'- 0: 正面，默认角度'."\n"
+                                    .'- 1: 左侧30度'."\n"
+                                    .'- 2: 右侧30度'."\n"
+                                    ."\n"
+                                    .'具体每个角度的效果预览可以参考：[3D数字人视频合成使用指南](https://help.aliyun.com/document_detail/447834.html#a989eb5075t9y)', 'type' => 'string', 'required' => false, 'example' => '0'],
+                            ],
+                            'required' => false,
+                            'description' => '',
+                        ],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'ExtraImages',
+                    'in' => 'query',
+                    'style' => 'json',
+                    'schema' => [
+                        'title' => '其余可提供的图片URL列表',
+                        'description' => '其余可提供的图片URL列表',
+                        'type' => 'array',
+                        'items' => ['title' => '额外图片列表中的第一张图片', 'description' => '额外图片列表中的第一张图片', 'type' => 'string', 'required' => false, 'example' => 'https://img.example.com/item1.jpg'],
+                        'required' => false,
+                    ],
+                ],
+                [
+                    'name' => 'DeviceId',
+                    'in' => 'query',
+                    'schema' => ['title' => '设备号，用于建立设备商品向量关联', 'description' => '设备号，用于建立设备商品向量关联', 'type' => 'string', 'required' => false, 'example' => 'DEVICE_001'],
+                ],
+            ],
+            'responses' => [
+                200 => [
+                    'schema' => [
+                        'title' => 'Schema of Response',
+                        'description' => 'Schema of Response',
+                        'type' => 'object',
+                        'properties' => [
+                            'RequestId' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string', 'example' => 'E1AD60F1-BAC7-546B-9533-E7AD02B16E3F'],
+                            'Code' => ['title' => '错误码，正常调用时，不会返回该参数。', 'description' => '错误码，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => '200'],
+                            'Success' => ['title' => '是否调用成功：true：调用成功。false：调用失败。', 'description' => '是否调用成功：true：调用成功。false：调用失败。', 'type' => 'boolean', 'example' => 'True'],
+                            'Message' => ['title' => '错误信息，正常调用时，不会返回该参数。', 'description' => '错误信息，正常调用时，不会返回该参数。', 'type' => 'string', 'example' => 'OK'],
+                            'Data' => [
+                                'title' => '商品信息',
+                                'description' => '商品信息',
+                                'type' => 'object',
+                                'properties' => [
+                                    'ItemUniqueId' => ['title' => '业务方商品ID，同一业务方下唯一', 'description' => '业务方商品ID，同一业务方下唯一', 'type' => 'string', 'example' => 'ITEM_001'],
+                                    'PlatformItemId' => ['title' => '平台商品ID，全局唯一', 'description' => '平台商品ID，全局唯一', 'type' => 'string', 'example' => 'PLAT_001'],
+                                ],
+                            ],
+                        ],
+                    ],
+                ],
+            ],
+            'staticInfo' => ['returnType' => 'synchronous'],
+            'title' => '商品更新API',
+            'description' => '## 请求说明'."\n"
+                .'- 更新时以 `platform_item_id` 作为主标识。'."\n"
+                .'- 若同时传入 `platform_item_id` 和 `item_unique_id`，二者必须指向同一商品。'."\n"
+                .'- 商品标题 (`image_title`) 和商品主图图片 URL 列表 (`main_image`) 是必填项，其中 `main_image` 至少需要提供一张图片。'."\n"
+                .'- 可选参数包括多角度图片列表 (`multi_view_images`)、其余可提供的图片 URL 列表 (`extra_images`) 以及设备号 (`device_id`)。'."\n"
+                .'- 在 `multi_view_images` 中，每个对象需包含图片 OSS 地址 (`url`) 和拍摄角度 (`angle`)，其中 `angle` 的取值范围为：上视图(`up`)、下视图(`down`)、左视图(`left`)、右视图(`right`)、前视图(`front`)、后视图(`back`)。',
+            'changeSet' => [],
+            'responseDemo' => '[{"errorExample":"","example":"{\\n  \\"RequestId\\": \\"E1AD60F1-BAC7-546B-9533-E7AD02B16E3F\\",\\n  \\"Code\\": \\"200\\",\\n  \\"Success\\": true,\\n  \\"Message\\": \\"OK\\",\\n  \\"Data\\": {\\n    \\"ItemUniqueId\\": \\"ITEM_001\\",\\n    \\"PlatformItemId\\": \\"PLAT_001\\"\\n  }\\n}","type":"json"}]',
+        ],
+    ],
+    'endpoints' => [
+        ['regionId' => 'cn-beijing', 'regionName' => '华北2（北京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'agentretailvision.cn-beijing.aliyuncs.com', 'endpoint' => 'agentretailvision.cn-beijing.aliyuncs.com', 'vpc' => ''],
+    ],
+    'errorCodes' => [],
+    'changeSet' => [],
+];