StorageCloud API

O que é o StorageCloud?

O StorageCloud é uma plataforma gratuita e colaborativa para envio, armazenamento e download de arquivos. O sistema possui controle inteligente de créditos, gerenciado diretamente pela marca StorageCloud, sem dependência de terceiros.

Visualização de Créditos em Tempo Real

Abaixo você pode consultar em tempo real a quantidade atual de créditos disponíveis para um determinado id. Os dados são atualizados automaticamente a cada 30 segundos, através da integração com o endpoint credits.php.

Como Funciona?

• API sem autenticação, sem chave e sem cadastro.
• Envie arquivos via requisição POST.
• Baixe arquivos diretamente via requisição HTTP GET.
• Cada ação consome 1 crédito global vinculado ao id.
• Os créditos são controlados de forma centralizada pela StorageCloud.

Parâmetros Obrigatórios

1. file (Arquivo)

• Tipo: Arquivo (multipart/form-data)
• Obrigatório: Sim, para upload

2. punch (Caminho/Destino)

• Tipo: String
• Obrigatório: Sim, para upload
• Exemplo: sistemas/cliente1/logo.png
• Define o caminho lógico onde o arquivo será armazenado no FTP remoto.

3. id (Identificador)

• Tipo: String
• Obrigatório: Sim, em todas as requisições (GET e POST)
• Usado para verificar créditos e descontá-los automaticamente pela plataforma StorageCloud.

Como Realizar Upload

Faça uma requisição POST enviando o arquivo e os parâmetros:

curl -X POST https://api-storagecloud.onrender.com/ -F "file=@seuarquivo.png" -F "punch=sistemas/cliente1/logo.png" -F "id=Free"

Exemplos em várias linguagens

Python (requests)

import requests
url = 'https://api-storagecloud.onrender.com/'
files = {'file': open('seuarquivo.png', 'rb')}
data = {'punch': 'sistemas/cliente1/logo.png', 'id': 'Free'}
response = requests.post(url, files=files, data=data)
print(response.text)

PHP (cURL)

<?php
$url = 'https://api-storagecloud.onrender.com/';
$filePath = 'seuarquivo.png';
$postFields = [
  'file' => new CURLFile($filePath),
  'punch' => 'sistemas/cliente1/logo.png',
  'id' => 'Free'
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

JavaScript (fetch API)

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('punch', 'sistemas/cliente1/logo.png');
formData.append('id', 'Free');
fetch('https://api-storagecloud.onrender.com/', {
  method: 'POST',
  body: formData
}).then(res => res.text())
  .then(console.log)
  .catch(console.error);

Como Realizar Download

Basta acessar a URL do arquivo com o parâmetro id:

https://api-storagecloud.onrender.com/sistemas/cliente1/logo.png?id=Free

Exemplos para download

Python

import requests
url = 'https://api-storagecloud.onrender.com/sistemas/cliente1/logo.png?id=Free'
response = requests.get(url)
if response.status_code == 200:
    with open('logo.png', 'wb') as f:
        f.write(response.content)

PHP

<?php
$url = 'https://api-storagecloud.onrender.com/sistemas/cliente1/logo.png?id=Free';
$content = file_get_contents($url);
file_put_contents('logo.png', $content);
?>

JavaScript (fetch)

fetch('https://api-storagecloud.onrender.com/sistemas/cliente1/logo.png?id=Free')
  .then(res => res.blob())
  .then(blob => {
    const url = window.URL.createObjectURL(blob);
    const a = document.createElement('a');
    a.href = url;
    a.download = 'logo.png';
    document.body.appendChild(a);
    a.click();
    a.remove();
    window.URL.revokeObjectURL(url);
  });

Endpoints Importantes

1. Upload de Arquivos

Método: POST

2. Download de Arquivos

3. URL de Anúncio (Geração de Créditos)

4. Verificação de Créditos

Utilize esta URL para consultar a quantidade atual de créditos vinculados ao id informado.

Como Ajudar?

• Utilize a URL de anúncio em sites ou aplicativos para gerar créditos automaticamente.
• Compartilhe a plataforma para ampliar a comunidade e aumentar os créditos disponíveis.

Componentes e Funcionamento Completo da StorageCloud API

Entenda abaixo cada componente principal da StorageCloud, sua função, como funciona e exemplos práticos.