Wie Sie unsere API verwenden
1
.
Was ist eine API?
Der Begriff API steht für Application Programming Schnittstelle. Es handelt sich um ein Kommunikationsprotokoll zur Vereinfachung des Datenaustauschs daten zwischen einem Client und einem Server zu vereinfachen. Die kommunikation erfolgt in einem strikten Format, oder es wird eine bestimmte Aktion ausgelöst, so dass sie sich gegenseitig perfekt ergänzen.
Ein API-Schlüssel ist eine eindeutige Kennung der zur Authentifizierung eines Benutzers oder eines programm, das die API aufruft.
2
.
Was bedeutet die API für die Nutzer unserer Plattform?
Das bedeutet, dass Sie die API nutzen können, um einfach daten an unsere Plattform zu senden oder von ihr abzurufen.
Senden Sie Ihre eigenen Daten, um sie mit den Daten zu kombinieren die sich bereits auf unserer Plattform befinden. Dabei kann es sich um Daten aus einem ERP- oder CRM-System oder von Sensoren und Messsystemen sein. Sie können auch Daten anfordern zur Verwendung in Ihrer eigenen Anwendung.
3
.
Wie benutzt man unsere API und den API-Schlüssel?
1. Erstellen eines API-Schlüssel-Erstellung
Da sich die API in einer öffentlichen Beta-Phase befindet, muss der API-Schlüssel per E-Mail unter help@calculus.group angefordert werden. Sie können Kontakt sie können uns eine E-Mail mit der Betreffzeile "Request API-Schlüssel für Calculus". In der E-Mail teilen Sie uns bitte mit, für welches Unternehmen Sie sie den API-Schlüssel benötigen und wofür Sie ihn verwenden wollen.
Bitte beachten! Wenn der API-Schlüssel kompromittiert werden würde, senden Sie uns bitte eine E-Mail an die gleiche Adresse, um den schlüssel zu widerrufen.
2. Verwenden Sie die API, um Daten zu erhalten
Mit der API können Sie Daten von allen Anlagen abrufen, die die mit dem Unternehmen verbunden sind, zu dem der API-Schlüssel gehört. Der API-Endpunkt zum Abrufen von Daten lautet "https://api.calculus.group/asset/{key}". Ersetzen Sie {key} durch den eindeutigen Bezeichner des Assets. Die Aufrufe werden mit der HTTP-Aktion "GET" durchgeführt.
Parameter
|
epochStart
|
Die beginn der Zeitreihe, für die Sie Daten benötigen. Das verwendete Datums-/Zeitformat ist "Epoch", der UNIX-Zeitcode. Unter https://www.epochconverter.com/ finden Sie Tools zur Konvertierung von und nach Epoch. Wenn Sie diesen Parameter verwenden, sollten Sie ihn immer zusammen mit dem Parameter "epochEnd" verwendet werden. Wenn nicht verwendet, werden standardmäßig die letzten 24 Stunden herangezogen. |
|
epochEnd
|
Die ende der Zeitreihe, für die Sie Daten benötigen. Das verwendete Datums-/Zeitformat ist "Epoch", der UNIX-Zeitcode. Unter https://www.epochconverter.com/ finden Sie Tools zur Konvertierung von und nach Epoch. Wenn Sie diesen Parameter verwenden, sollten Sie ihn immer zusammen mit dem Parameter "epochEnd" verwendet werden. Wenn nicht verwendet, werden standardmäßig die letzten 24 Stunden herangezogen. |
Köpfe
In den Kopfzeilen senden Sie den API-Schlüssel an die Calculus-Plattform, um Ihr Gerät zu authentifizieren authentifizieren.
|
CalculusApiKey |
Verwenden Sie den API-Schlüssel, den Sie in Schritt 1 erhalten haben, um sich bei der API zu authentifizieren. |
JSON-Modell
Der Kern der Anfrage ist immer im JSON-Format.
3. Verwenden Sie die API, um Daten zu veröffentlichen
Der API-Endpunkt für die Übermittlung von Daten an unsere Plattform lautet "https://api.calculus.group/General/PostData".
Die Aufrufe erfolgen mit der HTTP-Aktion "POST".
Parameter
|
api-Version
|
Die version der API, die Sie aufrufen möchten. Version 1.0 ist veraltet, Version 2.0 ist derzeit der bevorzugte Weg. Verwenden Sie "api-version=2.0". |
Ein typischer Aufruf wäre ein POST an sein: "https://api.calculus.group/General/PostData?api-version=2.0".
Köpfe
In den Kopfzeilen senden Sie den API-Schlüssel an die Calculus-Plattform, um Ihr Gerät zu authentifizieren authentifizieren.
|
CalculusApiKey |
Verwenden Sie den API-Schlüssel, den Sie in Schritt 1 erhalten haben, um sich bei der API zu authentifizieren. |
4
.
JSON-Modell
Der Kern der Anfrage ist immer im JSON-Format. Die Verwendung von "check-deltas" und "reset-deltas" wird wird verwendet, wenn Werte überlaufen und auf 0 zurückgesetzt werden können. Wenn Sie die korrekten kumulativen Werte, kann dies verwendet werden, um sie in unserem backend zu berechnen. Bitte kontaktieren Sie uns für weitere Informationen, wie Sie dies unter help@calculus.group implementieren können.
Die folgenden Werte können eingestellt werden:
|
gerät |
Name des Geräts des Gateways, dem Sie Daten hinzufügen möchten. Wenn er nicht vorhanden ist, wird das Gateway automatisch hinzugefügt. Verwenden Sie das Präfix, das wir zusammen mit dem API-Schlüssel für das von Ihnen gewählte Gerät, und zwar im folgenden Format: "Präfix_Gateway". |
||||||
|
zeitstempel |
Sekunden seit Jan. 1, 1970 (Epoche). |
||||||
|
check-delta
|
Derzeit nur verfügbar, nachdem ein Messpfad als Delta markiert wurde. Bitte kontaktieren uns für weitere Informationen unter help@calculus.group. |
||||||
|
deltas zurücksetzen |
Derzeit nur verfügbar, nachdem ein Messpfad als Delta markiert wurde. Bitte kontaktieren uns für weitere Informationen unter help@calculus.group. |
||||||
|
messungen |
A array von Messwerten, die Sie hinzufügen möchten. Dies kann einen Wert, einen string-Wert oder beides haben.
|
Beispiel JSON-Körper
{
"Gerät": "prefix_TestDevice",
"check-deltas": true,
"reset-deltas": true,
"timestamp":1573206752,
"Messungen":
[
{
"Pfad": "Messung_1",
"Wert": 1
},
{
"Pfad": "Messung-2",
"stringValue": "OFF"
},
{
"Pfad": "temp|measurement.3",
"Wert": 9,4,
"stringValue": "BROKEN"
},
{
"Pfad": "temp|measurement.4",
"Wert": 11,4,
"stringValue": "OVERLOAD"
}
]
}