Image Self-Hosting Service

\n \n \n \n

This service will store your image in our blob storage and provide a permanent URL.

Supported formats: JPEG, PNG, GIF, WebP, SVG, BMP

\n \n

\n API Documentation\n

\n \n \n\n`;\n}\n\n// HTML for the success page\nfunction getSuccessHtml(originalSource: string, hostedUrl: string): string {\n const fullHostedUrl = new URL(hostedUrl, new URL(import.meta.url).origin).href;\n const isUploadedFile = originalSource === \"Uploaded file\";\n \n return `\n\n\n \n \n Image Successfully Hosted\n \n \n\n\n

Image Successfully Hosted!

\n \n

\n ${!isUploadedFile ? `\n

Original Image

\n ${originalSource}\n

\n ` : ''}\n \n

Self-Hosted Image URL

\n ${fullHostedUrl}\n

\n \n

Preview

\n $\"Hosted$ \n

\n \n

API Access

\n GET /api/info?key=${hostedUrl.split('=')[1]}\n

\n View API Documentation\n

\n \n \n Host Another Image\n \n

\n \n \n \n \n\n`;\n}\n\n// HTML for the API documentation page\nfunction getApiDocsHtml(): string {\n const baseUrl = new URL(import.meta.url).origin;\n \n return `\n\n\n \n \n Image Hosting API Documentation\n \n \n\n\n

Image Hosting API Documentation

A simple API for hosting images in Val Town's blob storage

\n \n

API Endpoints

\n \n

\n POST\n

/api/upload

\n \n

Upload an image from a URL and store it in blob storage.

\n \n

Request Body (JSON):

{\n  \"url\": \"https://example.com/image.jpg\"\n}

\n \n

Response (Success):

{\n  \"success\": true,\n  \"key\": \"img_1234567890_abc123.jpg\",\n  \"url\": \"${baseUrl}/view?key=img_1234567890_abc123.jpg\",\n  \"contentType\": \"image/jpeg\"\n}

\n \n

Response (Error):

{\n  \"success\": false,\n  \"error\": \"Error message\"\n}

\n \n

Example (cURL):

curl -X POST ${baseUrl}/api/upload \\\\\n  -H \"Content-Type: application/json\" \\\\\n  -d '{\"url\": \"https://example.com/image.jpg\"}'

\n \n

\n GET\n

/api/info

\n \n

Get information about a hosted image.

\n \n

Query Parameters:

key - The unique key of the image

\n \n

Response (Success):

{\n  \"success\": true,\n  \"key\": \"img_1234567890_abc123.jpg\",\n  \"contentType\": \"image/jpeg\",\n  \"size\": 12345,\n  \"url\": \"${baseUrl}/view?key=img_1234567890_abc123.jpg\"\n}

\n \n

Response (Error):

{\n  \"success\": false,\n  \"error\": \"Error message\"\n}

\n \n

Example (cURL):

curl \"${baseUrl}/api/info?key=img_1234567890_abc123.jpg\"

\n \n

\n GET\n

/view

\n \n

Retrieve and display a hosted image.

\n \n

Query Parameters:

key - The unique key of the image

\n \n

Response:

Returns the image with the appropriate content type.

\n \n

Example (HTML):

<img src=\"${baseUrl}/view?key=img_1234567890_abc123.jpg\" alt=\"Hosted image\">

\n \n

Error Codes

\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n

Status Code	Description
200	Success
400	Bad request (invalid parameters)
404	Resource not found
500	Server error

\n \n

\n \n Back to Image Hosting\n \n

\n \n \n\n`;\n}","deleted","label",[98],"permalink","https://www.val.town/x/dcm31/Imagetourl/code/image-host.ts","extension","actionData","errors"]

Image Self-Hosting Service

Option 1: Upload from URL

Option 2: Upload from Device

Image Successfully Hosted!

Original Image

Self-Hosted Image URL

Preview

API Access

Image Hosting API Documentation

API Endpoints

/api/upload

Request Body (JSON):

Response (Success):

Response (Error):

Example (cURL):

/api/info

Query Parameters:

Response (Success):

Response (Error):

Example (cURL):

/view

Query Parameters:

Response:

Example (HTML):

Error Codes