Endpoints de la API

La API REST de InstaSwift permite gestionar feeds y consultar estadísticas programáticamente. Todos los endpoints requieren autenticación con API Key y el plan Server activo.

URL Base

https://estelarlatam.com/plataforma/instaswift/server/

Todas las peticiones deben incluir el header de autenticación:

Authorization: Bearer TU_API_KEY

Resumen de endpoints

Método	Path	Descripción	Scope requerido
GET	`/feeds`	Listar todos los feeds del servidor	feeds:read
POST	`/feeds`	Crear un nuevo feed	feeds:write
DELETE	`/feeds/{id}`	Eliminar un feed por ID	feeds:write
GET	`/feeds/{id}/posts`	Últimos posts publicados de un feed	feeds:read
GET	`/stats`	Estadísticas del servidor	stats:read

GET /feeds — Listar feeds

Devuelve la lista de todos los feeds configurados en el servidor.

Respuesta de ejemplo:

{
  "feeds": [
    {
      "id": 7,
      "cuenta": "natgeo",
      "canal": "1234567890",
      "estado": "activo",
      "tipos": ["post", "reel"],
      "filtros": 2,
      "ultimoPost": "2026-05-25T10:00:00Z"
    }
  ],
  "total": 1,
  "plan": "server"
}

POST /feeds — Crear feed

Crea un nuevo feed de Instagram.

Cuerpo de la petición (JSON):

{
  "cuenta": "natgeo",
  "canalId": "1234567890",
  "tipos": ["post", "reel"],
  "filtros": []
}

Respuesta exitosa (201 Created):

{
  "id": 8,
  "cuenta": "natgeo",
  "canalId": "1234567890",
  "estado": "activo",
  "creado": "2026-05-25T14:00:00Z"
}

DELETE /feeds/{id} — Eliminar feed

Elimina permanentemente un feed por su ID.

Respuesta exitosa (200 OK):

{
  "ok": true,
  "mensaje": "Feed 7 eliminado correctamente"
}

GET /feeds/{id}/posts — Últimos posts de un feed

Devuelve los últimos posts publicados por un feed específico. Parámetros de query opcionales:

limite: Número de posts a devolver (máximo 50, defecto 10).
tipo: Filtrar por "post", "reel" o "story".

Ejemplo:

GET /feeds/7/posts?limite=5&tipo=post

Respuesta:

{
  "posts": [
    {
      "id": "abc123",
      "tipo": "post",
      "caption": "La increíble biodiversidad...",
      "mediaUrl": "https://...",
      "postUrl": "https://www.instagram.com/p/abc123/",
      "publicadoEn": "2026-05-25T10:00:00Z",
      "publicadoDiscord": "2026-05-25T10:00:02Z"
    }
  ]
}

GET /stats — Estadísticas del servidor

Devuelve estadísticas de actividad del servidor.