Dies ist ein Entwicklerhandbuch für Partner, die HP- und Lenovo-Garantieabfragen für ein Deployment über die REST-API anschalten möchten, anstatt die Nerdio Manager Intune Insights-Benutzeroberfläche zu verwenden.
Garantieabfragen für HP- und Lenovo-Geräte werden bereits 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).
|
Integrationstyp |
Anmeldedatenfelder (innerhalb von |
Anmerkungen |
|---|---|---|
|
|
|
Beide Angaben sind erforderlich, damit der Synchronisierungs-Job HP aufrufen kann. |
|
|
|
Diese Angabe ist erforderlich, damit der Synchronisierungs-Job Lenovo aufrufen kann. |
|
|
Keine |
Vollständig von Nerdio verwaltet. Es ist im Admin-Bildschirm schreibgeschützt und verfügt über keine Anmeldedatenfelder. Rufen Sie diese API nicht für |
Die beiden Typ-Strings sind Teil des Vertrags und müssen exakt wie dargestellt geschrieben werden.
Wichtig
Bei diesen Strings wird zwischen Groß- und Kleinschreibung unterschieden. Beispiele finden Sie in der Tabelle unten.
|
Richtig |
Falsch |
|---|---|
|
|
|
|
|
|
Weitere Informationen dazu, warum die Strings genau übereinstimmen müssen, finden Sie unten unter Zwei exakte Typ-Strings, keine Allow-List.
Alle Aufrufe verwenden Authorization: Bearer <jwt>, wobei das JWT aus demselben Verfahren zur Ausgabe von Admin-Token stammt, das Nerdio bereits für alle anderen Features für Partner nutzt:
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; diese Berechtigung ist im Admin-JWT bereits enthalten. 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 eine Anmeldeinformation hinterlegt ist. Die Anmeldeinformation selbst wird von diesem oder einem anderen Endpoint niemals zurückgegeben.
Ein unbekannter oder nie erstellter {type} gibt 404 Not Found zurück.
Um alles aufzulisten, was für das Deployment konfiguriert ist:
GET /api/admin/integrations
Antwort: 200 OK, ein Array mit derselben Struktur, ein Eintrag pro Integrationstyp, der jemals gespeichert wurde (soft-gelöschte 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).
Wichtig
Drei Dinge an diesem Body können leicht falsch gemacht werden:
-
integrationTypeist im Body erforderlich, zusätzlich zur Angabe in der Route. Wird das Feld weggelassen, wird400mit{"errors":{"IntegrationType":["The IntegrationType field is required."]}}zurückgegeben. Sein Wert muss nicht mit der Route übereinstimmen (Nerdio Manager speichert und sucht immer anhand des Routenwerts), aber wenn Sie ihn ganz weglassen, schlägt die Validierung fehl. Senden Sie ihn daher jedes Mal mit. -
credentialsJsonist ein String, der JSON enthält, kein verschachteltes JSON-Objekt. Der Admin-Bildschirm von Nerdio Manager selbst erstellt den Wert vor dem Senden mitJSON.stringify(...). Wenn Sie den Wert als echtes verschachteltes Objekt statt als String senden, erhalten Sie400mit"The JSON value could not be converted to System.String". Für einen rohen HTTP-Client gibt es hier keinen stillen Fehlermodus: Ein falsch geformtescredentialsJsonwird sofort abgelehnt. -
Das Weglassen von
credentialsJsonbei einer bestehenden Integration behält die zuvor gespeicherten Anmeldedaten bei. So schalten SieisEnabledviaPUTum, ohne das Geheimnis zum erneuten Senden zur Hand zu haben. Senden SiecredentialsJsonnur, wenn Sie den gespeicherten Wert tatsächlich ersetzen möchten.
Dieser Aufruf ist ein Upsert: Das erste PUT für einen {type} erstellt ihn, jedes nachfolgende PUT aktualisiert dieselbe Zeile.
PATCH /api/admin/integrations/{type}/toggle
Content-Type: application/json
{ "isEnabled": false }
Antwort: 204 No Content. Ein unbekannter {type} gibt 404 Not Found zurück.
DELETE /api/admin/integrations/{type}
Antwort: 204 No Content bei Erfolg, 404 Not Found, wenn für diesen Typ nichts gespeichert ist. Dies ist ein Soft-Delete: Ein erneuter Aufruf von PUT für denselben {type} erstellt einen brandneuen Datensatz (eine neue integrationId), der gelöschte wird nicht wiederhergestellt.
Nerdio Manager hat keine Möglichkeit, einen HP- oder Lenovo-Schlüssel vor dem Speichern beim Anbieter zu überprüfen. Das Speichern eines falsch eingegebenen oder abgelaufenen Schlüssels wird sofort mit 200 OK und isConfigured: true erfolgreich abgeschlossen – mit genau derselben Antwort, die Sie für einen korrekten Schlüssel erhalten würden.
Der Fehler tritt später und unbemerkt auf: Die nächste geplante Synchronisierung versucht den Anbieteraufruf, dieser schlägt fehl und eine Warnung wird in das Hintergrund-Synchronisierungsprotokoll geschrieben. An den Aufrufer dieser API wird nichts zurückgegeben, und es erscheint keine sichtbare Fehlermeldung. Aus Sicht des Admins ist das einzige sichtbare Symptom, dass die Garantiedaten für diesen Anbieter auf den Geräten einfach nie aufgefüllt werden. Wenn das passiert, überprüfen Sie den Anmeldedatenwert selbst; dass der API-Aufruf 200 zurückgegeben hat, bedeutet nicht, dass der Schlüssel gültig ist.
PUT validiert {type} nicht gegen eine bekannte Liste. PUT /api/admin/integrations/HPWaranty (mit Tippfehler) gibt 200 OK zurück und erstellt eine Zeile, die exakt wie eine korrekt geschriebene aussieht; es gibt kein 404, um den Fehler abzufangen.
Diese Zeile ist dann für den Synchronisierungsjob 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 mit Tippfehler oder falscher Groß-/Kleinschreibung gespeicherte Zeile bei der Überprüfung in Ordnung aussehen. Der Synchronisierungsjob lädt jedoch aktivierte Integrationen und gleicht dann den Typ im Speicher durch einen exakten, die Groß- und Kleinschreibung berücksichtigenden String-Vergleich mit den Literalen "HpWarranty" und "LenovoWarranty" ab. Eine Zeile, die als HPWaranty, hpwarranty oder in einer anderen Variante gespeichert ist, besteht jede leseseitige Prüfung, wird aber bei jeder Synchronisierungsausführung stillschweigend übersprungen.
Wichtig
Es gibt nirgendwo in diesem Pfad einen Fehler: weder bei dem PUT, das die Zeile erstellt hat, noch bei einem späteren GET, noch beim Synchronisierungsjob (der einfach nichts findet, das übereinstimmt, und fortfährt). Die beiden Typ-Strings beim ersten Mal exakt richtig zu haben, ist die einzige Schutzmaßnahme, die heute existiert. Eine robustere und explizitere Fehlerberichterstattung ist für eine zukünftige Version geplant.
|
Status |
Wann |
|---|---|
|
|
Fehlerhafter JSON-Body, |
|
401 Nicht autorisiert |
Fehlendes oder ungültiges Bearer-Token bei jedem |
|
403 Unzulässig |
Das Token ist gültig, aber der User ist kein Instanz-Admin. |
|
404 Nicht gefunden |
|
|
|
|
|
Aktion |
Methode |
Pfad |
Textkörper |
|---|---|---|---|
|
Einen Admin-JWT abrufen |
|
|
|
|
Alle Integrationen auflisten |
|
|
Keine |
|
Status einer Integration abrufen |
|
|
Keine |
|
Anschalten / Anmeldedaten festlegen |
|
|
|
|
Ausschalten / Anschalten, Anmeldedaten beibehalten |
|
|
|
|
Vollständig entfernen |
LÖSCHEN ( |
|
Keine |
{type} ist HpWarranty oder LenovoWarranty. Rufen Sie diese API nicht für DellWarranty auf.
Kommentare (0 Kommentare)