商品信息

商品信息上传接口

post

商品信息上传接口

Authorizations

Query parameters

gatewayNointeger(8)Optional

网关号；固定长度8位，如：10001001

merNointeger(5)Optional

商户号；固定长度5位，如：10001

goodsNamestring(1000)Optional

商品名称 有多个信息请用”|“隔开，明细不得超过10个；最小长度为1，最大长度为1000

goodsNumstring(200)Optional

商品数量 有多个信息请用”|“隔开，明细不得超过10个；最小长度为1，最大长度为200

goodsPricestring(200)Optional

商品单价 有多个信息请用”|“隔开，明细不得超过10个；最小长度为1，最大长度为200

orderNostring(64)Optional

商户订单号；最小长度为1，最大长度为64，如：12167001000000000001

tradeNostring(64)Optional

交易流水号；最小长度为1，最大长度为64，如：2021092810011380477264

Header parameters

authorizationanyRequired

ACCESS_TOKEN，格式：Bearer ACCESS_TOKEN

request-idstring(20)Required

请求id，最小长度为1，最大长度为20，30分钟之内唯一

request-timestring(19)Required

请求时间，时间格式为 yyyy-MM-dd'T'HH:mm:ss ，请求误差不能超过30分钟

Responses

200

OK

*/*

post

HTTPcURLJavaScriptPython

POST /openApi/goods HTTP/1.1
Host: {openapiurl}
Authorization: YOUR_API_KEY
authorization: null
request-id: null
request-time: null
Accept: */*

200

OK

{
  "data": {
    "resultCode": "0000",
    "resultMessage": "SUCCESS",
    "tradeNo": 2.0210928100113805e+21
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

请求报文示例

uploadLogistics.sh

curl --request POST \
  --url https://{openApiUrl}/openApi/goods \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \
  --data 'merNo=12345&gatewayNo=12345001&tradeNo=2022042617331600244628&orderNo=2022042617&goodsName=iphone&goodsNum=1&goodsPrice=100'

结果对象属性描述

property name	type	description
result	Object	请求响应对象
code	String	响应码
message	String	响应信息
data	Object	数据对象
tradeNo	String	交易流水号
resultCode	String	上传结果错误码
resultMessage	String	上传结果错误信息