Ласкаво просимо до RAPS

RAPS🌼RAPSRust CLI for Autodesk Platform Services.View in glossary (Rust🦀RustSystems programming language known for safety.View in glossary APS CLI💻CLIText-based interface for running commands.View in glossary) — це потужний інструмент командного рядка для роботи з Autodesk Platform Services☁️APSAutodesk Platform Services - cloud APIs for CAD/BIM automation.View in glossary (APS). Він надає зручний доступ до всіх основних API🔌APIInterface for software components to communicate.View in glossary APS, зокрема автентифікації, зберігання об’єктів, трансляції моделей, управління даними, вебхуків, автоматизації проєктування та багато іншого.

Чому RAPS?

• 🦀 Написаний на Rust — швидкий, надійний та безпечний для пам’яті
• ⚡ Створений для CI/CD🔁CI/CDAutomated build, test, and deployment pipelines.View in glossary — стандартизовані коди завершення, виведення у JSON📋JSONStandard data interchange format.View in glossary/YAML📝YAMLHuman-readable configuration format.View in glossary, неінтерактивний режим
• 🔐 Безпечний — зберігання у системному сховищі ключів за замовчуванням, автоматичне оновлення токенів, безпечна система плагінів
• 🚀 Інтерактивна оболонка — автодоповнення TAB, підказки параметрів, історія команд
• 🤖 Готовий до ШІ — MCP🧠MCPProtocol for AI assistant tool integration.View in glossary-сервер для інтеграції з ШІ-помічниками
• 📦 Єдиний бінарний файл — без залежностей, проста установка
• 🏗️ Розширена підтримка ACC🏗️ACCAutodesk's construction management platform.View in glossary — Issues, RFI, Assets, Submittals, Checklists

Режими використання

RAPS пропонує кілька способів взаємодії з APS — оберіть режим, який найкраще підходить для вашого робочого процесу:

📖 Дивіться Режими використання для детального порівняння та інструкцій з налаштування.

Основні можливості

🔐 Автентифікація

• 2-legged OAuth🔐OAuthIndustry-standard authorization protocol used by APS.View in glossary (Client Credentials🤖2-legged authServer-to-server authentication without user context.View in glossary) для серверних операцій
• 3-legged OAuth (Authorization Code👤3-legged authUser-authorized authentication with browser login.View in glossary) з входом через браузер
• Безпечне зберігання токенів з автоматичним оновленням

📦 Object Storage Service (OSS)

• Створення, перегляд та видалення бакетів (підтримка кількох регіонів)
• Завантаження, вивантаження та управління об’єктами
• Відновлювані багаточастинні завантаження для великих файлів
• Пакетне завантаження з паралельною обробкою

🔄 Model Derivative

• Трансляція CAD📐CADSoftware for creating technical drawings and 3D models.View in glossary-файлів у різні формати (SVF2🚀SVF2Current APS viewing format (improved performance).View in glossary, OBJ🎲OBJSimple 3D geometry format.View in glossary, STL🖨️STL3D printing mesh format.View in glossary, STEP🔧STEPISO standard for 3D CAD data exchange.View in glossary тощо)
• Перевірка статусу трансляції з опитуванням
• Завантаження похідних файлів

🏗️ Data Management

• Перегляд хабів, проєктів, папок та елементів
• Створення папок та управління версіями
• Повна інтеграція з BIM 360🔵BIM 360Legacy Autodesk construction platform (predecessor to ACC).View in glossary/ACC

👥 Account Admin (нове у v4.0)

• Масове управління користувачами у проєктах ACC/BIM🏛️BIMIntelligent 3D model-based design for buildings.View in glossary 360
• Додавання, видалення, оновлення ролей користувачів у масштабі
• Управління дозволами папок
• Відновлювані операції з відстеженням прогресу

🔗 Спеціальні API-запити (нове у v4.5)

• Виконання довільних HTTP🔗HTTPProtocol for web communication.View in glossary-запитів до будь-якого ендпоінту APS
• Повний контроль над методом, заголовками та тілом запиту
• Доступ до будь-якого API APS, що ще не обгорнутий командами RAPS

📊 Портфельна звітність (нове у v4.5)

• Агреговані підсумки RFI та Issues по всіх проєктах
• Аналітика на рівні портфеля по кількох проєктах
• Швидка перевірка стану будівельного портфеля

📋 Управління шаблонами (нове у v4.5)

• Створення, оновлення та архівування шаблонів проєктів
• Перегляд та інспекція деталей шаблонів
• Стандартизація налаштування проєктів по всій організації

🤖 MCP Server

• Інтеграція з ШІ-помічниками через Model Context Protocol
• 72 інструменти для операцій APS природною мовою
• Працює з Claude, Cursor та іншими MCP-клієнтами

Архітектура

RAPS побудований на мікроядерній архітектурі, що розділяє основну функціональність від розширених можливостей:

• Ядро: Мінімальна довірена основа (автентифікація, HTTP-клієнт, конфігурація, обробка помилок)
• Сервісні крейти: Незалежні модулі для API APS (OSS📦OSSAPS cloud storage for files and models.View in glossary, Derivative📤DerivativeAny output generated from model translation.View in glossary, Data Management📂Data ManagementAPS service for accessing files in ACC, BIM 360, and Fusion.View in glossary, Design Automation🤖Design AutomationRun Autodesk desktop apps in the cloud.View in glossary, ACC, Webhooks🪝WebhooksEvent notifications sent to your application.View in glossary, Reality Capture)
• Прикладний рівень: Користувацькі інтерфейси (CLI, MCP Server, TUI) та розширені можливості

Дивіться Посібник з архітектури для детальної інформації.

Швидкий старт

# Встановлення RAPS CLI (оберіть один спосіб)
curl -fsSL https://raw.githubusercontent.com/dmytro-yemelianov/raps/main/install.sh | bash  # Linux/macOS
pip install raps                          # Python (CLI binary)
npm install -g @dmytro-yemelianov/raps-cli # Node.js
brew install dmytro-yemelianov/raps/raps  # Homebrew

# Або встановіть Python bindings для програмного використання
pip install raps-bindings

# Налаштуйте облікові дані
export APS_CLIENT_ID="your_client_id"
export APS_CLIENT_SECRET="your_client_secret"

# Перевірте автентифікацію
raps auth test

# Починайте працювати з командами!
raps bucket list

Наступні кроки

1. Встановлення — встановіть RAPS у вашій системі
2. Режими використання — оберіть спосіб роботи з RAPS (CLI, Shell🖥️TerminalApplication for running command-line programs.View in glossary, Docker🐳DockerContainer platform for consistent environments.View in glossary тощо)
3. Конфігурація — налаштуйте облікові дані APS
4. Автентифікація — ознайомтеся з варіантами автентифікації
5. Ваш перший робочий процес — завантажте та трансформуйте модель