- Foxtable(狐表) (http://foxtable.com/bbs/index.asp)
-- 专家坐堂 (http://foxtable.com/bbs/list.asp?boardid=2)
---- [求助]这个接口怎么写？详情见下【暂时没问题】快递鸟api (http://foxtable.com/bbs/dispbbs.asp?boardid=2&id=143198)
-- 发布时间：2019/11/17 13:32:00
-- [求助]这个接口怎么写？详情见下【暂时没问题】快递鸟api
这是我的部分代码
Dim hc订单 As new HttpClient("http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json")
hc订单 .C \'
hc订单.FormData.Add("RequestData", "{ ""OrderCode"": ""012657018199"", ""ShipperCode"": ""SF"", ""PayType"": 1, ""MonthCode"": ""1234567890"", ""ExpType"": 1, ""Cost"": 1.0, ""OtherCost"": 1.0, ""Sender"": { ""Company"": ""LV"", ""Name"": ""Taylor"", ""Mobile"": ""15018442396"", ""ProvinceName"": ""上海"", ""CityName"": ""上海市"", ""ExpAreaName"": ""青浦区"", ""Address"": ""明珠路"" }, ""Receiver"": { ""Company"": ""GCCUI"", ""Name"": ""Yann"", ""Mobile"": ""15018442396"", ""ProvinceName"": ""北京"", ""CityName"": ""北京市"", ""ExpAreaName"": ""朝阳区"", ""Address"": ""三里屯街道"" }, ""Commodity"": [ { ""GoodsName"": ""鞋子"", ""GoodsQuantity"": 1, ""GoodsWeight"": 1.0 }, { ""GoodsName"": ""衣服"", ""GoodsQuantity"": 1, ""GoodsWeight"": 1.0 }, ], ""AddService"": [ { ""Name"": "" INSURE "", ""Value"": ""1000"" }, { ""Name"": ""COD"", ""Value"": ""1020"" "" CustomerID "": ""1234567890"" } ], ""Weight"": 1.0, ""Quantity"": 1, ""Volume"": 0.0, ""Remark"": ""小心轻放"" }")
hc订单 .FormData.Add("EBusinessID","ZTO77***83171")
hc订单 .FormData.Add("RequestType","1007")
hc订单 .FormData.Add("DataSign",？？？) \'这里不会写
output.Show(hc订单.GetData)
这个
| DataSign怎么写？ |
电子面单接口
（1）电子面单接口是快递鸟提供给独立电商、仓储管理系统、物流供应链等物流系统平台使用的下单接口。
（2）为客户解决在线发货需求，商户通过网络选择快递公司发送请求通知快递公司有快递要发货。
（3） 客户把数据通过此接口转发到快递鸟，由快递鸟为您安排快递员上门取件的服务。
（4）订单编号（OrderCode）不可重复提交，重复提交系统会返回具体错误代码。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：http://api.kdniao.com/api/EOrderService
（2）为客户解决在线发货需求，商户通过网络选择快递公司发送请求通知快递公司有快递要发货。
（3） 客户把数据通过此接口转发到快递鸟，由快递鸟为您安排快递员上门取件的服务。
（4）订单编号（OrderCode）不可重复提交，重复提交系统会返回具体错误代码。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）接口地址： API测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
API正式地址：http://api.kdniao.com/api/EOrderService
请求系统级参数说明：
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| RequestData | String | 请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。 | R |
| EBusinessID | String | 商户ID，请在我的服务页面查看。 | R |
| RequestType | String | 请求指令类型：1007 | R |
| DataSign | String | 数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后 进行URL(utf-8)编码。详细过程请查看Demo。 | R |
| DataType | String | 请求、返回数据类型：只支持JSON格式 | O |
备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）
接口参数
1.电子面单接口
请求内容字段定义：
| 参数名称 | 类型 | 说明 | 是否必须 | |
|---|---|---|---|---|
| MemberID | String（50） | ERP系统、电商平台等系统或平台类型用户的会员ID或店铺账号等唯一性标识，用于区分其用户 | O | |
| CustomerName | String(50) | 电子面单客户号，需要下载《快递鸟电子面单客户号参数对照表.xlsx》，参考对应字段传值 | O | |
| CustomerPwd | String(30) | O | ||
| SendSite | String(30) | O | ||
| SendStaff | String(30) | C | ||
| MonthCode | String | C | ||
| CustomArea | String(500) | 商家自定义区域 | C | |
| WareHouseID | String(30) | 发货仓编码 | O | |
| TransType | Int(1) | 运输方式 1- 陆运 2- 空运 不填默认为1 | O | |
| ShipperCode | String(10) | 快递公司编码 详细编码参考《2019快递鸟接口支持快递公司编码.xlsx》 | R | |
| LogisticCode | String(30) | 快递单号(仅宅急送可用) | O | |
| ThrOrderCode | String(50) | 第三方订单号 (ShipperCode为JD且ExpType为1时必填) | C | |
| OrderCode | String(30) | 订单编号(自定义，不可重复) | R | |
| PayType | Int(1) | 邮费支付方式:1-现付，2-到付，3-月结，4-第三方支付(仅SF支持) | R | |
| ExpType | String(2) | 快递类型：1-标准快件 ,详细快递类型参考《快递公司快递业务类型.xlsx》 | R | |
| IsReturnSignBill | Int(1) | 是否要求签回单 1- 要求 0-不要求 | O | |
| OperateRequire | String(20) | 签回单操作要求(如：签名、盖章、身份证复印件等) | O | |
| Cost | Cost Double(5) | 快递运费 | O | |
| OtherCost | Double(5) | 其他费用 | O | |
| Receiver | Company | String(30) | 收件人公司 | O |
| Name | String(30) | 收件人 | R | |
| Tel | String(20) | 电话与手机，必填一个 | R | |
| Mobile | String(20) | |||
| PostCode | String(10) | 收件人邮编 | c | |
| ProvinceName | String(20) | 收件省 (如广东省，不要缺少“省”；如是直辖市，请直接传北京、上海等； 如是自治区，请直接传广西壮族自治区等) | R | |
| CityName | String（20） | 收件市(如深圳市，不要缺少“市”； 如果是市辖区，请直接传北京市、上海市等) | R | |
| ExpAreaName | String（20） | 收件区/县(如福田区，不要缺少“区”或“县”) | R | |
| Address | String(100) | 收件人详细地址 | R | |
| Sender | Company | String(30) | 发件人公司 | O |
| Name | String(30) | 发件人 | R | |
| Tel | String(20) | 电话与手机，必填一个 | R | |
| Mobile | String(20) | |||
| PostCode | String(10) | 发件地邮编(ShipperCode为EMS、YZPY、YZBK时必填) | C | |
| ProvinceName | String(20) | 发件省 (如广东省，不要缺少“省”； 如是直辖市，请直接传北京、上海等； 如是自治区，请直接传广西壮族自治区等) | R | |
| CityName | String(20) | 发件市(如深圳市，不要缺少“市； 如是市辖区，请直接传北京市、上海市等”) | R | |
| ExpAreaName | String(20) | 发件区/县(如福田区，不要缺少“区”或“县”) | R | |
| Address | String(100) | 发件人详细地址 | R | |
| IsNotice | Int(1) | 是否通知快递员上门揽件 0- 通知 1- 不通知 不填则默认为1 | O | |
| StartDate | Date | 上门取货时间段:"yyyy-MM-dd HH:mm:ss"格式化，本文中所有时间格式相同 | O | |
| EndDate | Date | O | ||
| Weight | Double(10,3) | 包裹总重量kg 当为快运的订单时必填，不填时快递鸟将根据各个快运公司要求传对应的默认值 | C | |
| Quantity | Int(2) | 包裹数(最多支持30件) 一个包裹对应一个运单号，如果是大于1个包裹，返回则按照子母件的方式返回母运单号和子运单号 | R | |
| Volume | Double(20,3) | 包裹总体积m3 当为快运的订单时必填，不填时快递鸟将根据各个快运公司要求传对应的默认值 | C | |
| Remark | String(60) | 备注 | O | |
| AddServices | ||||
| AddService | Name | String(20) | 增值服务名称 (数组形式，可以有多个增值服务) | C |
| Value | String(30) | 增值服务值 | C | |
| CustomerID | String(30) | 客户标识（选填） | O | |
| Commoditys | ||||
| Commodity | GoodsName | String(100) | 商品名称 | R |
| GoodsCode | String(100) | 商品编码 | O | |
| Goodsquantity | Int(5) | 商品数量 | O | |
| GoodsPrice | Double(10) | 商品价格 | O | |
| GoodsWeight | Double(10,3) | 商品重量kg | O | |
| GoodsDesc | String(50) | 商品描述 | O | |
| GoodsVol | Double(15,3) | 商品体积m3 | O | |
| IsReturnPrintTemplate | String(1) | 返回电子面单模板：0-不需要；1-需要 | O | |
| IsSendMessage | Int(1) | 是否订阅短信：0-不需要；1-需要 | O | |
| TemplateSize | String(10) | 模板规格(默认的模板无需传值，非默认模板传对应模板尺寸) | O | |
| PackingType | Int(2) | 包装类型(快运字段)默认为0； 0- 纸 1- 纤 2- 木 3- 托膜 4- 木托 99-其他 | C | |
| DeliveryMethod | Int(1) | 送货方式(快运字段)默认为0； 0- 自提 1- 送货上门（不含上楼） 2- 送货上楼 | C | |
[此贴子已经被作者于2020/3/19 23:15:33编辑过]
-- 发布时间：2019/11/17 13:34:00
--
{
"OrderCode": "012657018199",
"ShipperCode": "SF",
"PayType": 1,
"MonthCode": "1234567890",
"ExpType": 1,
"Cost": 1.0,
"OtherCost": 1.0,
"Sender": {
"Company": "LV",
"Name": "Taylor",
"Mobile": "15018442396",
"ProvinceName": "上海",
"CityName": "上海市",
"ExpAreaName": "青浦区",
"Address": "明珠路"
},
"Receiver": {
"Company": "GCCUI",
"Name": "Yann",
"Mobile": "15018442396",
"ProvinceName": "北京",
"CityName": "北京市",
"ExpAreaName": "朝阳区",
"Address": "三里屯街道"
},
"Commodity": [
{
"GoodsName": "鞋子",
"GoodsQuantity": 1,
"GoodsWeight": 1.0
},
{
"GoodsName": "衣服",
"GoodsQuantity": 1,
"GoodsWeight": 1.0
},
],
"AddService": [
{
"Name": " INSURE ",
"Value": "1000"
},
{
"Name": "COD",
"Value": "1020"
" CustomerID ": "1234567890"
}
],
"Weight": 1.0,
"Quantity": 1,
"Volume": 0.0,
"Remark": "小心轻放"
}[此贴子已经被作者于2019/11/17 13:47:53编辑过]
-- 发布时间：2019/11/17 20:16:00
--
把2楼附件里3个函数:encrypt(String content, String keyValue, String charset)、MD5(string str, string charset)、base64(String str, String charset)转换为vb.net放到全局代码使用即可
-- 发布时间：2019/11/20 12:24:00
--
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Net;
using System.Text;
using System.Web;
using System.Security.Cryptography.X509Certificates;
using System.Net.Security;
namespace Test
.......................
/// <param name="charset">编码方式</param>
/// <returns></returns>
private string base64(String str, String charset)
{
return Convert.ToBase64String(System.Text.Encoding.GetEncoding(charset).GetBytes(str));
}
}
}
这一段全部放到全局代码吗？不对呀，部分放进去也不对。要怎么改？
-- 发布时间：2019/11/20 13:35:00
--
只让您转换3个函数，其它乱七八糟的不需要
-- 发布时间：2019/11/20 20:56:00
--
encrypt
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
-- 发布时间：2019/11/20 20:57:00
--
这两串吗？
-- 发布时间：2019/11/20 22:36:00
--
hc订单.FormData.Add("RequestData", "{ ""OrderCode"": ""012657018199"", ""ShipperCode"": ""SF"", ""PayType"": 1, ""MonthCode"": ""1234567890"", ""ExpType"": 1, ""Cost"": 1.0, ""OtherCost"": 1.0, ""Sender"": { ""Company"": ""LV"", ""Name"": ""Taylor"", ""Mobile"": ""15018442396"", ""ProvinceName"": ""上海"", ""CityName"": ""上海市"", ""ExpAreaName"": ""青浦区"", ""Address"": ""明珠路"" }, ""Receiver"": { ""Company"": ""GCCUI"", ""Name"": ""Yann"", ""Mobile"": ""15018442396"", ""ProvinceName"": ""北京"", ""CityName"": ""北京市"", ""ExpAreaName"": ""朝阳区"", ""Address"": ""三里屯街道"" }, ""Commodity"": [ { ""GoodsName"": ""鞋子"", ""GoodsQuantity"": 1, ""GoodsWeight"": 1.0 }, { ""GoodsName"": ""衣服"", ""GoodsQuantity"": 1, ""GoodsWeight"": 1.0 }, ], ""AddService"": [ { ""Name"": "" INSURE "", ""Value"": ""1000"" }, { ""Name"": ""COD"", ""Value"": ""1020"" "" CustomerID "": ""1234567890"" } ], ""Weight"": 1.0, ""Quantity"": 1, ""Volume"": 0.0, ""Remark"": ""小心轻放"" }")
这里这样写不对吧，怎么进行URL(utf-8)编码？
请求系统级参数说明：
| 参数名称 | 类型 | 说明 | 必须要求 |
|---|---|---|---|
| RequestData | String | 请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。 | R |
-- 发布时间：2019/11/21 8:48:00
--
直接赋值即可，默认就是utf-8，不需要另外处理
-- 发布时间：2019/11/21 9:22:00
--
放进去提示
此主题相关图片如下：qq截图20191121092130.png
此主题相关图片如下：qq截图20191121092130.pngencrypt
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}
private string encrypt(String content, String keyValue, String charset)
{
if (keyValue != null)
{
return base64(MD5(content + keyValue, charset), charset);
}
return base64(MD5(content, charset), charset);
}