Intune Insights: Implementierungshandbuch für die Garantieintegration

Garantieabfragen für HP- und Lenovo-Geräte werden planmäßig ausgeführt, sobald ein gültiger Schlüssel für das Deployment vorhanden ist. Über diese API legen Sie diesen Schlüssel fest (oder entfernen ihn).

Die beiden Typ-Strings sind Teil des API-Vertrags und müssen exakt wie angegeben geschrieben werden.

Warum die exakte Schreibweise wichtig ist, erfahren Sie weiter unten unter Zwei exakte Typ-Strings, keine Allow-List.

Alle Aufrufe verwenden Authorization: Bearer <jwt>. Das JWT stammt aus derselben Ausgabe von Admin-Token, die Nerdio bereits für alle anderen Features für Partner verwendet:

POST /api/nerdio/issue-jwt/admin
ApiSecret: <shared secret>
Content-Type: application/json
 
{ "userEmail": "you@example.com", "userName": "Ihr Name" }

Antwort: 200 OK

{ "jwt": "<admin JWT>" }

Die unten aufgeführten Integrations-Endpoints erfordern einen Instanz-Admin-User, dessen Berechtigung bereits im Admin-JWT enthalten ist. Es ist keine weitere Berechtigungserteilung erforderlich.

GET /api/admin/integrations/{type}

Antwort: 200 OK

{
  "integrationId": 1,
  "integrationType": "HpWarranty",
  "isEnabled": true,
  "isConfigured": true,
  "configJson": null,
  "createdAt": "2026-09-01T19:13:09.6863181Z",
  "updatedAt": "2026-09-01T19:13:09.6863565Z"
}

isConfigured gibt an, ob Anmeldedaten hinterlegt sind. Die Anmeldedaten selbst werden niemals von diesem oder einem anderen Endpoint zurückgegeben.

Ein unbekannter oder nie erstellter {type} gibt 404 Not Found zurück.

Um alle für das Deployment konfigurierten Elemente aufzulisten:

GET /api/admin/integrations

Antwort: 200 OK mit einem Array derselben Struktur: Es enthält einen Eintrag für jeden Integrationstyp, der jemals gespeichert wurde. Als gelöscht markierte Einträge sind ausgeschlossen.

PUT /api/admin/integrations/{type}
Content-Type: application/json
 
{
  "integrationType": "HpWarranty",
  "isEnabled": true,
  "credentialsJson": "{\"apiKey\":\"...\",\"apiSecret\":\"...\"}"
}

PUT /api/admin/integrations/{type}
Content-Type: application/json
 
{
  "integrationType": "LenovoWarranty",
  "isEnabled": true,
  "credentialsJson": "{\"clientId\":\"...\"}"
}

Antwort: 200 OK, das resultierende IntegrationResponseDto (gleiche Struktur wie in Abschnitt 1).

Dieser Aufruf ist ein Upsert: Das erste PUT für {type} erstellt einen Datensatz. Jedes weitere PUT aktualisiert denselben Datensatz.

PATCH /api/admin/integrations/{type}/toggle
Content-Type: application/json
 
{ "isEnabled": false }

Antwort: 204 No Content. Für einen unbekannten Typ {type} wird 404 Not Found zurückgegeben.

DELETE /api/admin/integrations/{type}

Antwort: 204 No Content bei Erfolg, 404 Not Found, wenn für diesen Typ nichts hinterlegt ist. Dies ist ein Soft-Delete: Ein erneuter Aufruf von PUT für denselben {type} erstellt einen völlig neuen Datensatz (eine neue integrationId); der gelöschte Datensatz wird nicht wiederhergestellt.

Nerdio Manager hat keine Möglichkeit, einen HP- oder Lenovo-Schlüssel vor dem Speichern beim Anbieter zu überprüfen. Auch wenn ein Schlüssel falsch eingegeben wurde oder abgelaufen ist, wird das Speichern erfolgreich abgeschlossen: Die Antwort lautet 200 OK und isConfigured: true – genau wie bei einem gültigen Schlüssel.

Der Fehler zeigt sich erst später und bleibt unbemerkt: Die nächste geplante Synchronisierung versucht, den Anbieter aufzurufen. Der Aufruf schlägt fehl, und im Protokoll der Hintergrundsynchronisierung wird eine Warnung erfasst. An den Aufrufer dieser API wird nichts zurückgegeben und es erscheint keine sichtbare Fehlermeldung. Aus Sicht des Admins ist nur eines zu erkennen: Die Felder für Garantiedaten dieses Anbieters werden auf den Geräten nie aufgefüllt. Wenn das passiert, überprüfen Sie den Wert der Anmeldedaten. Dass der API-Aufruf 200 zurückgegeben hat, bedeutet nicht, dass der Schlüssel gültig ist.

PUT prüft {type} nicht anhand einer Liste bekannter Typen. PUT /api/admin/integrations/HPWaranty (mit Tippfehler) gibt 200 OK zurück und erstellt genauso wie bei korrekter Schreibweise einen Datensatz. Der Fehler wird nicht durch 404 abgefangen.

Diese Zeile ist dann für den Sync-Job für immer unsichtbar. Der Lesepfad (GET/PUT/DELETE) gleicht {type} ohne Berücksichtigung der Groß-/Kleinschreibung mit der Datenbank ab, daher gibt GET /api/admin/integrations/hpwarranty problemlos die HpWarranty-Zeile zurück und lässt eine Speicherung mit Tippfehler oder falscher Groß-/Kleinschreibung bei der Überprüfung unauffällig erscheinen. Der Sync-Job lädt jedoch aktivierte Integrationen und vergleicht deren Typ im Speicher exakt und unter Berücksichtigung der Groß- und Kleinschreibung mit den Zeichenfolgen "HpWarranty" und "LenovoWarranty". Ein als HPWaranty, hpwarranty oder in einer anderen Variante gespeicherter Datensatz besteht alle Prüfungen beim Lesen, wird aber bei jeder Sync-Ausführung stillschweigend übersprungen.

{type} ist HpWarranty oder LenovoWarranty. Rufen Sie diese API nicht für DellWarranty auf.