API y documentación

Introducción

La base de la API es /api/v1. Todas las peticiones y respuestas usan JSON en UTF-8. Los recursos están siempre limitados a la cuenta del token utilizado.

curl https://tu-dominio/api/v1/perfiles \
  -H "Authorization: Bearer kln_tu_token"

Autenticación

Envía tu token en la cabecera Authorization: Bearer <token> o en X-API-Token. Encuentras tu token en Panel → API y puedes regenerarlo cuando quieras.

# Node 22+
const res = await fetch('https://tu-dominio/api/v1/perfiles', {
  headers: { Authorization: 'Bearer kln_tu_token' }
});
console.log(await res.json());

# Python
import requests
r = requests.get('https://tu-dominio/api/v1/perfiles',
                 headers={'Authorization': 'Bearer kln_tu_token'})
print(r.json())

Perfiles

GET/api/v1/perfilesLista los perfiles de la cuenta

POST/api/v1/perfilesCrea un perfil

GET/api/v1/perfiles/:idDetalle de un perfil

PATCH/api/v1/perfiles/:idActualiza campos sueltos

DELETE/api/v1/perfiles/:idElimina un perfil

Cuerpo aceptado al crear:

{
  "name": "Tienda ES",
  "group_id": 3,
  "proxy_id": 7,
  "platform": "Windows",
  "locale": "es-ES",
  "timezone": "Europe/Madrid",
  "resolution": "1920x1080",
  "tags": "tienda,es",
  "notes": "Cuenta principal"
}

Respuesta 201 Created con el objeto completo, incluido id y created_at.

Proxies

GET/api/v1/proxiesLista los proxies

POST/api/v1/proxiesCrea un proxy

DELETE/api/v1/proxies/:idElimina un proxy

{
  "label": "ES Madrid",
  "kind": "socks5",
  "host": "proxy.ejemplo.net",
  "port": 1080,
  "username": "usuario",
  "password": "secreto",
  "country": "ES"
}

La contraseña nunca se devuelve en las respuestas de lectura.

Grupos

GET/api/v1/gruposLista los grupos

POST/api/v1/gruposCrea un grupo

Errores

Código	Significado
400	Datos inválidos o incompletos
401	Token ausente, inválido o plan sin API
403	Límite del plan alcanzado
404	Recurso inexistente en tu cuenta
429	Demasiadas peticiones

{ "error": "limite_alcanzado",
  "message": "Tu plan permite 50 perfiles." }

Límites de uso

120 peticiones por minuto y token. Al superarlo se devuelve 429. Los límites de perfiles y proxies dependen de tu plan y se comprueban en cada creación.

Crear cuenta