Быстрый старт

Получить ключ API

1. Создайте личный ключ

В приложении Sofia откройте Настройки › API, вкладку Личный доступ, и создайте ключ. Выберите его название, срок действия и разрешения. Ключ показывается один раз: скопируйте его и храните в хранилище секретов, но не в коде.

2. Сделайте первый вызов

Передайте ключ в заголовке Authorization. GET /v1/me покажет, от чьего имени действует ключ, его Workspace и разрешения.

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. Получите список заведений

Каждая публикация принадлежит заведению. Запишите id того, для которого хотите публиковать.

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

Дальнейшие шаги

Вы готовы к первой публикации. Чтобы попробовать любой эндпоинт в браузере, откройте справочник API и нажмите Попробовать.