SPARETECH API

Inhaltsverzeichnis
SPARETECH API

Allgemeine Informationen

Die SPARETECH API ist eine Lösung, die die nahtlose Synchronisation von Daten zwischen der SPARETECH-Anwendung und verschiedenen anderen Systemen, einschließlich ERP und MDM, ermöglicht und den Benutzern eine effiziente und problemlose Synchronisation bietet.

Unsere API nutzt REST-Designprinzipien und ermöglicht Ihnen die Verwaltung Ihrer Materialstammdaten. Sie verfügt über ressourcenorientierte URLs, verwendet Standard-HTTPS-Methoden und akzeptiert und liefert JSON-kodierte Anfrage- und Antwortkörper. Die Autorisierung erfolgt mit Standard-JWT-Tokens.

SPARETECH Workflow APIs

Ressourcen Mit dieser API können Sie
Schema das Materialstamm-Konfigurationsschema abrufen, das für weitere Zuordnungen verwendet werden kann
Erstellung von Materialien alle Erstellungsabsichten für die Materialstammerstellung in Ihrem ERP oder MDM synchronisieren
Materialänderung alle Änderungsabsichten für Materialstammänderungen in Ihrem ERP oder MDM synchronisieren
Materialerweiterung alle Erweiterungsabsichten für die Materialstammerweiterung in Ihrem ERP oder MDM synchronisieren
Materialstamm-Aktualisierung den Materialstamm in SPARETECH auf Basis der von Ihrem ERP initiierten Änderungen aktualisieren

Sicherheit und Authentifizierung

Unsere API verwendet den Client Credentials Flow für die Authentifizierung und JWT-Tokens für die Autorisierung. SPARETECH stellt Ihnen Ihre Client-Anmeldeinformationen, ein Paar aus Client ID und Client Secret, für jede Umgebung zur Verfügung. Weitere Einzelheiten zur Authentifizierung Ihrer Anwendung finden Sie im Abschnitt Zugangstoken erhalten.

Testen und experimentieren

Wir stellen Ihnen eine Sandbox-Umgebung zur Verfügung, in der Sie Testdaten erstellen können, während Sie Ihre Integration sicher ausprobieren können, ohne Ihre Live-Daten zu beeinträchtigen. Verwenden Sie die Anwendung, um Ihre Testdaten zu verwalten, und rufen Sie dann die API auf, um Ihre Integration zu testen.

Los geht's

Zugriffstoken erhalten

Um auf Ihre Daten zugreifen zu können, müssen Sie zunächst Ihre Client-Anmeldedaten gegen ein Zugriffstoken austauschen. Dies geschieht durch den Aufruf unseres Authentifizierungsendpunkts.

Beispiel

$ curl 'https://sync.sandbox.sparetech.io/v1/auth' --request POST \
--header 'content-type: application/json' \
--data '{ "client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET" }'

Eine Liste der Erstellungsabsichten abrufen

Jetzt, da Sie ein Zugriffstoken haben, können Sie Erstellungsintentionen anfordern.

$ curl 'https://sync.sandbox.sparetech.io/v1/creation-intents' \
--header "Authorization: Bearer <access_token>"

Ihre Antwort sollte in etwa so aussehen, was Ihnen zeigt, dass eine Absicht vorliegt:

{
 "hasMore": false,
 "totalCount": 1,
 "limit": 10,
 "creationIntents":
[
   {
    "id": "904134",
    "createdAt": "2022-12-10T12:05:12Z",
    "status": "Exported",
    "metadata": {
    "MANU": "Sparetech",
    "ART_NUM": "SED1234",
    "TYP": "TYP_1234",
    "DESC": "Material Description"
   }
  }
 ]
}

Der Inhalt Ihres creationIntents-Metadatenobjekts hängt von Ihrer eigenen Exportkonfiguration ab, und Sie können über den Endpunkt Exportschema auf das gesamte Objekt zugreifen.

Eine Erstellung bestätigen

Nachdem Sie Ihre verfügbaren Erstellungsabsichten aufgelistet haben, können Sie diese bearbeiten und in Ihr System schreiben. Anschließend sollten Sie den Endpunkt Confirm Creation aufrufen, um SPARETECH zu informieren, dass Sie das Material verarbeitet haben. Auf diese Weise stellen Sie sicher, dass Ihre Materialstammdaten zwischen den beiden Systemen synchronisiert sind.

$ curl "https://sync.sandbox.sparetech.io/v1/creation-intents/904134/confirm" \
-X POST \
-H "Authorization: Bearer <access_token>" \
-d "{ \"materialNumber\": \"<YOUR_INTERNAL_REFERENCE>\" }"

YOUR_INTERNAL_REFERENCE ist der Wert, den Sie als Identifikator für dieses Material in Ihrem System verwenden.

Änderung- und Erweiterungsabsichten

Für Änderungsintentionen und Erweiterungsintentionen ist der Prozess sehr ähnlich! Sie brauchen nur die verfügbaren Intents aufzulisten, sie auf Ihr System anzuwenden und die Bestätigungsendpunkte aufzurufen, um die beiden Systeme auf dem gleichen Stand zu halten. Spezifische Informationen über diese beiden Prozesse finden Sie in unserer Dokumentation.

Empfehlungen

  • Speichern Sie Ihre Anmeldedaten und Token sicher und geben Sie sie nur an Dienste weiter, die sie benötigen.
  • Reduzieren Sie unnötige Anrufe, indem Sie das vom Autorisierungsserver erhaltene Zugriffstoken speichern.
  • Für SAP-Kunden, die SAP NetWeaver verwenden: Prüfen Sie Ihre Version, bevor Sie mit der Konfiguration in PI/PO beginnen und ob der REST Adapter den Authentifizierungsfluss für OAuth 2.0 unterstützt.

API Dokumentation

Finden Sie die technische API Dokumention auf dieser Seite.

Danke! Ihre Anfrage ist eingegangen!
Ihre Anfrage konnte leider nicht verarbeitet werden.
Beitrag teilen

Weitere Beiträge

Webinar Ersatzteilmanagement like a Bosch
09
.
Jul
2024

Webinar Ersatzteilmanagement like a Bosch

Erfahren Sie in unserem Webinar, wie Bosch mithilfe von SPARETECH seine Effizienz im Ersatzteilmanagement um 50% steigern konnte.

Mehr lesen
Erfolge und Herausforderungen der KI im Ersatzteilmanagement | SPARETECH Summit 2024
21
.
Jun
2024

Erfolge und Herausforderungen der KI im Ersatzteilmanagement | SPARETECH Summit 2024

Erfahren Sie mehr über aktuelle Entwicklungen und das zukünftige Potenzial von KI im Ersatzteilmanagement und in der Wartung.

Mehr lesen
Digitales und kollaboratives Ersatzteilmanagement | MANN+HUMMEL und SPARETECH
01
.
Jul
2024

Digitales und kollaboratives Ersatzteilmanagement | MANN+HUMMEL und SPARETECH

Erfahren Sie, wie MANN+HUMMEL mit SPARETECH das Ersatzteilmanagement verbessert und die Datentransparenz innerhalb und zwischen den Werken erhöht hat.

Mehr lesen
Das Video kann nur angezeigt werden, wenn Cookies erlaubt sind.