Die Infomaniak-API nutzen, um Ihre Aufgaben zu automatisieren

Möchten Sie die Verwaltung Ihrer Infomaniak-Dienste automatisieren? Konten programmatisch erstellen, Ihre Domains verwalten oder mit kDrive aus Ihren Anwendungen interagieren? Die Infomaniak-APIs machen das möglich. Dieser technische Leitfaden zeigt Ihnen, wie Sie loslegen.

Infomaniak entdecken

Übersicht der Infomaniak-APIs

Infomaniak stellt mehrere APIs für die Interaktion mit seinen Diensten bereit:

• Manager-API – Produkt-, Benutzer- und Abrechnungsverwaltung
• kDrive-API – Dateiverwaltung, Freigabe, Metadaten
• Mail-API – Postfach-, Alias- und Filterverwaltung
• DNS-API – DNS-Eintrags-Verwaltung

Die APIs folgen REST-Standards und geben JSON zurück.

Authentifizierung

Ein API-Token erhalten

1. Beim Infomaniak Manager anmelden
2. Zum Profil gehen → „API" oder „Tokens"
3. Einen neuen Token erstellen
4. Die erforderlichen Berechtigungen (Scopes) definieren
5. Den generierten Token kopieren (er wird nicht nochmals angezeigt)

Den Token verwenden

Den Token in den Request-Headers angeben:

``` Authorization: Bearer IHR_TOKEN_HIER ```

Token-Sicherheit

• Niemals einen Token in ein Git-Repository committen
• Umgebungsvariablen verwenden
• Tokens mit den minimal erforderlichen Berechtigungen erstellen
• Nicht mehr verwendete Tokens widerrufen

Verwendungsbeispiele

Ihre Produkte auflisten (Manager-API)

```bash curl -X GET "https://api.infomaniak.com/1/products" \ -H "Authorization: Bearer IHR_TOKEN" \ -H "Content-Type: application/json" ```

Antwort:

```json { "result": "success", "data": [ { "id": 12345, "name": "Mail Hosting", "status": "active" }, { "id": 12346, "name": "kSuite", "status": "active" } ] } ```

Eine Datei zu kDrive hochladen (kDrive-API)

```bash curl -X POST "https://api.infomaniak.com/2/drive/{drive_id}/files/upload" \ -H "Authorization: Bearer IHR_TOKEN" \ -F "file=@/pfad/zur/datei.pdf" \ -F "directory_id=1" ```

Einen DNS-Eintrag hinzufügen

```bash curl -X POST "https://api.infomaniak.com/1/domain/{domain_id}/dns/record" \ -H "Authorization: Bearer IHR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "type": "A", "source": "www", "target": "123.45.67.89", "ttl": 3600 }' ```

SDKs und Bibliotheken

Sie können die API direkt mit jeder Sprache aufrufen, die HTTP-Anfragen stellen kann. Hier einige Beispiele:

Python

```python import requests API_TOKEN = "ihr_token" BASE_URL = "https://api.infomaniak.com" headers = { "Authorization": f"Bearer {API_TOKEN}", "Content-Type": "application/json" } # Produkte auflisten response = requests.get(f"{BASE_URL}/1/products", headers=headers) products = response.json() for product in products["data"]: print(f"{product['name']}: {product['status']}") ```

JavaScript (Node.js)

```javascript const axios = require('axios'); const API_TOKEN = process.env.INFOMANIAK_TOKEN; const BASE_URL = 'https://api.infomaniak.com'; const client = axios.create({ baseURL: BASE_URL, headers: { 'Authorization': `Bearer ${API_TOKEN}`, 'Content-Type': 'application/json' } }); // Produkte auflisten async function listProducts() { const response = await client.get('/1/products'); return response.data.data; } listProducts().then(products => { products.forEach(p => console.log(`${p.name}: ${p.status}`)); }); ```

PHP

```php Anwendungsfälle für Automatisierung

Benutzer-Provisioning

Kontoerstellung automatisieren, wenn neue Teammitglieder eingestellt werden:

1. HR meldet den neuen Mitarbeiter im HRIS an
2. Ein Skript erkennt den neuen Eintrag
3. Über die API erstellt es das E-Mail-Konto und den kDrive-Zugriff
4. Eine Willkommens-E-Mail wird automatisch versandt

Automatisches Backup

Ihre kDrive-Daten regelmäßig an einen anderen Ort herunterladen:

1. Geplantes Skript (Cron) jede Nacht
2. Kürzlich geänderte Dateien über die API auflisten
3. Die relevanten Dateien herunterladen
4. Auf einem lokalen NAS oder Swiss Backup speichern

Dynamische DNS-Verwaltung

Ihre DNS-Einträge automatisch aktualisieren:

1. Ihre öffentliche IP ändert sich (Verbindung ohne statische IP)
2. Ein Skript erkennt die Änderung
3. Über die DNS-API aktualisiert es den A-Eintrag
4. Ihre Domain zeigt immer auf die richtige IP

Berichterstattung

Automatische Berichte über die Dienstnutzung erstellen:

1. Wöchentliches Skript
2. Statistiken über die verschiedenen APIs sammeln
3. Einen Bericht erstellen (PDF, E-Mail)
4. An Verantwortliche versenden

Grenzen und Best Practices

Rate Limiting

APIs haben Anfragelimits, um Missbrauch zu verhindern:

• Die dokumentierten Limits einhalten
• Bei Bedarf Verzögerungen zwischen Anfragen implementieren
• 429-Fehler (Too Many Requests) behandeln

Fehlerbehandlung

APIs geben explizite Fehlercodes zurück:

• 200 – Erfolg
• 400 – Fehlerhafte Anfrage
• 401 – Ungültiger oder abgelaufener Token
• 403 – Unzureichende Berechtigungen
• 404 – Ressource nicht gefunden
• 429 – Zu viele Anfragen
• 500 – Serverfehler

Behandeln Sie diese Fehler in Ihrem Code für robuste Automatisierungen.

Idempotenz

Gestalten Sie Ihre Skripte idempotent: Das zweimalige Ausführen desselben Skripts sollte keine Duplikate oder Fehler erzeugen.

Dokumentation

Die offizielle Infomaniak-API-Dokumentation ist auf der Infomaniak-Entwicklerseite verfügbar. Dort finden Sie:

• Vollständige Liste der Endpunkte
• Akzeptierte Parameter
• Anfrage- und Antwortbeispiele
• Versions-Changelog

Fazit

Die Infomaniak-APIs eröffnen viele Automatisierungsmöglichkeiten. Ob für Benutzer-Provisioning, Dateiverwaltung oder DNS-Administration – Sie können Infomaniak in Ihre automatisierten Workflows integrieren.

Beginnen Sie mit einfachen Skripten, testen Sie gründlich und erweitern Sie schrittweise. Die Entwicklungsinvestition amortisiert sich schnell durch tägliche Zeitersparnis.

Infomaniak entdecken