商品信息

商品信息上传接口

商品信息上传接口

post

/openApi/goods

Authorizations

Query parameters

gatewayNointeger(8)

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

merNointeger(5)

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

goodsNamestring(1000)

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

goodsNumstring(200)

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

goodsPricestring(200)

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

orderNostring(64)

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

tradeNostring(64)

交易流水号；最小长度为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

*/*

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'http://{openApiUrl}/openApi/goods' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'request-id: null' \
  --header 'request-time: null'

200

200

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

OK

请求报文示例

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	上传结果错误信息