API

Propojte Moniary s vlastními skripty, systémy a AI agenty.

Přes API můžete číst a upravovat doklady, vystavovat a posílat faktury, párovat platby a nahrávat doklady k vytěžení. Každý požadavek se provede pod vaším účtem, v jedné firmě a s oprávněními, která máte v aplikaci.

V kostce

Údaj	Hodnota
Adresa	`https://moniary.com/api/v1`
Ověření	`Authorization: Bearer <API klíč>`
Formát	JSON v kódování UTF-8
Limit	300 požadavků za minutu na jeden API klíč
Reference	Referenční příručka, strojově jako `/api/v1/openapi.json` (OpenAPI 3.1)

První požadavek

API klíč vytvoříte v Nastavení → API a CLI (víc na stránce API klíče a přihlášení). Ověřte, že funguje:

curl https://moniary.com/api/v1/me \
  -H "Authorization: Bearer $MONIARY_API_KEY"

{
  "key": {
    "id": "…",
    "name": "Export",
    "prefix": "mny_RTE5jErA",
    "scope": "read"
  },
  "user": { "id": "…", "email": "jana@firma.cz" },
  "workspace": { "id": "…", "name": "Firma s.r.o." }
}

Potom spusťte první akci, třeba souhrn přijatých dokladů:

curl -X POST https://moniary.com/api/v1/actions/invoices.getInvoiceStats \
  -H "Authorization: Bearer $MONIARY_API_KEY"

Raději pracujete v terminálu? CLI se přihlásí přes prohlížeč a totéž zvládne jedním příkazem.

Jak API funguje

API se skládá z akcí, například invoices.getInvoiceStats, tags.create nebo issuedInvoices.issueInvoice. Všechny se volají stejně: POST /actions/<název>, vstup pošlete v těle jako JSON a výsledek dostanete v poli data. Podrobnosti najdete na stránce Akce.

Kromě akcí má API několik pevných endpointů: GET /me, vyhledávání akcí, nahrávání dokladů a přihlášení CLI. Všechny popisuje Referenční příručka, která vychází z jednoho popisu ve formátu OpenAPI.

Stabilita

Akce se nemění. Nepřejmenujeme je a jejich vstup neupravíme tak, aby váš kód přestal fungovat. Přidávat budeme jen nové akce a nepovinná pole. Pokud by změna byla nutná, dáme vám vědět předem.

Co API umí

Přijaté a vydané doklady, kontakty, bankovní transakce, štítky, kategorie a náhledy přiznání k DPH, kontrolního a souhrnného hlášení. Další oblasti přidáme postupně. Mazání, nákup kreditu, správa API klíčů a nastavení firmy zůstávají jen v aplikaci.