diff --git a/buds/02.md b/buds/02.md index 3461f45..3b9b7f0 100644 --- a/buds/02.md +++ b/buds/02.md @@ -12,13 +12,25 @@ Defines the `/upload`, `/list` and `DELETE /` endpoints A blob descriptor is a JSON object containing `url`, `sha256`, `size`, `type`, and `uploaded` fields -- `url` A public facing url this blob can retrieved from +- `url` A publicly accessible URL to the [BUD-01](./01.md#get-sha256---get-blob) `GET /` endpoint (optionally with a file extension) - `sha256` The sha256 hash of the blob - `size` The size of the blob in bytes - `type` (optional) The MIME type of the blob - `uploaded` The unix timestamp of when the blob was uploaded to the server -Servers may include additional fields in the descriptor like `magnet`, `infohash`, or `ipfs` depending on other protocols they support +Servers MAY include additional fields in the descriptor like `magnet`, `infohash`, or `ipfs` depending on other protocols they support + +Example: + +```json +{ + "url": "https://cdn.example.com/b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553.pdf", + "sha256": "b1674191a88ec5cdd733e4240a81803105dc412d6c6708d53ab94fc248f4f553", + "size": 184292, + "type": "application/pdf", + "uploaded": 1725105921 +} +``` ## PUT /upload - Upload Blob