Guía rápida

1. Crear una clave personal

En la app de Sofia, abre Ajustes › API, pestaña Acceso personal, y crea una clave. Elige su nombre, su caducidad y sus permisos. La clave se muestra una sola vez: cópiala y guárdala en un almacén de secretos, nunca en tu código.

2. Hacer tu primera llamada

Envía la clave en la cabecera Authorization. GET /v1/me te dice por quién actúa la clave, sus Workspaces y sus permisos.

bash

curl https://api.sofia-post.com/api/v1/me \
  -H "Authorization: Bearer $SOFIA_API_KEY"

json

{
  "tokenType": "personal_key",
  "user": { "id": "cmo7qiltc0000sb1p7zdx1aw4" },
  "coverage": "account",
  "workspaces": [{ "id": "cmo7qiltc0000sb1p7zdx1aw4", "name": "160 food" }],
  "scopes": ["establishments:read", "posts:read", "posts:write"],
  "mode": "live",
  "expiresAt": "2026-11-09T20:09:05.644Z"
}

3. Listar tus establecimientos

Cada publicación pertenece a un establecimiento. Anota el id de aquel para el que quieres publicar.

bash

curl https://api.sofia-post.com/api/v1/establishments \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Siguientes pasos

Ya estás listo para tu primera publicación. Para probar cualquier endpoint desde tu navegador, abre la referencia de la API y pulsa Probar.