1. 核心請(qǐng)求參數(shù)

表格

二、作業(yè)筆記詳情完整字段（JSON）

json

{
  "code": 0,
  "data": {
    // 基礎(chǔ)信息
    "note_id": "66d3b9a...",
    "title": "高數(shù)作業(yè)答案+解題步驟",
    "content": "本次高數(shù)作業(yè)涵蓋極限、導(dǎo)數(shù)...（含富文本）",
    "note_type": "normal", // normal=圖文/video=視頻
    "publish_time": "2026-05-07T16:30:00Z",
    "status": "published", // published/draft/deleted
    "is_commercial": false,

    // 作業(yè)標(biāo)簽（關(guān)鍵）
    "tags": ["高數(shù)作業(yè)", "大學(xué)數(shù)學(xué)", "解題技巧", "作業(yè)分享"],
    "category": "education",

    // 多媒體（作業(yè)圖片/視頻）
    "images": [
      "https://xxx.com/1.jpg", // 作業(yè)圖1
      "https://xxx.com/2.jpg"  // 作業(yè)圖2（最多9張）
    ],
    "video": { // 視頻筆記才有
      "url": "https://xxx.com/video.mp4",
      "cover": "https://xxx.com/cover.jpg",
      "duration": 120 // 秒
    },

    // 互動(dòng)數(shù)據(jù)
    "interact": {
      "like_count": 1280,
      "collect_count": 342,
      "comment_count": 89,
      "share_count": 56
    },

    // 作者信息
    "user": {
      "user_id": "user_123",
      "nickname": "學(xué)習(xí)小助手",
      "avatar": "https://xxx.com/avatar.jpg",
      "is_verified": false,
      "follower_count": 5200
    },

    // 擴(kuò)展（可選）
    "location": "北京",
    "product_info": null // 無(wú)商品則為空
  }
}

三、作業(yè)筆記特征（篩選識(shí)別）

標(biāo)題關(guān)鍵詞：作業(yè)、答案、解題、步驟、錯(cuò)題、真題、復(fù)習(xí)

標(biāo)簽特征：含 #作業(yè) #學(xué)科名+作業(yè) #學(xué)習(xí)打卡 等

內(nèi)容結(jié)構(gòu)：題目→解答→步驟→答案→總結(jié)

多媒體：多張手寫(xiě) / 打印作業(yè)圖片，或視頻講解

四、Python 調(diào)用示例（v4）

python

運(yùn)行

import requests
import hashlib
import time

def get_homework_note_detail(note_id, app_key, app_secret, access_token):
    url = f"https://api.xiaohongshu.com/v4/notes/{note_id}"
    ts = str(int(time.time()))
    # 簽名生成（ASCII升序）
    sign_str = f"app_key{app_key}note_id{note_id}timestamp{ts}{app_secret}"
    sign = hashlib.md5(sign_str.encode()).hexdigest()
    params = {
        "access_token": access_token,
        "app_key": app_key,
        "timestamp": ts,
        "sign": sign,
        "fields": "title,content,tags,images,interact,user"
    }
    resp = requests.get(url, params=params)
    return resp.json() if resp.status_code == 200 else None

五、常見(jiàn)錯(cuò)誤與處理

401：access_token 過(guò)期 → 用 refresh_token 刷新

403：權(quán)限不足 → 開(kāi)放平臺(tái)申請(qǐng) “筆記詳情” 權(quán)限

404：筆記不存在 / 私密 → 核對(duì) note_id，確認(rèn)筆記公開(kāi)

429：頻率超限 → 降頻 + 緩存，或申請(qǐng)?zhí)犷~

審核編輯 黃宇