Introducción
Obtener una clave de API¿Qué es Sofia API?
Sofia API da a tu código acceso a tu cuenta de Sofia: los establecimientos de tus Workspaces, sus redes conectadas, su biblioteca de medios, sus publicaciones y sus estadísticas. Es una API REST sobre HTTPS. Las peticiones y las respuestas son JSON, y cada endpoint cuelga de una única URL base.
https://api.sofia-post.com/api/v1¿Qué puede hacer la API?
- Publicar: ahora, en una fecha o como borrador, en una o varias redes a la vez.
- Comprobar antes de publicar: una simulación (dry run) te dice si cada red aceptaría la publicación, sin escribir nada.
- Gestionar medios: sube un archivo o impórtalo desde una URL a la biblioteca de medios de un establecimiento.
- Seguir las publicaciones: lee el estado de cada red, su enlace permanente o el motivo del fallo. Un webhook firmado también puede avisarte.
- Leer estadísticas: las últimas cifras que Sofia recopiló de cada cuenta conectada.
- Conectar redes: crea un enlace alojado que permite al propietario conectar una red que falta.
¿A quién va dirigida?
Si automatizas tu propio Workspace, basta una clave personal: créala en Ajustes › API y envíala como token Bearer. Para un producto SaaS que actúa por sus usuarios en sus propios Workspaces, registra un cliente OAuth: cada persona autoriza tu aplicación en el Workspace que elija.
Siguientes pasos
- Guía rápida: una clave y una primera llamada.
- Autenticación: claves personales, OAuth con PKCE, client credentials.
- Tu primera publicación: del medio a la publicación en línea.
- Referencia de la API: todos los endpoints, con un playground para probarlos.