Přejít na hlavní obsah
API je dostupné výhradně v rámci plánu Enterprise. Kontaktujte nás pro více informací o cenách a funkcích pro firmy.
Macaly API používá k autentizaci API klíče. Klíče jsou vázané na tým a sdílejí stejný systém kreditů jako webové rozhraní.

​
Získání API klíče

  1. Přihlaste se ke svému účtu Macaly
  2. Klikněte na svůj profil (vpravo nahoře)
  3. Přejděte do Nastavení → API klíče
  4. Klikněte na „Vytvořit nový API klíč”
  5. Klíč si ihned zkopírujte (zobrazí se pouze jednou)

​
Použití API klíče

API klíč uveďte v hlavičce Authorization u všech požadavků: 
Authorization: Bearer macaly_your_api_key_here

​
Příklad požadavku

curl -X POST https://www.macaly.com/api/chat \
  -H "Authorization: Bearer macaly_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"content": "Create a landing page"}'

​
Formát API klíče

VlastnostHodnota
Prefixmacaly_
Celková délka39 znaků
Příkladmacaly_abc123def456ghi789jkl012mno345

​
Bezpečnostní doporučení

API klíče poskytují plný přístup ke zdrojům a kreditům vašeho týmu. Zacházejte s nimi jako s hesly.
  1. Uchovávejte klíče bezpečně – Používejte proměnné prostředí, nikdy je neukládejte přímo do kódu
  2. Klíče pravidelně obměňujte – Pravidelně je rušte a vytvářejte nové
  3. Používejte samostatné klíče – Pro různá prostředí a aplikace vytvářejte samostatné klíče
  4. Sledujte využití – Pravidelně kontrolujte využití kreditů v nastavení
  5. Kompromitované klíče ihned zrušte – Pokud dojde k prozrazení klíče, zneplatněte ho co nejdříve

​
Limity požadavků

  • Neúspěšné pokusy o autentizaci API klíčem jsou omezeny na 5 požadavků za minutu na IP adresu
  • Toto opatření chrání proti útokům hrubou silou

​
Správa klíčů

API klíče můžete spravovat v nastavení svého účtu Macaly:
  • Zobrazení klíčů – Přehled všech aktivních klíčů s datem vytvoření a posledního použití
  • Vytvoření klíčů – Generování nových klíčů s volitelným názvem pro snadnou identifikaci
  • Odvolání klíčů – Deaktivace klíčů, které již nepotřebujete nebo které byly kompromitovány