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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

curl -X PUT "https://app.coverse.team/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 с точкой (1234.5), в m — по локали (1 234,50).
  • Даты в v — серийные номера, в m — строка.
  • Формулы: английские имена, ; между аргументами — =SUM(A1;B1).

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