Авторизация

API принимает JWT. Вы получаете пару токенов по почте и паролю аккаунта AiGenda и передаёте access в каждом запросе.

Получить токен

curl -X POST https://api.aigenda.tech/api/token/ \
  -H "Content-Type: application/json" \
  -d '{"username": "you@example.com", "password": "ваш-пароль"}'

Ответ 200

{
  "refresh": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCJ9.signature",
  "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIn0.signature"
}

Поле называется username, но в него кладётся почта.

Передать токен

Добавьте заголовок ко всем запросам, кроме получения и обновления токена:

Authorization: Bearer <access>

Сколько живут токены

Токен	Срок	Как обновить
`access`	30 дней	новый вход по почте и паролю или `refresh`
`refresh`	1 сутки	только новым входом

Обновление по refresh возвращает новый access, но новый refresh не выдаёт. Через сутки после входа обновиться уже нельзя, поэтому проще всего так:

Храните access и время его истечения. Оно лежит в поле exp внутри токена (Unix-время в секундах).
Когда до exp осталось меньше суток или API ответил 401, получите новую пару по почте и паролю.
Повторите исходный запрос один раз с новым токеном.

Срок действия токена

import base64, json

def token_expires_at(access: str) -> int:
    payload = access.split(".")[1]
    payload += "=" * (-len(payload) % 4)
    return json.loads(base64.urlsafe_b64decode(payload))["exp"]

Ошибки

Ответ	Тело	Что делать
`401` при входе	`{"detail": "No active account found with the given credentials"}`	Проверьте почту и пароль
`401`	`{"detail": "Authentication credentials were not provided."}`	Добавьте заголовок `Authorization`
`401`	`{"detail": "Given token not valid for any token type", "code": "token_not_valid", ...}`	Токен истёк или испорчен: войдите заново

Не храните пароль в коде и репозитории. Передавайте его через переменные окружения или хранилище секретов вашей платформы.

Входите в кабинет через Google? У такого аккаунта может не быть пароля. Задайте его на странице восстановления пароля, и вход через API заработает.

Начало работы

Загрузка записи

Обработка и результат

Справка

Авторизация

Получить токен

Передать токен

Сколько живут токены

Ошибки

​Получить токен

​Передать токен

​Сколько живут токены

​Ошибки

Получить токен

Передать токен

Сколько живут токены

Ошибки