Für Entwickler

API-Integration

Automatisieren Sie die Kartenproduktion aus Ihrem System heraus. REST-API, Webhooks, vollständige Dokumentation.

Zur Dokumentation Mit einem Ingenieur sprechen

Schnelle Integration

Einfach zu integrieren

Eine HTTP-Anfrage genügt, um Druck, NFC-Codierung und Versand einer Karte auszulösen. Webhooks für die Verfolgung in Echtzeit.

REST-API mit Authentifizierung per API-Schlüssel
Webhooks für Statusaktualisierungen in Echtzeit
Vollständige Sandbox zum kostenlosen Testen
Vollständige OpenAPI-Dokumentation (Swagger)
Standardisierte und paginierte JSON-Antworten
Idempotenz bei Anfragen zur Erstellung

// Eine Kartenbestellung anlegen

POST https://api.printags.com/v1/orders

{
  "card_type": "ntag213",
  "design": {
    "template_id": "tpl_abc123",
    "variables": {
      "name": "Jean Dupont",
      "title": "Directeur technique",
      "photo": "https://..."
    }
  },
  "nfc": {
    "url": "https://example.com/jean"
  },
  "shipping": {
    "name": "Jean Dupont",
    "address": "12 rue de la Paix",
    "city": "Paris",
    "country": "FR"
  }
}

Architektur

Integrationsarchitektur

Ihr System kommuniziert mit der Printags-API. Um alles Weitere kümmern wir uns.

Ihr System

ERP, CRM, E-Commerce, SaaS

API RESTWebhooks

Printags

Druck + Codierung + Versand

API-Referenz

Die wichtigsten Endpunkte

POST/v1/ordersEine Bestellung anlegen

GET/v1/orders/:idStatus einer Bestellung

GET/v1/orders/:id/trackingSendungsverfolgung

POST/v1/designsEin Design hochladen

GET/v1/templatesTemplates auflisten

POST/v1/webhooksEinen Webhook einrichten

GET/v1/cards/:idDetails einer Karte

GET/v1/billing/usageMonatlicher Verbrauch

Webhooks

Benachrichtigungen in Echtzeit

Erhalten Sie bei jeder Statusänderung eine automatische Benachrichtigung. Richten Sie Ihre Webhooks über die API oder das Dashboard ein.

order.created

Bestellung eingegangen und bestätigt

order.printing

Druck läuft

order.encoding

NFC-Codierung läuft

order.quality_check

Qualitätskontrolle bestanden

order.shipped

Paket versendet, Sendungsnummer verfügbar

order.delivered

Zustellung bestätigt

Sandbox & Sicherheit

Testen Sie gefahrlos

Die Sandbox-Umgebung bildet die Produktions-API nach. Testen Sie Ihre Integration ohne Kosten und ohne Risiko.

Sandbox identisch mit der Produktion
Getrennte API-Schlüssel (Test / Produktion)
HTTPS verpflichtend auf allen Endpunkten
Konfigurierbares Rate Limiting
Logs und Verlauf aller Anfragen

Integrationsszenarien

Wie unsere Integratoren die API nutzen

E-Commerce

Ein Kunde bestellt eine Karte in Ihrem Shop. Die API löst Produktion und Versand automatisch aus.

SaaS / Plattform

Ihre Plattform verwaltet Mitglieder. Bei jeder Anmeldung wird automatisch eine Karte gedruckt und versendet.

HR / Corporate

Neue Mitarbeitende = automatischer Ausweis. Die API lässt sich an Ihr HR-System anbinden, um die Produktion auszulösen.

IoT / Ladestationen

Neuer Abonnent in Ihrem Ladenetz = NFC-Badge, automatisch über die API gedruckt und versendet.

Veranstaltungen

Online-Anmeldungen = personalisierte Badges, vor der Veranstaltung produziert und an die Teilnehmenden versendet.

Treueprogramm

Neues Mitglied in Ihrem Programm = NFC-Kundenkarte, gedruckt mit variablen Daten und Codierung.

Häufige Fragen

FAQ — API-Integration

Wie lange dauert die Integration?

Die meisten unserer Integratoren sind in weniger als einem Tag einsatzbereit. Die Dokumentation ist vollständig und enthält Codebeispiele in mehreren Sprachen. Eine Sandbox-Umgebung steht sofort bereit.

Gibt es SDKs?

Die API ist eine gewöhnliche REST-API (JSON über HTTPS). Sie ist mit allen Sprachen und Frameworks kompatibel. Wir stellen Codebeispiele und Postman-Collections bereit, damit Sie schnell starten können.

Ist die API rund um die Uhr verfügbar?

Ja, die API ist 24 Stunden am Tag, 7 Tage die Woche verfügbar. Wir garantieren ein SLA von 99,9 % Verfügbarkeit. Den aktuellen Status finden Sie auf unserer Statusseite.

Wie funktioniert die Abrechnung?

Monatliches Abonnement + Stückpreis pro Karte. Über den API-Endpunkt /v1/billing/usage verfolgen Sie Ihren Verbrauch in Echtzeit. Automatische Abrechnung zum Monatsende.

Sind die übermittelten Daten sicher?

Ja. HTTPS ist auf allen Endpunkten verpflichtend. Personenbezogene Daten (Fotos, Namen) werden verschlüsselt gespeichert und nach der Produktion gelöscht. DSGVO-konform.

Kann ich die API-Aufrufe meiner Nutzer begrenzen?

Ja, das Rate Limiting ist konfigurierbar. Standardmäßig sind es 100 Anfragen pro Minute. Je nach Tarif anpassbar.

Bereit für die Integration?

Erstellen Sie Ihr Konto und greifen Sie in 2 Minuten auf die Sandbox zu. Vollständige Dokumentation verfügbar.

Integrator-Konto erstellen API-Dokumentation