Publications and Catalogue

What public means

/download is the instance's anonymous publication catalogue. Only usable files with published records are included. Visitors can see filenames, types and sizes and request downloads. Confirm distribution rights and inspect file contents before publishing.

Uploading does not automatically publish a file. Sharing and catalogue publication are separate controls. A catalogue request error does not mean there are no publications.

Publish your own file through the admin page

1. As an administrator, open /admin/publish and select one of your own files with a usable current version. Use load more as needed.
2. Enter the public slug: 1–64 lowercase letters, digits or hyphens, beginning and ending with a letter or digit.
3. Deliberately choose “立即公开” (publish now) or “保存为草稿” (save draft). The page defaults to publish now, so check before submitting.
4. Choose “保存发布状态” (save publication state), then inspect the returned slug and state.
5. For a publication, open /download in a signed-out browser and download to compare contents. A draft should remain absent from the public catalogue.

Although the page is under administration, PUT /api/v1/files/{fileId}/publication enforces file ownership. Being an administrator does not let this endpoint publish another person's file. Regular owners can manage their own publications through the authenticated API, but have no corresponding regular-user page.

API states and conflicts

A request can be {"slug":"release-notes","status":"draft"}. Supported states are draft, published and disabled. The same file endpoint creates or updates its publication; a conflicting slug returns 409. Changing the slug changes the identifier used to request tickets, so check existing distribution arrangements.

The API supports disabling a publication. The current UI selector only offers public and draft, not disabled. No disable button does not mean no API support; neither operation can recall saved copies.

Catalogue and download limits

GET /api/v1/publications defaults to 50 items, permits 100 and returns nextCursor. The current /download page reads only the first page and has no pagination or search/filter controls. A record missing beyond that first page is not necessarily absent from the service.

On a click, POST /api/v1/publications/{slug}/download-ticket issues a ticket for a Storage request. It lasts 60 seconds and can be consumed once. The object address is not a permanent external link. Draft, disabled or unavailable publications return 404 when requesting a ticket.

A publication follows the current file version, while an existing ticket identifies the version selected at issuance. State changes prevent new ineligible tickets but do not promise immediate invalidation of issued short-lived grants. See Files and versions.