API

Co s API postavíte

• Skripty na rutinu: hromadná změna DNS záznamů, založení schránek pro nové kolegy, noční kontrola expirace domén.
• Mikroaplikace na míru: interní přehled klientských webů, formulář, kterým si kolega sám založí subdoménu, nebo bot do Slacku.
• Napojení na vaše systémy: CI/CD, fakturace, CRM nebo workflow v n8n.
• Totéž, co dělá AI asistent přes MCP, jen řízené vaším kódem. Napsat vám ho může i samotný asistent.

Jak začít

1. Vytvořte si API klíč. Bez něj API žádný požadavek nepřijme.
2. Klíči nastavte oprávnění jen na to, co skript potřebuje (třeba jen čtení DNS), a volitelně omezení na IP adresy a platnost.
3. Klíč se zobrazí jen jednou. Uložte si ho do správce hesel nebo proměnné prostředí, nikdy ne do kódu v gitu.
4. Posílejte ho v hlavičce Authorization u každého požadavku.

Vytvořit API klíč

První volání

Výpis vašich domén:

curl https://api.vas-hosting.cz/v1/domains \
  -H "Authorization: Bearer $VH_API_KEY"

Přidání DNS záznamu, třeba ověření pro Google:

curl -X POST https://api.vas-hosting.cz/v1/domains/example.cz/dns \
  -H "Authorization: Bearer $VH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"type": "TXT", "name": "@", "value": "google-site-…"}'

Odpovědi jsou v JSON. Úplný seznam endpointů s příklady najdete v dokumentaci API.

Bezpečnost a limity

• Každý skript nebo aplikace má mít vlastní klíč. Když jeden unikne, zrušíte jen ten.
• U klíče vidíte, kdy a odkud byl naposledy použit.
• Mazání domén, serverů a databází vyžaduje klíč s výslovným oprávněním k mazání.
• API má limit počtu požadavků za minutu, aktuální stav vrací v hlavičkách odpovědi.

Odkazy

• Dokumentace API
• Správa API klíčů
• Raději přes AI asistenta? MCP

Články

• První skript nad API za 10 minut
• Hromadná změna DNS u desítek domén
• Interní mikroaplikace: přehled klientských webů
• Jak bezpečně zacházet s API klíči

Videonávody

• API klíč: vytvoření a oprávnění 3:50
• Skript na kontrolu expirace domén 8:15
• Mikroaplikace s AI asistentem od nuly 16:40