开放平台使用说明

对接环境

环境类型	地址
测试环境	https://test-oms.hanjinexp.com/openapi/customer/
线上环境	https://oms.hanjinexp.com/openapi/customer/

应用与密钥

api_key: 请联系我司运营人员

api_secret: 请联系我司运营人员

服务端响应状态

Code	Description
200	success；服务器已成功处理了请求
301	repeated requests；重复请求
400	badRequest；客户端提交的数据错误
401	unauthorized；请求要求身份验证
500	server error；服务器遇到错误，无法完成请求

计算签名

使用您在我司的获得的api_key以及api_secret进行签名计算,将得计算到的签名作填入头部参数signature使用

签名方法

按顺序拼接api_key+api_secret+timestamp+requestBody

注意requestBody为json压缩格式,示例{"field":"value"}

示例值
api_key:abcdefght
api_secret:123456789
timestamp:1766304000
requestBody:{"field":"value"}
示例字符串
abcdefght1234567891766304000{"field":"value"}

将拼接的字符串进行 MD5 加密（32 位小写）

计算MD5(abcdefght1234567891766304000{"field":"value"})
小写MD5值
e6a7c2b605cb9f03d1a9c283c2149c3e

接口头部参数

api_key

您的api_key {{api_key}}

示例47608e3aca7c41d6af9c454cfa29fd60

timestamp

毫秒时间戳 {{secTimestamp}}

示例1766304000

signature

计算签名 {{signature}}

示例 79d8af56641cf301d44e14abbdefec4f

api-token

通过通过OAuth授权方式获得，平台服务商、第三方软件商必须传入,请联系我司运营人员获取

示例27d6bfcae7b74a0495c6fef7cff53c93

accept-language

支持语言值 ['en', 'zh', 'vi', 'ko']

不传默认使用 en

curl --location --request POST 'https://test-oms.hanjinexp.com/openapi/customer/order_create/'
--header 'api_key: 1766304000'
--header 'signature: 79d8af56641cf301d44e14abbdefec4f'
--header 'api-token: 27d6bfcae7b74a0495c6fef7cff53c93'
--header 'accept-language: en' \

开放平台使用说明

对接环境

应用与密钥

服务端响应状态

计算签名

接口头部参数

标准场景对接流程

分段场景对接流程

开放平台使用说明

对接环境#

应用与密钥#

服务端响应状态#

计算签名#

接口头部参数#

标准场景对接流程#

分段场景对接流程#

对接环境

应用与密钥

服务端响应状态

计算签名

接口头部参数

标准场景对接流程

分段场景对接流程