通用包注册表

发布通用文件，例如发布二进制文件或其他输出，供您的用户或组织使用。

对包注册表进行身份验证

要对包注册表进行身份验证，您需要提供自定义 HTTP 标头或使用 HTTP 基本身份验证。

发布包

要发布通用包，请执行带有请求正文中包内容的 HTTP PUT 操作。您不能将同名文件两次发布到同一个包中。您必须先删除现有的包版本。

PUT https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}

参数	描述
owner	包的所有者。
package_name	包名称。它只能包含小写字母 (a-z)、大写字母 (A-Z)、数字 (0-9)、点 (.)、连字符 (-)、加号 (+) 或下划线 (_)。
package_version	包版本，一个非空字符串，不包含前导或尾随空格。
file_name	文件名。它只能包含小写字母 (a-z)、大写字母 (A-Z)、数字 (0-9)、点 (.)、连字符 (-)、加号 (+) 或下划线 (_)。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_password_or_token \
     --upload-file path/to/file.bin \
     https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin

如果您正在使用 2FA 或 OAuth，请使用个人访问令牌代替密码。

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
201 已创建	包已发布。
400 错误请求	包名称和/或版本和/或文件名无效。
409 冲突	包中已存在同名文件。

下载包

要下载通用包，请执行 HTTP GET 操作。

GET https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{file_name}

参数	描述
owner	包的所有者。
package_name	包名称。
package_version	包版本。
file_name	文件名。

文件内容将在响应正文中提供。响应内容类型为 application/octet-stream。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_token_or_password \
     https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
200 OK	成功
404 未找到	未找到包或文件。

删除包

要删除通用包，请执行 HTTP DELETE 操作。这将删除此版本的所有文件。

DELETE https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}

参数	描述
owner	包的所有者。
package_name	包名称。
package_version	包版本。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_token_or_password -X DELETE \
     https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
204 无内容	成功
404 未找到	未找到包。

删除包文件

要删除通用包的文件，请执行 HTTP DELETE 操作。如果不再有文件，这也会删除包版本。

DELETE https://gitea.example.com/api/packages/{owner}/generic/{package_name}/{package_version}/{filename}

参数	描述
owner	包的所有者。
package_name	包名称。
package_version	包版本。
filename	文件名。

使用 HTTP 基本身份验证的示例请求

curl --user your_username:your_token_or_password -X DELETE \
     https://gitea.example.com/api/packages/testuser/generic/test_package/1.0.0/file.bin

服务器将返回以下 HTTP 状态代码。

HTTP 状态代码	含义
204 无内容	成功
404 未找到	未找到包或文件。