Ping


Beschreibung

Mit dieser Methode können Sie die Systemzeit der API abrufen.

  • Diese Methode benötigt keine Authentifizierung.
  • Der Server synchronisiert seine Zeit über NTP, sie können die Antwort daher auch als Normalzeitquelle verwenden wenn Sie keinen Zugriff auf einen NTP-Server haben.

Anfrage

Syntax

GET /v2/ping HTTP/1.1
Host: api.cobai.com
Content-Length: 0
Date: Datum/Uhrzeit

Request-Parameter

Diese Methode benutzt keine zusätzlichen Request-Parameter

Request-Header

Diese Methode benutzt zusätzlich zu den Standard-Requestheadern keine weiteren Header.

Request-Body

Diese Methode verwendet keinen Request-Body

Antwort

Als Antwort erhalten Sie ein XML-Dokument mit der aktuellen Systemzeit des API-Servers. Diese Zeit können Sie z.B. bei der Erzeugung einer API-Signatur als Zeitbasis verwenden.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pingResponse>
  <localTime>2011-01-29T13:23:56.750+01:00</localTime>
</pingResponse>
Das Antwortdokument wird zukünftig um zusätzliche Felder erweitert. Verwenden Sie daher einen geeigneten XML-Parser um die Zeitinformation auszulesen.

Antwortelemente

Name Inhalt
localTimeDie aktuelle Systemzeit des API-Servers.