Skip to content

Latest commit

 

History

History
271 lines (196 loc) · 8.02 KB

README.md

File metadata and controls

271 lines (196 loc) · 8.02 KB
Raw

⚡️ CLOUD STORAGE API ⚡️

Our Cloud Storage API provides a seamless and free solution for users to upload and retrieve files such as photos and videos. The API is integrated with Telegram, allowing users to securely store their files on Telegram servers and access them using unique access keys.

Features:

  • Upload and Retrieve Files: Users can easily upload their photos and videos to the Cloud Storage API. They can also retrieve their files whenever needed, ensuring easy access to their media content.

  • Telegram Integration: The API leverages Telegram's robust infrastructure to store and manage user files, ensuring a secure and reliable storage solution.

  • Unique Access Keys: Each user is provided with a unique access key token that combines their Telegram account ID and a random number. This access key ensures secure and private access to their stored files.

Supported File Types:

Currently, the API supports the following file types:

  • Photos (image files)
  • Videos

Future Enhancements:

We have plans to expand the API's capabilities in the future to include additional file types, such as audio and documents, based on user feedback and needs.

Limitation:

For optimal performance and fair resource allocation, the API enforces a limitation on file uploads. Users can upload a maximum of 5 photos at once. This limitation ensures smooth handling of file uploads and enhances overall user experience.

Terms and Conditions:

  • Data Retention: We do not delete your files from the Telegram servers, but please note that the API relies on Telegram's infrastructure, and we cannot guarantee the duration for which your files will be stored on their servers.

  • Recommended Usage: Our Cloud Storage API is ideal for non-confidential projects where users seek a convenient and free file storage solution. For sensitive or confidential data, we recommend using specialized storage services with dedicated security measures.

Note:

As we continue to improve our API, we value user feedback and will consider adding new features and functionalities to meet the evolving needs of our users. We aim to provide a user-friendly and reliable cloud storage solution integrated with Telegram, offering a seamless experience for file management and access.


Get Access

🌟 First, you need to register and get access_key token.

To Register:


Base Url : https://unlimited-cloud-storage-api.vercel.app/api


End-Points:

  • ⚡️upload/
  • ⚡️getfile/{file_name}
  • ⚡️getposts/
  • ⚡️uploadfileurl/

upload:

Example:

const axios = require("axios");
const FormData = require("form-data");
const fs = require("fs");

const uploadFile = async () => {
  try {
    const formData = new FormData();

    //add file loaction in array
    const files = ["friend.jpg", "new.jpg"];

    files.forEach((filePath) => {
      const fileStream = fs.createReadStream(filePath);

      //the field name to include the file must be "file"
      formData.append("file", fileStream);
    });

    await axios
      .post(
        "https://unlimited-cloud-storage-api.vercel.app/api/upload",
        formData,
        {
          headers: {
            access_key: "Your access key",
            "Content-Type": "multipart/form-data",
          },
        }
      )
      .then(function (response) {
        console.log(response.data.message);
      })
      .catch((err) => {
        console.log(err.response.data);
      });
  } catch (error) {
    console.error(error);
  }
};

uploadFile();

Response Body:

{
    "message": "Files uploaded successfully",
    "uploadedUrls": [
        "https://cdn4.telegram-cdn.org/file/FELzjyD91K_jwmnpzTJK_HIiHN5B_0U_fukX_sJRm-rhtZkdlrwUSnBD0gwFhfNHgYPl6FquM4ZZEUHvMzrzFmRxY5Ql1TEs2CM1pBGKsVJtTuNOYrwciXKM7CgkFOSDDeLYVi-02D5mvcAyw4n1AElXbISUPrl3f7AVMwYkxPZUtzYWlnWuLNMVg0dILY4e2mO-YDiOrYTYthQjVAXMn5wlKVC-hYuk4lqWPUSiUgJugNoR3RhIxsY-w90zA-Ti9x0V_n4sDpyxhqC47XTm7E62SQtyYDEg42fng-iRIuQMU3sv2rX63P4fr1Mwri-yrT0qBopdEI4vb8sbDt5txw.jpg",
        "https://cdn4.telegram-cdn.org/file/GCWBiIar7WuKSrVn0TBlUq_9HfBF2gjhymdi9dFgODAryCRTpYxML4-Ei06INhIHXVCQLEc8cDfpfKEXT9ysFcuTGEVuQ15wlWWCIBhKI_TTVuJCNLfAmKoCDJ6XHTDXpFEFkH8JLsVcTFHEG2R2ufkyNaqFoHaktS63jNofK1CoHchZv-lR_YKLR1oOm-rlCr6I5goBBxexPa6Mfvf1HgeFIN3jd3Qum_LI7w2W4sM0LHcTlhE1kE5mYnZnzDsyO9kjMoBmYRAauiTw-GfCT1NgTJ2eusKJrwiONMveMPOnAD7SsyDjPE_erusys4Vk5AoHzLGPIWOzWJo6e1E8XA.jpg"
    ]
}

getfile/{name}

Example:

[Get] ⚡️ https://unlimited-cloud-storage-api.vercel.app/api/getfile/myfile


const axios = require("axios");

const getFile = async () => {
  await axios
    .get("https://unlimited-cloud-storage-api.vercel.app/api/getfile/myfile", {
      headers: {
        access_key: "Your access key",
      },
    })
    .then(function (response) {
      console.log(response.data.message);
    })
    .catch((err) => {
      console.log(err.response.data);
    });
};

getFile();

Response Body:

[
  {
    id: 72,
    title: "myfile_a.jpg",
    photo:
      "https://cdn4.telegram-cdn.org/file/CsXCohVeqFeBVQaV2SMdCVbZhZeoa3qVH0wFYUOWsnM17F80y_1NfnZCt2YFwjiGpVPlwstxp1fx4OUg_PnxFL0GykOf1vXY_yfhrBKydTrs2pZeqZwQ8fFGHz-cfiynyY_hfvbW5k0aqSX5ZKb5sfBKbI7Gj7kSYFTSjWw2xah4T4_xkFw3sf50P56XPK-9CGsAJf28BdVgWTp7uSSQcMCJPtsZ9aRPUyOGzcnV7Fo8_rPszry1sSG0VD5I904DzCmKGc4wDjXOa9OtAcgwFgepaAcEfURtQHVHPII89H8t_n7ggkNXc8NKNF3lbM9jloLyO7h4LyOU_Sj-uvHRhg.jpg",
  },
];

getposts

Example:

[Get] ⚡️ https://unlimited-cloud-storage-api.vercel.app/api/getposts


const axios = require("axios");

const getPosts = async () => {
  await axios
    .get("https://unlimited-cloud-storage-api.vercel.app/api/getposts", {
      headers: {
        access_key: "Your access key",
      },
    })
    .then(function (response) {
      console.log(response.data.message);
    })
    .catch((err) => {
      console.log(err.response.data);
    });
};

getPosts();

Response Body:


[
  {
    id: 72,
    title: "love.jpg",
    photo:
      "https://cdn4.telegram-cdn.org/file/CsXCohVeqFeBVQaV2SMdCVbZhZeoa3qVH0wFYUOWsnM17F80y_1NfnZCt2YFwjiGpVPlwstxp1fx4OUg_PnxFL0GykOf1vXY_yfhrBKydTrs2pZeqZwQ8fFGHz-cfiynyY_hfvbW5k0aqSX5ZKb5sfBKbI7Gj7kSYFTSjWw2xah4T4_xkFw3sf50P56XPK-9CGsAJf28BdVgWTp7uSSQcMCJPtsZ9aRPUyOGzcnV7Fo8_rPszry1sSG0VD5I904DzCmKGc4wDjXOa9OtAcgwFgepaAcEfURtQHVHPII89H8t_n7ggkNXc8NKNF3lbM9jloLyO7h4LyOU_Sj-uvHRhg.jpg",
  },
  {
    id: 73,
    title: "vid.mp4",
    video:
      "https://cdn4.telegram-cdn.org/file/CsXCohVeqFeBVQaV2SMdCVbZhZeoa3qVH0wFYUOWsnM17F80y_1NfnZCt2YFwjiGpVPlwstxp1fx4OUg_PnxFrBKydTrs2pZeqZwQ8fFGHz-cfiynyY_hfvbW5k0aqSX5ZKb5sfBKbI7Gj7kSYFTSjWw2xah4T4_xkFw3sf50P56XPK-9CGsAJf28BdVgWTp7uSSQcMCJPtsZ9aRPUyOGzcnV7Fo8_rPszry1sSG0VD5I904DzCmKGc4wDjXOa9OtAcgwFgepaAcEfURtQHVHPII89H8t_n7ggkNXc8NKNF3lbM9jloLyO7h4LyOU_Sj-uvHRhg.mp4",
  },
];

uploadfileurl

Example:

[POST] ⚡️ https://unlimited-cloud-storage-api.vercel.app/api/uploadfileurl


// Import axios library
const axios = require("axios");

// Define the body, header and endpoint
const body = {
  fileUrls: [
    "https://th.bing.com/th/id/OIP.HxV79tFMPfBAIo0BBF-sOgHaEy?rs=1&pid=ImgDetMain",
    "https://th.bing.com/th/id/R.9f214b0588c3db4ec93470b884140103?rik=XSDEeGIWON%2f9vg&pid=ImgRaw&r=0",
  ],
};

const header = {
  access_key: "12636692...", //get from cloud autorize bot
};

const endPoint =
  "https://unlimited-cloud-storage-api.vercel.app/api/uploadfileurl";

// Make the api request using axios
axios
  .post(endPoint, body, { headers: header })
  .then((response) => {
    // Handle the response
    console.log(response.data);
  })
  .catch((error) => {
    // Handle the error
    console.error(error);
  });