整份替换店铺介绍,九个字段必须同时出现
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"
}