Přeskočit na obsah
Dokumentace IS Mango

Přehled a začínáme

1. Co je Mango API

Sekce “1. Co je Mango API”

Mango API je REST API systému Mango. Umožňuje externím systémům, integračním nástrojům a automatizacím číst a zapisovat data přímo do systému — bez ručního klikání v aplikaci.

Typické použití:

  • Automatizace přes Make.com (zakládání zákazníků z formulářů, export dat do tabulek)
  • Integrace vlastních systémů (CRM, billing, provisioning)
  • Reagování na události v Mango přes webhooky
  • Reporting a analytika přes vlastní skripty

2. Dokumentace — přehled sekcí

Sekce “2. Dokumentace — přehled sekcí”
Sekce Obsah
Swagger — Endpoint reference

https://api.mango.cloud/docs/		 Kompletní přehled všech API endpointů: URL, metody, parametry, příklady požadavků a odpovědí. Zahrnuje také Postman kolekci ke stažení.
Správa přístupu k API

Správa přístupu k API		 Jak vytvořit API token, typy tokenů (osobní vs. lokační), povinné HTTP hlavičky, bezpečnostní doporučení a zrušení tokenu.
Webhooky

Webhooky		 Jak nastavit webhook notifikace, struktura payloadu, ověření pravosti (HMAC), synchronní vs. asynchronní doručení a diagnostika přes historii volání.
Make.com integrace

Make.com integrace		 Jak propojit Mango s Make.com: dostupné moduly (zákazníci, události), připojení, recepty a řešení potíží.

3. Rychlý start

Sekce “3. Rychlý start”

Krok 1: Získejte API token

Sekce “Krok 1: Získejte API token”

Přihlaste se do Mango Admin, vyberte Tokeny → Moje tokeny a vytvořte nový token. Token si zkopírujte — zobrazí se pouze jednou.

Podrobný návod: Správa přístupu k API

Krok 2: Vyzkoušejte první volání

Sekce “Krok 2: Vyzkoušejte první volání”

Každý požadavek musí obsahovat hlavičky Authorization a X-CT:

GET https://api.mango.cloud/api/v3/customers
Authorization: Bearer <váš_token>
X-CT: <číslo_lokace>

Kompletní seznam endpointů a interaktivní konzole: Swagger dokumentace

Krok 3 (volitelné): Nastavte webhooky

Sekce “Krok 3 (volitelné): Nastavte webhooky”

Pokud chcete reagovat na události v Mango v reálném čase, nakonfigurujte si webhooky v Mango Admin → Webhooky → Konfigurace.

Podrobný návod: Webhooky — ;Mango API

Krok 4 (volitelné): Propojte Mango s Make.com

Sekce “Krok 4 (volitelné): Propojte Mango s Make.com”

Pro automatizaci bez programování použijte Mango Custom App pro Make.com — umožňuje zakládat zákazníky, vyhledávat a reagovat na události přímo ze scénářů v Make.

Podrobný návod: Mango Custom App pro Make

4. Prostředí

Sekce “4. Prostředí”
Prostředí Base URL Určení
Produkce https://api.mango.cloud/api/v3 Ostrá data zákazníků
Test https://apiv3-test.devel.ogsoftdev.com/api/v3 Vývoj a testování integrace

5. Podpora

Sekce “5. Podpora”