# 蒲公英-笔记详情

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /api/v2/pgy/note/detail:
    post:
      summary: 蒲公英-笔记详情
      deprecated: false
      description: >-
        获取单篇笔记的正文、图片/视频与互动数据。

        对应蒲公英笔记卡片点开后的详情弹窗。


        - **note_id**: 笔记ID


        **返回主要字段**（都在 `data.data` 下）：笔记基础（`noteId`/`noteLink`/`title`/`content`
        正文/`type` 类型/`createTime`）、

        作者（`userId`/`name`/`headPhoto`）、媒体（`imagesList[]` 图片 url 与宽高、`videoInfo`
        视频）、

        互动数据（`impNum` 曝光/`readNum` 阅读/`likeNum` 点赞/`favNum` 收藏/`cmtNum` 评论）。


        ## 示例


        ```bash

        curl -X POST 'https://rnote.dev/api/v2/pgy/note/detail'       -H
        'X-API-Key: sk-你的Key' -H 'Content-Type: application/json'       -d
        '{"note_id": "6a9aa495000000002603936d"}'

        ```


        `note_id` 从 `/blogger/notes` 的 `list[].noteId`、`/blogger/notes_v2` 的

        `noteList[].noteInfo.noteId`，或 `/content/square` 的榜单结果里取。
      operationId: note_detail_api_v2_pgy_note_detail_post
      tags:
        - 蒲公英数据接口 V1
        - 蒲公英数据接口 V1
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NoteDetailReq'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: string
          headers: {}
          x-apifox-name: ''
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          headers: {}
          x-apifox-name: ''
      security:
        - API Key: []
          x-apifox:
            schemeGroups:
              - id: Krb4QDV1nuukQ6HJDzyOT
                schemeIds:
                  - API Key
            required: true
            use:
              id: Krb4QDV1nuukQ6HJDzyOT
            scopes:
              Krb4QDV1nuukQ6HJDzyOT:
                API Key: []
      x-apifox-folder: 蒲公英数据接口 V1
      x-apifox-status: released
      x-run-in-apifox: https://app.apifox.com/web/project/7909900/apis/api-479203859-run
components:
  schemas:
    NoteDetailReq:
      properties:
        note_id:
          type: string
          title: Note Id
          description: 笔记ID
          examples:
            - 6a20edfa0000000021020951
      type: object
      required:
        - note_id
      title: NoteDetailReq
      x-apifox-orders:
        - note_id
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
      x-apifox-orders:
        - detail
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          type: string
        ctx:
          type: object
          title: Context
          x-apifox-orders: []
          properties: {}
          x-apifox-ignore-properties: []
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
      x-apifox-orders:
        - loc
        - msg
        - type
        - input
        - ctx
      x-apifox-ignore-properties: []
      x-apifox-folder: ''
  securitySchemes:
    API Key:
      type: apikey
      description: '在此输入 API Key (格式: sk-xxx)，所有 /api/v1/* 接口需要携带'
      in: header
      name: X-API-Key
    InternalKey:
      type: apikey
      description: 内部调用方服务密钥（机器平面），形如 `thk-int-{id}-{secret}`。
      in: header
      name: X-Internal-Key
    UserSession:
      type: apikey
      description: 终端用户会话令牌（门户平面），登录后由门户签发。
      in: header
      name: X-User-Session
    StaffSession:
      type: apikey
      description: 管理后台员工会话 cookie（管理平面），登录后种下。
      in: cookie
      name: admin_session
    Combination:
      group:
        - id: 1724839
        - id: 1724840
      type: combination
servers:
  - url: https://rnote.dev
    description: 正式环境
security: []

```