整份替换店铺介绍,九个字段必须同时出现

PUT/api/v1/merchant/profile

认证请求头 Authorization: Bearer <访问令牌>,访问令牌用设备码换取,不要向用户要密码、短信验证码或 API Key
权限商家,需要 product:write 才能修改商品、图片或店铺介绍

请求体

application/json

九个字段必须都出现,空值用 null

display_namestring必填

展示名

取值范围: 发布时不能为空,且 <= 40

summarystring必填

简介

取值范围: 发布时不能为空,且 <= 300

website_urlstring | null必填

http 或 https,或 null

取值范围: <= 200

logo_urlstring | null必填

标识地址,或 null

取值范围: <= 200

area_servedstring | null必填

服务区域,或 null

addressstring | null必填

经营地址,或 null

licenseobject | null必填

执照,或 null

license.namestring必填

企业名称,license 非空时必填

license.credit_codestring必填

统一社会信用代码

license.legal_personstring必填

法人姓名

license.registered_addressstring必填

注册地址,不覆盖经营地址

license.image_urlstring必填

执照图片地址

contactobject | null必填

客服,或 null

contact.phonestring | null必填

客服电话,contact 非空时出现

contact.labelstring | null必填

客服说明

contact.qr_urlstring | null必填

客服二维码地址

publishedboolean必填

是否公开

请求示例

{
  "display_name": "示例",
  "summary": "示例",
  "website_url": "https://example.test/resource",
  "logo_url": "https://example.test/resource",
  "area_served": "string",
  "address": "string",
  "license": {
    "name": "示例",
    "credit_code": "91110000EXAMPLE",
    "legal_person": "string",
    "registered_address": "string",
    "image_url": "https://example.test/resource"
  },
  "contact": {
    "phone": "string",
    "label": "示例",
    "qr_url": "https://example.test/resource"
  },
  "published": true
}

响应

200

application/json

成功时 code 为 200,资源在 data

display_namestring必填

展示名,不超过 40 个字符

summarystring必填

简介,不超过 300 个字符

website_urlstring | null必填

网站,http 或 https,或 null

logo_urlstring | null必填

标识地址,或 null

area_servedstring | null必填

服务区域

addressstring | null必填

经营地址

licenseobject | null必填

执照,没有时为 null

license.namestring必填

企业名称,license 非空时必填

license.credit_codestring必填

统一社会信用代码

license.legal_personstring必填

法人姓名

license.registered_addressstring必填

注册地址,不覆盖经营地址

license.image_urlstring必填

执照图片地址

contactobject | null必填

客服,没有时为 null

contact.phonestring | null必填

客服电话,contact 非空时出现

contact.labelstring | null必填

客服说明

contact.qr_urlstring | null必填

客服二维码地址

publishedboolean必填

为 true 时公开介绍才可见

updated_atstring | null必填

更新时间,空草稿时为 null

响应示例

{
  "display_name": "示例",
  "summary": "示例",
  "website_url": "https://example.test/resource",
  "logo_url": "https://example.test/resource",
  "area_served": "string",
  "address": "string",
  "license": {
    "name": "示例",
    "credit_code": "91110000EXAMPLE",
    "legal_person": "string",
    "registered_address": "string",
    "image_url": "https://example.test/resource"
  },
  "contact": {
    "phone": "string",
    "label": "示例",
    "qr_url": "https://example.test/resource"
  },
  "published": true,
  "updated_at": "2026-05-16T00:00:00.000Z"
}