- Documentación
- API · Versión 1.0
- Introducción
Introducción
En esta página
La API REST de Quiet Social permite que tu aplicación publique en las redes de una marca sin pasar por el panel: un artículo puesto en línea, un producto lanzado o un evento creado se convierte en una publicación, programada o inmediata, en Facebook, Instagram, LinkedIn, Threads y Pinterest.
Nada de lo que se describe aquí requiere una biblioteca. Para no escribir las llamadas usted mismo, el SDK PHP las hace para cualquier aplicación PHP, y el paquete Laravel publica sus modelos Eloquent; todo lo que hacen pasa por esta API.
Dirección base
https://quietsocial.dev/api/v1
La versión está en la ruta. Por tanto, una URL lleva su versión: un ejemplo copiado de esta documentación sigue siendo válido, y una versión 2 convivirá con la versión 1, no ocupará su lugar.
Formato
- Los cuerpos de petición y de respuesta están en JSON, salvo el envío de un archivo, en
multipart/form-data. - Toda respuesta bajo
/api/se devuelve en JSON, errores incluidos. Se recomienda la cabeceraAccept: application/json, pero no es necesaria. - Las fechas están en formato ISO 8601, con su desfase:
2026-10-01T09:30:00+00:00. - Los recursos se designan con un identificador público con prefijo —
pub_…,dst_…—, nunca con un número. Consulta Límites y convenciones.
Primera llamada
Crea una clave en el panel, menú Clés API (Claves API) (consulta Autenticación) y luego pregúntale a la API quién eres:
curl https://quietsocial.dev/api/v1/me \
-u "$QUIET_CLIENT_ID:$QUIET_CLIENT_SECRET"
La respuesta indica sobre qué espacio de trabajo y sobre qué marca actúa este cliente, y qué permisos tiene. Es la primera llamada de toda integración: evita descubrir los permisos que faltan de rechazo en rechazo.
Recorrido típico
- Listar los destinos de la marca con
GET /destinations, para conocer sus identificadores y lo que acepta cada uno. - Enviar la imagen, si la hay, con
POST /media. - Crear la publicación con
POST /publications, dándole una clave de idempotencia. - Recibir aviso del resultado, red por red, mediante un webhook — o volver a leer la publicación con
GET /publications/{id}.
Las páginas de esta referencia
- Autenticación: identificador, secreto,
GET /me. - Permisos: lo que abre cada permiso, y la marca de un cliente.
- Idempotencia: repetir una escritura sin publicar dos veces.
- Marcas y destinos: dónde se puede publicar, y qué.
- Publicaciones: crear, leer, liberar, cancelar, relanzar.
- Medios: enviar y gestionar las imágenes.
- Webhooks: recibir notificaciones y verificar la firma.
- Errores: cada código, y si hay que reintentar.
- Límites y convenciones: frecuencia, paginación, identificadores.
- Servidor MCP: conectar un asistente a la API, con la misma clave.