Частые вопросы

Какой базовый URL у Coverse API?

Базовый URL — https://app.coverse.team/api/v1. Здесь api — это часть пути (/api/v1) на основном хосте app.coverse.team, а не отдельный поддомен. Адрес вида api.coverse.team не существует и не резолвится.

Как аутентифицироваться в API?

Передавайте токен доступа в заголовке Authorization: Bearer ТОКЕН. Токен создаётся в настройках аккаунта и наследует права своего пользователя. Подробнее — Аутентификация.

Почему запись возвращает 422 «Value writes require a collaborative table»?

Запись через API доступна только для таблиц в новом (совместном) формате. Таблицы, созданные в старом формате, доступны для чтения, но не для записи. Чтобы включить запись, создайте таблицу заново в новом формате или обратитесь в поддержку для конвертации существующего документа.

Затирает ли запись остальное содержимое листа?

Нет. Запись (PUT, batchUpdate, append) затрагивает только ячейки переданного блока. Остальные данные листа сохраняются.

Можно ли управлять форматированием ячеек через API?

Нет. Форматирование (объединение ячеек, границы, цвета, шрифты и начертание, выравнивание, перенос, числовые форматы, ширина столбцов и высота строк) через API не задаётся. Доступны только значения ячеек.

Как дописать строки в конец таблицы?

Используйте POST /documents/{id}/values/append. Строки добавляются после последней строки с данными; в ответе приходит startRow — номер строки, с которой начался добавленный блок. Подробнее — Диапазоны.

Как записать столбец, а не строку?

Либо передайте матрицу столбцом ({"values": [[10],[2],[5]]}), либо оставьте строку и укажите ориентацию ({"values": [[10,2,5]], "majorDimension": "COLUMNS"}). От диапазона в пути используется только верхняя-левая ячейка как точка привязки.

Как читать большие таблицы?

Чтение постраничное: используйте параметры offset и limit, а для следующей страницы — значение nextOffset из ответа, пока hasMore равно true. Подробнее — Пагинация.

Какие лимиты по частоте запросов?

Базовый лимит — 60 запросов в минуту на токен; тарифы могут его повышать. При превышении возвращается код 429. Подробнее — Лимиты.