Ir al contenido
Quiet Social

Introducción

Esta documentación está traducida del francés. Si ambas versiones difieren, prevalece la versión francesa.

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 cabecera Accept: 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

  1. Listar los destinos de la marca con GET /destinations, para conocer sus identificadores y lo que acepta cada uno.
  2. Enviar la imagen, si la hay, con POST /media.
  3. Crear la publicación con POST /publications, dándole una clave de idempotencia.
  4. 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