文档

ZBT开放平台

公共说明

接口协议

  • 使用HTTPS协议作为目前的交互协议
  • 生产环境下网关的统一入口是https://open.zbt.com/gw
  • 请求报文、响应报文格式都是JSON,Content-Type为application/json; charset=UTF-8
  • 交互的编码格式统一为UTF-8
  • HTTP正常响应的http code都是200,非正常返回400

请求报文

请求头

如果是post请求,需要设置请求头 Header: 设置 [Content-Type] 为 [application/json; charset=UTF-8]

请求必填参数

  • app-key:接入后分配的appKey
  • language:返回数据的语言,en_US或者zh_CN
  • source: 设置成5
  • bizType: 设置成1

使用配置

  • 申请app-key
  • app_key替换为步骤1申请的(在web_config.php中修改)
  • 修改地址(生产环境),系统上线时,需要修改网关地址(在web_config.php中修改)
  • 使用实例(http-get)

    <?php
    use xingc\open\api;
    require_once dirname(__DIR__) . '/api/http_client.php';
    // 调用的API接口(for Demo测试)
    $path = '/product/sell/list/v1';
    // Http Client Api初始化
    $client_api = new xingc\open\api\HttpClient($path);
    // 业务参数-json格式(for Demo测试)
    $res = '{"code":0,"error":""}';
    $client_api->http_get_json('currencyType=3&itemId=579504321057320960&page=1&limit=10&sort=price.asc', $res);
    // 查看调用结果
    var_dump($res);
    ?>
    

    使用实例(http-post)

    <?php
    use xingc\open\api;
    require_once dirname(__DIR__) . '/api/http_client.php';
    // 调用的API接口(for Demo测试)
    $path = '/product/starter/testPost/v1';
    // Http Client Api初始化
    $client_api = new xingc\open\api\HttpClient($path);
    // 业务参数-json格式(for Demo测试)
    $body_data = '{"id":3,"price":"12","num":"1","currencyTypeName":1,"item":{}}';
    // Api调用(true开启debug调试,false=非debug模式)
    $res = '{"code":0,"error":""}';
    $client_api->http_post_json($body_data, $res);
    // 查看调动结果
    var_dump($res);
    ?>