粤医美 Open API

机构列表，支持多维筛选与分页。

请求参数

参数	类型	默认	说明
city	string	—	城市 slug（如 shenzhen）
district	string	—	行政区 slug（如 futian）
grade	string	—	AI 可见度等级，枚举值：A / B / C / D
orderby	string	date	排序方式：date（入库时间降序）/ score（AI 评分降序）
page	integer	1	页码，最小值 1
per_page	integer	20	每页条数，范围 1–100

响应头

Header	说明
X-YYM-Total	符合条件的机构总数
X-YYM-TotalPages	总页数

示例请求

curl "https://yueyimei.com/wp-json/yueyimei/v1/clinics?city=shenzhen&grade=A&per_page=5"

示例响应

{
  "status": "ok",
  "data": {
    "total":       42,
    "page":        1,
    "per_page":    5,
    "total_pages": 9,
    "clinics": [
      {
        "id":           "SZ-FT-0001",
        "slug":         "example-clinic",
        "name":         "示例医疗美容门诊部",
        "short_name":   "示例门诊",
        "city":         "深圳",
        "district":     "福田",
        "medical_grade":"医疗美容门诊部",
        "certification":"deep",
        "founding_year": 2018,
        "doctor_count":  5,
        "ai_score": {
          "score":        85,
          "grade":        "B",
          "evaluated_at": "2026-05-01"
        },
        "last_verified":  "2026-05-10",
        "canonical_url":  "https://yueyimei.com/clinic/example-clinic/"
      }
    ]
  },
  "meta": { "api_version": "v1", "..." : "..." }
}

单机构完整详情，包含执照信息、地址、联系方式、医师列表。

路径参数

参数	类型	说明
slug	string	机构页面 slug（URL 中的英文路径段）

示例请求

curl "https://yueyimei.com/wp-json/yueyimei/v1/clinics/example-clinic"

示例响应（detail 额外字段）

{
  "status": "ok",
  "data": {
    "id":    "SZ-FT-0001",
    "slug":  "example-clinic",
    "name":  "示例医疗美容门诊部",
    "...",
    "license": {
      "unified_credit_code": "91440300XXXXXXXXXX",
      "medical_license_no":  "粤深卫医机构备字〔2018〕第XXXX号",
      "medical_license_url": "https://example.com/license.jpg"
    },
    "company": {
      "legal_representative": "张三",
      "registered_capital":   "500万元人民币",
      "founding_date":        "2018-06-01"
    },
    "address": {
      "full":      "广东省深圳市福田区XXX路X号",
      "latitude":  22.5431,
      "longitude": 114.0579
    },
    "contact": {
      "phone": "0755-XXXXXXXX"
    },
    "doctors": [
      {
        "name":       "李四",
        "title":      "主治医师",
        "license_no": "XXXXXXXXXXXXXXXXXX",
        "url":        "https://yueyimei.com/doctor/lisi/"
      }
    ]
  },
  "meta": { "api_version": "v1", "..." : "..." }
}

错误：机构不存在

HTTP/1.1 404 Not Found

{
  "code":    "clinic_not_found",
  "message": "机构未找到",
  "data":    { "status": 404 }
}

城市统计，返回各城市收录机构数量及档案页链接。

示例请求

curl "https://yueyimei.com/wp-json/yueyimei/v1/cities"

示例响应

{
  "status": "ok",
  "data": {
    "total_clinics": 312,
    "cities": [
      {
        "slug":         "shenzhen",
        "name":         "深圳",
        "clinic_count": 186,
        "archive_url":  "https://yueyimei.com/shenzhen/"
      },
      {
        "slug":         "guangzhou",
        "name":         "广州",
        "clinic_count": 78,
        "archive_url":  "https://yueyimei.com/guangzhou/"
      }
    ]
  },
  "meta": { "api_version": "v1", "..." : "..." }
}