Files
blossom/buds/bud-02.md
2024-04-29 20:01:23 -05:00

1.0 KiB

BUD-02

Media processing endpoint

draft optional

PUT /process

A server MAY expose a /process endpoint for the purpose of processing and/or optimizing any blob the user uploads

Just like the /upload endpoint the /process endpoint MUST accept binary data in the body of the request and MAY use the Content-Type header to get the MIME type of the data

The endpoint MUST also accept the Content-Type of multipart/form-data with the field blob containing the raw binary of the blob being upload

Similar to the /upload endpoint the server MUST respond with a Blob Descriptor

The server MUST also require authentication for the endpoint. in which case it MUST accept the same upload authorization event as the /upload endpoint

HEAD /process

If a server is exposing a PUT /process endpoint is MUST also expose a HEAD /process endpoint to allow clients to check if the PUT /process endpoint is available

The endpoint MUST respond with the 200 status code