snapshot: NODE1 production state 2026-02-09
Complete snapshot of /opt/microdao-daarion/ from NODE1 (144.76.224.179).
This represents the actual running production code that has diverged
significantly from the previous main branch.
Key changes from old main:
- Gateway (http_api.py): expanded from ~40KB to 164KB with full agent support
- Router: new /v1/agents/{id}/infer endpoint with vision + DeepSeek routing
- Behavior Policy: SOWA v2.2 (3-level: FULL/ACK/SILENT)
- Agent Registry: config/agent_registry.yml as single source of truth
- 13 agents configured (was 3)
- Memory service integration
- CrewAI teams and roles
Excluded from snapshot: venv/, .env, data/, backups, .tgz archives
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Apple
994
site/api-mvp/index.html
Normal file
994
site/api-mvp/index.html
Normal file
@@ -0,0 +1,994 @@
|
||||
|
||||
<!doctype html>
|
||||
<html lang="en" class="no-js">
|
||||
<head>
|
||||
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width,initial-scale=1">
|
||||
|
||||
|
||||
|
||||
<link rel="canonical" href="https://IvanTytar.github.io/microdao-daarion/api-mvp/">
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="icon" href="../assets/images/favicon.png">
|
||||
<meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.18">
|
||||
|
||||
|
||||
|
||||
<title>API Specification (MVP) — DAARION.city & MicroDAO - DAARION Documentation</title>
|
||||
|
||||
|
||||
|
||||
<link rel="stylesheet" href="../assets/stylesheets/main.66ac8b77.min.css">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
||||
<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
|
||||
<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
|
||||
|
||||
|
||||
|
||||
<script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
</head>
|
||||
|
||||
|
||||
<body dir="ltr">
|
||||
|
||||
|
||||
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
|
||||
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
|
||||
<label class="md-overlay" for="__drawer"></label>
|
||||
<div data-md-component="skip">
|
||||
|
||||
|
||||
<a href="#api-specification-mvp-daarioncity-microdao" class="md-skip">
|
||||
Skip to content
|
||||
</a>
|
||||
|
||||
</div>
|
||||
<div data-md-component="announce">
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<header class="md-header md-header--shadow" data-md-component="header">
|
||||
<nav class="md-header__inner md-grid" aria-label="Header">
|
||||
<a href=".." title="DAARION Documentation" class="md-header__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
|
||||
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
|
||||
|
||||
</a>
|
||||
<label class="md-header__button md-icon" for="__drawer">
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
|
||||
</label>
|
||||
<div class="md-header__title" data-md-component="header-title">
|
||||
<div class="md-header__ellipsis">
|
||||
<div class="md-header__topic">
|
||||
<span class="md-ellipsis">
|
||||
DAARION Documentation
|
||||
</span>
|
||||
</div>
|
||||
<div class="md-header__topic" data-md-component="header-topic">
|
||||
<span class="md-ellipsis">
|
||||
|
||||
API Specification (MVP) — DAARION.city & MicroDAO
|
||||
|
||||
</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
|
||||
|
||||
|
||||
|
||||
<label class="md-header__button md-icon" for="__search">
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
|
||||
</label>
|
||||
<div class="md-search" data-md-component="search" role="dialog">
|
||||
<label class="md-search__overlay" for="__search"></label>
|
||||
<div class="md-search__inner" role="search">
|
||||
<form class="md-search__form" name="search">
|
||||
<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
|
||||
<label class="md-search__icon md-icon" for="__search">
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
|
||||
</label>
|
||||
<nav class="md-search__options" aria-label="Search">
|
||||
|
||||
<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
|
||||
</button>
|
||||
</nav>
|
||||
|
||||
</form>
|
||||
<div class="md-search__output">
|
||||
<div class="md-search__scrollwrap" data-md-scrollfix>
|
||||
<div class="md-search-result" data-md-component="search-result">
|
||||
<div class="md-search-result__meta">
|
||||
Initializing search
|
||||
</div>
|
||||
<ol class="md-search-result__list" role="presentation"></ol>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
</nav>
|
||||
|
||||
</header>
|
||||
|
||||
<div class="md-container" data-md-component="container">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<main class="md-main" data-md-component="main">
|
||||
<div class="md-main__inner md-grid">
|
||||
|
||||
|
||||
|
||||
<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
|
||||
<div class="md-sidebar__scrollwrap">
|
||||
<div class="md-sidebar__inner">
|
||||
|
||||
|
||||
|
||||
|
||||
<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
|
||||
<label class="md-nav__title" for="__drawer">
|
||||
<a href=".." title="DAARION Documentation" class="md-nav__button md-logo" aria-label="DAARION Documentation" data-md-component="logo">
|
||||
|
||||
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3 3 3 0 0 0 3 3m0 3.54C9.64 9.35 6.5 8 3 8v11c3.5 0 6.64 1.35 9 3.54 2.36-2.19 5.5-3.54 9-3.54V8c-3.5 0-6.64 1.35-9 3.54Z"/></svg>
|
||||
|
||||
</a>
|
||||
DAARION Documentation
|
||||
</label>
|
||||
|
||||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../public/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Home
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../public/getting-started/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Getting Started
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../public/architecture-overview/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Architecture
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../public/daiS_daos_overview/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
DAIS & DAOS
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item md-nav__item--section md-nav__item--nested">
|
||||
|
||||
|
||||
|
||||
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
|
||||
|
||||
|
||||
<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Internal
|
||||
</span>
|
||||
|
||||
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
</label>
|
||||
|
||||
<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
|
||||
<label class="md-nav__title" for="__nav_5">
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
Internal
|
||||
</label>
|
||||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item md-nav__item--nested">
|
||||
|
||||
|
||||
|
||||
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_1" >
|
||||
|
||||
|
||||
<label class="md-nav__link" for="__nav_5_1" id="__nav_5_1_label" tabindex="0">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Infra
|
||||
</span>
|
||||
|
||||
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
</label>
|
||||
|
||||
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_1_label" aria-expanded="false">
|
||||
<label class="md-nav__title" for="__nav_5_1">
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
Infra
|
||||
</label>
|
||||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/infra/INFRA_AUTOMATION_PACK_V1/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Infra Automation Pack v1
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/infra/monitoring_overview/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Monitoring Overview
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/infra/nodes_registry_v0/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Nodes Registry v0
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item md-nav__item--nested">
|
||||
|
||||
|
||||
|
||||
<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
|
||||
|
||||
|
||||
<label class="md-nav__link" for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Specs
|
||||
</span>
|
||||
|
||||
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
</label>
|
||||
|
||||
<nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
|
||||
<label class="md-nav__title" for="__nav_5_2">
|
||||
<span class="md-nav__icon md-icon"></span>
|
||||
Specs
|
||||
</label>
|
||||
<ul class="md-nav__list" data-md-scrollfix>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/specs/matrix_presence_aggregator/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Matrix Presence Aggregator
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/specs/city_map_spec/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
City Map Spec
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<li class="md-nav__item">
|
||||
<a href="../internal/specs/node_join_protocol_draft/" class="md-nav__link">
|
||||
|
||||
|
||||
<span class="md-ellipsis">
|
||||
Node Join Protocol (Draft)
|
||||
</span>
|
||||
|
||||
|
||||
</a>
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
|
||||
</li>
|
||||
|
||||
|
||||
|
||||
</ul>
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
|
||||
<div class="md-sidebar__scrollwrap">
|
||||
<div class="md-sidebar__inner">
|
||||
|
||||
|
||||
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
</nav>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<div class="md-content" data-md-component="content">
|
||||
<article class="md-content__inner md-typeset">
|
||||
|
||||
|
||||
|
||||
|
||||
<h1 id="api-specification-mvp-daarioncity-microdao">API Specification (MVP) — DAARION.city & MicroDAO<a class="headerlink" href="#api-specification-mvp-daarioncity-microdao" title="Permanent link">¶</a></h1>
|
||||
<p><strong>Документ описує мінімальний набір API-ендпоінтів для запуску MVP-версії MicroDAO, інтегрованої з DAARION.city.</strong></p>
|
||||
<p>Фокус:</p>
|
||||
<ul>
|
||||
<li>створення та реєстрація MicroDAO</li>
|
||||
<li>робота з реєстром DAO та платформ</li>
|
||||
<li>базові операції Wallet (DAAR/DAARION)</li>
|
||||
<li>реєстрація вендорів та створення платформ</li>
|
||||
<li>PDP-перевірки</li>
|
||||
<li>базові Agent / Router виклики (stub-рівень)</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<h1 id="1">1. Загальні принципи<a class="headerlink" href="#1" title="Permanent link">¶</a></h1>
|
||||
<ul>
|
||||
<li>Транспорт: <strong>HTTPS / JSON</strong></li>
|
||||
<li>Auth: <strong>Bearer Token (user / service token)</strong></li>
|
||||
<li>Стиль: REST-like з чіткими ресурсами</li>
|
||||
<li>Усі критичні операції проходять через PDP</li>
|
||||
<li>Ідентифікатори DAO/платформ/користувачів — <code>UUID</code> / <code>string</code> (визначається реалізацією)</li>
|
||||
</ul>
|
||||
<p>Базовий префікс:</p>
|
||||
<div class="codehilite"><pre><span></span><code>/api/v1
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="2-auth-context">2. Auth & Context<a class="headerlink" href="#2-auth-context" title="Permanent link">¶</a></h1>
|
||||
<p>Контекст користувача / сервісу визначається:</p>
|
||||
<ul>
|
||||
<li>токеном авторизації (user/service)</li>
|
||||
<li>DAO-контекстом (якщо вказано <code>X-DAO-ID</code> у заголовках)</li>
|
||||
</ul>
|
||||
<p>Приклад заголовків:</p>
|
||||
<div class="codehilite"><pre><span></span><code><span class="err">Authorization: Bearer <token></span>
|
||||
<span class="err">X-DAO-ID: <dao_id> # опційно, якщо дія виконується в межах конкретного DAO</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="3-daofactory-api">3. DAOFactory API<a class="headerlink" href="#3-daofactory-api" title="Permanent link">¶</a></h1>
|
||||
<h2 id="31-microdao">3.1 Створення MicroDAO<a class="headerlink" href="#31-microdao" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/dao</code></p>
|
||||
<p>Створює новий MicroDAO (A3 або A4).</p>
|
||||
<h3 id="_1">Умови<a class="headerlink" href="#_1" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>PDP: <code>policy.dao.create</code></li>
|
||||
<li>токен користувача</li>
|
||||
</ul>
|
||||
<h3 id="request">Request<a class="headerlink" href="#request" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"public | private"</span><span class="p">,</span><span class="w"> </span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A3 | A4"</span><span class="p">,</span><span class="w"> </span>
|
||||
<span class="w"> </span><span class="nt">"settings"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"visibility"</span><span class="p">:</span><span class="w"> </span><span class="s2">"catalog | invite-only"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response">Response<a class="headerlink" href="#response" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A3 | A4"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"parent_dao_id"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"federation_mode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"none"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"created_at"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2025-..."</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h2 id="32-dao-id">3.2 Отримати DAO за id<a class="headerlink" href="#32-dao-id" title="Permanent link">¶</a></h2>
|
||||
<p><strong>GET</strong> <code>/api/v1/dao/{dao_id}</code></p>
|
||||
<h3 id="response_1">Response<a class="headerlink" href="#response_1" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A1 | A2 | A3 | A4"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"platform | public | private"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"parent_dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string | null"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"federation_mode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"none | member | superdao"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"settings"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="err">...</span><span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h2 id="33-dao">3.3 Список DAO (каталог)<a class="headerlink" href="#33-dao" title="Permanent link">¶</a></h2>
|
||||
<p><strong>GET</strong> <code>/api/v1/dao</code></p>
|
||||
<p>Параметри:</p>
|
||||
<ul>
|
||||
<li><code>level</code> (опційно): <code>A1|A2|A3|A4</code></li>
|
||||
<li><code>type</code> (опційно): <code>platform|public|private</code></li>
|
||||
</ul>
|
||||
<h3 id="response_2">Response<a class="headerlink" href="#response_2" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"items"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A2"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"platform"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">]</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="4-registry-api-dao-platforms">4. Registry API (DAO & Platforms)<a class="headerlink" href="#4-registry-api-dao-platforms" title="Permanent link">¶</a></h1>
|
||||
<h2 id="41-a2">4.1 Реєстр платформ (тільки A2)<a class="headerlink" href="#41-a2" title="Permanent link">¶</a></h2>
|
||||
<p><strong>GET</strong> <code>/api/v1/platforms</code></p>
|
||||
<h3 id="response_3">Response<a class="headerlink" href="#response_3" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"items"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Helion"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"helion"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Energy platform"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A2"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">]</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="5-wallet-api-daar-daarion">5. Wallet API (DAAR / DAARION)<a class="headerlink" href="#5-wallet-api-daar-daarion" title="Permanent link">¶</a></h1>
|
||||
<h2 id="51">5.1 Отримати баланс користувача<a class="headerlink" href="#51" title="Permanent link">¶</a></h2>
|
||||
<p><strong>GET</strong> <code>/api/v1/wallet/me</code></p>
|
||||
<h3 id="response_4">Response<a class="headerlink" href="#response_4" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"user_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"balances"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nt">"symbol"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DAAR"</span><span class="p">,</span><span class="w"> </span><span class="nt">"amount"</span><span class="p">:</span><span class="w"> </span><span class="s2">"123.45"</span><span class="w"> </span><span class="p">},</span>
|
||||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nt">"symbol"</span><span class="p">:</span><span class="w"> </span><span class="s2">"DAARION"</span><span class="p">,</span><span class="w"> </span><span class="nt">"amount"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0.50"</span><span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">]</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h2 id="52">5.2 Перевірка базових прав доступу (допоміжний метод)<a class="headerlink" href="#52" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/wallet/check-access</code></p>
|
||||
<p>Перевіряє, чи достатньо токенів для певної дії (корисно для UI).</p>
|
||||
<h3 id="request_1">Request<a class="headerlink" href="#request_1" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"check"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dao.create | vendor.register | platform.create"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_5">Response<a class="headerlink" href="#response_5" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"allowed"</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"reason"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<p>або</p>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"allowed"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"reason"</span><span class="p">:</span><span class="w"> </span><span class="s2">"INSUFFICIENT_DAARION_BALANCE"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="6-vendor-platform-api">6. Vendor & Platform API<a class="headerlink" href="#6-vendor-platform-api" title="Permanent link">¶</a></h1>
|
||||
<h2 id="61">6.1 Реєстрація вендора на платформі<a class="headerlink" href="#61" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/platforms/{platform_id}/vendors</code></p>
|
||||
<h3 id="_2">Умови<a class="headerlink" href="#_2" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>PDP: <code>policy.vendor.register</code> (мінімум 0.01 DAARION у стейкінгу)</li>
|
||||
</ul>
|
||||
<h3 id="request_2">Request<a class="headerlink" href="#request_2" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"display_name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"GreenFarm UA"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"contact"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"email"</span><span class="p">:</span><span class="w"> </span><span class="s2">"owner@example.com"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_6">Response<a class="headerlink" href="#response_6" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"vendor_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"platform_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"approved | pending"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h2 id="62-a2">6.2 Створення платформи (A2)<a class="headerlink" href="#62-a2" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/platforms</code></p>
|
||||
<h3 id="_3">Умови<a class="headerlink" href="#_3" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>PDP: <code>policy.platform.create</code> (мінімум 1 DAARION у стейкінгу)</li>
|
||||
</ul>
|
||||
<h3 id="request_3">Request<a class="headerlink" href="#request_3" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Helion"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"slug"</span><span class="p">:</span><span class="w"> </span><span class="s2">"helion"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"description"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Energy platform"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"domain"</span><span class="p">:</span><span class="w"> </span><span class="s2">"energy"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_7">Response<a class="headerlink" href="#response_7" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span><span class="w"> </span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Helion"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A2"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"platform"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="7-pdp-api">7. PDP API<a class="headerlink" href="#7-pdp-api" title="Permanent link">¶</a></h1>
|
||||
<h2 id="71">7.1 Перевірка політики<a class="headerlink" href="#71" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/pdp/check</code></p>
|
||||
<h3 id="request_4">Request<a class="headerlink" href="#request_4" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"policy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policy.dao.create"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"resource"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dao"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"id"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span>
|
||||
<span class="w"> </span><span class="p">},</span>
|
||||
<span class="w"> </span><span class="nt">"context"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A3"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"user_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_8">Response<a class="headerlink" href="#response_8" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"decision"</span><span class="p">:</span><span class="w"> </span><span class="s2">"allow | deny | require-elevation"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"reason"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string | null"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<blockquote>
|
||||
<p>У продакшн-коді сервіси зазвичай викликають PDP напряму, а не через публічний API. Ендпоінт може використовуватись для діагностики, дебагу або внутрішніх адміністративних інструментів.</p>
|
||||
</blockquote>
|
||||
<hr />
|
||||
<h1 id="8-agents-router-api-mvp-stub">8. Agents & Router API (MVP Stub)<a class="headerlink" href="#8-agents-router-api-mvp-stub" title="Permanent link">¶</a></h1>
|
||||
<h2 id="81-dao-simple-invoke">8.1 Запуск агента в DAO (simple invoke)<a class="headerlink" href="#81-dao-simple-invoke" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/dao/{dao_id}/agents/{agent_id}/invoke</code></p>
|
||||
<h3 id="_4">Умови<a class="headerlink" href="#_4" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>PDP: <code>policy.agent.run</code></li>
|
||||
</ul>
|
||||
<h3 id="request_5">Request<a class="headerlink" href="#request_5" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"input"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"metadata"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"origin"</span><span class="p">:</span><span class="w"> </span><span class="s2">"admin-console | user-chat | system"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_9">Response<a class="headerlink" href="#response_9" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"run_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"queued | running | completed | failed"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"output"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string | null"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h2 id="82-router-flow">8.2 Створення Router flow (спрощено)<a class="headerlink" href="#82-router-flow" title="Permanent link">¶</a></h2>
|
||||
<p><strong>POST</strong> <code>/api/v1/router/flows</code></p>
|
||||
<h3 id="request_6">Request<a class="headerlink" href="#request_6" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Onboard new member"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"steps"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>
|
||||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"agent"</span><span class="p">,</span><span class="w"> </span><span class="nt">"agent_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"welcome-agent"</span><span class="w"> </span><span class="p">},</span>
|
||||
<span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"agent"</span><span class="p">,</span><span class="w"> </span><span class="nt">"agent_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policy-explainer"</span><span class="w"> </span><span class="p">}</span>
|
||||
<span class="w"> </span><span class="p">]</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<h3 id="response_10">Response<a class="headerlink" href="#response_10" title="Permanent link">¶</a></h3>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"flow_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"created"</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="9-events-system-clients">9. Events (System → Clients)<a class="headerlink" href="#9-events-system-clients" title="Permanent link">¶</a></h1>
|
||||
<p>Події можуть відправлятися через Webhook / WebSocket / NATS (деталі реалізації залежать від інфраструктури).</p>
|
||||
<p>Мінімальний набір подій:</p>
|
||||
<ul>
|
||||
<li><code>dao.created</code></li>
|
||||
<li><code>platform.created</code></li>
|
||||
<li><code>vendor.registered</code></li>
|
||||
<li><code>agent.run.completed</code></li>
|
||||
</ul>
|
||||
<p>Приклад payload:</p>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"event"</span><span class="p">:</span><span class="w"> </span><span class="s2">"dao.created"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"data"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"dao_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"string"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"A3"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"created_by"</span><span class="p">:</span><span class="w"> </span><span class="s2">"user_id"</span>
|
||||
<span class="w"> </span><span class="p">},</span>
|
||||
<span class="w"> </span><span class="nt">"ts"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2025-..."</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="10">10. Статуси та помилки<a class="headerlink" href="#10" title="Permanent link">¶</a></h1>
|
||||
<h2 id="101-http-">10.1 HTTP-статуси<a class="headerlink" href="#101-http-" title="Permanent link">¶</a></h2>
|
||||
<ul>
|
||||
<li><code>200 OK</code> — успішний запит</li>
|
||||
<li><code>201 Created</code> — ресурс створено</li>
|
||||
<li><code>400 Bad Request</code> — некоректні дані</li>
|
||||
<li><code>401 Unauthorized</code> — відсутня/некоректна авторизація</li>
|
||||
<li><code>403 Forbidden</code> — PDP = deny</li>
|
||||
<li><code>404 Not Found</code> — ресурс не знайдено</li>
|
||||
<li><code>409 Conflict</code> — конфлікт станів</li>
|
||||
<li><code>500 Internal Server Error</code> — внутрішня помилка</li>
|
||||
</ul>
|
||||
<h2 id="102">10.2 Приклад помилки<a class="headerlink" href="#102" title="Permanent link">¶</a></h2>
|
||||
<div class="codehilite"><pre><span></span><code><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"error"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ACCESS_DENIED"</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"PDP denied action 'platform.create' for this user."</span><span class="p">,</span>
|
||||
<span class="w"> </span><span class="nt">"details"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
|
||||
<span class="w"> </span><span class="nt">"policy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policy.platform.create"</span>
|
||||
<span class="w"> </span><span class="p">}</span>
|
||||
<span class="p">}</span>
|
||||
</code></pre></div>
|
||||
|
||||
<hr />
|
||||
<h1 id="11-api">11. Подальший розвиток API<a class="headerlink" href="#11-api" title="Permanent link">¶</a></h1>
|
||||
<p>Цей документ описує <strong>MVP-шар</strong>. Надалі можливі розширення:</p>
|
||||
<ul>
|
||||
<li>детальний Wallet API (транзакції, стейкінг, payout-и)</li>
|
||||
<li>повна OpenAPI-специфікація</li>
|
||||
<li>окремий Agent Runtime API (streams, tools, multi-step flows)</li>
|
||||
<li>Notification API (email / push / in-app)</li>
|
||||
</ul>
|
||||
<p>На рівні MVP цього набору достатньо, щоб:</p>
|
||||
<ul>
|
||||
<li>створювати DAO</li>
|
||||
<li>реєструвати платформи</li>
|
||||
<li>реєструвати вендорів</li>
|
||||
<li>керувати базовими правами доступу</li>
|
||||
<li>запускати прості агенти та оркестраційні флоу.</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<h2 id="12-integration-with-other-docs">12. Integration with Other Docs<a class="headerlink" href="#12-integration-with-other-docs" title="Permanent link">¶</a></h2>
|
||||
<p>Цей документ інтегрується з:</p>
|
||||
<ul>
|
||||
<li><code>api.md</code> — повна API специфікація (розширена версія)</li>
|
||||
<li><code>core-services-mvp.md</code> — реалізація core-сервісів (Wallet, DAOFactory, Registry, PDP)</li>
|
||||
<li><code>pdp_access.md</code> — PDP та система доступів</li>
|
||||
<li><code>microdao-architecture.md</code> — архітектура A1-A4</li>
|
||||
<li><code>superdao-federation.md</code> — SuperDAO та федерації</li>
|
||||
<li><code>tokenomics/city-tokenomics.md</code> — токеноміка</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<h2 id="13-changelog">13. Changelog<a class="headerlink" href="#13-changelog" title="Permanent link">¶</a></h2>
|
||||
<h3 id="v100-2024-11-14">v1.0.0 — 2024-11-14<a class="headerlink" href="#v100-2024-11-14" title="Permanent link">¶</a></h3>
|
||||
<ul>
|
||||
<li>Початкова версія MVP API специфікації</li>
|
||||
<li>Додано DAOFactory API (створення, отримання, список DAO)</li>
|
||||
<li>Додано Registry API (реєстр платформ)</li>
|
||||
<li>Додано Wallet API (баланси, перевірка доступу)</li>
|
||||
<li>Додано Vendor & Platform API (реєстрація вендорів, створення платформ)</li>
|
||||
<li>Додано PDP API (перевірка політик)</li>
|
||||
<li>Додано Agents & Router API (stub-рівень)</li>
|
||||
<li>Додано Events (системні події)</li>
|
||||
</ul>
|
||||
<hr />
|
||||
<p><strong>Версія:</strong> 1.0.0<br />
|
||||
<strong>Останнє оновлення:</strong> 2024-11-14<br />
|
||||
<em>Документ готовий до інтеграції у Cursor, GitHub або будь-який інший проект.</em></p>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
</article>
|
||||
</div>
|
||||
|
||||
|
||||
<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
|
||||
</div>
|
||||
|
||||
</main>
|
||||
|
||||
<footer class="md-footer">
|
||||
|
||||
<div class="md-footer-meta md-typeset">
|
||||
<div class="md-footer-meta__inner md-grid">
|
||||
<div class="md-copyright">
|
||||
|
||||
|
||||
Made with
|
||||
<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
|
||||
Material for MkDocs
|
||||
</a>
|
||||
|
||||
</div>
|
||||
|
||||
</div>
|
||||
</div>
|
||||
</footer>
|
||||
|
||||
</div>
|
||||
<div class="md-dialog" data-md-component="dialog">
|
||||
<div class="md-dialog__inner md-typeset"></div>
|
||||
</div>
|
||||
|
||||
|
||||
<script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.instant", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
|
||||
|
||||
|
||||
<script src="../assets/javascripts/bundle.3220b9d7.min.js"></script>
|
||||
|
||||
|
||||
</body>
|
||||
</html>
|
||||
Reference in New Issue
Block a user