Documentação da API

Bem-vindo à API do CloudPri. Através desta interface, você pode listar, gerenciar e exibir conteúdos de vídeo, áudio e links de forma programática em seus próprios projetos.

Nota de Segurança: Esta API foi projetada para ser robusta e segura. Utilize sempre boas práticas ao integrar em seus sistemas.

Bem-vindo à referência da API CloudPri. Nossa API segue os princípios REST e utiliza JSON para comunicação.

Pronto para integrar?

Obtenha sua chave de acesso em segundos e comece a construir.

Obter API Key

Autenticação

Autenticação

Todas as requisições devem incluir sua API Key. Você pode enviá-la de duas formas:

  1. Header HTTP: Recomendado para requisições seguras entre servidores.
  2. Query Parameter: Útil para links diretos ou uso rápido no navegador.
# Via Header (Recomendado)
X-API-KEY: sua_chave_aqui

# Via URL
GET https://seusite.com/api.php?key=sua_chave_aqui&action=status
Cuidado: Nunca exponha sua API Key em código client-side (como HTML ou JS público) se quiser evitar acessos não autorizados.

Parâmetros Comuns

Abaixo estão os parâmetros principais aceitos pela API em quase todos os endpoints:

Parâmetro Tipo Obrigatório Descrição
key string Sim Sua chave de acesso à API.
action string Não A ação a ser executada (Default: download).
file int Depende ID numérico do arquivo no sistema.
json int Não Se 1, força o retorno sempre em formato JSON.

Status do Sistema

Retorna informações básicas de saúde da API e estatísticas de uso da sua chave.

GET /api.php?action=status
RESPOSTA DE EXEMPLO
{
  "status": "success",
  "metadata": {
    "api_version": "2.0",
    "system": "Sistema Exemplo",
    "stats": {
      "total_files": 12,
      "storage_usedFormatted": "145.2 MB"
    },
    "server_time": "2024-03-15 14:30:00"
  }
}

Listar Arquivos

Retorna a lista completa de arquivos associados à sua conta, ordenados pelos mais recentes.

GET /api.php?action=list
DADOS RETORNADOS

Inclui ID, nome original, tamanho, tipo de arquivo e links diretos para download/informações.

Player & Playlist

Ação ideal para exibir vídeos ou áudios diretamente em iframes no seu site.

GET /api.php?action=player&file={id}
GET /api.php?action=player&playlist={id}
FUNCIONALIDADES
  • Suporte a Google Drive (Preview/Streaming)
  • Streaming nativo para arquivos MP4/MP3
  • Interface Premium com modo escuro automático
  • Barra lateral de playlist (se houver mais de um arquivo)

Feedback de Vídeo

Permite registrar interações do usuário com o conteúdo.

POST /api.php?action=video_feedback
Post Body Valores
file_id ID do arquivo
tipo like, dislike, report

Respostas e Erros

A API utiliza códigos de status HTTP padrão e um corpo de resposta JSON para indicar o sucesso ou falha de uma requisição.

Código Status Descrição / Solução
MISSING_KEY 401 A chave de API não foi enviada. Verifique o parâmetro key ou o header X-API-KEY.
INVALID_KEY 401 A chave fornecida é inválida ou foi desativada pelo administrador.
RATE_LIMIT_EXCEEDED 429 Muitas requisições em um curto período. Aguarde alguns minutos antes de tentar novamente.
NOT_FOUND 404 O arquivo solicitado não existe ou você não tem permissão para acessá-lo.
ESTRUTURA DE ERRO JSON
{
  "status": "error",
  "message": "Mensagem descritiva do erro",
  "code": "CÓDIGO_DO_ERRO"
}

Exemplo em JavaScript

async function fetchFiles() {
    const API_KEY = 'SUA_CHAVE';
    const response = await fetch(`api.php?key=${API_KEY}&action=list`);
    const data = await response.json();
    
    if (data.status === 'success') {
        data.data.files.forEach(file => {
            console.log(`Arquivo: ${file.nome_original}`);
        });
    }
}

Exemplo em PHP

CloudPri API v2.0 • © 2026 • Desenvolvedores