ecstore接口文档规则.docxVIP

数据中心接口说明 目录 数据中心接口说明 1 目录 1 更新日志 3 请求参数说明 4 . 接口域名说明 4 . format 参数说明 4 . 接口访问权限 4 pid 参数说明 4 签名参数 4 返回数据说明 5 . 返回数据分 4 部分 5 异常(错误码 )说明 6 门票列表接口 7 . 接口地址 7 . 请求类型 7 . 输入参数 7 . 返回结果 8 . 调用示例 9 . 返回 json 格式示例 9 . 返回 xml 格式示例 11 订单列表 12 . 接口地址 12 . 请求类型 12 . 输入参数 12 . 返回结果 13 . 调用示例 14 . 返回 json 格式示例 14 . 返回 xml 格式示例 15 下单发票接口 17 . 接口地址 17 . 输入参数 17 . 返回结果 18 . 返回 json 格式示例 19 . 返回 xml 格式示例 20 退票接口 22 . 接口地址 22 . 输入参数 22 . 返回结果 22 . 返回 json 格式示例 23 . 返回 xml 格式示例 24 验证通知 24 . 通知参数 24 . 返回结果 25 . 返回 json 格式示例 25 . 返回 xml 格式示例 25 更新日志 日期 版本 说明 作者 2013-03-15 创建文档 莫灿宽 2013-03-22 添加退票接口 莫灿宽 2013-03-27 下单接口添加开始游玩日期和价格类型参数 莫灿宽 2013-05-08 下单接口返回信息中添加二维码参数 qrcode 莫灿宽 请求参数说明 接口域名说明 为了说明的方便我这里都假定接口域名是 。实际使用中如果是其他域名只需将相应域名替代即可 format 参数说明 指定接口返回格式。主要包含三种格式： xml、json、php。如果未显式调用 format 参数，默认返回 json 格式。具体返回格式可查看具体接口的返回示例获取 xml 格式 cid=1pid=10000 获取 json 格式 cid=1pid=10000 接口访问权限 合作伙伴如果要访问接口至少要提供 _pid 和签名（签名是由授权码和参数生成） pid 参数说明 每个接口都需要 _pid 参数，这是合作伙伴的编号，在此文档中有时叫合作伙伴 id. 签名参数 还需要签名来验证请求的合法性。签名生成规则： md5(md5(param1=value1param2=value2param3=value3).$authcode) md5: 加密算法， 32 位 md5 算法 $authcode: 授权码 param1=value1param2=value2param3=value3 ：传递给接口的参数。多个参数用 连接 注： 1，所有参数 (除_sig 参数)需要按照键名英文排好次序。 2，参数要求：除 _sig 参数本身以外的所有其他参与请求接口的参数。 3，其中的‘ .’号表示 连接符号 ，即连接多个字符串。 请勿理解成可见的字符 4， $authcode 是授权码，即账号密码。 5，什么参数被用来生产签名参数：如果使用 GET方式请求，则使用 GET参数。如果使用 POST方式请求，则使用 POST参数。二者只用其一 php 中生成签名示例： “ “123456 ”) $sig = md5( md5( $query ) . $authCode ); “123456 ”)。 返回数据说明 返回数据分 4 部分 success: 表成功和失败状态。 true 表成功， false 表失败。 message: 提示信息，当有错误发生时，此 message包含有错误信息3） errorn: 错误码，当有错误发生时，此 errorn 包含有错误码号 4） 返回数据 : 如果是获取多条信息类接口则 : list: 多条信息列表 total: 数据总数 如果是获取单条信息类接口则 : info: 单条信息 3. 异常(错误码 )说明 1） 300500 = 没有数据 2） 300501 = 参数错误 3） 300502 = 用户不存在 4） 300503 = 用户未开通接口授权 5） 300504 = 授权码错误 6） 300505 = 票不存在 7） 300506 = 票已过期 8） 300507 = 票数不足 9） 300508 = 获取分销商分组失败 10） 300509 = 获取景区失败 11） 300510 = 余额不足 12） 300511 = 短信发送失败 13） 300512 = 余额更新失败 14） 300513 = 票数修改失败 15） 300514 = 订单添加失败 16） 300515