API Reference

Endpoints REST para integrar AdsBolt en tu flujo de trabajo.

Autenticación

Todos los endpoints requieren autenticación. Desde el navegador, la sesión se gestiona con cookies httpOnly de Supabase. Para integraciones server-to-server, incluye el JWT del usuario:

Authorization: Bearer <user_jwt_token>
Content-Type: application/json

Notificaciones

Usa GET, PATCH y DELETE sobre /api/notifications con el JWT del usuario. Los detalles de parámetros figuran en la tabla de endpoints más abajo.

Endpoints

GET/api/notifications

Lista notificaciones del usuario autenticado.

Params: limit, offset, unread=true

PATCH/api/notifications

Marca notificaciones como leídas.

Params: Body: { ids?: string[], markAll?: boolean }

DELETE/api/notifications

Elimina notificación(es).

Params: ?id=<uuid>

GET/api/credits

Historial de créditos y saldo.

Params: limit

POST/api/studio/generate

Genera imágenes/videos con AI.

Params: { prompt, type, model, quantity?, aspectRatio?, duration? }

POST/api/meta/publish

Publica campaña en Meta Ads.

Params: { projectId, campaignName, objective, dailyBudget, ... }

POST/api/google-ads/publish

Publica campaña en Google Ads.

Params: { projectId, campaignName, objective, dailyBudget, ... }

POST/api/brands/[brandId]/invite

Invita colaborador a marca.

Params: { email } | { linkOnly: true }

POST/api/campaign-suggestions

Sugerencias AI de campaña.

Params: { brandId, projectId }

POST/api/ai-optimizer

Optimiza creatividad existente.

Params: { creativeId, mode }

Rate Limits

Studio generate: 20 peticiones / hora por usuario.
Publish (Meta/Google): Limitado por las APIs de plataforma.
Lectura (GET): 100 peticiones / minuto.

Cuando excedes el límite, recibirás HTTP 429 con header Retry-After.

Modelos disponibles (Studio)

Key	Nombre	Tipo
seedream-4	SeedDream 4 (ByteDance)	Imagen
gpt-image-2	GPT Image 2 (OpenAI)	Imagen
nano-banana-pro	Nano Banana Pro (Google)	Imagen
nano-banana-2	Nano Banana 2 (Google)	Imagen
seedance-2	Seedance 2.0 Fast (ByteDance)	Video
kling-v3	Kling V3 (Kuaishou)	Video
grok-imagine-video	Grok Imagine Video (xAI)	Video