API — přehled

API je stejné rozhraní, které používá naše aplikace. Co jde v dashboardu, jde i přes API.

Základ

https://api.multibrains.eu/v1

Ověření

Každý požadavek nese klíč v hlavičce:

Authorization: Bearer mb_live_...

Klíč vydáme v dashboardu (připravujeme). Klíč je vázaný na účet — nesdílejte ho a při úniku ho zrušte.

Odpovědi

Úspěch vrací JSON. Chyba má vždy stejný tvar:

{"error":{"code":"not_found","message":"Agent neexistuje."}}

Kódy chyb jsou v češtině i angličtině, ale code je vždy anglicky, aby se dal zpracovat programem.

Endpointy

| Metoda | Cesta | Co dělá | | --- | --- | --- | | GET | /v1/agents | seznam agentů | | POST | /v1/agents | vytvoří agenta | | GET | /v1/agents/{id} | detail agenta | | POST | /v1/agents/{id}/start | spustí agenta | | POST | /v1/agents/{id}/stop | uspí agenta | | DELETE | /v1/agents/{id} | smaže agenta | | GET | /v1/agents/{id}/files | vypíše soubory | | POST | /v1/agents/{id}/exec | spustí příkaz | | POST | /v1/agents/{id}/chat | pošle zprávu |