laantungir/blossom
1
0
Fork 0
mirror of https://github.com/hzrd149/blossom.git synced 2025-12-08 22:58:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #42 from hzrd149/media-head

Browse Source 
Update BUD-05: Add HEAD /media endpoint
This commit is contained in:
hzrd149
2024-11-30 18:49:02 -06:00
committed by GitHub
parent 854218f573 c5d90aa74d
commit 13fa0f485d
2 changed files with 7 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
README.md
View File

@@ -12,7 +12,7 @@ Blobs are packs of binary data addressed by their sha256 hash
## How does it work? ## How does it work?
Blossom Servers expose four endpoints for managing blobs Blossom Servers expose a few endpoints for managing blobs
- `GET /<sha256>` (optional file `.ext`) [BUD-01](./buds/01.md#get-sha256---get-blob) - `GET /<sha256>` (optional file `.ext`) [BUD-01](./buds/01.md#get-sha256---get-blob)
- `HEAD /<sha256>` (optional file `.ext`) [BUD-01](./buds/01.md#head-sha256---has-blob) - `HEAD /<sha256>` (optional file `.ext`) [BUD-01](./buds/01.md#head-sha256---has-blob)
@@ -27,7 +27,8 @@ Blossom Servers expose four endpoints for managing blobs
- `Authentication`: Signed [nostr event](./buds/02.md#delete-authorization-required) - `Authentication`: Signed [nostr event](./buds/02.md#delete-authorization-required)
- `PUT /mirror` [BUD-04](./buds/04.md#put-mirror---mirror-blob) - `PUT /mirror` [BUD-04](./buds/04.md#put-mirror---mirror-blob)
- `Authentication`: Signed [nostr event](./buds/02.md#upload-authorization-required) - `Authentication`: Signed [nostr event](./buds/02.md#upload-authorization-required)
- `PUT /media` [BUD-05](./buds/05.md) - `HEAD /media` [BUD-05](./buds/05.md#head-media)
- `PUT /media` [BUD-05](./buds/05.md#put-media)
- `Authentication`: Signed [nostr event](./buds/05.md#upload-authorization) - `Authentication`: Signed [nostr event](./buds/05.md#upload-authorization)
## Protocol specification (BUDs) ## Protocol specification (BUDs)

4
buds/05.md
View File

@@ -22,6 +22,10 @@ Servers MAY require an `upload` [authorization event](./02.md#upload-authorizati
If a server requires an `upload` authorization event it MUST preform all the checks outlined in the [`/upload`](./02.md#upload-authorization-required) endpoint If a server requires an `upload` authorization event it MUST preform all the checks outlined in the [`/upload`](./02.md#upload-authorization-required) endpoint
## HEAD /media
Servers MUST respond to `HEAD` requests on the `/media` endpoint in a similar way to the `HEAD /upload` endpoint defined in [BUD-06](./06.md)
## Limitations ## Limitations
This endpoint is intentionally limited to optimizing a single blob with the goal of making it easier to distribute This endpoint is intentionally limited to optimizing a single blob with the goal of making it easier to distribute