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

Соберите первую интеграцию за 5 минут

Задача: прочитать таблицу и дописать в неё строку.

Шаг 1. Токен​

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

Шаг 2. Найдите таблицу​

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

Возьмите id нужной таблицы из ответа.

Шаг 3. Прочитайте данные​

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

Шаг 4. Допишите строку​

append добавляет данные после последней заполненной строки:

curl -X POST "https://app.coverse.team/v1/documents/$DOCUMENT_ID/values/append" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"range":"A1","values":[["Новая заявка",1500]]}'

Тот же сценарий целиком на Python​

import requests

BASE = "https://app.coverse.team/v1"
headers = {"Authorization": f"Bearer {TOKEN}"}

docs = requests.get(f"{BASE}/documents", params={"type": "table"}, headers=headers).json()
doc_id = docs["documents"][0]["id"]

requests.post(
    f"{BASE}/documents/{doc_id}/values/append",
    headers=headers,
    json={"range": "A1", "values": [["Новая заявка", 1500]]},
)

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