2.8 KiB

Raw Blame History

date	title	slug	draft	toc	menu
2021-07-20T00:00:00+00:00	Generic Packages Repository	packages/generic	false	false	[{sidebar [{parent packages} {name Generic} {weight 40} {identifier generic}]}]

Generic Packages Repository

Publish generic files, like release binaries or other output, for your user or organization.

Table of Contents

Authenticate to the package registry

To authenticate to the Package Registry, you need to provide [custom HTTP headers or use HTTP Basic authentication]({{< relref "doc/developers/api-usage.en-us.md#authentication" >}}).

Publish a package

To publish a generic package perform a HTTP PUT operation with the package content in the request body. You cannot publish a package if a package of the same name and version already exists. You must delete the existing package first.

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

Parameter	Description
`owner`	The owner of the package.
`package_name`	The package name. It can contain only lowercase letters (`a-z`), uppercase letter (`A-Z`), numbers (`0-9`), dots (`.`), hyphens (`-`), or underscores (`_`).
`package_version`	The package version as described in the SemVer spec.
`file_name`	The filename. It can contain only lowercase letters (`a-z`), uppercase letter (`A-Z`), numbers (`0-9`), dots (`.`), hyphens (`-`), or underscores (`_`).

Example request using HTTP Basic authentication:

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

The server reponds with the following HTTP Status codes.

HTTP Status Code	Meaning
`201 Created`	The package has been published.
`400 Bad Request`	The package name and/or version are invalid or a package with the same name and version already exist.

Download a package

To download a generic package perform a HTTP GET operation.

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

Parameter	Description
`owner`	The owner of the package.
`package_name`	The package name.
`package_version`	The package version.
`file_name`	The filename.

The file content is served in the response body. The response content type is application/octet-stream.