B2B Dokumentation

B2B API – Produktcodes & Lizenzen automatisiert abrufen

Unsere REST-API ermöglicht es verifizierten Geschäftskunden und IT-Resellern, Produktcodes und Lizenzinformationen automatisiert abzurufen und in eigene Systeme zu integrieren.

vpn_key API-Zugang beantragen Geschäftskunden-Seite

Authentifizierung

Alle API-Anfragen erfordern einen gültigen API-Key, der im HTTP-Header mitgesendet wird. API-Keys können nach Verifikation Ihres Unternehmens beantragt werden.

info API-Zugang ist ausschließlich für verifizierte B2B-Kunden und Reseller verfügbar. Zugang beantragen →

Header-Format

HTTP Request Header

X-API-Key: YOUR_API_KEY_HERE
Content-Type: application/json
Accept: application/json

Beispiel mit cURL

cURL

curl -X GET "https://technikcenter24.com/api/v1/orders" \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Base URL

Alle Endpunkte sind relativ zur folgenden Base URL:

Base URL

https://technikcenter24.com/api/v1

Alle Antworten werden als JSON zurückgegeben (Content-Type: application/json).

Rate Limits

Plan	Anfragen / Minute	Anfragen / Tag
Standard B2B	60	5.000
Reseller	120	20.000
Enterprise	individuell	individuell

Bei Überschreitung wird HTTP 429 Too Many Requests zurückgegeben. Der Header Retry-After enthält die Wartezeit in Sekunden.

Fehlercodes

HTTP-Code	Bedeutung
`200 OK`	Anfrage erfolgreich
`400 Bad Request`	Ungültige Parameter
`401 Unauthorized`	Fehlender oder ungültiger API-Key
`403 Forbidden`	Keine Berechtigung für diese Ressource
`404 Not Found`	Ressource nicht gefunden
`429 Too Many Requests`	Rate Limit überschritten
`500 Internal Server Error`	Serverfehler – bitte Support kontaktieren

Fehler-Response Format

JSON

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key."
  }
}

Endpunkt: Bestellungen

GET /api/v1/orders Alle Bestellungen des Accounts

Parameter	Typ	Beschreibung
`page`	integer	Seite (Standard: 1)
`per_page`	integer	Einträge pro Seite (max. 100)
`status`	string	`paid` \| `pending` \| `all`

Beispiel-Response

{
  "success": true,
  "data": {
    "orders": [
      {
        "id": "ORD-12345",
        "status": "paid",
        "total": 49.99,
        "currency": "EUR",
        "created_at": "2026-01-15T10:30:00Z",
        "items_count": 2
      }
    ],
    "pagination": {
      "page": 1,
      "per_page": 20,
      "total": 42
    }
  }
}

GET /api/v1/orders/{order_id} Einzelne Bestellung abrufen

Endpunkt: Produktcodes & Lizenzen

GET /api/v1/orders/{order_id}/codes Alle Codes einer Bestellung

Beispiel-Response

{
  "success": true,
  "data": {
    "order_id": "ORD-12345",
    "codes": [
      {
        "id": "CODE-789",
        "product_name": "Microsoft Office 2024 Professional",
        "product_sku": "MS-OFF-2024-PRO",
        "license_key": "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX",
        "download_url": "https://...",
        "activation_guide_url": "https://...",
        "delivered_at": "2026-01-15T10:31:00Z",
        "status": "active"
      }
    ]
  }
}

GET /api/v1/codes/{code_id} Einzelnen Code abrufen

warning Lizenzschlüssel dürfen ausschließlich für den eigenen Gebrauch oder den genehmigten Weiterverkauf verwendet werden. Eine unerlaubte Weitergabe verstößt gegen die Nutzungsbedingungen.

Endpunkt: Produkte

GET /api/v1/products Produktkatalog abrufen

Parameter	Typ	Beschreibung
`category`	string	Kategorie-Slug filtern
`in_stock`	boolean	Nur verfügbare Produkte
`page`	integer	Seite

Beispiel-Response

{
  "success": true,
  "data": {
    "products": [
      {
        "id": 42,
        "sku": "MS-OFF-2024-PRO",
        "name": "Microsoft Office 2024 Professional",
        "price": 49.99,
        "currency": "EUR",
        "in_stock": true,
        "category": "microsoft-office"
      }
    ]
  }
}

Webhooks

Webhooks ermöglichen es, Echtzeit-Benachrichtigungen zu empfangen, wenn Bestellungen oder Codes bereitgestellt werden. Webhook-URLs können im Kundenkonto hinterlegt werden.

Verfügbare Events

Event	Beschreibung
`order.paid`	Bestellung wurde bezahlt
`codes.delivered`	Codes wurden bereitgestellt
`order.refunded`	Bestellung wurde erstattet

Webhook Payload

POST – Ihr Webhook-Endpoint

{
  "event": "codes.delivered",
  "timestamp": "2026-01-15T10:31:05Z",
  "data": {
    "order_id": "ORD-12345",
    "codes_count": 2
  },
  "signature": "sha256=..."
}

Verifizieren Sie die Signatur mit Ihrem Webhook-Secret: HMAC-SHA256(payload, webhook_secret)

Häufige Fragen

Wie beantrage ich einen API-Key?

Senden Sie eine E-Mail an service@technikcenter24.com mit Ihren Unternehmensdaten. Nach Prüfung erhalten Sie Ihren API-Key innerhalb von 24h.

Welches Format haben die Antworten?

Alle Antworten werden als JSON zurückgegeben. Das Root-Objekt enthält immer success: true/false sowie entweder data oder error.

Kann ich Bestellungen per API aufgeben?

Bestellungen per API sind derzeit nur für Enterprise-Kunden mit Rahmenvertrag verfügbar. Sprechen Sie uns an für ein individuelles Angebot.

Gibt es eine Sandbox-Umgebung?

Eine Sandbox-Umgebung für Testintegration steht auf Anfrage zur Verfügung. Kontaktieren Sie uns für Zugang.