Přejít na obsah
Pro vývojáře

JobMistr API.

Programový přístup k vašim zakázkám, klientům, fakturám a účetním datům — pro integrace, které aplikace nepokrývá.

Co můžete postavit

API zpřístupňuje stejné stavební bloky, ze kterých se skládá aplikace: klienty, zakázky, nabídky, faktury, výdaje a položky kalendáře. Propojte JobMistr s vlastním webem, interním dashboardem nebo nástrojem, se kterým zatím neintegrujeme.

  • Posílejte poptávky z webu rovnou do pipeline zakázek
  • Stahujte faktury a platby do vlastního reportingu
  • Synchronizujte kalendář s interními systémy
  • Automatizujte exporty dokladů pro účetní

Endpointy

REST API pod /api/v1, omezené na váš účet. Čtěte své záznamy jako JSON nebo posílejte nové poptávky rovnou do pipeline. Seznamy jsou stránkované a částky vracejí jako čísla.

  • GET /api/v1/clients, /invoices, /quotes, /jobs, /expenses a /calendar — seznam nebo jeden záznam podle id
  • POST /api/v1/leads — z webové poptávky vytvoří klienta a obchod v pipeline

Webhooky

Zaregistrujte HTTPS endpoint a přijímejte události v reálném čase. Každé doručení je podepsané (HMAC-SHA256), takže si ověříte, že přišlo od nás, a neúspěšná doručení se automaticky opakují.

  • invoice.paid — faktura byla uhrazena
  • invoice.overdue — faktuře vypršela splatnost
  • job.completed — zakázka byla označena jako dokončená

Autentizace

V Nastavení vytvořte API klíč a posílejte ho jako Bearer token (Authorization: Bearer jm_…, nebo hlavička X-API-Key). Klíče jsou vázané na váš účet a využití se počítá do měsíčního limitu požadavků vašeho tarifu.

Dostupnost

Přístup k API je součástí tarifu Business spolu s white-label možnostmi a integracemi na míru. Uživatele API zatím zapojujeme individuálně — napište nám, co stavíte, a připravíme vám klíče i dokumentaci.