Přejít na obsah
Dokumentace

Reference

Přehled změn: API klíče

Změny v produktu API klíče: nové funkce, vylepšení a opravy.

říjen 2026

  1. Nové

    Sledování událostí: události workspace a vlastní události

    Sledování událostíAPI klíčeWebhooky

    Vedle událostí, které zaznamenává Emailit, teď můžete odesílat i události ze svých systémů, například objednávku, změnu tarifu nebo zobrazení produktu. Spravujete je na nových kartách Workspace events a Tracking v sekci Email API > Events.

    • Dva rozsahy. Události workspace (w:<name>) se nejdřív deklarují s typovanými vlastnostmi a Emailit odmítne události, které jim neodpovídají. Vlastní události (c:<name>) přijmou libovolný objekt JSON. Log událostí má filtr Scope a endpoint Výpis událostí parametr scope.
    • Ze serverů. Odeslání události zaznamená jednu událost a Dávkové odeslání událostí až 100. Fungují s novými API klíči s oprávněním Events Only, které mohou odesílat události, ale nemohou číst data ani odesílat e-maily.
    • Z webu. Sledovací skript odesílá události s veřejným sledovacím klíčem, který můžete omezit na své weby. identify propojí události návštěvníka s kontaktem.
    • Kontakty a webhooky. Události se zobrazují v panelu Activity log kontaktu. Webhooky dostávají typy, které vyberete, nebo pomocí w:* a c:* všechny události workspace či všechny vlastní události.
    • API a MCP. API událostí workspace a API sledovacích klíčů a v sadě nástrojů MCP events nástroj send-event a nástroje pro události workspace.
    • Tarify. Sledování událostí a sledovací skript jsou součástí tarifů Pro, Business a Custom. Tarif Pro může používat 100 typů událostí, tarif Business 1 000 a tarif Custom nemá žádný limit. Viz Limity.

    Viz Sledování událostí.

září 2026

  1. Opravené

    Opravy kompatibility API v2

    REST APIAPI klíčeE-mailové APIOdesílací domény

    • API klíče vytvořené dřív, než klíče dostaly předponu secret_, se na /v2 opět přijímají.
    • Načtení e-mailu vrací celý objekt e-mailu včetně object, from a to.
    • Odpovědi pro domény vracejí track_loads a track_clicks jako 0, nebo 1, jak je zdokumentováno.
  2. Změněné

    API klíče jen pro odesílání omezené na endpointy pro odesílání

    API klíčeE-mailové API

    Klíče jen pro odesílání dřív mohly vypisovat a načítat e-maily a volat některé další endpointy pro čtení. Teď jsou omezené na Odeslání e-mailu a akce s existujícím e-mailem: přeplánování, zrušení, opakované odeslání a přeposlání. Ostatní endpointy klíče pro odesílání odmítnou.

    Pokud vaše integrace čte také e-maily, domény nebo jiné zdroje, použijte pro tato volání klíč s plným přístupem. Viz API klíče.

říjen 2025

  1. Nové

    API v2

    REST APIAPI klíčeOdesílací doménySeznamy kontaktůBlokované adresy

    API klíče nahrazují přístupové údaje. Klíč má oprávnění full, nebo sending, klíč pro odesílání lze omezit na jednu odesílací doménu a klíče můžete spravovat přes API. API v1 zůstalo během přechodu dostupné.

    Viz Reference API.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.