Documentación de la API

Integra JSphere Drive en tus aplicaciones con nuestra API RESTful. Ejemplos en múltiples lenguajes de programación.

Límites del Plan

Tu acceso a la API está limitado según tu plan actual de JSphere. Las peticiones excesivas pueden resultar en bloqueos temporales.

Autenticación

Todos los endpoints requieren autenticación mediante tokens válidos.

Importante

Los tokens son sensibles y nunca deben mostrarse en código del lado del cliente. Si tu token cambia, el anterior se vuelve inservible inmediatamente.

POST/GET token=[TOKEN]

curl -X POST "https://drive.jsphere.net/api/verify" \
  -d "token=TU_TOKEN_AQUI"

<?php
// Nunca muestres tokens en código del lado del cliente
$token = 'TU_TOKEN_AQUI';
$url = 'https://drive.jsphere.net/api/verify';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, "token=" . $token);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

# Nunca muestres tokens en código del lado del cliente
url = 'https://drive.jsphere.net/api/verify'
data = {'token': 'TU_TOKEN_AQUI'}

response = requests.post(url, data=data)
print(response.json())

Subir Archivos

Endpoint para subir archivos al sistema de almacenamiento.

Límites de Subida

El tamaño máximo de archivo y el número de subidas permitidas dependen de tu plan actual de JSphere.

POST https://drive.jsphere.net/api/upload

curl -X POST "https://drive.jsphere.net/api/upload" \
  -F "token=TU_TOKEN_AQUI" \
  -F "file=@/ruta/al/archivo.jpg"

<?php
// Nunca muestres tokens en código del lado del cliente
$url = 'https://drive.jsphere.net/api/upload';
$token = 'TU_TOKEN_AQUI';
$file_path = '/ruta/al/archivo.jpg';

$post_data = [
    'token' => $token,
    'file' => new CURLFile($file_path)
];

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => 1,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_RETURNTRANSFER => true
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

# Nunca muestres tokens en código del lado del cliente
url = 'https://drive.jsphere.net/api/upload'
token = 'TU_TOKEN_AQUI'
file_path = '/ruta/al/archivo.jpg'

files = {
    'file': ('archivo.jpg', open(file_path, 'rb'))
}
data = {
    'token': token
}

response = requests.post(url, files=files, data=data)
print(response.json())

Descargar Archivos

Endpoint para descargar o visualizar archivos multimedia.

POST https://drive.jsphere.net/api/download

curl -X POST "https://drive.jsphere.net/api/download" \
  -d "token=TU_TOKEN_AQUI" \
  -d "filename=documento.pdf" \
  --output documento.pdf

import requests

# Nunca muestres tokens en código del lado del cliente
url = 'https://drive.jsphere.net/api/download'
data = {
    'token': 'TU_TOKEN_AQUI',
    'filename': 'documento.pdf'
}

response = requests.post(url, data=data, stream=True)
with open('documento.pdf', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

<?php
// Nunca muestres tokens en código del lado del cliente
$url = 'https://drive.jsphere.net/api/download';
$token = 'TU_TOKEN_AQUI';
$filename = 'documento.pdf';

$post_data = [
    'token' => $token,
    'filename' => $filename
];

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => 1,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FILE => fopen($filename, 'w')
]);

curl_exec($ch);
curl_close($ch);

Actualizar Archivos

Endpoint para actualizar información de archivos existentes.

Importante

Puedes actualizar archivos por File ID (específico) o por nombre (todos los que coincidan). Al menos un campo nuevo debe ser proporcionado.

POST https://drive.jsphere.net/api/update

curl -X POST "https://drive.jsphere.net/api/update" \
  -d "token=TU_TOKEN_AQUI" \
  -d "file_id=12345" \
  -d "new_filename=nuevo_nombre.pdf" \
  -d "new_expiration=2024-12-31T23:59"

<?php
// Nunca muestres tokens en código del lado del cliente
$url = 'https://drive.jsphere.net/api/update';
$token = 'TU_TOKEN_AQUI';

$post_data = [
    'token' => $token,
    'file_id' => '12345', // O usar 'filename' => 'archivo.pdf'
    'new_filename' => 'nuevo_nombre.pdf',
    'new_expiration' => '2024-12-31T23:59'
];

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => $url,
    CURLOPT_POST => 1,
    CURLOPT_POSTFIELDS => $post_data,
    CURLOPT_RETURNTRANSFER => true
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

import requests

# Nunca muestres tokens en código del lado del cliente
url = 'https://drive.jsphere.net/api/update'
token = 'TU_TOKEN_AQUI'

data = {
    'token': token,
    'file_id': '12345',  # O usar 'filename': 'archivo.pdf'
    'new_filename': 'nuevo_nombre.pdf',
    'new_expiration': '2024-12-31T23:59'
}

response = requests.post(url, data=data)
print(response.json())