Zum Hauptinhalt gehen

Requests

Host / URL

Die URL für API-Anfragen hängt von der Basisdomäne Ihres Systems ab und setzt sich wie folgt zusammen:

https://<system_id>.<server_id>.quentn.com/public/api/<api_version>/<api_endpoint>

Hinweis: Der HTTP-Host deiner API-URL ist derselbe wie in deiner Anmelde-URL.

Achtung: Alle Anfragen müssen über HTTPS gestellt werden. HTTP wird nicht unterstützt.

Authentication

Jede API-Anfrage, die du stellst, muss authentifiziert werden, indem du einen Autorisierungs-Header mit deinem API-Schlüssel hinzufügst. Du findest deinen System-API-Schlüssel in deinen Kontoeinstellungen.

Example header:

POST https://your-api-domain-HERE.tdl
Authorization: Bearer Your.API.Key-HERE

Example with cURL:

curl -X "POST" "https://your-api-domain-HERE.tdl" -H "Authorization: 
Bearer Your.API.Key-HERE" -H "Content-Type: application/json"

HTTP Verbs

Je nach Ressource unterstützen wir die folgenden HTTP-Verben:

Verb Description
GET Retrieve a resource or group of resouces
POST Create a new resource 
PUT Update an existing resource
DELETE Delete an existing resource 

Request Body

Wenn du Daten über POST- oder PUT-Anforderungen übermittelst, musst du deine Nutzdaten im JSON-Format übermitteln.

Example request:

GET https://<system_id>.<server_id>.quentn.com/public/api?limit=200&offset=15 HTTP/1.1
Parameter Description
limit The number of records to return
offset The number of records to skip

Verwandte Beiträge