NAMES LEGAL für Entwickler#
Bauen Sie auf NAMES LEGAL auf – aus Ihrer eigenen Anwendung heraus: Lesen und Schreiben des Inhalts einer Website, Verkauf von NAMES LEGAL an Ihre Nutzer, ohne dass diese Ihr Produkt verlassen, und Befüllen ihrer Website mit den Daten, die Sie bereits besitzen.
Drei Wege der Integration#
| Sie möchten… | Verwenden Sie | Wer richtet es ein |
|---|---|---|
| Den Inhalt einer Website (Team, Dienstleistungen, News…) per Code lesen oder schreiben | Website-API | Der Website-Inhaber erstellt einen API-Schlüssel in seiner Konsole |
| Ihre Nutzer eine NAMES LEGAL-Website innerhalb Ihrer Anwendung kaufen lassen | Eingebetteter Kauf | NAMES LEGAL erstellt einen Vertriebskanal für Sie; Sie fügen eine Zeile ein |
| Eine Website mit Ihren eigenen Daten (Tabelle oder API) befüllen und aktualisieren | Datenkonnektor | Der Website-Inhaber verbindet Ihre API in seiner Konsole; Sie stellen einen Feed bereit |
Alle drei lassen sich kombinieren. Eine typische Plattform-Integration sieht so aus:
- Ihr Nutzer klickt in Ihrer Anwendung auf Meine Website erstellen: Das Fenster für den eingebetteten Kauf öffnet sich, er wählt einen Plan und bezahlt.
- Sobald die Website bereit ist, erhält Ihr Server ein signiertes
site.ready-Webhook mit der Adresse der Website und Ihrer eigenen Referenz für diesen Nutzer. - Der Website-Inhaber verbindet Ihre Anwendung in seiner Konsole als Datenquelle. Wenn Ihre API dem NAMES LEGAL-Feed-Format folgt, wird jede Sammlung automatisch verknüpft: Lehrkräfte werden zum Team, Kurse werden zu Dienstleistungen, News werden zu Blogbeiträgen.
- Von da an aktualisiert sich die Website selbst – stündlich, täglich oder sofort, wenn Sie ihre Webhook-Adresse aufrufen.
Wichtige Fakten#
- Jede Website ist unabhängig. Jede NAMES LEGAL-Website hat ihre eigene Adresse (
https://<site>.names.legaloder eine eigene Domain), ihre eigenen Daten und ihre eigenen API-Schlüssel. Es gibt keine globale API, die alle Websites erreicht. - Die Abrechnung bleibt bei NAMES LEGAL. Ein Nutzer, der über Ihre Anwendung kauft, wird zu einem NAMES LEGAL-Kunden, der von NAMES LEGAL abgerechnet wird. Sie haben nie mit Zahlungen oder Kartendaten zu tun.
- White-Label per Design. Besucher einer Website sehen niemals eine NAMES LEGAL-Markierung, die von diesen Integrationen stammt.
- Sechs Sprachen. Die Plattform, das Kauffenster und das Inhaltsmodell unterstützen Englisch, Französisch, Deutsch, Italienisch, Spanisch und Portugiesisch.
In dieser Dokumentation verwendete Konventionen#
<site>ist die Adresse einer NAMES LEGAL-Website, zum Beispielhttps://ecolehorizon.names.legal.- Daten folgen ISO 8601:
2026-09-24oder2026-09-24T14:02:11+02:00. - Alle Anfragen und Antworten verwenden UTF-8-JSON, sofern nicht anders angegeben.