河马供应链 接口文档

App.Order.Preview
订单预览

接口地址：http://api.hmgyl.com.cn/?s=App.Order.Preview

请求方式  POST

接口描述： 创建订单前置预览，返回运费及其他

接口参数

参数名字类型是否必须默认值其他说明
sign字符串必须签名
appid字符串必须appid
products字符串JSON格式必须商品信息
address字符串JSON格式必须收货地址
out_order_no字符串必须最小：2；最大：64商户订单号

返回结果

参数名字类型说明
total_money浮点型订单总金额【已经策略】
sum_money浮点型商品总金额【已经策略】
sum_carriage浮点型运费总金额
add_itional_fee浮点型附加费
skuList[]数组sku列表
skuList[].amount浮点型商品总价【已经策略】
skuList[].price浮点型商品单价【已经策略】
skuList[].cost_price浮点型成本价
skuList[].product_id字符串商品ID
skuList[].sku_id字符串skuId
skuList[].product_num整型购买数量
skuList[].sub_order_on字符串平台子订单号

错误列表

错误状态码错误描述信息
400表示客户端参数错误
404表示接口服务不存在
500表示服务端内部错误
406签名错误
407身份信息异常
408账户账号异常
409账户账号身份异常
410身份信息出错
411账户账号被锁定
42000商品不存在商品库
42003商品已下架
42004sku已下架
42005sku库存不足

在线测试   

参数是否必须值
service 必须
sign 必须
appid 必须
products 必须
address 必须
out_order_no 必须

客户端请求示例

返回示例PHP示例 
[
    {
        "sum_money": 232,
        "total_money": 232,
        "sum_carriage": 0,
        "add_itional_fee": 0,
        "skuList": [
            {
                "amount": 82,
                "price": 41,
                "product_id": 1685,
                "sku_id": 2649196,
                "product_num": 2,
                "sub_order_on": "5b3eefdb4a4e41aceef869edd7dbc16e32149799173dd133f7a83bb394277e6e"
            },
            {
                "amount": 150,
                "price": 50,
                "product_id": 826,
                "sku_id": 1628029,
                "product_num": 3,
                "sub_order_on": "5b3eefdb4a4e41aceef869edd7dbc16e32149799173dd133f7a83bb394277e6e"
            }
        ]
    },
    {
        "sum_money": 108,
        "total_money": 108,
        "sum_carriage": 0,
        "add_itional_fee": 0,
        "skuList": [
            {
                "amount": 108,
                "price": 36,
                "product_id": 1700,
                "sku_id": 2681523,
                "product_num": 3,
                "sub_order_on": "fccc0108763ae2e8911f4f114522976375281959e044422b1803ca031b54404e"
            }
        ]
    }
]
<?php
require_once dirname(__FILE__) . '/PhalApiClient.php';

$client = PhalApiClient::create()
    ->withHost('http://api.hmgyl.com.cn/');$rs = $client->reset()
    ->withService('App.Order.Preview')
    ->withParams('products', '[{"product_id":"553669822926","sku_id":"f561c4f7cdb23de81fc2303ebf1e8f55","product_num":2},{"product_id":"553507958686","sku_id":"f561c4f7cdb23de81fc2303ebf1e8f55","product_num":3}]')
    ->withParams('address', '{"user_phone":18602344691,"user_name":"tiger","user_address_province":"重庆市","user_address_city":"市辖区","user_address_area":"万州区","user_address_town":"镇/街道","user_address":"滨江路1号"}')
    ->withParams('out_order_no', 12345678)
    ->withTimeout(3000)
    ->request();

// ret状态码，200表示成功
var_dump($rs->getRet());
// 业务数据
var_dump($rs->getData());
// 提示信息
var_dump($rs->getMsg());
温馨提示： 此接口文档根据接口代码和注释实时自动生成，帮助文档请见PhalApi 2.x 开发文档。
PhalApi

接口，从简单开始！
© 2015-2025 Powered By 河马供应链 2.23.0    专业版