Tapter для агентов и интеграций

Получить список страниц аккаунта

curl -H "Authorization: Bearer $TAPTER_TOKEN" \
  "https://dev.tapter.kz/api/v1/profiles"

Создать страницу

Сначала проверьте адрес: это публичный URL страницы, и занятый стоит лишнего круга.

curl -H "Authorization: Bearer $TAPTER_TOKEN" \
  "https://dev.tapter.kz/api/v1/profiles/check-login?login=my.coffee"

curl -X POST -H "Authorization: Bearer $TAPTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"login":"my.coffee"}' \
  "https://dev.tapter.kz/api/v1/profiles"

Добавить блок

У каждого типа блока есть своя JSON Schema, описания полей и готовый пример. Незнакомое поле вернётся как 422 с его именем — агент чинится с первой попытки. Заголовок «Precognition: true» проверяет запрос, ничего не записывая.

curl -H "Authorization: Bearer $TAPTER_TOKEN" \
  "https://dev.tapter.kz/api/v1/slot-types/button"

curl -X POST -H "Authorization: Bearer $TAPTER_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: add-button-1" \
  -d '{"type":"button","data":{"title":"Book now","link":"https://example.com/book"}}' \
  "https://dev.tapter.kz/api/v1/profiles/my.coffee/slots"

Добавить несколько блоков сразу

Один запрос вместо цикла: порядок массива — это порядок на странице, а создаётся либо всё, либо ничего. Ошибка в третьем блоке приходит ключом slots.2.data.* и не оставляет полстраницы. Так же работают изменение (PATCH .../slots) и удаление (DELETE .../slots с {"ids": [...]}).

curl -X POST -H "Authorization: Bearer $TAPTER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"slots":[
        {"type":"button","data":{"title":"Book now","link":"https://example.com/book","style":"primary"}},
        {"type":"text","data":{"title":"About us","description":"A coffee shop on Abay street"}}
      ]}' \
  "https://dev.tapter.kz/api/v1/profiles/my.coffee/slots/batch"

Проверить результат

Готовая страница в markdown — та же самая, что видит посетитель, и в том же порядке. Дешевле и надёжнее скриншота.

curl -H "Authorization: Bearer $TAPTER_TOKEN" \
  "https://dev.tapter.kz/api/v1/profiles/my.coffee/markdown"

Посмотреть статистику страницы

Просмотры и клики по каждому блоку, вместе с теми же цифрами за предыдущий период. Это то, с чего начинается осмысленная правка страницы, а не догадки.

curl -H "Authorization: Bearer $TAPTER_TOKEN" \
  "https://dev.tapter.kz/api/v1/profiles/my.coffee/analytics?period=last28"