https://github.com/sh20raj/mediagur

mediagur : Upload File and Get URL Free File Hosting with Uploading API. Upload a file to the mediagur platform and get the file URL.
https://github.com/sh20raj/mediagur

image-uploader mediagur uploadthings

Last synced: 11 months ago
JSON representation

mediagur : Upload File and Get URL Free File Hosting with Uploading API. Upload a file to the mediagur platform and get the file URL.

• Host: GitHub
• URL: https://github.com/sh20raj/mediagur
• Owner: SH20RAJ
• Created: 2024-04-12T09:41:10.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-06-29T02:07:42.000Z (almost 2 years ago)
• Last Synced: 2025-03-22T06:32:25.518Z (about 1 year ago)
• Topics: image-uploader, mediagur, uploadthings
• Language: HTML
• Homepage: https://mediagur.vercel.app/
• Size: 373 KB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          

### mediagur : Upload File and Get URL

Free File Hosting with Uploading API. Upload a file to the mediagur platform and get the file URL.

[![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2FSH20RAJ%2Fmediagur&countColor=%23263759&style=flat)](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2FSH20RAJ%2Fmediagur)

[![](https://data.jsdelivr.com/v1/package/gh/mediagur/images/badge)](https://www.jsdelivr.com/package/gh/mediagur/images)







- **URL**: `https://mediagur.vercel.app/upload`

- **Method**: `POST`

- **Request Headers**:

  - `Content-Type: multipart/form-data`

#### Request Body

- **Form Data**:

  - `file`: The file to be uploaded. Supported file types: Any.

#### Response

- **Success Response**:

  - **Code**: `200 OK`

  - **Content**:

    ```json

    {

      "url": "https://mediagur.vercel.app/files/abcdefg/file.jpg",

      "jsdelivr": "https://cdn.jsdelivr.net/gh/mediagur/abcdefg/file.jpg"

    }

    ```

- **Error Responses**:

  - **Code**: `400 Bad Request`

    - **Content**: `{ "error": "No file uploaded" }`

  - **Code**: `500 Internal Server Error`

    - **Content**: `{ "error": "File upload failed" }`

#### Example

- **Request**:

  ```http

  POST https://mediagur.vercel.app/upload

  Content-Type: multipart/form-data

  ----WebKitFormBoundary7MA4YWxkTrZu0gW

  Content-Disposition: form-data; name="file"; filename="example.jpg"

  Content-Type: image/jpeg

  

  ----WebKitFormBoundary7MA4YWxkTrZu0gW--

  ```

- **Response**:

  ```json

  {

    "url": "https://mediagur.vercel.app/files/abcdefg/example.jpg",

    "jsdelivr": "https://cdn.jsdelivr.net/gh/mediagur/abcdefg/example.jpg"

  }

  ```

### Explanation

- This API endpoint allows clients to upload a file to the mediagur platform using a `POST` request with `multipart/form-data` content type.

- The uploaded file is stored on the mediagur platform indefinitely.

- After successful upload, the API responds with a JSON object containing the URL of the uploaded file on the mediagur platform and a jsDelivr CDN URL for easy access to the file.

- If no file is uploaded, the API returns a `400 Bad Request` error with an appropriate error message.

- If there is an internal server error during file upload, the API returns a `500 Internal Server Error` with an error message.

### Additional Notes

- Uploaded files are stored indefinitely.

- The jsDelivr CDN URLs provided can be used to access the uploaded files.

### Contact

For any questions or support, please contact us at [support@mediagur.vercel.app](mailto:support@mediagur.vercel.app).

This simplified documentation focuses on the POST endpoint for uploading files and getting the file URL. You can expand this documentation with more endpoints, parameters, and detailed examples as needed.