接口参考 · 查询操作
创建创意必要信息接口
taobao.universalbp.new.creative.findrequire
核对日期:2026-09-19。字段名称、类型与业务层级按淘宝文档整理;请求地址、鉴权和店铺选择按下方本站说明接入。
文档按上述日期核对;最新变更及详细场景规则请查看淘宝官方说明。
通过奇门云调用
- 签名地址:POST https://api.miandanni.com/api/wanxiang/sign;Content-Type: application/json。
- 客户购买的奇门云密钥用于申请签名;实际调用淘宝开放平台万相台官方 API。方法、字段、类型、层级、金额单位和场景以官方文档为准。奇门云校验客户服务、店铺归属与授权后签名,客户服务器直接请求淘宝并接收业务数据。
- 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在业务脚本同目录,使用 Client.call。奇门云密钥不是淘宝 AppSecret;不要求客户自行计算平台签名。
- 签名申请头 Authorization: Bearer 你的奇门云密钥。JSON 为 {shopKey, method, params};shopKey 必须属于当前客户。客户 Bearer 密钥不能转发到淘宝。
- 业务参数放入 params,保留淘宝字段名、类型、层级及枚举。对象直接使用 JSON 对象;下表业务根字段不放在请求最外层。
- app_key、session、sign、timestamp、v、format 等公共字段由服务器生成。签发的本店铺 session 和签名只能用于客户服务器,不进入前端、日志或公共仓库;AppSecret 和 refresh_token 不提供给客户。
- 本站支持店铺直接登录:top_service_context.login_type 为 1,ext 为 {} 或字符串 "{}";不允许 member_id、其他账户身份或代理登录。官方表内此类字段用于说明差异,不能照抄传入。
- 业务根对象未填写的必填子项需按官方文档补全。ID 保持精度,金额单位、日期范围和枚举以具体方法官方说明为准。
- 签发成功为 {ok:true,data:{version:1,ticketId,service,method,issuedAt,request}},不表示业务已执行;客户端按合同执行 data.request。TOP fields 原样作为字符串表单发送,不改值。
- 淘宝业务响应直接返回客户程序,保留 error_response、top_result、逐项错误和 request_id;HTTP 200 仍检查 top_result.info.ok。签名阶段失败读取奇门云 error.code、message 和 details。
- 每次签名校验密钥、服务有效期、店铺归属、淘宝应用订购及授权。业务能力仍取决于淘宝资格与推广场景。签发限流不等于平台实际调用次数。
- 一次签名只生成一份请求,不自动翻页或重试。创建、调价、启停、删除会实际生效;超时或结果未知先查询实际状态。ticketId 不是平台幂等键。
- 签名不是一次性凭据,平台接受的时间窗口内可能重放;解绑、停用或到期阻止新签发,不能即时撤回已签发请求。老客户原程序继续可用。
- 每周一北京时间凌晨2:00检查官方更新,经核对验证后同步,不承诺实时同步。官方方法尚未同步时提供完整方法名和官方链接反馈,不误判为平台权限不足。
{
"shopKey": "填写你授权店铺的 shopKey",
"method": "taobao.universalbp.new.creative.findrequire",
"params": {
"top_service_context": {
"biz_code": "universalBP",
"login_type": 1,
"ext": "{}"
},
"creative_require_query_v_o": {}
}
}这是请求结构模板。空对象和占位内容需按下方字段表填写;修改接口未填入任何真实广告编号或预算。
请求业务参数
以下路径都位于请求体的 params 内。[] 表示数组元素;嵌套字段的必填标记只描述其父对象使用时的要求。
官方 top_service_context.member_id、代理登录和扩展身份不适用于本站。本站固定使用自己的已授权店铺,login_type=1、ext={}。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_service_context | TopServiceContext必填含下级字段 | 推广业务上下文 | — |
top_service_context.biz_code | String必填 | 推广场景标识 | xxxxx |
top_service_context.login_type | Number可选 | 账户登录方式枚举:1、2=代理直投(叉乘账号) | 1 |
top_service_context.member_id | Number可选 | 广告账户标识代理直投(叉乘)时必填 | 12345 |
top_service_context.ext | String可选 | 扩展参数 | {} |
creative_require_query_v_o | CreativeRequireQueryVO必填含下级字段 | 创意查询对象 | — |
creative_require_query_v_o.creative_set_mode | String可选 | 业务字段 creative_set_mode枚举:minimalist=极简版、professional=专业版 | professional |
creative_require_query_v_o.creative_optimization | String可选 | 业务字段 creative_optimization枚举:black_creative=黑盒优先、white_creative=宝贝主图、user_defined_only=仅用户自定义 | professional |
creative_require_query_v_o.main_pic_video | String可选 | 业务字段 main_pic_video枚举:1=开、0=关 | 1 |
creative_require_query_v_o.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_require_query_v_o.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_require_query_v_o.campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_require_query_v_o.adgroup_list | AdgroupVO []可选含下级字段 | 单元列表 | — |
creative_require_query_v_o.adgroup_list[].gmt_create | Date可选 | 业务字段 gmt_create | 2023-12-09 14:34:12 |
creative_require_query_v_o.adgroup_list[].gmt_modified | Date可选 | 业务字段 gmt_modified | 2023-12-09 14:34:12 |
creative_require_query_v_o.adgroup_list[].campaign_id | Number可选 | 推广计划编号计划已经存在场景必填 | 68796878069 |
creative_require_query_v_o.adgroup_list[].campaign_name | String可选 | 推广计划名称 | 管家计划_宝贝候选集 |
creative_require_query_v_o.adgroup_list[].adgroup_id | Number可选 | 推广单元编号 | 68793666608 |
creative_require_query_v_o.adgroup_list[].adgroup_name | String可选 | 推广单元名称 | ds460418344 |
creative_require_query_v_o.adgroup_list[].online_status | Number可选 | 投放上下线状态枚举:-1=未进入投放状态、0=用户设置状态-下线、1=用户设置状态-上线、2=合同未生效、9=投放结束、105=待支付 | 0 |
creative_require_query_v_o.adgroup_list[].display_status | String可选 | 推广展示状态枚举:pause=暂停推广、start=正在推广、terminate=结束推广、wait=等待推广、pending=准备推广、wait_pay=计划未付款 | pause |
creative_require_query_v_o.adgroup_list[].audit_status | Number可选 | 业务字段 audit_status枚举:-1=待审核、0=后台下线状态、1=后台上线状态 | 1 |
creative_require_query_v_o.adgroup_list[].audit_reason | String可选 | 业务字段 audit_reason | xxxxx |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc | AdgroupOcpcVO可选含下级字段 | 单元对象 | — |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.enable_ocpc | Boolean可选 | 业务字段 enable_ocpc枚举:false=否、true=是 | true |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_ratio | Number可选 | 业务字段 ocpc_ratio | 200 |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_marketing_aim | String可选 | 业务字段 ocpc_marketing_aim | click |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ocpc_status | String可选 | 业务字段 ocpc_status枚举:new_ad_openable=可开启新广告加速、new_item_openable=可开启新品冷启动、new_ad_speeding=新广告加速加速中、new_item_speeding=新品冷启动加速中、new_ad_complete=新广告加速加速完成、new_item_complete=新品冷启动加速完成 | new_ad_complete |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.enable_cold_speed_new_item | Boolean可选 | 业务字段 enable_cold_speed_new_item枚举:true=是、false=否 | false |
creative_require_query_v_o.adgroup_list[].adgroup_ocpc.ecpc_option | Number可选 | 业务字段 ecpc_option | 1 |
creative_require_query_v_o.adgroup_list[].promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_require_query_v_o.adgroup_list[].sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_require_query_v_o.adgroup_list[].material | CommonMaterialVO可选含下级字段 | 素材 | — |
creative_require_query_v_o.adgroup_list[].material.material_id | Number可选 | 素材标识 | 714616513841 |
creative_require_query_v_o.adgroup_list[].material.material_type | Number可选 | 素材类型枚举:1=淘宝宝贝、2=淘宝店铺、3=cms LandingPage页面、4=cms 分流总页面、5=自定义、201=PC店铺LandingPage页面、202=无线店铺LandingPage页面、203=内容LandingPage页面、204=淘宝直播、210=淘宝直播用户ID、205=有好货、209=无线店铺Tab3页面、212=超级品牌日LandingPage页面、211=超级发布会LandingPage页面、301=ICBU商品、302=ICBU PC店铺LandingPage页面、303=ICBU PC店铺、8=用户ID、9=信息流淘积木用户ID、10=口碑用户ID、206=店铺优惠券、207=商品优惠券、208=直播单品、309=直播间商品半屏卡、304=1688商品、305=内容平台-短视频、306=附近门店-用户ID、307=饿了么-菜品、401=LAZADA商品、501=飞猪酒店、502=飞猪商品、503=飞猪短信、601=淘积木页面、1001=AE宝贝、1101=淘宝宝贝SKU、310=内容平台-订阅内容 | 1 |
creative_require_query_v_o.adgroup_list[].material.material_name | String可选 | 素材名称 | yiliantest测试请不要拍22 |
creative_require_query_v_o.adgroup_list[].material.title | String可选 | 展示标题 | yiliantest测试请不要拍22 |
creative_require_query_v_o.adgroup_list[].material.img_url | String可选 | 业务字段 img_url | //img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
creative_require_query_v_o.adgroup_list[].material.link_url | String可选 | 业务字段 link_url | http://item.taobao.com/item.htm?id=715121254343 |
creative_require_query_v_o.adgroup_list[].material.price | String可选 | 金额 | 999900 |
creative_require_query_v_o.adgroup_list[].material.bid_count | Number可选 | 出价数量 | 899900 |
creative_require_query_v_o.adgroup_list[].material.quantity | Number可选 | 业务字段 quantity | 10 |
creative_require_query_v_o.adgroup_list[].material.first_starts_time | Date可选 | 业务字段 first_starts_time | 2023-04-26 14:51:03 |
creative_require_query_v_o.adgroup_list[].material.starts | Date可选 | 业务字段 starts | 2023-04-26 14:51:03 |
creative_require_query_v_o.adgroup_list[].material.category_id | String可选 | 业务对象标识 | 16 50010850 |
creative_require_query_v_o.adgroup_list[].material.promotion_type | String可选 | 业务字段 promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、content=内容、short_video=短视频、user_define=自定义 | item |
creative_require_query_v_o.adgroup_list[].material.sub_promotion_type | String可选 | 业务字段 sub_promotion_type枚举:item=商品、item_private_mini=独享橱窗、shop=店铺、you_hao_huo=有好货、picture=图文、short_video=短视频、live_room=直播间、live_spot=看点、tao_blocks=淘积木、user_define_url=自定义url | item |
creative_require_query_v_o.adgroup_list[].material.life_cycle_list | ItemLifeCycleViewVO []可选含下级字段 | 列表集合列表中最多有2个元素 | — |
creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].life_cycle_desc | String可选 | 业务字段 life_cycle_desc | 新品打爆期 |
creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].color | String可选 | 业务字段 color | #36A2FC |
creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].tips | String可选 | 业务字段 tips | 近30日GMV排名在叶子类目5%以内的新品 |
creative_require_query_v_o.adgroup_list[].material.life_cycle_list[].type | Number可选 | 类型 | 1 |
creative_require_query_v_o.adgroup_list[].material.life_cycle_days | Number可选 | 业务字段 life_cycle_days | 3 |
creative_require_query_v_o.adgroup_list[].material.life_cycle_diff_with_avg | String可选 | 业务字段 life_cycle_diff_with_avg | 较慢 |
creative_require_query_v_o.adgroup_list[].material.life_cycle_diff_with_avg_tips | String可选 | 业务字段 life_cycle_diff_with_avg_tips | 快于同类目商品经历过同样阶段变化所用时间 |
creative_require_query_v_o.adgroup_list[].material.grow_desc | String可选 | 业务字段 grow_desc | 日均再成交122.55元 可提高爆品类目排名卡位 |
creative_require_query_v_o.adgroup_list[].material.grow_rank | Number可选 | 业务字段 grow_rank | 1077 |
creative_require_query_v_o.adgroup_list[].alive_group_id | Number可选 | 业务对象标识枚举:0=宝贝链接、3=订阅店铺、5=直播、6=加购、7=收藏加购、8=入会有礼、12=关注有礼、11=直播联动、10=自定义模板、13=同店搜 | 0 |
creative_require_query_v_o.adgroup_list[].alive_group_name | String可选 | 业务字段 alive_group_name | 宝贝链接(默认) |
creative_require_query_v_o.adgroup_list[].black_creative_status | String可选 | 业务字段 black_creative_status枚举:success=合成成功、fail=合成失败 | success |
creative_require_query_v_o.adgroup_list[].report_info_map | String可选 | 业务字段 report_info_map | — |
creative_require_query_v_o.adzone_list | AdzoneVO []可选含下级字段 | 列表集合 | — |
creative_require_query_v_o.adzone_list[].adzone_id | Number可选 | 业务对象标识 | 111287850198 |
creative_require_query_v_o.adzone_list[].adzone_name | String可选 | 业务字段 adzone_name | 全屏微详情 |
creative_require_query_v_o.adzone_list[].description | String可选 | 业务字段 description | 首页及购中后的全屏微详情场景 |
creative_require_query_v_o.adzone_list[].img_url | String可选 | 业务字段 img_url | https://img.alicdn.com/imgextra/i2/O1CN01PL50aZ1HTD0KEFMEq_!!6000000000758-2-tps-750-1624.png |
creative_require_query_v_o.promotion_scene | String可选 | 业务字段 promotion_scene枚举:promotion_scene_crowd=人群方舟、promotion_scene_item=店铺宝贝运营、promotion_scene_traffic=宝藏场景、AD_STRATEGY_LAXIN=策略中心拉新场景、AD_STRATEGY_SHANGXINLI=策略中心上新礼场景、AD_STRATEGY_FRESH_BOX=策略中心小黑盒场景、AD_STRATEGY_LAXIN_XINXIANG=策略中心拉新新享一笔钱场景、AD_STRATEGY_RUHUI_NEW=策略中心入会快新会员场景、AD_STRATEGY_RUHUI_OLD=策略中心入会快老会员场景、AD_STRATEGY_LIUZI=策略中心留资快场景、AD_STRATEGY_YURE=策略中心活动加速场景、AD_STRATEGY_HUODONG_ESCORT=活动全周期护航计划、AD_STRATEGY_CROWD_INDUSTRY=策略中心行业人群通、AD_STRATEGY_WHOLE_SHOP_SMART=策略中心全店放心推-智能托管、AD_STRATEGY_WHOLE_SHOP_CUSTOM=策略中心全店放心推-自定义、AD_STRATEGY_EVEN_BUDGET=策略中心均匀曝光场景、AD_STRATEGY_SXK_GUARANTEE=万相台上新快确定性保障、AD_STRATEGY_HPJS_GUARANTEE=万相台货品加速确定性保障、AD_STRATEGY_HPJS_TIME_LIMIT=万相台货品加速限时加速、AD_STRATEGY_FANS_HEADLINES=万相台粉丝头条、WXT_AGENCY_XST_CPC=服务商版一键起量(CPC)、WXT_AGENCY_XST_CPA=服务商版客源多(CPA)、WXT_AGENCY_SHEQUN=服务商版社群(CPA+CPS) | promotion_scene_crowd |
creative_require_query_v_o.optimize_target | String可选 | 优化目标枚举:conv=促进成交、coll_cart=促进加购、click=促进点击、deal_count=促进成交笔数、exposure_pv=促进曝光、mini_view=促进橱窗宝贝浏览个数、mini_interactive=促进橱窗宝贝互动、ad_strategy_wangwang=策略中心旺旺咨询、shop_potential=提升潜客人数、shop_interest_new=提升兴趣新客人数、shop_purchase_new=提升首购新客人数、shop_visit_new=提升访问新客人数、shop_repurchase=提升复购人数、high_cvr=提升高转换人群成交人数、deeplink_d=提升品牌发现人数-D、deeplink_e1=提升品牌种草人数-E、deeplink_e2=提升品牌互动人数-E、deeplink_p=提升品牌行动人数-P、deeplink_i=提升品牌首购人数-I、deeplink_n=提升品牌复购人数-N、deeplink_k=提升品牌挚爱人数-K、hf_grass_plant=预热种草、hf_impoundment=预售蓄水、hf_harvest=爆发收割、nd_click=提高互动量、nd_cart=提高加购量、nd_deal=提高成交量、ad_strategy_ruhui_count=策略中心入会快新会员场景入会量目标、ad_strategy_lzl=策略中心留资快留资量目标、ad_strategy_try=策略中心派样量、ad_strategy_view=策略中心优化展现、ad_strategy_auto_trans=策略中心自动流转、ad_strategy_trial_order=策略中心表单获客成本、ad_strategy_liuzi_cost=策略中心广义留资目标、ad_strategy_cool_start=策略中心自动冷启动、ad_strategy_cool_start_mini_aim=策略中心冷启动分阶段目标流转、wxt_agency_ai=A转I人群流转、wxt_agency_smart=自定义场景、form_submit=表单提交、trial_order=试用下单、wangwang_liuzi=旺旺留资 | conv |
creative_require_query_v_o.item_selected_mode | String可选 | 业务字段 item_selected_mode枚举:shop=全店优选、user_define=用户自定义选品、scope=范围圈选、trend=趋势选品 | shop |
creative_require_query_v_o.auto_wang_wang_picture | String可选 | 业务字段 auto_wang_wang_picture枚举:1=开、0=关 | 1 |
creative_require_query_v_o.version | String可选 | 业务字段 version | 2 |
返回业务字段
响应外层为 universalbp_new_creative_findrequire_response。下面的逻辑字段路径从该外层内部开始;样例 JSON 路径额外标注 TOP 集合包装,解析时仍需以实际返回为准。
| 字段路径 | 类型 / 必填 | 字段含义 | 示例值 |
|---|---|---|---|
top_result样例 JSON:universalbp_new_creative_findrequire_response.top_result | TopResult官方未标注必填含下级字段 | 接口业务结果 | — |
top_result.info样例 JSON:universalbp_new_creative_findrequire_response.top_result.info | TopInfo官方未标注必填含下级字段 | 执行状态信息 | — |
top_result.info.ok样例 JSON:universalbp_new_creative_findrequire_response.top_result.info.ok | Boolean官方未标注必填 | 业务是否成功 | true |
top_result.info.message样例 JSON:universalbp_new_creative_findrequire_response.top_result.info.message | String官方未标注必填 | 业务结果提示 | 参数错误 |
top_result.info.error_code样例 JSON:universalbp_new_creative_findrequire_response.top_result.info.error_code | String官方未标注必填 | 业务错误标识 | xxxxx |
top_result.creative_require_v_o样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o | CreativeRequireVO官方未标注必填含下级字段 | 创意对象 | — |
top_result.creative_require_v_o.is_special_category样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.is_special_category | Boolean官方未标注必填 | 业务字段 is_special_category枚举:true=是、false=否 | true |
top_result.creative_require_v_o.has_mini_detail_video样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.has_mini_detail_video | Boolean官方未标注必填 | 业务字段 has_mini_detail_video枚举:true=是、false=否 | true |
top_result.creative_require_v_o.creative_add_operators样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_add_operators | String []官方未标注必填 | 业务字段 creative_add_operators枚举:video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] |
top_result.creative_require_v_o.has_item_picture样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.has_item_picture | Boolean官方未标注必填 | 业务字段 has_item_picture枚举:true=是、false=否 | true |
top_result.creative_require_v_o.material_info_list样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list | CreativeMaterialInfoVO []官方未标注必填含下级字段 | 素材列表集合 | — |
top_result.creative_require_v_o.material_info_list[].material_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_id | Number官方未标注必填 | 素材标识 | 714616513841 |
top_result.creative_require_v_o.material_info_list[].is_active_item样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].is_active_item | Boolean官方未标注必填 | 业务字段 is_active_item枚举:true=是、false=否 | false |
top_result.creative_require_v_o.material_info_list[].is_special_category样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].is_special_category | Boolean官方未标注必填 | 业务字段 is_special_category枚举:true=是、false=否 | false |
top_result.creative_require_v_o.material_info_list[].has_mini_detail_video样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_mini_detail_video | Boolean官方未标注必填 | 业务字段 has_mini_detail_video枚举:true=是、false=否 | false |
top_result.creative_require_v_o.material_info_list[].mini_detail_video_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].mini_detail_video_id | Number官方未标注必填 | 视频标识 | 398436114008 |
top_result.creative_require_v_o.material_info_list[].has_item_picture样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_item_picture | Boolean官方未标注必填 | 业务字段 has_item_picture枚举:true=是、false=否 | true |
top_result.creative_require_v_o.material_info_list[].has_auto_creative样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].has_auto_creative | Boolean官方未标注必填 | 业务字段 has_auto_creative枚举:true=是、false=否 | true |
top_result.creative_require_v_o.material_info_list[].material_image_info_list样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list | MaterialImageInfoVO []官方未标注必填含下级字段 | 素材图片列表集合 | — |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].material_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].material_id | Number官方未标注必填 | 素材标识 | 714616513841 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].sync_key样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].sync_key | String官方未标注必填 | 业务字段 sync_key | xxxx |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_position样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_position | Number官方未标注必填 | 业务字段 image_position | 0 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].img_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].img_url | String官方未标注必填 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].link_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].link_url | String官方未标注必填 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].material_name样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].material_name | String官方未标注必填 | 素材名称 | 外投宝贝测试,请不要拍 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_id | Number官方未标注必填 | 图片标识 | 101 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].size样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].size | String官方未标注必填 | 业务字段 size | 800*800 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].width | Number官方未标注必填 | 业务字段 width | 800 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].height | Number官方未标注必填 | 业务字段 height | 800 |
top_result.creative_require_v_o.material_info_list[].material_image_info_list[].image_properties样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_image_info_list.material_image_info_v_o[].image_properties | String官方未标注必填 | 业务字段 image_properties | xxxxx |
top_result.creative_require_v_o.material_info_list[].material_video_list样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list | MaterialVideoVO []官方未标注必填含下级字段 | 素材视频列表 | — |
top_result.creative_require_v_o.material_info_list[].material_video_list[].tag样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].tag | String官方未标注必填 | 业务字段 tag | tag |
top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_id | Number官方未标注必填 | 视频标识 | 10101 |
top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_url | String官方未标注必填 | 业务字段 mini_detail_video_url | http://localhost |
top_result.creative_require_v_o.material_info_list[].material_video_list[].mini_detail_video_image_path样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].mini_detail_video_image_path | String官方未标注必填 | 业务字段 mini_detail_video_image_path | http://localhost |
top_result.creative_require_v_o.material_info_list[].material_video_list[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].width | Number官方未标注必填 | 业务字段 width | 100 |
top_result.creative_require_v_o.material_info_list[].material_video_list[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_video_list.material_video_v_o[].height | Number官方未标注必填 | 业务字段 height | 200 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list | MaterialImageInfoVO []官方未标注必填含下级字段 | 素材图片列表集合 | — |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].material_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].material_id | Number官方未标注必填 | 素材标识 | 714616513841 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].sync_key样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].sync_key | String官方未标注必填 | 业务字段 sync_key | xxxx |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_position样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_position | Number官方未标注必填 | 业务字段 image_position | 0 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].img_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].img_url | String官方未标注必填 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].link_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].link_url | String官方未标注必填 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].material_name样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].material_name | String官方未标注必填 | 素材名称 | 外投宝贝测试,请不要拍 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_id | Number官方未标注必填 | 图片标识 | 101 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].size样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].size | String官方未标注必填 | 业务字段 size | 800*800 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].width | Number官方未标注必填 | 业务字段 width | 800 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].height | Number官方未标注必填 | 业务字段 height | 800 |
top_result.creative_require_v_o.material_info_list[].material_sku_image_info_list[].image_properties样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material_sku_image_info_list.material_image_info_v_o[].image_properties | String官方未标注必填 | 业务字段 image_properties | xxxxx |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list | MaterialImageInfoVO []官方未标注必填含下级字段 | 图片列表集合 | — |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].material_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].material_id | Number官方未标注必填 | 素材标识 | 714616513841 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].sync_key样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].sync_key | String官方未标注必填 | 业务字段 sync_key | xxxx |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_position样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_position | Number官方未标注必填 | 业务字段 image_position | 0 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].img_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].img_url | String官方未标注必填 | 业务字段 img_url | https://img.alicdn.com/bao/uploaded/i1/3838159498/O1CN013BTEpu2K28f5CkcgG_!!3838159498.jpg |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].link_url样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].link_url | String官方未标注必填 | 业务字段 link_url | http://item.taobao.com/item.htm?id=668800719012 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].material_name样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].material_name | String官方未标注必填 | 素材名称 | 外投宝贝测试,请不要拍 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_id | Number官方未标注必填 | 图片标识 | 101 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].size样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].size | String官方未标注必填 | 业务字段 size | 800*800 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].width | Number官方未标注必填 | 业务字段 width | 800 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].height | Number官方未标注必填 | 业务字段 height | 800 |
top_result.creative_require_v_o.material_info_list[].material3x4_image_info_list[].image_properties样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.material_info_list.creative_material_info_v_o[].material3x4_image_info_list.material_image_info_v_o[].image_properties | String官方未标注必填 | 业务字段 image_properties | xxxxx |
top_result.creative_require_v_o.creative_form_infos样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos | CreativeFormInfoVO []官方未标注必填含下级字段 | 创意集合 | — |
top_result.creative_require_v_o.creative_form_infos[].type样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].type | String官方未标注必填 | 类型枚举:101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 |
top_result.creative_require_v_o.creative_form_infos[].format样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].format | Number官方未标注必填 | 业务字段 format | 2 |
top_result.creative_require_v_o.creative_form_infos[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].width | Number官方未标注必填 | 业务字段 width | 100 |
top_result.creative_require_v_o.creative_form_infos[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].height | Number官方未标注必填 | 业务字段 height | 200 |
top_result.creative_require_v_o.creative_form_infos[].num_limit样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].num_limit | Number官方未标注必填 | 业务字段 num_limit | 12 |
top_result.creative_require_v_o.creative_form_infos[].current_creative_num样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].current_creative_num | Number官方未标注必填 | 业务字段 current_creative_num | 10 |
top_result.creative_require_v_o.creative_form_infos[].tag样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].tag | String官方未标注必填 | 业务字段 tag | tag |
top_result.creative_require_v_o.creative_form_infos[].text样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].text | String官方未标注必填 | 业务字段 text | 513x750 |
top_result.creative_require_v_o.creative_form_infos[].desc_info样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].desc_info | String官方未标注必填 | 业务字段 desc_info | 竖版模板 |
top_result.creative_require_v_o.creative_form_infos[].content样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].content | String官方未标注必填 | 内容 | xxxxxx |
top_result.creative_require_v_o.creative_form_infos[].icon样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].icon | String官方未标注必填 | 业务字段 icon | xxxxxx |
top_result.creative_require_v_o.creative_form_infos[].creative_add_operators样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].creative_add_operators | String []官方未标注必填 | 业务字段 creative_add_operators枚举:video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] |
top_result.creative_require_v_o.creative_form_infos[].template_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.creative_form_infos.creative_form_info_v_o[].template_id | Number官方未标注必填 | 模板标识 | 202396 |
top_result.creative_require_v_o.smart_creative_form_infos样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos | CreativeFormInfoVO []官方未标注必填含下级字段 | 创意集合 | — |
top_result.creative_require_v_o.smart_creative_form_infos[].type样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].type | String官方未标注必填 | 类型枚举:101=竖版大图800x1200、102=竖版视频800x1200、103=竖版长图513x750、104=竖版视频512x750、105=竖版模板513x750、113=方图800x800、114=方视频800x800、115=横版大图320x90、116=横版大图240x100、117=横版大图140x120、118=横版大图730x350、119=横版大图846x220、120=横版大图780x210、121=横版大图840x90、122=横版大图180x100、124=横版大图980x200、125=横版大图820x90、126=竖版视频750x1000、127=竖版视频720x960、128=竖版视频1080x1440、129=竖版视频720x1280、130=竖版视频1080x1920 | 103 |
top_result.creative_require_v_o.smart_creative_form_infos[].format样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].format | Number官方未标注必填 | 业务字段 format | 2 |
top_result.creative_require_v_o.smart_creative_form_infos[].width样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].width | Number官方未标注必填 | 业务字段 width | 100 |
top_result.creative_require_v_o.smart_creative_form_infos[].height样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].height | Number官方未标注必填 | 业务字段 height | 200 |
top_result.creative_require_v_o.smart_creative_form_infos[].num_limit样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].num_limit | Number官方未标注必填 | 业务字段 num_limit | 12 |
top_result.creative_require_v_o.smart_creative_form_infos[].current_creative_num样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].current_creative_num | Number官方未标注必填 | 业务字段 current_creative_num | 10 |
top_result.creative_require_v_o.smart_creative_form_infos[].tag样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].tag | String官方未标注必填 | 业务字段 tag | tag |
top_result.creative_require_v_o.smart_creative_form_infos[].text样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].text | String官方未标注必填 | 业务字段 text | 513x750 |
top_result.creative_require_v_o.smart_creative_form_infos[].desc_info样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].desc_info | String官方未标注必填 | 业务字段 desc_info | 竖版模板 |
top_result.creative_require_v_o.smart_creative_form_infos[].content样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].content | String官方未标注必填 | 内容 | xxxxxx |
top_result.creative_require_v_o.smart_creative_form_infos[].icon样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].icon | String官方未标注必填 | 业务字段 icon | xxxxxx |
top_result.creative_require_v_o.smart_creative_form_infos[].creative_add_operators样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].creative_add_operators | String []官方未标注必填 | 业务字段 creative_add_operators枚举:video=视频创意、creativeCool=创意库、local=图片、template=模板创意 | ['video'] |
top_result.creative_require_v_o.smart_creative_form_infos[].template_id样例 JSON:universalbp_new_creative_findrequire_response.top_result.creative_require_v_o.smart_creative_form_infos.creative_form_info_v_o[].template_id | Number官方未标注必填 | 模板标识 | 202396 |
Python 签名直连示例
下载 qimenyun_direct.py 与业务脚本放在同一目录,保留淘宝业务参数,使用奇门云密钥和 shopKey 申请签名,由客户服务器直接请求淘宝。运行前补全业务参数,无需自行计算平台签名。
# Python 3.9+,无需安装第三方依赖。
# 先下载 https://api.miandanni.com/examples/qimenyun_direct.py 放在本文件同一目录。
# 先申请签名,再由本程序直接请求淘宝;业务数据直接返回客户服务器。
import json
from getpass import getpass
from qimenyun_direct import Client, CallError, check_result
api_key = getpass("请输入奇门云密钥:").strip()
config = {"mode": "direct", "apiKey": api_key, "services": {"wanxiang": {"signEndpoint": "https://api.miandanni.com/api/wanxiang/sign"}}}
client = Client(config)
body = json.loads("{\"shopKey\":\"填写你授权店铺的 shopKey\",\"method\":\"taobao.universalbp.new.creative.findrequire\",\"params\":{\"top_service_context\":{\"biz_code\":\"universalBP\",\"login_type\":1,\"ext\":\"{}\"},\"creative_require_query_v_o\":{}}}")
body["shopKey"] = input("请输入自己的 shopKey:").strip()
try:
result = client.call("wanxiang", body)
print(client.display(result))
check_result(result)
except CallError as exc:
print(client.display(exc.payload))
raise SystemExit(str(exc)) from None
# 不自动重试。写操作超时或结果未知时,先查询实际状态。
判断成功与失败
签名阶段先检查 HTTP 状态;本站鉴权、套餐或授权失败返回 {ok:false,error:{code,message}}。签名 HTTP 200 仅说明已签发;客户端执行官方请求后,还要检查淘宝响应的 error_response、逐项错误和 top_result.info.ok;失败不能当成空列表。
执行阶段的淘宝原始 error_response、业务 info 和 request_id 直接返回客户服务器,不由奇门云统一包装。签名和授权由本站管理,业务参数、日期、分页及平台资格按淘宝原始错误排查。
error_response:TOP 网关错误;应读取错误码及细分错误码,不能按空结果处理。top_result.info:HTTP 成功仍须核对业务 ok;false 表示业务未完成。
下载本页 MD 可交给开发人员或 AI,密钥只填在自己的私密配置中。