Mit API-Tokens können Sie eigene Skripte, Tools oder Automatisierungen mit InfraNest verbinden und dabei dieselben Aktionen ausführen, die Sie sonst manuell in der App anklicken würden. Dieser Artikel richtet sich an alle, die Aufgaben automatisieren möchten, statt sie manuell zu erledigen.
Überblick
- InfraNest verfügt über eine vollständige REST API — alles, was Sie in der App tun können, können Sie auch per Automatisierung tun.
- Den Zugriff auf die API erhalten Sie durch das Erstellen eines Eintrags unter API-Tokens, der wie ein Schlüssel funktioniert.
- Jedes Token kann genau auf das beschränkt werden, was es tun darf, und wie lange.
Ein Token erstellen
- Gehen Sie zu API-Tokens und wählen Sie Erstellen.
- Geben Sie dem Token einen Namen, wählen Sie seine Berechtigungen (was es tun darf) und legen Sie optional ein Ablaufdatum fest.
- Wählen Sie Kopieren, um das Token sofort zu kopieren.
WarningKopieren Sie das Token jetzt — es wird nur einmal angezeigt. Danach sehen Sie nur noch einen Hinweis auf die letzten Zeichen, und es kann nicht erneut angezeigt werden.
Berechtigungen auswählen
Berechtigungen legen fest, was jedes Token sehen oder ändern kann. Für jeden Bereich können Sie Lese- oder Schreibzugriff gewähren, außerdem gibt es eine schreibgeschützte Voreinstellung und eine Option für vollen Zugriff. Geben Sie einem Token grundsätzlich nur das, was es tatsächlich benötigt.
Jeder Bereich umfasst mehr, als der Name vermuten lässt:
- Domains & Contacts — Domains, Kontakte, Transfers, Nameserver
- DNS — Zonen, Records, Vorlagen
- Cloud Infrastructure — Server, Volumes, Snapshots, Netzwerke, Firewalls, Load Balancers, Cloud-Anmeldedaten
- Monitoring — Verfügbarkeitsprüfungen, Vorfälle, Wartung, Statusseiten, außerdem Zertifikate sowie Webhooks, Automatisierungen, Integrationen und Tags
- Drop Catch — beobachtete Domains und Drop-Catch-Versuche
- Members & Teams — Mitglieder, Einladungen, Rollen, Single Sign-On
- Billing — Abonnement, Rechnungen, Zahlungsmethoden, Rechnungsdaten (nur lesend)
- Audit Log — das Audit-Log Ihrer Organisation (nur lesend)
- Data export & import — Export Ihrer Daten und Import aus einer Datei
NoteZertifikate und Webhooks sind keine eigenen Bereiche — sie gehören zu Monitoring, daher benötigt ein Token, das eines davon braucht, Zugriff auf Monitoring. Billing und das Audit Log sind über die API immer nur lesend zugänglich — ein Abonnement ändern oder eine Rechnung bezahlen kann nur eine in der App angemeldete Person.
Tokens verwalten
- Gehen Sie zu API-Tokens, um Ihre vorhandenen Tokens zu sehen.
- Prüfen Sie das Datum der letzten Verwendung jedes Tokens, um zu sehen, ob es noch aktiv ist.
- Wählen Sie Entfernen bei jedem Token, das Sie widerrufen möchten — dies tritt sofort in Kraft.
TipDie vollständige Endpunkt-Referenz finden Sie in der App — wählen Sie View full API documentation auf der Seite API-Tokens.
Fehlerbehebung
- Erhalten Sie die Antwort "try again shortly"? Manche Aktionen, wie manuelle Synchronisierungen und „check now“, sind pro Organisation ratenbegrenzt, um die Plattform zu schützen. Warten Sie kurz und versuchen Sie es erneut.
- Token verloren? Sie können es nicht erneut anzeigen — erstellen Sie ein neues und entfernen Sie das alte.
War dieser Artikel hilfreich?