Перейти к основному содержимому

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

Postman — скачал и сразу пробуешь

Готовая коллекция со всеми методами: скачать коллекцию Postman. Импортируйте её в Postman (Import → выберите файл), задайте переменную baseUrl = https://app.coverse.team/api/v1 и подставьте свой токен в заголовок Authorization: Bearer … — можно сразу выполнять запросы.

1. Создайте токен доступа​

В настройках аккаунта → «Автоматизация и API» создайте токен и выберите нужные права. Токен показывается один раз — сохраните его.

2. Базовый адрес​

Все запросы идут на https://app.coverse.team/api/v1.

3. Передавайте токен в заголовке​

Authorization: Bearer ВАШ_ТОКЕН

4. Список ваших таблиц​

curl "https://app.coverse.team/api/v1/documents?type=table" \
  -H "Authorization: Bearer $TOKEN"

5. Прочитать значения​

curl "https://app.coverse.team/api/v1/documents/DOCUMENT_ID/values/A1:B10" \
  -H "Authorization: Bearer $TOKEN"

Диапазон в пути нужно URL-кодировать, если он содержит имя листа или : (например Лист1!A1:C10). Подробнее — в разделе «Как устроены диапазоны».

6. Записать значения​

curl -X PUT "https://app.coverse.team/api/v1/documents/DOCUMENT_ID/values/A1" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"values":[["Привет","=1+1"]],"valueInputOption":"USER_ENTERED"}'

Значения ячеек​

  • Каждая ячейка возвращается как { v, m, f? }: v — исходное значение, m — как видит пользователь, f — формула (если есть). Пустая ячейка — null.
  • v типизировано: числа — JSON-числа (1234.5), логические — true/false, текст — строка; одинаково для ручных значений и результатов формул. m — всегда строка по локали (1 234,50).
  • Даты: в v — серийный номер (например 46037), в m — готовая строка, а сама ячейка помечена полем t: "d": { "v": 46037, "m": "15.01.2026", "t": "d" }.
  • Формулы: английские имена, ; между аргументами — =SUM(A1;B1).
  • При записи передавайте числа JSON-числами (1234.5): они сохраняются как числа и показываются в числовом формате ячейки. Строка "1234.5" останется текстом.
примечание

Запись значений доступна на платных тарифах. На бесплатном тарифе запросы записи возвращают 403 — подробнее в разделе Лимиты.

Полный список методов — в Справочнике API. Коды ошибок описаны там же.