API de contenido
API de Contenido
Sube y gestiona assets multimedia programáticamente con la API de Contenido.
Subir contenido
`` POST /v1/content/upload Content-Type: multipart/form-data ``
Campos del formulario:
file— El archivo multimedia (requerido)name— Nombre visible (opcional, por defecto el nombre del archivo)tags— Etiquetas separadas por coma (opcional)folder_id— ID de carpeta destino (opcional)
Respuesta: ``json { "success": true, "data": { "id": "asset_abc123", "name": "Summer Promotion", "type": "image", "format": "jpeg", "width": 1920, "height": 1080, "size": 524288, "url": "https://cdn.govista.app/assets/...", "created_at": "2025-01-15T10:30:00Z" } } ``
Subir desde URL
`` POST /v1/content/upload-url ``
Cuerpo de la petición: ``json { "url": "https://example.com/image.jpg", "name": "Imported Image" } ``
Listar contenido
`` GET /v1/content ``
Parámetros de consulta:
page,limit— Paginacióntype— Filtrar:image,videotag— Filtrar por etiquetafolder_id— Filtrar por carpetasearch— Buscar por nombre
Usa el endpoint upload-url para integrar con tu CMS. Cuando se publique nuevo contenido en tu web, envíalo automáticamente a GoVista vía API.
Obtener detalle del contenido
`` GET /v1/content/:id ``
Actualizar metadatos del contenido
`` PATCH /v1/content/:id ``
Cuerpo de la petición: ``json { "name": "Updated Name", "tags": ["new-tag"], "folder_id": "folder_xyz" } ``
Eliminar contenido
`` DELETE /v1/content/:id ``
Listar carpetas
`` GET /v1/content/folders ``
Crear carpeta
`` POST /v1/content/folders ``
Cuerpo de la petición: ``json { "name": "Summer 2025", "parent_id": null } ``
La subida de contenido está limitada a 2 GB por archivo vía API. Para archivos muy grandes, considera dividir vídeos o comprimir antes de subir. El endpoint de subida admite chunked transfer encoding para archivos grandes.