BrosDrop API v1.0

Introducción

Autenticación
Límites & Cuotas
Playground

Endpoints

Subir Archivo
Listar Archivos
Obtener Detalles
Eliminar Archivo

Documentación API

Integra la potencia de BrosDrop en tus aplicaciones. Automatiza subidas, gestiona transferencias y crea flujos de trabajo personalizados.

Disponible para planes Plus y Pro

Interactive Playground

API Key

Subir Archivo

Seleccionar Archivo (Prueba Real)

Seleccionar un archivo autocompletará los parámetros y ejecutará la subida real (PUT) automáticamente tras obtener la URL firmada.

Body Params

name

size

type

expiresInHoursopcional

Preview

Request (Curl)

curl -X POST "undefined/api/v1/upload" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

Esperando solicitud...

Autenticación

Todas las peticiones a la API deben incluir tu clave secreta en el header x-api-key.

bash

curl -H "x-api-key: bdp_7a8f9c..." https://brosdrop.com/api/v1/files

Límites y Cuotas

Los límites de la API dependen de tu plan de suscripción.

Plan Plus

Peticiones / hora 100
Subidas / día 15
Tamaño Máx. 500 MB

Plan Pro

Peticiones / hora 500
Subidas / día 50
Tamaño Máx. 5 GB

POST

Subir Archivo

Inicia una nueva transferencia. Este endpoint devuelve una URL firmada (uploadUrl) donde debes hacer un PUT con el binario del archivo.

/api/v1/upload

Body Params

Campo	Tipo	Descripción
`name`	string	Nombre del archivo (ej. "vacaciones.zip")
`size`	number	Tamaño en bytes
`type`	string	MIME type (ej. "application/zip")
`expiresInHours`	number	(Opcional) Horas hasta caducar
`customLink`	string	(Opcional) Slug personalizado

Ejemplo

bash

# 1. Solicitar Subida
curl -X POST https://brosdrop.com/api/v1/upload \
  -H "x-api-key: YOUR_KEY" \
  -d '{"name": "test.txt", "size": 1024, "type": "text/plain"}'

# Response
{
  "id": "658c...",
  "uploadUrl": "https://r2....",
  "fileUrl": "https://brosdrop.com/d/custom-link",
  "expiresAt": "2024-..."
}

# 2. Subir Archivo a la uploadUrl
curl -X PUT "https://r2...." -d @test.txt

GET

Listar Archivos

/api/v1/files

Obtén una lista paginada de tus transferencias activas.

Query Params

Param	Default	Descripción
`page`	1	Número de página
`limit`	10	Resultados por página

json

{
  "data": [
    {
      "originalName": "foto.png",
      "size": 204857,
      "views": 4,
      "downloads": 1,
      "expiresAt": "2023-..."
    }
  ],
  "pagination": {
    "total": 45,
    "page": 1,
    "totalPages": 5
  }
}

DELETE

Eliminar Archivo

/api/v1/files/:id

Elimina permanentemente un archivo y sus datos.

json

{ "message": "File deleted successfully" }