SSLmarket API für Bestellungen der Zertifikate
SSLmarket bringt Ihnen API, die es ermöglicht, Bestellungen von fast allen Zertifikatstypen aus unserem Angebot so einfach wie möglich aufzugeben. Sie kann das Bestellen einer größeren Menge von Zertifikaten beschleunigen und somit können Sie sich den Aufgaben widmen, die für Ihr Business wirklich wichtig sind. In diesem Artikel finden Sie Dokumentation, mit welcher Sie Ihr Bestellen über API starten und Ihre Zeit sparen können werden.
Für eine einfache Implementierung nutzen Sie die Spezifikation OpenAPI und Swagger.
Wie sich die SSLmarket API nutzen lässt
Die SSLmarket API können Sie auf zwei verschiedene Weisen nutzen. Empfehlenswert ist die API in Ihr System oder in Ihre eigene Schnittstelle für die Zertifikatsbestellungen zu implementieren. Dabei hilft Ihnen die hier aufgeführte Dokumentation. Indem Sie die Spezifikation OpenAPI einhalten, werden Sie bei uns eine vollständige Spezifikation generieren können und nachfolgend wird es schon sehr einfach sein, sie zu integrieren.
Die zweite Methode ist für solche Kunden geeignet, die selbst nicht programmieren können oder keinen eigenen Programmierer haben. Mit einem einfachen User Interface einer Drittpartei namens Postman werden Sie über die API Ihre Bestellung einfach aufgeben können, ohne die API auf der Seite des Kunden zu implementieren. Dadurch werden Sie die Arbeit mit Zertifikaten und ihre Verwaltung beschleunigen.
Die Bestellungen werden Sie einfach aufgeben können, ohne die ganze Bestellung durchzugehen, und die ausgestellten Zertifikate werden Sie über die API auch herunterladen können. Wir empfehlen Ihnen, das UI Postman mit unserer eigener Applikation SSLmarket für Windows zu kombinieren.
Fangen Sie mit der SSLmarket API an
Die API von SSLmarket können alle unseren Kunden nutzen. Sie brauchen keine Verträge abzuschließen oder sich mit Formalitäten zu verzögern. Sie brauchen sich nur in Ihr Kundenkonto einzuloggen und unter "Kontoeinstellung" "Zugang zum Kundenportal über API" zu aktivieren. Dadurch wird ein individueller API-Schlüssel zu der SSLmarket API erstellt – und er wird an das gegebene Kundenkonto gebunden.
Die hiesige Dokumentation geben Sie dann Ihrem Programmierer über. Er wird sie aus dem Endpoint openapi-specification, im Format der OpenAPI Spezifikation einlesen können. Das Parameter format kann den Wert json oder yaml haben. Die Antwort gibt es in dem Format application/json oder application/x-yaml.
GET https://www.sslmarket.at/api/openapi-specification/format/json
In diesem Format können Sie die API einfach in Ihre Entwicklungsumgebung oder Tool importieren (zum Beispiel Postman) und mir ihrer Nutzung beginnen. Die API können Sie ebenfalls im Swagger probieren. Sie brauchen nur die URL https://www.sslmarket.cz/api/swagger-ui/ aufzusuchen.
Authentifizierung von Anforderungen
Alle API-Anfragen müssen in dem Header der HTTP-Anfrage das Authentifizierungstoken zum Zugang angegeben haben (X-Auth-Token). Dieses finden Sie in Ihrer Kundenverwaltung nachdem Sie den Zugang zum Kundenportal über API aktiviert haben.
GET /api/order/list HTTP/1.1
Host: sslmarket.at
X-Auth-Token: {{AUTH_TOKEN}}
Rückgabewerte
Nach einem erfolgreichen Aufrufen des Endpoints sendet API den HTTP-Statuscode der Antwort 2XX zurück. Nach einem nicht erfolgreichen Aufruf sendet API den Statuscode der Antwort 4XX zurück; in dem Körper der Antwort finden Sie den Typ des Fehlers (String) und seine Beschreibung.
Zugängliche Funktionen der SSLmarket API
Unten finden Sie eine Liste der Funktionen von API, die Sie für die Bestellungen und Download aller digitalen Zertifikate in unserem Angebot nutzen werden.
Jede Funktion ist über ein eigenes Endpoint erreichbar. Auf dieses Endpoint senden Sie die Anforderung ab, die die für den Aufruf der gegebenen Funktion erforderlichen Parameter enthält. Die Inputparameter werden auf obligatorische, die Sie in der Anforderung absenden müssen, und nicht obligatorische (fakultative) aufgeteilt. In der Spezifikation wird bei jeder Funktion ihre Nutzung aufgeführt, Adresse des Endpoints, Beschreibung der Input- und Outputparameter und das Format der Antwort.
- Generierung der OpenAPI Spezifikation - mit diesem Schritt starten Sie, siehe den Absatz "Fangen Sie mit der SSLmarket API an".
- Liste von Produkten
- E-Mail für DCV erneut senden
- Neue Bestellung aufgeben
- Liste der Bestellungen
- Detail der Bestellung
- Anpassung der Bestellung
- Neuausstellung des Zertifikats
- Neuausstellung des Zertifikats abbrechen
- Widerruf des Zertifikats
- Download des Zertifikats
- CSR-Decoder
- Decoder von Zertifikaten
- OCSP check
Überfordert mit Informationen?
Wir helfen Ihnen mit der Nutzung von API gerne weiter und gerne bekommen wir Ihr Feedback.
+43 1 3053 940
