AR Hosting API Documentation

API Documentation

This documentation provides a comprehensive guide on how to use the Ashlynn Repository API to upload media files to the platform.

Endpoints

• POST /upload - Direct file upload via form data.
• GET /hosturl?url=[media_url] - Uploads media from a specified URL.

Base URLs

• POST: https://ar-hosting.pages.dev/upload
• GET: https://ar-hosting.pages.dev/hosturl?url=[media_url]

POST Method

Uploads a media file (image, video, or any other type of media) directly using multipart/form-data. This method is ideal for client-side form submissions.

Header: Content-Type: multipart/form-data (Required)

Form Data Parameters

Usage Example (cURL)

curl -X POST https://ar-hosting.pages.dev/upload   -H "Content-Type: multipart/form-data"   -F "file=@path/to/your/file.jpg"

Usage Example (JavaScript - Fetch API)

const fileInput = document.querySelector('input[type="file"]');
  const formData = new FormData();
  formData.append('file', fileInput.files[0]);
  
  fetch('https://ar-hosting.pages.dev/upload', {
    method: 'POST',
    body: formData
  })
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

GET Method

Fetches and uploads media from a provided URL. This method is suitable for uploading media files already hosted online.

Usage: GET /hosturl?url=[media_url]

Parameters

Usage Example

https://ar-hosting.pages.dev/hosturl?url=https://example.com/path/to/media.jpg

Response Format (Success)

A successful upload will return a JSON object with the following details:

{
    "data": "https://ar-hosting.pages.dev/1753020712833.png",
    "url": "https://ar-hosting.pages.dev/1753020712833.png",
    "filename": "2nNV2I4.png",
    "size": 83638,
    "uploaded_on": "2025-07-20T14:11:52.833Z",
    "media_type": "image/png",
    "creator": "https://t.me/Ashlynn_Repository"
  }

• data: The direct URL of the uploaded media file.
• url: (Alias for data) The direct URL of the uploaded media file.
• filename: The original filename of the uploaded media.
• size: The size of the uploaded file in bytes.
• uploaded_on: The timestamp when the file was uploaded (ISO 8601 format).
• media_type: The MIME type of the uploaded media (e.g., 'image/png', 'video/mp4').
• creator: A link to the creator's Telegram channel.

Response Format (Error)

In case of an error, especially with the url parameter for the GET method, an error JSON object will be returned:

{
    "error": "Failed to download file from URL"
  }

Notes

• POST Method: Best for uploading files directly from user input (e.g., via an HTML form).
• GET Method: Ideal for programmatically uploading files that are already accessible via a public URL.
• All uploaded media is subject to a 20MB file size limit.