Introduzione
Ottieni una chiave APIChe cos'è Sofia API?
Sofia API dà al tuo codice accesso al tuo account Sofia: le attività dei tuoi Workspace, le loro reti collegate, la loro mediateca, le loro pubblicazioni e le loro statistiche. È un'API REST su HTTPS. Richieste e risposte sono in JSON e ogni endpoint si trova sotto un unico URL di base.
https://api.sofia-post.com/api/v1Cosa può fare l'API?
- Pubblicare: subito, a una data o come bozza, su una o più reti insieme.
- Verificare prima di pubblicare: una simulazione (dry run) ti dice se ogni rete accetterebbe la pubblicazione, senza scrivere nulla.
- Gestire i media: carica un file o importalo da un URL nella mediateca di un'attività.
- Seguire le pubblicazioni: leggi lo stato di ogni rete, il suo permalink o il motivo dell'errore. Può avvisarti anche un webhook firmato.
- Leggere le statistiche: gli ultimi dati raccolti da Sofia per ogni account collegato.
- Collegare le reti: crea un link ospitato che permette al titolare di collegare una rete mancante.
A chi è destinata?
Se automatizzi il tuo Workspace, basta una chiave personale: creala in Impostazioni › API e inviala come token Bearer. Per un prodotto SaaS che agisce per conto dei suoi utenti sui loro Workspace, registra un client OAuth: ogni persona autorizza la tua applicazione sul Workspace che sceglie.
Prossimi passi
- Guida rapida: una chiave e una prima chiamata.
- Autenticazione: chiavi personali, OAuth con PKCE, client credentials.
- La tua prima pubblicazione: dal media alla pubblicazione online.
- Riferimento API: ogni endpoint, con un playground per provarlo.