§ API REFERENCE

查询产品公开内容

GET/capabilities/{resource_type}/{resource_id}/contentscope: capabilities:read

读取当前可用产品的正式介绍、适用对象、科学背景、限制、内容版本及类别专属详情。

鉴权：Authorization: Bearer <access_token>。

§ 1

请求信息

REQUEST

GET https://api.lingxiguangnian.com/api/open/v1/capabilities/{resource_type}/{resource_id}/content

请求头

参数	类型	必填	说明
`Authorization`	string	是	Bearer <access_token>。由 POST /token 换取，有效期 2 小时；api_secret 不得直连业务端点（→ 401）。

路径参数

参数	类型	必填	说明
`resource_type`	enum	是	CAPABILITY_UNIT / SCENE_SOLUTION，取自 /capabilities。
`resource_id`	uuid	是	取自 /capabilities。

§ 2

调用示例

EXAMPLES

GET /capabilities/{resource_type}/{resource_id}/content

curl "https://api.lingxiguangnian.com/api/open/v1/capabilities/CAPABILITY_UNIT/22222222-2222-4222-8222-222222222222/content" \
  -H "Authorization: Bearer oat_xxxxxxxxxxxxxxxx"

§ 3

返回结果

RESPONSE

返回字段

参数	类型	必填	说明
`resource_type/resource_id/category/name`	mixed	是	与能力目录同源的产品身份。
`summary/description`	string \| null	是	正式公开简介与说明；缺失时为 null，不生成占位文案。
`scientific_background`	string \| null	是	正式科学背景或临床来源。
`target_audiences`	string[]	是	适用对象。
`estimated_duration`	string \| null	是	预计时长。
`cover_url`	string \| null	是	公开封面地址。
`content_version/updated_at`	string \| null	是	内容版本与更新时间。
`content_status`	enum	是	COMPLETE / PARTIAL。
`missing_fields`	string[]	是	缺失的核心公开字段；调用方不得自行编造。
`details`	object	是	量表、AI测评或方案的类别专属公开字段。

RESPONSE · JSON

{
  "success": true,
  "data": {
    "resource_type": "CAPABILITY_UNIT",
    "resource_id": "22222222-2222-4222-8222-222222222222",
    "category": "SCALE_ASSESSMENT",
    "name": "症状自评量表",
    "price_credits": 5,
    "summary": "用于了解近期多维心理症状表现。",
    "scientific_background": "正式量表公开来源",
    "target_audiences": ["成人"],
    "estimated_duration": "10分钟",
    "content_version": "1.0.0",
    "content_status": "COMPLETE",
    "missing_fields": [],
    "details": { "kind": "scale", "scale_code": "SCL90", "item_count": 90 }
  }
}

§ 4

端点错误码

ERRORS

通用鉴权、scope 与限流错误见「使用概述」；下表为本端点专属错误。

HTTP	error_code	触发条件
404	`open_api.capability_not_found`	产品不存在、不属于正式开放类别、未发布、无当前有效价格或被机构目录排除。
500	`open_api.capability_content_query_failed`	产品内容查询失败。

使用说明

PARTIAL 仍是可执行的正式产品，只表示公开内容字段尚不完整；调用方应展示已有字段并记录缺口。

契约真源：apps/m-master/src/app/api/open/v1/capabilities/[resourceType]/[resourceId]/content/route.ts