GiteaHat
  1. notification
GiteaHat
  • Gitea接口
    • activitypub
      • Returns the Person actor for a user
      • Send to the inbox
    • admin
      • List cron tasks
      • Run cron task
      • List all organizations
      • List unadopted repositories
      • Adopt unadopted files as a repository
      • Delete unadopted files
      • Search users according filter conditions
      • Create a user
      • Delete a user
      • Edit an existing user
      • Add a public key on behalf of a user
      • Delete a user's public key
      • Create an organization
      • Create a repository on behalf of a user
    • miscellaneous
      • Render a markdown document as HTML
      • Render raw markdown as HTML
      • Returns the nodeinfo of the Gitea application
      • Get default signing-key.gpg
      • Returns the version of the Gitea application
    • notification
      • List users's notification threads
        GET
      • Mark notification threads as read, pinned or unread
        PUT
      • Check if unread notifications exist
        GET
      • Get notification thread by ID
        GET
      • Mark notification thread as read by ID
        PATCH
      • List users's notification threads on a specific repo
        GET
      • Mark notification threads as read, pinned or unread on a specific repo
        PUT
    • organization
      • Create a repository in an organization
      • Get list of organizations
      • Create an organization
      • Get an organization
      • Delete an organization
      • Edit an organization
      • List an organization's webhooks
      • Create a hook
      • Get a hook
      • Delete a hook
      • Update a hook
      • List an organization's labels
      • Create a label for an organization
      • Get a single label
      • Delete a label
      • Update a label
      • List an organization's members
      • Check if a user is a member of an organization
      • Remove a member from an organization
      • List an organization's public members
      • Check if a user is a public member of an organization
      • Publicize a user's membership
      • Conceal a user's membership
      • List an organization's repos
      • Create a repository in an organization
      • List an organization's teams
      • Create a team
      • Search for teams within an organization
      • Get a team
      • Delete a team
      • Edit a team
      • List a team's members
      • List a particular member of team
      • Add a team member
      • Remove a team member
      • List a team's repos
      • List a particular repo of team
      • Add a repository to a team
      • Remove a repository from a team
      • List the current user's organizations
      • List a user's organizations
      • Get user permissions in organization
    • package
      • Gets all packages of an owner
      • Gets a package
      • Delete a package
      • Gets all files of a package
    • issue
      • Search for issues across the repositories that the user has access to
      • List a repository's issues
      • Create an issue. If using deadline only the date will be taken into account, and time of day ignored.
      • List all comments in a repository
      • Get a comment
      • Delete a comment
      • Edit a comment
      • Get a list of reactions from a comment of an issue
      • Add a reaction to a comment of an issue
      • Remove a reaction from a comment of an issue
      • Get an issue
      • Delete an issue
      • Edit an issue. If using deadline only the date will be taken into account, and time of day ignored.
      • List all comments on an issue
      • Add a comment to an issue
      • Delete a comment
      • Edit a comment
      • Set an issue deadline. If set to null, the deadline is deleted. If using deadline only the date will be taken into account, and time of day ignored.
      • Get an issue's labels
      • Replace an issue's labels
      • Add a label to an issue
      • Remove all labels from an issue
      • Remove a label from an issue
      • Get a list reactions of an issue
      • Add a reaction to an issue
      • Remove a reaction from an issue
      • Delete an issue's existing stopwatch.
      • Start stopwatch on an issue.
      • Stop an issue's existing stopwatch.
      • Get users who subscribed on an issue.
      • Check if user is subscribed to an issue
      • Subscribe user to issue
      • Unsubscribe user from issue
      • List all comments and events on an issue
      • List an issue's tracked times
      • Add tracked time to a issue
      • Reset a tracked time of an issue
      • Delete specific tracked time
      • Get all of a repository's labels
      • Create a label
      • Get a single label
      • Delete a label
      • Update a label
      • Get all of a repository's opened milestones
      • Create a milestone
      • Get a milestone
      • Delete a milestone
      • Update a milestone
    • repository
      • Migrate a remote git repository
      • Search for repositories
      • Get a repository
      • Delete a repository
      • Edit a repository's properties. Only fields that are set will be changed.
      • Get an archive of a repository
      • Return all users that have write access and can be assigned to issues
      • List branch protections for a repository
      • Create a branch protections for a repository
      • Get a specific branch protection for the repository
      • Delete a specific branch protection for the repository
      • Edit a branch protections for a repository. Only fields that are set will be changed
      • List a repository's branches
      • Create a branch
      • Retrieve a specific branch from a repository, including its effective branch protection
      • Delete a specific branch from a repository
      • List a repository's collaborators
      • Check if a user is a collaborator of a repository
      • Add a collaborator to a repository
      • Delete a collaborator from a repository
      • Get repository permissions for a user
      • Get a list of all commits from a repository
      • Get a commit's combined status, by branch/tag/commit reference
      • Get a commit's statuses, by branch/tag/commit reference
      • Gets the metadata of all the entries of the root dir
      • Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir
      • Update a file in a repository
      • Create a file in a repository
      • Delete a file in a repository
      • Apply diff patch to repository
      • Get the EditorConfig definitions of a file in a repository
      • List a repository's forks
      • Fork a repository
      • Gets the blob of a repository.
      • Get a single commit from a repository
      • Get a commit's diff or patch
      • Get a note corresponding to a single commit from a repository
      • Get specified ref or filtered repository's refs
      • Get specified ref or filtered repository's refs
      • Gets the tag object of an annotated tag (not lightweight tags)
      • Gets the tree of a repository.
      • List the hooks in a repository
      • Create a hook
      • List the Git hooks in a repository
      • Get a Git hook
      • Delete a Git hook in a repository
      • Edit a Git hook in a repository
      • Get a hook
      • Delete a hook in a repository
      • Edit a hook in a repository
      • Test a push webhook
      • Get available issue templates for a repository
      • List a repository's keys
      • Add a key to a repository
      • Get a repository's key by id
      • Delete a key from a repository
      • Get languages and number of bytes of code written
      • Get a file or it's LFS object from a repository
      • Sync a mirrored repository
      • List a repo's pull requests
      • Create a pull request
      • Get a pull request
      • Update a pull request. If using deadline only the date will be taken into account, and time of day ignored.
      • Get a pull request diff or patch
      • Get commits for a pull request
      • Check if a pull request has been merged
      • Merge a pull request
      • Cancel the scheduled auto merge for the given pull request
      • create review requests for a pull request
      • cancel review requests for a pull request
      • List all reviews for a pull request
      • Create a review to an pull request
      • Get a specific review for a pull request
      • Submit a pending review to an pull request
      • Delete a specific review from a pull request
      • Get a specific review for a pull request
      • Dismiss a review for a pull request
      • Cancel to dismiss a review for a pull request
      • Merge PR's baseBranch into headBranch
      • Get all push mirrors of the repository
      • add a push mirror to the repository
      • Sync all push mirrored repository
      • Get push mirror of the repository by remoteName
      • deletes a push mirror from a repository by remoteName
      • Get a file from a repository
      • List a repo's releases
      • Create a release
      • Get changed files for a pull request
      • Get a release by tag name
      • Delete a release by tag name
      • Get a release
      • Delete a release
      • Update a release
      • List release's attachments
      • Create a release attachment
      • Get a release attachment
      • Delete a release attachment
      • Edit a release attachment
      • Return all users that can be requested to review in this repo
      • Get signing-key.gpg for given repository
      • List a repo's stargazers
      • Get a commit's statuses
      • Create a commit status
      • List a repo's watchers
      • Check if the current user is watching a repo
      • Watch a repo
      • Unwatch a repo
      • List a repository's tags
      • Create a new git tag in a repository
      • Get the tag of a repository by tag name
      • Delete a repository's tag by name
      • List a repository's teams
      • Check if a team is assigned to a repository
      • Add a team to a repository
      • Delete a team from a repository
      • List a repo's tracked times
      • List a user's tracked times in a repo
      • Get list of topics that a repository has
      • Replace list of topics for a repository
      • Add a topic to a repository
      • Delete a topic from a repository
      • Transfer a repo ownership
      • Accept a repo transfer
      • Reject a repo transfer
      • Create a wiki page
      • Get a wiki page
      • Delete a wiki page
      • Edit a wiki page
      • Get all wiki pages
      • Get revisions of a wiki page
      • Create a repository using a template
      • Get a repository by id
      • search topics via keyword
      • Create a repository
    • settings
      • Get instance's global settings for api
      • Get instance's global settings for Attachment
      • Get instance's global settings for repositories
      • Get instance's global settings for ui
    • user
      • Get the authenticated user
      • List the authenticated user's oauth2 applications
      • creates a new OAuth2 application
      • get an OAuth2 Application
      • delete an OAuth2 Application
      • update an OAuth2 Application, this includes regenerating the client secret
      • List the authenticated user's email addresses
      • Add email addresses
      • Delete email addresses
      • List the authenticated user's followers
      • List the users that the authenticated user is following
      • Check whether a user is followed by the authenticated user
      • Follow a user
      • Unfollow a user
      • Get a Token to verify
      • Verify a GPG key
      • List the authenticated user's GPG keys
      • Create a GPG key
      • Get a GPG key
      • Remove a GPG key
      • List the authenticated user's public keys
      • Create a public key
      • Get a public key
      • Delete a public key
      • List the repos that the authenticated user owns
      • Get user settings
      • Update user settings
      • The repos that the authenticated user has starred
      • Whether the authenticated is starring the repo
      • Star the given repo
      • Unstar the given repo
      • Get list of all existing stopwatches
      • List repositories watched by the authenticated user
      • List all the teams a user belongs to
      • List the current user's tracked times
      • Search for users
      • Get a user
      • List the given user's followers
      • List the users that the given user is following
      • Check if one user is following another user
      • List the given user's GPG keys
      • Get a user's heatmap
      • List the given user's public keys
      • List the repos owned by the given user
      • The repos that the given user has starred
      • List the repositories watched by a user
      • List the authenticated user's access tokens
      • Create an access token
      • delete an access token
  • Hat拓展接口
    • repository
      • actions
        • 获取流水线文件列表
        • 获取流水线任务列表
        • 重新启动流水线任务
        • 重新启动全部流水线任务
        • 禁用流水线
        • 恢复流水线
        • 下载流水线日志
        • 启动流水线任务
      • 获取仓库所有文件文件夹
      • 获取仓库路径下所有文件文件夹
      • 仓库内搜索文件
      • 获取单个commit内容
      • 获取单个commit的dif内容
      • 创建一个webhook
      • 获取一个webhook推送历史
      • Gets the most recent non-prerelease, non-draft release of a repository, sorted by created_at
      • 获取所有的发行版
      • 获取一个发行版
      • 创建一个发行版
      • 更新一个发行版
      • 获取所有分支名称
      • 获取所有分支 (按类型分组)
      • 获取所有标签名称
      • 获取所有标签
      • 获取仓库分支、标签数量
      • 获取仓库readme文件内容
      • 获取仓库目录下readme文件内容
      • 获取所有commits（按时间分组）
      • 获取仓库贡献者
      • 获取仓库commit数量、标签数量、分支数量、发行版数量（按分支）
      • 获取文件或文件夹下的commit列表
      • 获取仓库blame内容
      • 分支、标签、commit的比较接口
      • 迁移项目（直接）
      • 获取一个合并请求
      • 获取合并请求下的commit列表
      • Get changed files for a pull request
      • 仓库下批量更改文件（创建、更新、删除）
      • 获取合并请求下所有版本记录
      • 获取合并请求下一个版本记录的diff内容
      • 获取仓库代码贡献情况
      • 获取所有分支
      • 获取仓库贡献者（包括代码行）
      • 恢复一个已删除分支
      • 获取最近的commit列表
      • 删除一个仓库
    • organization
      • 创建一个组织
      • 团队添加所有组织项目
      • 团队移除所有组织项目
      • 编辑一个组织
    • users
      • 获取用户贡献记录（按时间）
    • admin
      • 编辑一个用户
  1. notification

Get notification thread by ID

GET
/notifications/threads/{id}

请求参数

Authorization
在 Header 添加参数
Authorization
，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password
示例：
Authorization: Basic *****************
Path 参数
id
string 
必需
id of notification thread

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/notifications/threads/' \
--header 'Authorization: Basic Og=='

返回响应

🟢200成功
application/json
Body
NotificationThread expose Notification on API
id
integer <int64>
可选
pinned
boolean 
可选
repository
object (Repository) 
可选
Repository represents a repository
allow_merge_commits
boolean 
可选
allow_rebase
boolean 
可选
allow_rebase_explicit
boolean 
可选
allow_rebase_update
boolean 
可选
allow_squash_merge
boolean 
可选
archived
boolean 
可选
archived_at
string <date-time>
可选
avatar_url
string 
可选
clone_url
string 
可选
created_at
string <date-time>
可选
default_allow_maintainer_edit
boolean 
可选
default_branch
string 
可选
default_delete_branch_after_merge
boolean 
可选
default_merge_style
string 
可选
description
string 
可选
empty
boolean 
可选
external_tracker
object (ExternalTracker) 
可选
ExternalTracker represents settings for external tracker
external_wiki
object (ExternalWiki) 
可选
ExternalWiki represents setting for external wiki
fork
boolean 
可选
forks_count
integer <int64>
可选
full_name
string 
可选
has_actions
boolean 
可选
has_issues
boolean 
可选
has_packages
boolean 
可选
has_projects
boolean 
可选
has_pull_requests
boolean 
可选
has_releases
boolean 
可选
has_wiki
boolean 
可选
html_url
string 
可选
id
integer <int64>
可选
ignore_whitespace_conflicts
boolean 
可选
internal
boolean 
可选
internal_tracker
object (InternalTracker) 
可选
InternalTracker represents settings for internal tracker
language
string 
可选
languages_url
string 
可选
link
string 
可选
mirror
boolean 
可选
mirror_interval
string 
可选
mirror_updated
string <date-time>
可选
name
string 
可选
open_issues_count
integer <int64>
可选
open_pr_counter
integer <int64>
可选
original_url
string 
可选
owner
object (User) 
可选
User represents a user
parent
object (Repository) 
可选
Repository represents a repository
permissions
object (Permission) 
可选
Permission represents a set of permissions
private
boolean 
可选
release_counter
integer <int64>
可选
repo_transfer
object (RepoTransfer) 
可选
RepoTransfer represents a pending repo transfer
size
integer <int64>
可选
ssh_url
string 
可选
stars_count
integer <int64>
可选
template
boolean 
可选
updated_at
string <date-time>
可选
url
string 
可选
watchers_count
integer <int64>
可选
website
string 
可选
subject
object (NotificationSubject) 
可选
NotificationSubject contains the notification subject (Issue/Pull/Commit)
html_url
string 
可选
latest_comment_html_url
string 
可选
latest_comment_url
string 
可选
state
string 
可选
StateType issue state type
title
string 
可选
type
string 
可选
NotifySubjectType represent type of notification subject
url
string 
可选
unread
boolean 
可选
updated_at
string <date-time>
可选
url
string 
可选
示例
{
    "id": 0,
    "pinned": true,
    "repository": {
        "allow_merge_commits": true,
        "allow_rebase": true,
        "allow_rebase_explicit": true,
        "allow_rebase_update": true,
        "allow_squash_merge": true,
        "archived": true,
        "archived_at": "2019-08-24T14:15:22Z",
        "avatar_url": "string",
        "clone_url": "string",
        "created_at": "2019-08-24T14:15:22Z",
        "default_allow_maintainer_edit": true,
        "default_branch": "string",
        "default_delete_branch_after_merge": true,
        "default_merge_style": "string",
        "description": "string",
        "empty": true,
        "external_tracker": {
            "external_tracker_format": "string",
            "external_tracker_regexp_pattern": "string",
            "external_tracker_style": "string",
            "external_tracker_url": "string"
        },
        "external_wiki": {
            "external_wiki_url": "string"
        },
        "fork": true,
        "forks_count": 0,
        "full_name": "string",
        "has_actions": true,
        "has_issues": true,
        "has_packages": true,
        "has_projects": true,
        "has_pull_requests": true,
        "has_releases": true,
        "has_wiki": true,
        "html_url": "string",
        "id": 0,
        "ignore_whitespace_conflicts": true,
        "internal": true,
        "internal_tracker": {
            "allow_only_contributors_to_track_time": true,
            "enable_issue_dependencies": true,
            "enable_time_tracker": true
        },
        "language": "string",
        "languages_url": "string",
        "link": "string",
        "mirror": true,
        "mirror_interval": "string",
        "mirror_updated": "2019-08-24T14:15:22Z",
        "name": "string",
        "open_issues_count": 0,
        "open_pr_counter": 0,
        "original_url": "string",
        "owner": {
            "active": true,
            "avatar_url": "string",
            "created": "2019-08-24T14:15:22Z",
            "description": "string",
            "email": "user@example.com",
            "followers_count": 0,
            "following_count": 0,
            "full_name": "string",
            "id": 0,
            "is_admin": true,
            "language": "string",
            "last_login": "2019-08-24T14:15:22Z",
            "location": "string",
            "login": "string",
            "login_name": "empty",
            "prohibit_login": true,
            "restricted": true,
            "starred_repos_count": 0,
            "visibility": "string",
            "website": "string"
        },
        "parent": {},
        "permissions": {
            "admin": true,
            "pull": true,
            "push": true
        },
        "private": true,
        "release_counter": 0,
        "repo_transfer": {
            "doer": {
                "active": true,
                "avatar_url": "string",
                "created": "2019-08-24T14:15:22Z",
                "description": "string",
                "email": "user@example.com",
                "followers_count": 0,
                "following_count": 0,
                "full_name": "string",
                "id": 0,
                "is_admin": true,
                "language": "string",
                "last_login": "2019-08-24T14:15:22Z",
                "location": "string",
                "login": "string",
                "login_name": "empty",
                "prohibit_login": true,
                "restricted": true,
                "starred_repos_count": 0,
                "visibility": "string",
                "website": "string"
            },
            "recipient": {
                "active": true,
                "avatar_url": "string",
                "created": "2019-08-24T14:15:22Z",
                "description": "string",
                "email": "user@example.com",
                "followers_count": 0,
                "following_count": 0,
                "full_name": "string",
                "id": 0,
                "is_admin": true,
                "language": "string",
                "last_login": "2019-08-24T14:15:22Z",
                "location": "string",
                "login": "string",
                "login_name": "empty",
                "prohibit_login": true,
                "restricted": true,
                "starred_repos_count": 0,
                "visibility": "string",
                "website": "string"
            },
            "teams": [
                {
                    "can_create_org_repo": true,
                    "description": "string",
                    "id": 0,
                    "includes_all_repositories": true,
                    "name": "string",
                    "organization": {
                        "avatar_url": "string",
                        "description": "string",
                        "email": "string",
                        "full_name": "string",
                        "id": 0,
                        "location": "string",
                        "name": "string",
                        "repo_admin_change_team_access": true,
                        "username": "string",
                        "visibility": "string",
                        "website": "string"
                    },
                    "permission": "none",
                    "units": [
                        "repo.code",
                        "repo.issues",
                        "repo.ext_issues",
                        "repo.wiki",
                        "repo.pulls",
                        "repo.releases",
                        "repo.projects",
                        "repo.ext_wiki"
                    ],
                    "units_map": {
                        "repo.code": "read",
                        "repo.ext_issues": "none",
                        "repo.ext_wiki": "none",
                        "repo.issues": "write",
                        "repo.projects": "none",
                        "repo.pulls": "owner",
                        "repo.releases": "none",
                        "repo.wiki": "admin"
                    }
                }
            ]
        },
        "size": 0,
        "ssh_url": "string",
        "stars_count": 0,
        "template": true,
        "updated_at": "2019-08-24T14:15:22Z",
        "url": "string",
        "watchers_count": 0,
        "website": "string"
    },
    "subject": {
        "html_url": "string",
        "latest_comment_html_url": "string",
        "latest_comment_url": "string",
        "state": "string",
        "title": "string",
        "type": "string",
        "url": "string"
    },
    "unread": true,
    "updated_at": "2019-08-24T14:15:22Z",
    "url": "string"
}
🟠403403
🟠404404
修改于 2024-03-15 02:18:17
上一页
Check if unread notifications exist
下一页
Mark notification thread as read by ID
Built with