Die QRtrack API ermöglicht es Ihnen, QR-Codes programmatisch zu erstellen, zu verwalten und Analytics-Daten abzurufen. Alle Requests verwenden JSON und erfordern einen API-Token.
https://qr.bigtex.de/api/v1
Die QRtrack API ermöglicht es Ihnen, QR-Codes programmatisch zu erstellen, zu verwalten und Analytics-Daten abzurufen. Alle Requests verwenden JSON und erfordern einen API-Token.
API-Tokens können im Dashboard unter "Einstellungen → API-Tokens" erstellt werden. Fügen Sie den Token in jeden Request im Authorization Header ein.
Authorization: Bearer IHR_API_TOKEN
curl -X GET "https://qr.bigtex.de/api/v1/qr-codes" \ -H "Authorization: Bearer IHR_API_TOKEN" \ -H "Accept: application/json"
Wichtig: Behandle deinen API-Token wie ein Passwort. Teile ihn niemals öffentlich und committe ihn nicht in Git-Repositories.
/qr-codes
Liste aller QR-Codes des authentifizierten Users abrufen (paginiert).
page - Seitennummer (Standard: 1)per_page - Einträge pro Seite (Standard: 20)/qr-codes
Neuen QR-Code erstellen.
name (string, erforderlich) - Name des QR-Codestarget_url (string, erforderlich) - Ziel-URLfolder_id (integer, optional) - Ordner-IDis_active (boolean, optional) - Aktiv-Status (Standard: true)/qr-codes/{'{id}'}
Details eines spezifischen QR-Codes abrufen.
/qr-codes/{'{id}'}
QR-Code aktualisieren.
name (string, optional) - Name des QR-Codestarget_url (string, optional) - Ziel-URLis_active (boolean, optional) - Aktiv-Status/qr-codes/{'{id}'}
QR-Code löschen (Soft Delete).
/qr-codes/{'{id}'}/stats
Statistiken für einen QR-Code abrufen.
from (date, optional) - Startdatum (Format: YYYY-MM-DD)to (date, optional) - Enddatum (Format: YYYY-MM-DD)curl -X POST "https://qr.bigtex.de/api/v1/qr-codes" \
-H "Authorization: Bearer IHR_API_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Mein QR-Code",
"target_url": "https://example.com"
}'
<?php
$token = 'IHR_API_TOKEN';
$baseUrl = 'https://qr.bigtex.de/api/v1';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . '/qr-codes');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $token,
'Accept: application/json',
]);
$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);
print_r($data);
const token = 'IHR_API_TOKEN';
const baseUrl = 'https://qr.bigtex.de/api/v1';
const response = await fetch(`${baseUrl}/qr-codes`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${token}`,
'Accept': 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({
name: 'Mein QR-Code',
target_url: 'https://example.com'
})
});
const data = await response.json();
console.log(data);
import requests
token = 'IHR_API_TOKEN'
base_url = 'https://qr.bigtex.de/api/v1'
qr_id = 1
headers = {
'Authorization': f'Bearer {token}',
'Accept': 'application/json'
}
params = {
'from': '2025-01-01',
'to': '2025-01-31'
}
response = requests.get(
f'{base_url}/qr-codes/{qr_id}/stats',
headers=headers,
params=params
)
data = response.json()
print(data)
Alle erfolgreichen Antworten werden im JSON-Format mit folgendem Schema zurückgegeben:
{
"data": {
"id": 1,
"name": "Mein QR-Code",
"short_code": "abc123",
"target_url": "https://example.com",
"redirect_url": "https://qr.bigtex.de/r/abc123",
"total_scans": 42,
"unique_scans": 38,
"is_active": true,
"created_at": "2025-01-15T12:00:00Z",
"updated_at": "2025-01-15T12:00:00Z"
}
}
Paginierte Antworten enthalten zusätzlich ein meta-Objekt mit Pagination-Informationen.
Die API verwendet standard HTTP-Statuscodes und gibt Fehlermeldungen im JSON-Format zurück.
400 Bad Request
Ungültige Parameter oder fehlerhafte JSON-Syntax
401 Unauthorized
Fehlender oder ungültiger API-Token
403 Forbidden
Keine Berechtigung für diese Aktion
404 Not Found
Ressource nicht gefunden
429 Too Many Requests
Rate Limit überschritten
{
"message": "Validierungsfehler",
"errors": {
"target_url": [
"Das Feld target_url muss eine gültige URL sein."
]
}
}
Die API ist auf 60 Anfragen pro Minute pro API-Token limitiert. Bei Überschreitung erhältst du einen 429 Too Many Requests Fehler.
X-RateLimit-Limit: 60 - Maximale Anfragen pro MinuteX-RateLimit-Remaining: 45 - Verbleibende AnfragenX-RateLimit-Reset: 1642247340 - Zeitpunkt des Limit-Resets (Unix-Timestamp)Unser Support-Team hilft dir gerne bei der Integration weiter.