**版本：202601**

# 创建物流商服务

**POST** `/openapi/2026-01/carrier_services`

使用提供的详情创建新物流商服务。

## 请求

**application/json**

**请求体 | 示例**

**请求体 (required)**

- `carrier_service` object (required)

  待创建的物流商服务数据

  - `name` string (required)

    物流商服务名称（同时作为英文/中文名）
  - `callback_url` string (required)

    运费计算回调 URL（Shoplazza 在计算运费时会向该地址发起调用）
  - `carrier_code` string (required)

    物流商服务唯一编码，例如 `dhl`
  - `active` boolean

    是否启用该物流商服务
  - `logo` string

    物流商服务 logo 的 URL
  - `short_desc` string

    物流商服务的简短描述

```json
{
  "carrier_service": {
    "name": "string",
    "callback_url": "string",
    "carrier_code": "string",
    "active": true,
    "logo": "string",
    "short_desc": "string"
  }
}
```

## 响应

**200**

OK

**application/json**

**数据结构 | 示例**

**数据结构**

- `code` string

  错误码
- `message` string

  错误信息
- `data` object

  - `carrier_service` object

    已创建的物流商服务

    - `id` string

      物流商服务 ID
    - `name` string

      物流商服务名称
    - `active` boolean

      是否启用
    - `callback_url` string

      运费计算回调 URL
    - `scopes` string

      权限范围（多个用逗号分隔）
    - `carrier_service_code` string

      物流商服务编码
    - `logo` string

      Logo URL
    - `short_desc` string

      物流商服务简短描述
    - `created_at` string

      创建时间（ISO-8601 格式）
    - `updated_at` string

      最后更新时间（ISO-8601 格式）

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "carrier_service": {
      "id": "string",
      "name": "string",
      "active": true,
      "callback_url": "string",
      "scopes": "string",
      "carrier_service_code": "string",
      "logo": "string",
      "short_desc": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```