物流服务里,快递下单的接口,请求参数的文档里至少有一半是错的,看得我脑壳痛,都不知道该怎么填,就下面这个:
- 其中最混乱的就是跟appid相关的
wx_appid字段,文档里说是app或者h5的appid,不是小程序的appid。那么问题来了,小程序的appid填在哪里??文档里的“请求数据示例”,写了一个小程序的示例,却完全没有传入任何小程序appid相关字段。你说它是“下单成功的例子”,谁信?
隔壁的“同城配送接口”对应的下单接口是在shop字段下有个`wxa_appid`专指小程序appid的,快递下单的这个接口则是完全没有提到`wxa_appid`这个值。
除了一个地方!那就是最底下的错误码9300536,这个错误码的文档,取值写的是“invalid wxa_appid”,说明里写的是“add_source=2时,wx_appid无效”,所以这里invalid的`wxa_appid`又是哪来的?
- 然后是sender和receiver两个字段的问题
首先receiver字段整个就是sender的复制粘贴,里面十个“发件人”都懒得改,这个都是小问题,receiver真的有`company`这个值吗???确定不是整个receiver里的属性都抄错了吗?
然后sender和receiver两个标着“必填”的字段,里面所有属性都是“选填”???所有名字地址电话号码都是选填???
- 然后是cargo字段的问题
好家伙,所有属性的说明都是“包裹总重量”,闭着眼睛复制粘贴已经是这个文档的基本操作了,这个已经没啥好吐槽的。
但是!所有属性都强行要求“必填”!包括三个看名字是体积相关的属性,你确定这个没错???这位来自微信官方在4年前的回复,不会是4年后都没有改吧?
- 然后是shop字段的问题
请问你的detail_list是啥???它里面的属性都有啥???它是长得像楼上cargo字段里的detail_list属性呢?还是长得像隔壁同城配送下单接口里shop字段的detail_list属性呢?
- 然后是insured字段的问题
还是跟上面的sender和receiver字段一样,自身是“必填”,然后里面所有属性都是“选填”??
- 然后是service字段的问题
只给了两个链接,两个都是404,两个必填的属性该怎么填给了两个404链接,真是666
我是刚对接完同城配送接口,过来对接快递接口的。同城配送的文档严谨准确,对接起来无比丝滑。来到快递接口这里,第一个下单接口就直接卡壳,一半的参数不知道怎么填,真是无语。
官方快更新你们的文档!你们几天前的微信公开课,小程序部门才刚刚吹完自己的物流对接服务呢!
你好,方便提供一下具体的请求参数详情吗,我们结合例子来看看
“小程序的appid要填在哪儿”这种问题需要啥例子??
“shop字段里的detail_list属性的说明是什么”这种问题需要啥例子??
我提的问题全是这个API文档的基本问题,没有一个需要所谓的具体参数和例子结合才能回答。
文档确实很多问题。