关于 GitHub App 权限
GitHub Apps 是用一组权限创建的。 权限定义了 GitHub App 可以通过 API 访问哪些资源。 有关详细信息,请参阅“为 GitHub Apps 选择权限”。
为帮助正确选择权限,在 REST API 响应中将会收到 X-Accepted-GitHub-Permissions
标头。 标头将会提示访问端点所需的权限。 有关详细信息,请参阅“REST API 故障排除”。
需要拥有这些权限才能访问专用资源。 某些端点也可以用来访问不具有这些权限的公共资源。 若要查看端点是否可以在没有权限的情况下访问公共资源,请参阅该端点的文档。
某些端点需要多个权限。 其他端点使用一组权限中的任何一个权限。 在这些情况下,“其他权限”列将包含复选标记。 有关使用端点所需的权限的完整详细信息,请参阅该端点的文档。
Business permissions for "Enterprise administration"
Organization permissions for "Administration"
Organization permissions for "Custom properties"
Organization permissions for "Custom repository roles"
Organization permissions for "Events"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
GET /users/{username}/events/orgs/{org} | read | UAT |
Organization permissions for "Members"
Organization permissions for "Organization announcement banners"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PATCH /orgs/{org}/announcement | write | UAT IAT | |
DELETE /orgs/{org}/announcement | write | UAT IAT | |
GET /orgs/{org}/announcement | read | UAT IAT |
Organization permissions for "Organization dependabot secrets"
Organization permissions for "Personal access token requests"
Organization permissions for "Personal access tokens"
Organization permissions for "Pre-receive hooks"
Organization permissions for "Projects"
Organization permissions for "Secrets"
Organization permissions for "Self-hosted runners"
Organization permissions for "Team discussions"
Organization permissions for "Variables"
Organization permissions for "Webhooks"
Repository permissions for "Actions"
Repository permissions for "Administration"
Repository permissions for "Checks"
Repository permissions for "Code scanning alerts"
Repository permissions for "Commit statuses"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
POST /repos/{owner}/{repo}/statuses/{sha} | write | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/status | read | UAT IAT | |
GET /repos/{owner}/{repo}/commits/{ref}/statuses | read | UAT IAT |
Repository permissions for "Contents"
Repository permissions for "Custom properties"
终结点 | Access | 令牌类型 | 其他权限 |
---|---|---|---|
PATCH /repos/{owner}/{repo}/properties/values | write | UAT IAT |