当前位置： API文档

xsd_upload_media.php（小时达订单图片回传）

1.接口说明

1.1 接口描述：用于小时达订单回传平台图片，例如美团鲜花类目配送前需要先上传图片。
1.2 注意事项：图片大小受限于对应平台。例如美团限制图片大小限制为10M，长宽比例需要限制为4:3。

2.调用场景

2.1 举例说明：SAP、线下ERP、SRM、SCM等系统对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境

https://openapi.ali.huice.cc/openapi/xsd_upload_media.php

正式环境https://openapi.huice.com/openapi/xsd_upload_media.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
是购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号appkeyString
是本开放平台“自助对接”功能模块内自助申请，申请流程单击这里
时间戳timestampint
是北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名signString
是API输入参数签名结果，签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型父级字段
长度必须描述
上传数据uploadvarchar

是字符的 json对象格式例如：{
  "tid": "T202604280001",
  "shop_id": 1001,
  "media_list": [
    {
      "url": "https://example.com/media/image1.jpg",
      "type": 0
    },
    {
      "url": "https://example.com/media/image2.jpg",
      "type": 0
    }
  ]
}
平台订单号tidvarcharupload
是
店铺IDshop_id intupload
是
文件列表media_list数组upload
是[
   {
     "url": "https://example.com/media/image1.jpg",
     "type": 0
   },
   {
     "url": "https://example.com/media/image2.jpg",
     "type": 0
   }
 ]
}
文件urlurlvarcharmedia_list
是文件url
类型typevarcharmedia_list
是类型 0 图片

4.响应参数

   4.1 公共响应参数

名称字段类型长度
必须描述
错误码codeint11是状态码:0表示成功,其他表示失败
错误描述messagevarchar255是错误描述

  5.请求示例

PHP
<?php
	require_once '../WdtClient.php';
	$c = new WdtClient();
	$c->sid = '';
	$c->appkey = '';
	$c->appsecret = '';
	$c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/xsd_upload_media.php';

	$uploadJson = '{
			"tid":"4033340323853971099",
			"shop_id":486,
			"media_list":[
				{
				"url":"http://p0.meituan.net/xianfu/63d5cb4cf120c89da74c1dd3e7c8bae651375.jpg",
				"type":0
				}
			]
		}';

	$c->putApiParam('upload', $uploadJson);
	$json = $c->wdtOpenApi();
	var_dump($json);
?>
JAVA
package com.erpx.api.trade;

import com.erpx.api.CommonConstants;
import com.erpx.api.WdtClient;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class XsdUploadMediaService {

    public static void main(String[] args) {
        WdtClient client = new WdtClient(
            "test",
            CommonConstants.appkey,
            CommonConstants.appSecret,
            CommonConstants.baseUrlProd
        );
        try {
            Map<String, String> params = new HashMap<>();
            params.put(
                "upload",
                "{\"tid\":\"T202604280001\",\"shop_id\":1001,\"media_list\":[{\"url\":\"https://example.com/media/image1.jpg\",\"type\":0},{\"url\":\"https://example.com/media/image2.jpg\",\"type\":0}]}"
            );
            String result = client.execute("xsd_upload_media.php", params);
        } catch (IOException e) {
            throw new RuntimeException(e);
        }
    }
}
C#
python

6.响应示例

   6.1 正常响应示例 

JSON

   6.2 异常响应示例

JSON
{
    "code": 2900,
    "message": "必传参数缺失 param参数错误，请参照接口文档！",
    "resultList": [

    ],
    "success": false
}








常用工具