开发者在线测试工具

使用注意事项

接口认证

所有 OpenAPI 接口均需进行签名认证。

请求 Header 中需携带 AppKey、Timestamp、Nonce、Sign 等认证信息。

AppKey、AppSecret 请联系 OSL 海外仓服务顾问申请获取。

请求地址

所有接口均以 Base URL 为前缀。

UAT（测试环境）

https://oms.osl.sohomall.jp/api // 注意：测试工具使用的是此URL，此URL为UAT测试环境。

正式环境(需申请开通后使用，开通请联系OSL海外仓服务顾问)

https://oms.oslhub.com/api

不同环境请使用对应的请求地址，请勿混用。

数据编码

请求及响应统一采用 UTF-8 编码。

请求 Content-Type：

application/json

请求方式

请严格按照接口文档要求使用对应的 HTTP Method（GET、POST 等）。

不支持文档未说明的请求方式。

时间要求

Timestamp 为当前 Unix 时间戳（秒或毫秒，以接口定义为准）。

客户端时间建议与服务器时间保持同步，避免因时间偏差导致验签失败。

接口频率限制

为保证系统稳定运行，OpenAPI 对接口调用频率进行限制。

超过限制可能返回限流错误，请合理控制调用频率。

异常重试

网络异常或服务器返回临时错误时，可采用指数退避方式进行重试。

对于业务错误，请根据错误码处理，不建议无限重试。

数据安全

请妥善保管 AppSecret，切勿泄露或提交至公开代码仓库。

建议服务端完成签名计算，不要在前端暴露密钥。

接口版本

请根据接口文档使用对应版本的 API。

如接口发生不兼容变更，将提前发布升级通知。

10.

技术支持

如遇接口调用问题，请联系 OSL 海外仓服务顾问或技术支持团队协助处理。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "appKey": "T755003_0000fwspy0wfsw00",
  "appSecret": "f2afb77ef169451f962a36936ab35291",
  "body": {
  "warehouseCode": "TYO-WH01",
  "remark": "postman test",
  "orderList": [
    {
      "sourceOrderNo": "OA-TEST-20260630174501",
      "platformType": "OPENAPI",
      "receiverName": "TEST USER",
      "receiverPhone": "09012345678",
      "receiverPostcode": "1000001",
      "receiverPrefecture": "東京都",
      "receiverCity": "千代田区",
      "recipientAddress1": "丸の内1-1-1",
      "recipientAddress2": "TEST BUILDING 101",
      "specifiedCarrier": "AUTO",
      "deliveryTimeSlot": "午前中",
      "remark": "first test order",
      "items": [
        {
          "sku": "wq-test-1",
          "quantity": 2
        },
        {
          "sku": "wq-test-2",
          "quantity": 1
        }
      ]
    },
    {
      "sourceOrderNo": "OA-TEST-20260630174502",
      "platformType": "OPENAPI",
      "receiverName": "TEST USER 2",
      "receiverPhone": "08098765432",
      "receiverPostcode": "1500001",
      "receiverPrefecture": "東京都",
      "receiverCity": "渋谷区",
      "recipientAddress1": "神宮前1-2-3",
      "recipientAddress2": "ROOM 202",
      "specifiedCarrier": "AUTO",
      "deliveryTimeSlot": "午後",
      "remark": "second test order",
      "items": [
        {
          "sku": "wq-test3",
          "quantity": 1
        }
      ]
    }
  ]
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "code": 200,
    "msg": "操作成功",
    "data": {
        "headers": {
            "App-Key": "XXXXXXXXXXXXXX",
            "Nonce": "XXXXXXXXXXXXXX",
            "Sign": "XXXXXXXXXXXXXXXXXXXXXX",
            "Timestamp": "1785296632"
        },
        "signRaw": "XXXXXXXXXX{}",
        "requestBody": "{}",
        "usage": "将 headers 复制到业务接口；业务接口 Body 可直接使用与 buildHeaders 相同的 body 对象（换行/缩进不影响验签，JSON 内容须一致）"
    },
    "type": "string"
}

开发者在线测试工具

使用注意事项#

请求参数

请求示例代码

返回响应

使用注意事项