Документация v2.4

API для
разработчиков

Стройте интеграции, автоматизируйте рабочие процессы и создавайте уникальные инструменты поверх Albedo. RESTful, быстрый и безопасный.

Получить API Key Посмотреть OpenAPI Spec

Базовый лимит: 500 запросов/день

Схема архитектуры API Albedo

Введение в API

Albedo API предоставляет полный программный доступ к вашим задачам, доскам и метрикам.

Мы используем стандартный REST-подход. Все данные передаются в формате JSON. API работает по протоколу HTTPS.

Базовый URL: https://api.albedo.app/v2

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

🔑

Аутентификация

Используйте Bearer-токены. Получите ключ в настройках профиля. Токены имеют TTL 24 часа, используйте refresh-token для продления.

Authorization: Bearer sk_live_51Mz...
📊

Эндпоинты

Полный CRUD доступ к ресурсам: /tasks, /boards, /users. Поддержка пагинации и фильтрации.

  • GET /tasks?status=open
  • POST /tasks
  • PATCH /tasks/{id}
⚠️

Лимиты и Ошибки

Стандартные HTTP-коды. Rate limiting: 100 запросов в минуту. При превышении возвращается код 429 Too Many Requests.

{ "error": "rate_limit_exceeded" }

Примеры кода

Создание задачи

cURL
curl -X POST https://api.albedo.app/v2/tasks \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Обновить дизайн", "due": "2023-11-15"}'

Получение списка задач

Python
import requests

response = requests.get(
  "https://api.albedo.app/v2/tasks",
  headers={"Authorization": f"Bearer {TOKEN}"}
)

print(response.json())

SDK для разных языков

Мы поддерживаем официальные библиотеки для самых популярных языков программирования. Начните за считанные минуты.

🐍

Python

pip install albedo-sdk

Документация
🟨

JavaScript / Node.js

npm install @albedo/sdk

Документация
🦀

Rust

cargo add albedo-rs

Документация

Нужна помощь?

Наша команда поддержки разработчиков ответит на ваши вопросы в течение 24 часов.

Написать в Discord Отправить тикет