mirror of
https://github.com/hzrd149/blossom.git
synced 2025-12-08 22:58:51 +00:00
add HEAD /sha256 endpoint for checking blobs
This commit is contained in:
2
Nostr.md
2
Nostr.md
@@ -6,7 +6,7 @@ See [Authorization events](./Server.md#authorization-events)
|
||||
|
||||
## User Server Discovery
|
||||
|
||||
Users should publish a kind `10063` event with a list of `r` tags indicating servers that others users should use when getting their blobs
|
||||
Users should publish a kind `10063` event with a list of ordered `r` tags indicating servers that others users should use when getting their blobs
|
||||
|
||||
### Example
|
||||
|
||||
|
||||
@@ -15,6 +15,7 @@ Blobs are packs of binary data addressed by their sha256 hash
|
||||
Blossom Servers expose four endpoints for managing blobs
|
||||
|
||||
- `GET /<sha256>` (optional file `.ext`)
|
||||
- `HEAD /<sha256>` (optional file `.ext`)
|
||||
- `PUT /upload`
|
||||
- `Authentication`: Signed [nostr event](./Server.md#upload-authorization-required)
|
||||
- Return a blob descriptor
|
||||
|
||||
@@ -105,6 +105,12 @@ Example Authorization event:
|
||||
}
|
||||
```
|
||||
|
||||
### HEAD /sha256 - Has Blob
|
||||
|
||||
The `HEAD /<sha256>` endpoint MUST respond with either a `200` or `404` status code
|
||||
|
||||
The endpoint MUST accept an optional file extension in the URL similar to the `GET /<sha256>` endpoint. ie. `.pdf`, `.png`, etc
|
||||
|
||||
### PUT /upload - Upload Blob
|
||||
|
||||
The `PUT /upload` endpoint should expect the `Content-Type` header of the request to be set to the MIME type of the blob and the body of the request to the raw data of the blob.
|
||||
|
||||
Reference in New Issue
Block a user