读取自己的介绍草稿,还没保存时返回空草稿,不是 404

GET/api/v1/merchant/profile

认证请求头 Authorization: Bearer <访问令牌>,访问令牌用设备码换取,不要向用户要密码、短信验证码或 API Key
权限必须是商家,读取自己的介绍不需要额外权限名

响应

200

application/json

未保存时返回空草稿,不是 404

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"
}