namensschild.ionamensschild.io
REST-API · Code & No-Code

Namensschilder direkt aus deinem System.

Sprich die REST-API aus jeder Umgebung an – ob mit TypeScript, PHP, Python und Node.js oder ganz ohne Code über Tools wie Zapier, Make, WordPress und Webflow. Eine CSV rein, ein druckfertiges PDF raus – ohne einen einzigen Editor-Klick.

Zur Dokumentation

Zwei Wege zur Integration

Wähle den Weg, der zu deinem Use Case passt – oder kombiniere beide.

REST-API

Für Backends, Automatisierung und Server-zu-Server-Flows.

  • Server-zu-Server, kein Frontend nötig
  • Massenexport tausender Schilder in einem Request
  • Webhooks für asynchrone Workflows
  • Idempotency-Keys gegen Doppelabbuchung
  • OpenAPI 3.1 → SDK in jeder Sprache

Typische Use Cases: HR-Onboarding, wiederkehrende Konferenzen, Online-Anmeldungen mit auto-generierten Schildern, Druckereien.

Embed-Status

Öffentlicher, frontend-sicherer Embed-Vertrag noch nicht freigegeben.

  • Aktueller Status transparent dokumentiert
  • Klare Sicherheitsgrenze für Secret Keys
  • Empfohlener Server-zu-Server-Pfad bis zur Freigabe
  • Geeignet für interne Architektur-Entscheidungen
  • Kein öffentlicher Browser-Key-Vertrag in v1

Relevant für Teams, die ein Widget, iframe oder Frontend-Upload für Endnutzer:innen planen und die Freigabegrenzen sauber verstehen müssen.

Häufige Entwickler-Fragen

Themen, die typischerweise beim Aufsetzen der Integration auftauchen.

Ja. Lege im Dashboard einen Test-Key (ns_test_…) an – Live- und Test-Keys verwaltest du dort getrennt. Damit sprichst du denselben Endpunkt an, ohne Credits zu verbrauchen – die generierten PDFs tragen ein namensschild.io-Wasserzeichen. Die Umgebung wird allein am Schlüssel-Prefix erkannt (ns_test_… bzw. ns_live_…); einen separaten Parameter gibt es nicht.

$ curl -X POST \

-F "csv=@list.csv" \

https://api.namensschild.io/v1/generate

→ 200 OK

application/pdf

Direkt mit dem Team sprechen?

Komplexe Integration, sehr hohes Volumen oder besondere Anforderungen? Unser Team antwortet in der Regel innerhalb eines Werktages.

Team kontaktieren

Starte direkt los mit diesen Namensschildpapieren

Im Editor gibt es bereits fertige Vorlagen, die auf diese Papiere angepasst sind. Alternativ kannst du im Editor auch deine eigenen Maße angeben.

* Bei Käufen über diese Links erhalten wir ggf. eine Provision. Dir entstehen dadurch keine Mehrkosten.

Starte deine Integration in 5 Minuten.

Free-Tier mit 25 Credits – ohne Kreditkarte. API-Key sofort verfügbar.

Wir respektieren deine Privatsphäre

Wir messen die Nutzung von namensschild.io standardmäßig nur anonym und ohne Cookies. Für genauere, geräteübergreifende Statistiken setzen wir – nur mit deiner Einwilligung – Cookies ein. Mehr dazu in unserer Datenschutzerklärung.