[{"data":1,"prerenderedAt":1326},["ShallowReactive",2],{"navigation_docs":3,"-guide-oauth":500,"-guide-oauth-surround":1321},[4,41,56,102],{"title":5,"icon":6,"path":7,"stem":8,"children":9},"内容发布","i-lucide-file-pen-line","\u002Fpublishing","0.publishing",[10,13,17,21,25,29,33,37],{"title":11,"path":7,"stem":12},"内容发布与审核","0.publishing\u002Findex",{"title":14,"path":15,"stem":16},"资源定义与收录范围","\u002Fpublishing\u002Fresource-definition","0.publishing\u002F0.resource-definition",{"title":18,"path":19,"stem":20},"帖子发布规范","\u002Fpublishing\u002Fposts","0.publishing\u002F1.posts",{"title":22,"path":23,"stem":24},"资源发布规范","\u002Fpublishing\u002Fresources","0.publishing\u002F2.resources",{"title":26,"path":27,"stem":28},"命名、署名与转载","\u002Fpublishing\u002Fnaming-and-attribution","0.publishing\u002F3.naming-and-attribution",{"title":30,"path":31,"stem":32},"资源审核要求","\u002Fpublishing\u002Fresource-review-requirements","0.publishing\u002F4.resource-review-requirements",{"title":34,"path":35,"stem":36},"审核与处置规范","\u002Fpublishing\u002Fmoderation","0.publishing\u002F5.moderation",{"title":38,"path":39,"stem":40},"举报、版权投诉与复核","\u002Fpublishing\u002Freports-and-appeals","0.publishing\u002F6.reports-and-appeals",{"title":42,"icon":43,"path":44,"stem":45,"children":46,"page":55},"参与贡献","i-lucide-hand-helping","\u002Fcontributing","1.contributing",[47,51],{"title":48,"path":49,"stem":50},"为 NexusMC 做贡献","\u002Fcontributing\u002Fgetting-started","1.contributing\u002F1.getting-started",{"title":52,"path":53,"stem":54},"NexusMC 开源项目","\u002Fcontributing\u002Fopen-source","1.contributing\u002F2.open-source",false,{"title":57,"icon":58,"path":59,"stem":60,"children":61,"page":55},"接入指南","i-lucide-book-open","\u002Fguide","1.guide",[62,66,70,74,78,82,86,90,94,98],{"title":63,"path":64,"stem":65},"开始接入","\u002Fguide\u002Fgetting-started","1.guide\u002F1.getting-started",{"title":67,"path":68,"stem":69},"个人令牌","\u002Fguide\u002Fpersonal-access-tokens","1.guide\u002F2.personal-access-tokens",{"title":71,"path":72,"stem":73},"开放平台 OAuth","\u002Fguide\u002Foauth","1.guide\u002F3.oauth",{"title":75,"path":76,"stem":77},"分页与错误","\u002Fguide\u002Fpagination-and-errors","1.guide\u002F4.pagination-and-errors",{"title":79,"path":80,"stem":81},"发布记录与联合筛选","\u002Fguide\u002Freleases-and-filters","1.guide\u002F5.releases-and-filters",{"title":83,"path":84,"stem":85},"资源更新与 Webhook","\u002Fguide\u002Fresource-updates-and-webhooks","1.guide\u002F6.resource-updates-and-webhooks",{"title":87,"path":88,"stem":89},"公共 API v1","\u002Fguide\u002Fpublic-api-v1","1.guide\u002F7.public-api-v1",{"title":91,"path":92,"stem":93},"机器人账号接入","\u002Fguide\u002Fbot-accounts","1.guide\u002F8.bot-accounts",{"title":95,"path":96,"stem":97},"机器人事件与回复","\u002Fguide\u002Fbot-events","1.guide\u002F9.bot-events",{"title":99,"path":100,"stem":101},"内容订阅","\u002Fguide\u002Fcontent-subscriptions","1.guide\u002F9.content-subscriptions",{"title":103,"icon":104,"path":105,"stem":106,"children":107},"API 参考","i-lucide-braces","\u002Fapi","2.api",[108,110,225,356,388,426,483],{"title":103,"path":105,"stem":109},"2.api\u002Findex",{"title":111,"icon":112,"path":113,"stem":114,"children":115},"公开内容","i-lucide-globe","\u002Fapi\u002Fpublic","2.api\u002F1.public\u002Findex",[116,118,125,130,135,140,145,150,155,160,165,170,175,180,185,190,195,200,205,210,215,220],{"title":117,"path":113,"stem":114},"概览",{"title":119,"path":120,"stem":121,"badge":122},"随机浏览公开资源","\u002Fapi\u002Fpublic\u002Fbrowse-resources","2.api\u002F1.public\u002Fbrowse-resources",{"label":123,"color":124},"GET","success",{"title":126,"path":127,"stem":128,"badge":129},"检查多资源构建兼容性","\u002Fapi\u002Fpublic\u002Fcheck-compatibility","2.api\u002F1.public\u002Fcheck-compatibility",{"label":123,"color":124},{"title":131,"path":132,"stem":133,"badge":134},"查找资源名称","\u002Fapi\u002Fpublic\u002Ffind-resource-names","2.api\u002F1.public\u002Ffind-resource-names",{"label":123,"color":124},{"title":136,"path":137,"stem":138,"badge":139},"获取首页内容","\u002Fapi\u002Fpublic\u002Fget-home","2.api\u002F1.public\u002Fget-home",{"label":123,"color":124},{"title":141,"path":142,"stem":143,"badge":144},"读取公开组织详情","\u002Fapi\u002Fpublic\u002Fget-organization","2.api\u002F1.public\u002Fget-organization",{"label":123,"color":124},{"title":146,"path":147,"stem":148,"badge":149},"获取帖子及递归回复","\u002Fapi\u002Fpublic\u002Fget-post","2.api\u002F1.public\u002Fget-post",{"label":123,"color":124},{"title":151,"path":152,"stem":153,"badge":154},"获取资源详情及匹配发布","\u002Fapi\u002Fpublic\u002Fget-resource","2.api\u002F1.public\u002Fget-resource",{"label":123,"color":124},{"title":156,"path":157,"stem":158,"badge":159},"获取提到资源的帖子","\u002Fapi\u002Fpublic\u002Fget-resource-mentions","2.api\u002F1.public\u002Fget-resource-mentions",{"label":123,"color":124},{"title":161,"path":162,"stem":163,"badge":164},"获取标签聚合页","\u002Fapi\u002Fpublic\u002Fget-tag","2.api\u002F1.public\u002Fget-tag",{"label":123,"color":124},{"title":166,"path":167,"stem":168,"badge":169},"列出内容区块","\u002Fapi\u002Fpublic\u002Flist-blocks","2.api\u002F1.public\u002Flist-blocks",{"label":123,"color":124},{"title":171,"path":172,"stem":173,"badge":174},"列出能力定义","\u002Fapi\u002Fpublic\u002Flist-capabilities","2.api\u002F1.public\u002Flist-capabilities",{"label":123,"color":124},{"title":176,"path":177,"stem":178,"badge":179},"列出资源缺口","\u002Fapi\u002Fpublic\u002Flist-gaps","2.api\u002F1.public\u002Flist-gaps",{"label":123,"color":124},{"title":181,"path":182,"stem":183,"badge":184},"列出公开组织","\u002Fapi\u002Fpublic\u002Flist-organizations","2.api\u002F1.public\u002Flist-organizations",{"label":123,"color":124},{"title":186,"path":187,"stem":188,"badge":189},"筛选公开帖子","\u002Fapi\u002Fpublic\u002Flist-posts","2.api\u002F1.public\u002Flist-posts",{"label":123,"color":124},{"title":191,"path":192,"stem":193,"badge":194},"筛选公开资源","\u002Fapi\u002Fpublic\u002Flist-resources","2.api\u002F1.public\u002Flist-resources",{"label":123,"color":124},{"title":196,"path":197,"stem":198,"badge":199},"查找开放标签","\u002Fapi\u002Fpublic\u002Flist-tags","2.api\u002F1.public\u002Flist-tags",{"label":123,"color":124},{"title":201,"path":202,"stem":203,"badge":204},"继续读取帖子的直接回复","\u002Fapi\u002Fpublic\u002Fpost-replies","2.api\u002F1.public\u002Fpost-replies",{"label":123,"color":124},{"title":206,"path":207,"stem":208,"badge":209},"继续读取资源发布","\u002Fapi\u002Fpublic\u002Fresource-releases","2.api\u002F1.public\u002Fresource-releases",{"label":123,"color":124},{"title":211,"path":212,"stem":213,"badge":214},"查询当前兼容更新构建","\u002Fapi\u002Fpublic\u002Fresource-updates","2.api\u002F1.public\u002Fresource-updates",{"label":123,"color":124},{"title":216,"path":217,"stem":218,"badge":219},"搜索公开内容","\u002Fapi\u002Fpublic\u002Fsearch-content","2.api\u002F1.public\u002Fsearch-content",{"label":123,"color":124},{"title":221,"path":222,"stem":223,"badge":224},"获取公开内容建议","\u002Fapi\u002Fpublic\u002Fsuggest-content","2.api\u002F1.public\u002Fsuggest-content",{"label":123,"color":124},{"title":226,"icon":227,"path":228,"stem":229,"children":230},"个人 API","i-lucide-key-round","\u002Fapi\u002Fpersonal","2.api\u002F2.personal\u002Findex",[231,232,239,246,251,256,261,268,273,278,283,288,292,297,301,305,310,314,318,322,326,330,335,340,346,351],{"title":117,"path":228,"stem":229},{"title":233,"path":234,"stem":235,"badge":236},"修改 Issue 状态","\u002Fapi\u002Fpersonal\u002Fchange-post-state","2.api\u002F2.personal\u002Fchange-post-state",{"label":237,"color":238},"PUT","warning",{"title":240,"path":241,"stem":242,"badge":243},"创建组织","\u002Fapi\u002Fpersonal\u002Fcreate-organization","2.api\u002F2.personal\u002Fcreate-organization",{"label":244,"color":245},"POST","info",{"title":247,"path":248,"stem":249,"badge":250},"创建帖子","\u002Fapi\u002Fpersonal\u002Fcreate-post","2.api\u002F2.personal\u002Fcreate-post",{"label":244,"color":245},{"title":252,"path":253,"stem":254,"badge":255},"创建联合兼容发布记录","\u002Fapi\u002Fpersonal\u002Fcreate-release","2.api\u002F2.personal\u002Fcreate-release",{"label":244,"color":245},{"title":257,"path":258,"stem":259,"badge":260},"创建资源","\u002Fapi\u002Fpersonal\u002Fcreate-resource","2.api\u002F2.personal\u002Fcreate-resource",{"label":244,"color":245},{"title":262,"path":263,"stem":264,"badge":265},"删除本人帖子","\u002Fapi\u002Fpersonal\u002Fdelete-post","2.api\u002F2.personal\u002Fdelete-post",{"label":266,"color":267},"DELETE","error",{"title":269,"path":270,"stem":271,"badge":272},"删除本人维护的资源","\u002Fapi\u002Fpersonal\u002Fdelete-resource","2.api\u002F2.personal\u002Fdelete-resource",{"label":266,"color":267},{"title":274,"path":275,"stem":276,"badge":277},"读取本人展示资料","\u002Fapi\u002Fpersonal\u002Fget-me","2.api\u002F2.personal\u002Fget-me",{"label":123,"color":124},{"title":279,"path":280,"stem":281,"badge":282},"读取本人的帖子","\u002Fapi\u002Fpersonal\u002Flist-own-posts","2.api\u002F2.personal\u002Flist-own-posts",{"label":123,"color":124},{"title":284,"path":285,"stem":286,"badge":287},"读取本人的资源","\u002Fapi\u002Fpersonal\u002Flist-own-resources","2.api\u002F2.personal\u002Flist-own-resources",{"label":123,"color":124},{"title":131,"path":289,"stem":290,"badge":291},"\u002Fapi\u002Fpersonal\u002Fpersonal-find-resource-names","2.api\u002F2.personal\u002Fpersonal-find-resource-names",{"label":123,"color":124},{"title":293,"path":294,"stem":295,"badge":296},"读取本人可见的组织","\u002Fapi\u002Fpersonal\u002Fpersonal-get-organization","2.api\u002F2.personal\u002Fpersonal-get-organization",{"label":123,"color":124},{"title":146,"path":298,"stem":299,"badge":300},"\u002Fapi\u002Fpersonal\u002Fpersonal-get-post","2.api\u002F2.personal\u002Fpersonal-get-post",{"label":123,"color":124},{"title":151,"path":302,"stem":303,"badge":304},"\u002Fapi\u002Fpersonal\u002Fpersonal-get-resource","2.api\u002F2.personal\u002Fpersonal-get-resource",{"label":123,"color":124},{"title":306,"path":307,"stem":308,"badge":309},"列出本人组织","\u002Fapi\u002Fpersonal\u002Fpersonal-list-organizations","2.api\u002F2.personal\u002Fpersonal-list-organizations",{"label":123,"color":124},{"title":186,"path":311,"stem":312,"badge":313},"\u002Fapi\u002Fpersonal\u002Fpersonal-list-posts","2.api\u002F2.personal\u002Fpersonal-list-posts",{"label":123,"color":124},{"title":191,"path":315,"stem":316,"badge":317},"\u002Fapi\u002Fpersonal\u002Fpersonal-list-resources","2.api\u002F2.personal\u002Fpersonal-list-resources",{"label":123,"color":124},{"title":201,"path":319,"stem":320,"badge":321},"\u002Fapi\u002Fpersonal\u002Fpersonal-post-replies","2.api\u002F2.personal\u002Fpersonal-post-replies",{"label":123,"color":124},{"title":206,"path":323,"stem":324,"badge":325},"\u002Fapi\u002Fpersonal\u002Fpersonal-resource-releases","2.api\u002F2.personal\u002Fpersonal-resource-releases",{"label":123,"color":124},{"title":211,"path":327,"stem":328,"badge":329},"\u002Fapi\u002Fpersonal\u002Fpersonal-resource-updates","2.api\u002F2.personal\u002Fpersonal-resource-updates",{"label":123,"color":124},{"title":331,"path":332,"stem":333,"badge":334},"回复帖子","\u002Fapi\u002Fpersonal\u002Freply-post","2.api\u002F2.personal\u002Freply-post",{"label":244,"color":245},{"title":336,"path":337,"stem":338,"badge":339},"编辑组织资料","\u002Fapi\u002Fpersonal\u002Fupdate-organization","2.api\u002F2.personal\u002Fupdate-organization",{"label":237,"color":238},{"title":341,"path":342,"stem":343,"badge":344},"修改本人帖子","\u002Fapi\u002Fpersonal\u002Fupdate-post","2.api\u002F2.personal\u002Fupdate-post",{"label":345,"color":238},"PATCH",{"title":347,"path":348,"stem":349,"badge":350},"修改本人维护的发布记录","\u002Fapi\u002Fpersonal\u002Fupdate-release","2.api\u002F2.personal\u002Fupdate-release",{"label":345,"color":238},{"title":352,"path":353,"stem":354,"badge":355},"修改本人维护的资源","\u002Fapi\u002Fpersonal\u002Fupdate-resource","2.api\u002F2.personal\u002Fupdate-resource",{"label":345,"color":238},{"title":357,"icon":358,"path":359,"stem":360,"children":361},"开放平台","i-lucide-shield-check","\u002Fapi\u002Foauth","2.api\u002F3.oauth\u002Findex",[362,363,368,373,378,383],{"title":117,"path":359,"stem":360},{"title":364,"path":365,"stem":366,"badge":367},"发起授权码流程","\u002Fapi\u002Foauth\u002Fauthorize-oauth","2.api\u002F3.oauth\u002Fauthorize-oauth",{"label":123,"color":124},{"title":369,"path":370,"stem":371,"badge":372},"交换、刷新令牌或签发机器人令牌","\u002Fapi\u002Foauth\u002Fexchange-oauth-token","2.api\u002F3.oauth\u002Fexchange-oauth-token",{"label":244,"color":245},{"title":374,"path":375,"stem":376,"badge":377},"读取授权用户信息","\u002Fapi\u002Foauth\u002Fget-oauth-userinfo","2.api\u002F3.oauth\u002Fget-oauth-userinfo",{"label":123,"color":124},{"title":379,"path":380,"stem":381,"badge":382},"列出可申请的 OAuth scope","\u002Fapi\u002Foauth\u002Flist-oauth-scopes","2.api\u002F3.oauth\u002Flist-oauth-scopes",{"label":123,"color":124},{"title":384,"path":385,"stem":386,"badge":387},"撤销访问或刷新令牌","\u002Fapi\u002Foauth\u002Frevoke-oauth-token","2.api\u002F3.oauth\u002Frevoke-oauth-token",{"label":244,"color":245},{"title":389,"path":390,"stem":391,"children":392,"icon":425},"精简资源查询","\u002Fapi\u002Fpublic-v1","2.api\u002F4.public-v1\u002Findex",[393,394,399,406,411,416,420],{"title":117,"path":390,"stem":391},{"title":395,"path":396,"stem":397,"badge":398},"读取公开资源详情","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-get-resource","2.api\u002F4.public-v1\u002Fpublic-v1-get-resource",{"label":123,"color":124},{"title":400,"path":401,"stem":402,"badge":403},"读取公开资源详情（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-get-resource","2.api\u002F4.public-v1\u002Fpublic-v1-head-get-resource",{"label":404,"color":405},"HEAD","neutral",{"title":407,"path":408,"stem":409,"badge":410},"筛选公开资源（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-list-resources","2.api\u002F4.public-v1\u002Fpublic-v1-head-list-resources",{"label":404,"color":405},{"title":412,"path":413,"stem":414,"badge":415},"读取当前兼容更新构建（HEAD）","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-head-resource-updates","2.api\u002F4.public-v1\u002Fpublic-v1-head-resource-updates",{"label":404,"color":405},{"title":191,"path":417,"stem":418,"badge":419},"\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-list-resources","2.api\u002F4.public-v1\u002Fpublic-v1-list-resources",{"label":123,"color":124},{"title":421,"path":422,"stem":423,"badge":424},"读取当前兼容更新构建","\u002Fapi\u002Fpublic-v1\u002Fpublic-v1-resource-updates","2.api\u002F4.public-v1\u002Fpublic-v1-resource-updates",{"label":123,"color":124},"i-lucide-network",{"title":427,"icon":428,"path":429,"stem":430,"children":431},"Webhook","i-lucide-webhook","\u002Fapi\u002Fwebhooks","2.api\u002F5.webhooks\u002Findex",[432,433,438,443,448,453,458,463,468,473,478],{"title":117,"path":429,"stem":430},{"title":434,"path":435,"stem":436,"badge":437},"申请创建 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fcreate-webhook-endpoint","2.api\u002F5.webhooks\u002Fcreate-webhook-endpoint",{"label":244,"color":245},{"title":439,"path":440,"stem":441,"badge":442},"订阅资源发布或知识库更新","\u002Fapi\u002Fwebhooks\u002Fcreate-webhook-subscription","2.api\u002F5.webhooks\u002Fcreate-webhook-subscription",{"label":244,"color":245},{"title":444,"path":445,"stem":446,"badge":447},"删除 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fdelete-webhook-endpoint","2.api\u002F5.webhooks\u002Fdelete-webhook-endpoint",{"label":266,"color":267},{"title":449,"path":450,"stem":451,"badge":452},"删除资源订阅","\u002Fapi\u002Fwebhooks\u002Fdelete-webhook-subscription","2.api\u002F5.webhooks\u002Fdelete-webhook-subscription",{"label":266,"color":267},{"title":454,"path":455,"stem":456,"badge":457},"查看投递记录","\u002Fapi\u002Fwebhooks\u002Flist-webhook-deliveries","2.api\u002F5.webhooks\u002Flist-webhook-deliveries",{"label":123,"color":124},{"title":459,"path":460,"stem":461,"badge":462},"列出我的 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Flist-webhook-endpoints","2.api\u002F5.webhooks\u002Flist-webhook-endpoints",{"label":123,"color":124},{"title":464,"path":465,"stem":466,"badge":467},"列出端点订阅","\u002Fapi\u002Fwebhooks\u002Flist-webhook-subscriptions","2.api\u002F5.webhooks\u002Flist-webhook-subscriptions",{"label":123,"color":124},{"title":469,"path":470,"stem":471,"badge":472},"重试当前版本的失败投递","\u002Fapi\u002Fwebhooks\u002Fretry-webhook-delivery","2.api\u002F5.webhooks\u002Fretry-webhook-delivery",{"label":244,"color":245},{"title":474,"path":475,"stem":476,"badge":477},"轮换 Webhook 签名密钥","\u002Fapi\u002Fwebhooks\u002Frotate-webhook-secret","2.api\u002F5.webhooks\u002Frotate-webhook-secret",{"label":244,"color":245},{"title":479,"path":480,"stem":481,"badge":482},"修改 Webhook 端点","\u002Fapi\u002Fwebhooks\u002Fupdate-webhook-endpoint","2.api\u002F5.webhooks\u002Fupdate-webhook-endpoint",{"label":345,"color":238},{"title":484,"path":485,"stem":486,"children":487,"icon":499},"机器人事件","\u002Fapi\u002Fbots","2.api\u002F6.bots\u002Findex",[488,489,494],{"title":117,"path":485,"stem":486},{"title":490,"path":491,"stem":492,"badge":493},"读取机器人事件","\u002Fapi\u002Fbots\u002Flist-bot-events","2.api\u002F6.bots\u002Flist-bot-events",{"label":123,"color":124},{"title":495,"path":496,"stem":497,"badge":498},"回复机器人事件","\u002Fapi\u002Fbots\u002Freply-bot-event","2.api\u002F6.bots\u002Freply-bot-event",{"label":244,"color":245},"i-lucide-bot",{"id":501,"title":71,"body":502,"description":1314,"extension":1315,"links":1316,"meta":1317,"navigation":1318,"path":72,"seo":1319,"stem":73,"__hash__":1320},"docs\u002F1.guide\u002F3.oauth.md",{"type":503,"value":504,"toc":1312},"minimark",[505,514,517,583,592,619,630,1168,1171,1287,1297,1308],[506,507,508,509,513],"p",{},"开放平台适合需要用户授权的服务端应用。先由站点账号创建应用，登记精确的回调地址与允许申请的 scope。",[510,511,512],"code",{},"client_secret"," 只在创建或轮换时返回；它必须保存在你的服务端。",[506,515,516],{},"授权流程按以下顺序完成：",[518,519,520,532,565,580],"ol",{},[521,522,523,524,527,528,531],"li",{},"为每次授权生成随机 ",[510,525,526],{},"code_verifier","，计算 SHA-256 后做 base64url 编码，得到 ",[510,529,530],{},"code_challenge","。",[521,533,534,535,538,539,542,543,546,547,550,551,542,554,557,558,560,561,564],{},"将用户浏览器引导至 ",[510,536,537],{},"\u002Fv1\u002Foauth2\u002Fauthorize","，传入 ",[510,540,541],{},"response_type=code","、",[510,544,545],{},"client_id","、登记的 ",[510,548,549],{},"redirect_uri","、申请的 ",[510,552,553],{},"scope",[510,555,556],{},"code_challenge_method=S256"," 与 ",[510,559,530],{},"。建议附上随机 ",[510,562,563],{},"state"," 并在回调时核对。",[521,566,567,568,570,571,573,574,576,577,531],{},"用户同意后，接入方服务端从回调取得一次性 ",[510,569,510],{},"，用 ",[510,572,526],{},"、同一个 ",[510,575,549],{}," 和 client authentication 调用 ",[510,578,579],{},"\u002Fv1\u002Foauth2\u002Ftoken",[521,581,582],{},"服务端保存返回的 access\u002Frefresh 凭据，仅把 access token 用于已获准的接口。刷新时替换旧 token 对；用户撤销授权后停止使用。",[506,584,585,586,557,588,591],{},"授权码有效期为 60 秒且只能兑换一次。access token 最长一小时，refresh family 有绝对 30 天期限；刷新不会延长这个上限。scope 可以缩小，不能扩大。",[510,587,579],{},[510,589,590],{},"\u002Fv1\u002Foauth2\u002Frevoke"," 使用专用 client authentication，不使用网站 Cookie\u002FCSRF；应用管理和 consent 则仍走网站会话。",[506,593,594,595,598,599,602,603,606,607,610,611,614,615,531],{},"只有带 ",[510,596,597],{},"profile:read"," 和\u002F或 ",[510,600,601],{},"email:read"," 的 OAuth access token 可以调用 ",[510,604,605],{},"userinfo","。PAT 不提供这两个 scope。authorize、token 和 revoke 的协议错误返回 OAuth 的 ",[510,608,609],{},"{ \"error\": \"...\" }","，不要按普通内容 API 的错误信封解析。scopes 和 userinfo 的错误使用普通映射 API 的 ",[510,612,613],{},"{error:{code,message}}","。参数和响应见 ",[616,617,618],"a",{"href":359},"OAuth API 参考",[506,620,621,622,625,626,629],{},"服务端交换授权码的 TypeScript 示例。",[510,623,624],{},"OAUTH_CODE"," 来自已核对 state 的回调，",[510,627,628],{},"OAUTH_CODE_VERIFIER"," 是发起本次授权时保存的随机值；回调地址必须与登记及授权请求一致：",[631,632,637],"pre",{"className":633,"code":634,"language":635,"meta":636,"style":636},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","function required(name: string): string {\n  const value = process.env[name]\n  if (!value) throw new Error(`缺少 ${name}`)\n  return value\n}\nconst response = await fetch('http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Foauth2\u002Ftoken', {\n  method: 'POST',\n  headers: { 'Content-Type': 'application\u002Fx-www-form-urlencoded' },\n  body: new URLSearchParams({\n    grant_type: 'authorization_code',\n    client_id: required('OAUTH_CLIENT_ID'),\n    client_secret: required('OAUTH_CLIENT_SECRET'),\n    code: required('OAUTH_CODE'),\n    code_verifier: required('OAUTH_CODE_VERIFIER'),\n    redirect_uri: 'https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback',\n  }),\n})\nif (!response.ok) throw new Error(`兑换失败：${response.status} ${await response.text()}`)\nconst tokens = await response.json() as {\n  access_token: string; token_type: 'Bearer'; expires_in: number\n  refresh_token: string; scope: string\n}\n\u002F\u002F 将 tokens 保存到服务端的安全存储；不要写入日志或交给浏览器。\n","ts","",[510,638,639,675,706,754,763,769,802,820,850,868,885,909,932,954,976,993,1003,1011,1074,1101,1136,1156,1161],{"__ignoreMap":636},[640,641,644,648,652,656,660,663,667,670,672],"span",{"class":642,"line":643},"line",1,[640,645,647],{"class":646},"spNyl","function",[640,649,651],{"class":650},"s2Zo4"," required",[640,653,655],{"class":654},"sMK4o","(",[640,657,659],{"class":658},"sHdIc","name",[640,661,662],{"class":654},":",[640,664,666],{"class":665},"sBMFI"," string",[640,668,669],{"class":654},"):",[640,671,666],{"class":665},[640,673,674],{"class":654}," {\n",[640,676,678,681,685,688,691,694,697,701,703],{"class":642,"line":677},2,[640,679,680],{"class":646},"  const",[640,682,684],{"class":683},"sTEyZ"," value",[640,686,687],{"class":654}," =",[640,689,690],{"class":683}," process",[640,692,693],{"class":654},".",[640,695,696],{"class":683},"env",[640,698,700],{"class":699},"swJcz","[",[640,702,659],{"class":683},[640,704,705],{"class":699},"]\n",[640,707,709,713,716,719,722,725,728,731,734,736,739,743,746,748,751],{"class":642,"line":708},3,[640,710,712],{"class":711},"s7zQu","  if",[640,714,715],{"class":699}," (",[640,717,718],{"class":654},"!",[640,720,721],{"class":683},"value",[640,723,724],{"class":699},") ",[640,726,727],{"class":711},"throw",[640,729,730],{"class":654}," new",[640,732,733],{"class":650}," Error",[640,735,655],{"class":699},[640,737,738],{"class":654},"`",[640,740,742],{"class":741},"sfazB","缺少 ",[640,744,745],{"class":654},"${",[640,747,659],{"class":683},[640,749,750],{"class":654},"}`",[640,752,753],{"class":699},")\n",[640,755,757,760],{"class":642,"line":756},4,[640,758,759],{"class":711},"  return",[640,761,762],{"class":683}," value\n",[640,764,766],{"class":642,"line":765},5,[640,767,768],{"class":654},"}\n",[640,770,772,775,778,781,784,787,789,792,795,797,800],{"class":642,"line":771},6,[640,773,774],{"class":646},"const",[640,776,777],{"class":683}," response ",[640,779,780],{"class":654},"=",[640,782,783],{"class":711}," await",[640,785,786],{"class":650}," fetch",[640,788,655],{"class":683},[640,790,791],{"class":654},"'",[640,793,794],{"class":741},"http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Foauth2\u002Ftoken",[640,796,791],{"class":654},[640,798,799],{"class":654},",",[640,801,674],{"class":654},[640,803,805,808,810,813,815,817],{"class":642,"line":804},7,[640,806,807],{"class":699},"  method",[640,809,662],{"class":654},[640,811,812],{"class":654}," '",[640,814,244],{"class":741},[640,816,791],{"class":654},[640,818,819],{"class":654},",\n",[640,821,823,826,828,831,833,836,838,840,842,845,847],{"class":642,"line":822},8,[640,824,825],{"class":699},"  headers",[640,827,662],{"class":654},[640,829,830],{"class":654}," {",[640,832,812],{"class":654},[640,834,835],{"class":699},"Content-Type",[640,837,791],{"class":654},[640,839,662],{"class":654},[640,841,812],{"class":654},[640,843,844],{"class":741},"application\u002Fx-www-form-urlencoded",[640,846,791],{"class":654},[640,848,849],{"class":654}," },\n",[640,851,853,856,858,860,863,865],{"class":642,"line":852},9,[640,854,855],{"class":699},"  body",[640,857,662],{"class":654},[640,859,730],{"class":654},[640,861,862],{"class":650}," URLSearchParams",[640,864,655],{"class":683},[640,866,867],{"class":654},"{\n",[640,869,871,874,876,878,881,883],{"class":642,"line":870},10,[640,872,873],{"class":699},"    grant_type",[640,875,662],{"class":654},[640,877,812],{"class":654},[640,879,880],{"class":741},"authorization_code",[640,882,791],{"class":654},[640,884,819],{"class":654},[640,886,888,891,893,895,897,899,902,904,907],{"class":642,"line":887},11,[640,889,890],{"class":699},"    client_id",[640,892,662],{"class":654},[640,894,651],{"class":650},[640,896,655],{"class":683},[640,898,791],{"class":654},[640,900,901],{"class":741},"OAUTH_CLIENT_ID",[640,903,791],{"class":654},[640,905,906],{"class":683},")",[640,908,819],{"class":654},[640,910,912,915,917,919,921,923,926,928,930],{"class":642,"line":911},12,[640,913,914],{"class":699},"    client_secret",[640,916,662],{"class":654},[640,918,651],{"class":650},[640,920,655],{"class":683},[640,922,791],{"class":654},[640,924,925],{"class":741},"OAUTH_CLIENT_SECRET",[640,927,791],{"class":654},[640,929,906],{"class":683},[640,931,819],{"class":654},[640,933,935,938,940,942,944,946,948,950,952],{"class":642,"line":934},13,[640,936,937],{"class":699},"    code",[640,939,662],{"class":654},[640,941,651],{"class":650},[640,943,655],{"class":683},[640,945,791],{"class":654},[640,947,624],{"class":741},[640,949,791],{"class":654},[640,951,906],{"class":683},[640,953,819],{"class":654},[640,955,957,960,962,964,966,968,970,972,974],{"class":642,"line":956},14,[640,958,959],{"class":699},"    code_verifier",[640,961,662],{"class":654},[640,963,651],{"class":650},[640,965,655],{"class":683},[640,967,791],{"class":654},[640,969,628],{"class":741},[640,971,791],{"class":654},[640,973,906],{"class":683},[640,975,819],{"class":654},[640,977,979,982,984,986,989,991],{"class":642,"line":978},15,[640,980,981],{"class":699},"    redirect_uri",[640,983,662],{"class":654},[640,985,812],{"class":654},[640,987,988],{"class":741},"https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback",[640,990,791],{"class":654},[640,992,819],{"class":654},[640,994,996,999,1001],{"class":642,"line":995},16,[640,997,998],{"class":654},"  }",[640,1000,906],{"class":683},[640,1002,819],{"class":654},[640,1004,1006,1009],{"class":642,"line":1005},17,[640,1007,1008],{"class":654},"}",[640,1010,753],{"class":683},[640,1012,1014,1017,1019,1021,1024,1026,1029,1031,1033,1035,1037,1039,1042,1044,1046,1048,1051,1053,1056,1059,1062,1064,1067,1070,1072],{"class":642,"line":1013},18,[640,1015,1016],{"class":711},"if",[640,1018,715],{"class":683},[640,1020,718],{"class":654},[640,1022,1023],{"class":683},"response",[640,1025,693],{"class":654},[640,1027,1028],{"class":683},"ok) ",[640,1030,727],{"class":711},[640,1032,730],{"class":654},[640,1034,733],{"class":650},[640,1036,655],{"class":683},[640,1038,738],{"class":654},[640,1040,1041],{"class":741},"兑换失败：",[640,1043,745],{"class":654},[640,1045,1023],{"class":683},[640,1047,693],{"class":654},[640,1049,1050],{"class":683},"status",[640,1052,1008],{"class":654},[640,1054,1055],{"class":654}," ${",[640,1057,1058],{"class":711},"await",[640,1060,1061],{"class":683}," response",[640,1063,693],{"class":654},[640,1065,1066],{"class":650},"text",[640,1068,1069],{"class":683},"()",[640,1071,750],{"class":654},[640,1073,753],{"class":683},[640,1075,1077,1079,1082,1084,1086,1088,1090,1093,1096,1099],{"class":642,"line":1076},19,[640,1078,774],{"class":646},[640,1080,1081],{"class":683}," tokens ",[640,1083,780],{"class":654},[640,1085,783],{"class":711},[640,1087,1061],{"class":683},[640,1089,693],{"class":654},[640,1091,1092],{"class":650},"json",[640,1094,1095],{"class":683},"() ",[640,1097,1098],{"class":711},"as",[640,1100,674],{"class":654},[640,1102,1104,1107,1109,1111,1114,1117,1119,1121,1124,1126,1128,1131,1133],{"class":642,"line":1103},20,[640,1105,1106],{"class":699},"  access_token",[640,1108,662],{"class":654},[640,1110,666],{"class":665},[640,1112,1113],{"class":654},";",[640,1115,1116],{"class":699}," token_type",[640,1118,662],{"class":654},[640,1120,812],{"class":654},[640,1122,1123],{"class":741},"Bearer",[640,1125,791],{"class":654},[640,1127,1113],{"class":654},[640,1129,1130],{"class":699}," expires_in",[640,1132,662],{"class":654},[640,1134,1135],{"class":665}," number\n",[640,1137,1139,1142,1144,1146,1148,1151,1153],{"class":642,"line":1138},21,[640,1140,1141],{"class":699},"  refresh_token",[640,1143,662],{"class":654},[640,1145,666],{"class":665},[640,1147,1113],{"class":654},[640,1149,1150],{"class":699}," scope",[640,1152,662],{"class":654},[640,1154,1155],{"class":665}," string\n",[640,1157,1159],{"class":642,"line":1158},22,[640,1160,768],{"class":654},[640,1162,1164],{"class":642,"line":1163},23,[640,1165,1167],{"class":1166},"sHwdD","\u002F\u002F 将 tokens 保存到服务端的安全存储；不要写入日志或交给浏览器。\n",[506,1169,1170],{},"同一请求的 curl 示例：",[631,1172,1176],{"className":1173,"code":1174,"language":1175,"meta":636,"style":636},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl --fail-with-body 'http:\u002F\u002F127.0.0.1:4520\u002Fv1\u002Foauth2\u002Ftoken' \\\n  --data-urlencode 'grant_type=authorization_code' \\\n  --data-urlencode \"client_id=$OAUTH_CLIENT_ID\" \\\n  --data-urlencode \"client_secret=$OAUTH_CLIENT_SECRET\" \\\n  --data-urlencode \"code=$OAUTH_CODE\" \\\n  --data-urlencode \"code_verifier=$OAUTH_CODE_VERIFIER\" \\\n  --data-urlencode 'redirect_uri=https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback'\n","bash",[510,1177,1178,1195,1209,1227,1243,1259,1275],{"__ignoreMap":636},[640,1179,1180,1183,1186,1188,1190,1192],{"class":642,"line":643},[640,1181,1182],{"class":665},"curl",[640,1184,1185],{"class":741}," --fail-with-body",[640,1187,812],{"class":654},[640,1189,794],{"class":741},[640,1191,791],{"class":654},[640,1193,1194],{"class":683}," \\\n",[640,1196,1197,1200,1202,1205,1207],{"class":642,"line":677},[640,1198,1199],{"class":741},"  --data-urlencode",[640,1201,812],{"class":654},[640,1203,1204],{"class":741},"grant_type=authorization_code",[640,1206,791],{"class":654},[640,1208,1194],{"class":683},[640,1210,1211,1213,1216,1219,1222,1225],{"class":642,"line":708},[640,1212,1199],{"class":741},[640,1214,1215],{"class":654}," \"",[640,1217,1218],{"class":741},"client_id=",[640,1220,1221],{"class":683},"$OAUTH_CLIENT_ID",[640,1223,1224],{"class":654},"\"",[640,1226,1194],{"class":683},[640,1228,1229,1231,1233,1236,1239,1241],{"class":642,"line":756},[640,1230,1199],{"class":741},[640,1232,1215],{"class":654},[640,1234,1235],{"class":741},"client_secret=",[640,1237,1238],{"class":683},"$OAUTH_CLIENT_SECRET",[640,1240,1224],{"class":654},[640,1242,1194],{"class":683},[640,1244,1245,1247,1249,1252,1255,1257],{"class":642,"line":765},[640,1246,1199],{"class":741},[640,1248,1215],{"class":654},[640,1250,1251],{"class":741},"code=",[640,1253,1254],{"class":683},"$OAUTH_CODE",[640,1256,1224],{"class":654},[640,1258,1194],{"class":683},[640,1260,1261,1263,1265,1268,1271,1273],{"class":642,"line":771},[640,1262,1199],{"class":741},[640,1264,1215],{"class":654},[640,1266,1267],{"class":741},"code_verifier=",[640,1269,1270],{"class":683},"$OAUTH_CODE_VERIFIER",[640,1272,1224],{"class":654},[640,1274,1194],{"class":683},[640,1276,1277,1279,1281,1284],{"class":642,"line":804},[640,1278,1199],{"class":741},[640,1280,812],{"class":654},[640,1282,1283],{"class":741},"redirect_uri=https:\u002F\u002Fexample.com\u002Foauth\u002Fcallback",[640,1285,1286],{"class":654},"'\n",[506,1288,1289,1292,1293,1296],{},[510,1290,1291],{},"example.com"," 是占位回调，必须替换。参考中的 ",[510,1294,1295],{},"REPLACE_WITH_*"," 字符串也只是占位秘密，不能直接完成兑换；必须先执行真实的授权与 S256 PKCE 流程。选择 HTTP Basic 时应删除 body 中的 client_id\u002Fclient_secret，不能同时使用两种 client authentication。",[506,1298,1299,1300,1303,1304,1307],{},"OAuth 接入使用 ",[510,1301,1302],{},"\u002Fv1\u002Foauth2","；申请权限前请以当前 ",[616,1305,1306],{"href":380},"scope 列表","为准。令牌交换、刷新、撤销和内容写入不会自动重试；超时可能已经提交。刷新请求结果未知时不要盲目重放旧 refresh token，否则会触发整族撤销。",[1309,1310,1311],"style",{},"html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":636,"searchDepth":677,"depth":677,"links":1313},[],"使用 confidential client 和 S256 PKCE 获得用户授权。","md",null,{},true,{"title":71,"description":1314},"XM7bEKun0qV9cXfJUDYUJCLuQqy5jzWlGNWUcD_EJoA",[1322,1324],{"title":67,"path":68,"stem":69,"description":1323,"children":-1},"为自己的工具使用有限的个人 API 权限。",{"title":75,"path":76,"stem":77,"description":1325,"children":-1},"正确处理列表游标、普通 API 与 OAuth 的错误格式。",1795179028017]