Wenn deine Domain bei IONOS liegt, musst du die Einträge nicht mehr von Hand abtippen. Du hinterlegst einen API-Key unter Anbindungen; sobald ein Projekt Domains hat, schreibt die Plattform die Einträge in die passende Zone.
Manuelles DNS bleibt möglich – siehe DNS-Eintrag konfigurieren.
API-Key in IONOS
Das ist die Hosting-DNS-API (api.hosting.ionos.com), nicht IONOS Cloud und nicht der Data Center Designer. Ein Cloud-Token aus dem DCD funktioniert hier nicht.
- Im IONOS-Konto anmelden (Kundennummer, E-Mail oder Domain).
- Den Developer Hub öffnen und den API-Zugang einmalig aktivieren (AGB akzeptieren).
- Unter API Keys einen neuen Key anlegen.
- Public Prefix und Secret kopieren. Die Plattform erwartet eine Zeile im Format
prefix.secret(ein Punkt dazwischen). IONOS zeigt die beiden Teile oft getrennt; nicht mit Leerzeichen oder Zeilenumbruch einfügen.
Ohne aktivierten API-Zugang lehnt IONOS den Key ab, auch wenn Prefix und Secret korrekt aussehen.
Anbindung in der Plattform
- Öffne Anbindungen und Anbindung hinzufügen.
- Wähle unter DNS die Kachel IONOS.
- Füge den API-Key ein und speichere. Die Plattform prüft, ob der Key gültig ist und welche Zonen er sieht.
Mehrere IONOS-Zugänge in einer Organisation sind möglich. Gehört eine Domain zu mehreren Zonen, nimmt die Plattform die treffendste (zum Beispiel shop.example.com vor example.com).
Was gesetzt wird
Die Plattform übernimmt dieselben Hosts, die du unter Domains siehst.
- Einträge werden nur gesetzt, wenn schon eine echte Server-Adresse da ist.
- Bestehende Einträge desselben Typs werden aktualisiert, nicht die ganze Zone ersetzt.
- Änderungen kommen schnell an.
flowchart LR org["IONOS-Anbindung"] domains["Domains in der Plattform"] zone["IONOS-Zone"] server["Dein Server"] org --> zone domains -->|"A / CNAME"| zone zone --> server
Nach dem Speichern eines Projekts versucht die Plattform, fehlende oder abweichende Einträge anzugleichen. Den Prüfstatus siehst du in der Domain-Übersicht.
Fehlersuche
- Key ungültig: Format
prefix.secretprüfen (ein Punkt, keine Leerzeichen), API-Zugang im IONOS-Konto aktivieren und die Anbindung aktualisieren. Ein Token aus IONOS Cloud / DCD ist der falsche Typ. - Kein Eintrag in IONOS: Die Domain liegt in keiner Zone, die der Key sieht – Account oder Zonennamen prüfen.
- Status in der Plattform noch rot: DNS braucht oft ein paar Minuten, oder der Server hat noch keine bekannte Adresse.