Программный доступ к таблицам

https://api.tabulya.ru даёт доступ к таблицам из скриптов, интеграций и CI: чтение и запись ячеек, листы, таблицы данных, форматирование, диаграммы, сводные и выполнение кода — всё то же, что доступно в приложении. Машиночитаемая спецификация — api.tabulya.ru/openapi.json.

Токен

Токен выдаётся в настройках пространства, на вкладке «API-токены». Значение показывается один раз при создании — сервер хранит только его хеш; отозванный токен перестаёт работать в течение минуты.

Токен действует в границах своего пространства и от имени того, кто его создал: файл соседнего пространства через него недоступен, даже если у вас есть к нему доступ.

curl https://api.tabulya.ru/v1/files \
  -H "Authorization: Bearer tby_live_…"

Первый запрос

Проверить ключ, ничего не меняя:

curl https://api.tabulya.ru/v1/auth/me \
  -H "Authorization: Bearer tby_live_…"

Записать значения и прочитать их обратно:

curl -X PUT "https://api.tabulya.ru/v1/files/$FILE/cells" \
  -H "Authorization: Bearer tby_live_…" \
  -H "content-type: application/json" \
  -d '{"cell": "A1", "values": [["Товар", "Цена"], ["Стол", 4500]]}'

curl "https://api.tabulya.ru/v1/files/$FILE/cells?range=A1:B2" \
  -H "Authorization: Bearer tby_live_…"

Лимиты

На токен — 10 запросов в секунду со всплеском до 30 и не больше 5 одновременных. Каждый ответ несёт X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset; при превышении приходит 429 с заголовком Retry-After — столько секунд стоит подождать перед повтором.

Поверх этого есть общий потолок на сетевой адрес: 50 запросов в секунду со всплеском до 100 и не больше 200 одновременных соединений.