文档中心 > API类目 > 度假&门票-交易管理API

alitrip.travel.trade.template.query (订单服务详情模版查询)

通过订单ID获取标注模版信息,商家可以根据模版来填充行业信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
is_new Boolean 可选 true
  • 默认值:false
  • 是否取最新的模版
    order_id Number 必须 111111 淘宝平台订单ID

    响应参数

    名称 类型 示例值 描述
    result ResultSet 订单服务标注模版获取结果
    • first_result
    • OrderTipInfoResult
    • 订单服务标注模版获取结果详情
    • └ is_new
    • Boolean
    • false
    • 是否是最新的模版,如果订单没有标注模版,则默认取最新的模版数据;如果订单有标注模版,则取对应的模版信息;
    • template_info
    • OrderTemplateInfo
    • 模版详情
    • └ category_id
    • Number
    • 1111
    • 模版对应的类目ID
    • model_list
    • OrderTipFormInfo []
    • 填充字段列表
    • └ accept_types
    • String []
    • png
    • 字段可接收数据类型
    • └ desc
    • String
    • 接送机时的司机手机
    • 字段具体描述
    • └ max_num
    • Number
    • 100
    • 最大数量 (如最大文件上传数量, 最大图片上传数量等)
    • options
    • OrderTipOptionInfo []
    • 选择项, 当type = select / selects 的时候存在
    • └ text
    • String
    • 司机
    • select对应的text值
    • └ value
    • String
    • 张三
    • select对应的value值
    • rule
    • OrderTipRuleInfo
    • 字段匹配规则
    • └ msg
    • String
    • 请输入正确的手机号
    • 字段描述
    • └ regex
    • String
    • ^1[\\d]{10}$
    • 字段正则表达式,字段值必须和正则匹配,否则上传服务信息会报错
    • └ require
    • Boolean
    • true
    • 字段是否必须
    • └ title
    • String
    • 司机姓名
    • 字段中文名称
    • └ name
    • String
    • mobileName
    • 字段属性名,在做服务信息回传时需要用到的KEY
    • └ value
    • String
    • 张三
    • 字段对应的值,单选值
    • └ values
    • String []
    • 张三;李四
    • 字段对应的值,多选值
    • └ template_id
    • Number
    • 1
    • 模版对应ID
    • └ version
    • Number
    • 1
    • 模版对应版本
    • └ view_template_url
    • String
    • http://tap.fliggy.com/#/info-table?cid=124864009
    • 查看模版链接

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlitripTravelTradeTemplateQueryRequest req = new AlitripTravelTradeTemplateQueryRequest();
    req.setIsNew(true);
    req.setOrderId(111111L);
    AlitripTravelTradeTemplateQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alitrip_travel_trade_template_query_response>
        <result>
            <first_result>
                <is_new>false</is_new>
                <template_info>
                    <category_id>1111</category_id>
                    <model_list>
                        <order_tip_form_info>
                            <accept_types>
                                <string>png</string>
                            </accept_types>
                            <desc>接送机时的司机手机</desc>
                            <max_num>100</max_num>
                            <options>
                                <order_tip_option_info>
                                    <text>司机</text>
                                    <value>张三</value>
                                </order_tip_option_info>
                            </options>
                            <rule>
                                <msg>请输入正确的手机号</msg>
                                <regex>^1[\\d]{10}$</regex>
                                <require>true</require>
                            </rule>
                            <title>司机姓名</title>
                            <name>mobileName</name>
                            <value>张三</value>
                            <values>
                                <string>张三;李四</string>
                            </values>
                        </order_tip_form_info>
                    </model_list>
                    <template_id>1</template_id>
                    <version>1</version>
                </template_info>
                <view_template_url>http://tap.fliggy.com/#/info-table?cid=124864009</view_template_url>
            </first_result>
        </result>
    </alitrip_travel_trade_template_query_response>

    异常示例

    • XML示例
    • JSON示例
    <error_response>
        <code>50</code>
        <msg>Remote service error</msg>
        <sub_code>isv.invalid-parameter</sub_code>
        <sub_msg>非法参数</sub_msg>
    </error_response>

    错误码解释

    错误码 错误描述 解决方案
    isv.0 根据错误提示修改 根据错误提示修改

    API工具

    如何获得此API

    FAQ

    返回
    顶部