# So verbinden Sie eine Anwendung mit ShareAI Builder, Schritt für Schritt

Erstellen Sie eine Termin-App, die Kunden mit ShareAI verbindet, nützliche KI-Agenden vorbereitet und ihnen die Kontrolle über ihre KI-Ausgaben gibt.

45–60 Minuten · 18 praktische Schritte · Anwendungsentwickler · Node.js-Beispiel

IHRE IMPLEMENTIERUNG

## Eine Kundenverbindung, auf der Sie aufbauen können.

Drei konkrete Ergebnisse: den Kunden verbinden, seinen Termin vorbereiten und die Integration zur Überprüfung bereitstellen.

### Anmeldung und erneuerbare Sitzungen

Ein Kunde wählt sein ShareAI-Konto aus, genehmigt Ihre App und kehrt zu JamZY zurück.

**Sie können es überprüfen, wenn**

Melden Sie sich an, aktualisieren Sie die Sitzung und trennen Sie erfolgreich.

### Ein nützlicher Vorbereitungsentwurf

Wandeln Sie ein Terminziel durch eine gezielte KI-Anfrage in eine Agenda und Fragen um.

**Sie können es überprüfen, wenn**

Erstellen Sie einen Entwurf; das Speichern eines Termins löst keinen KI-Aufruf aus.

### Eine Einrichtung, die Sie überprüfen können

Erklären Sie optionale KI-Gebühren und sammeln Sie die Plattformprüfungen, die Ihre Überprüfungseinreichung benötigt.

**Sie können es überprüfen, wenn**

Jede eingeschlossene Plattform und angeforderte Berechtigung hat aufgezeichnete Prüfungen.

## Sehen Sie, was Sie bauen werden

Sie werden eine Verbindung aufbauen, die Ihre Kunden verstehen können: ihr ShareAI-Konto, ein optionaler KI-Vorbereitungsentwurf und ein klarer Weg zurück zu ihrem Termin.

Wo Sie arbeiten werden Ihr fertiges Beispiel

Verbinden Sie Ihre Anwendung mit ShareAI Builder, von der Anmeldung bis zu einer getesteten Integration, die zur Überprüfung bereit ist. Diese Anleitung verwendet JamZY, eine kleine Node.js-Termin-Anwendung, um jeden Schritt zu zeigen: Registrieren Sie die App, konfigurieren Sie ihre Web-Plattform, verbinden Sie das ShareAI-Konto eines Kunden und senden Sie eine autorisierte KI-Anfrage. Wenden Sie die gleichen Schritte auf Ihr eigenes Produkt an.

| Fähigkeit | Was der Kunde zustimmt | Was JamZY demonstriert |
| --- | --- | --- |
| Anmeldung mit ShareAI | Eine Kontoverbindung und die Identitätsinformationen, die Ihre App anfordert. | Eine private Kundenidentität aus authentifizierten Benutzerinformationen. |
| Bezahlen mit ShareAI · KI-Nutzung | Verwendung des vom Kunden ausgewählten persönlichen oder Organisationskontos für autorisierte Schlussfolgerungen. | Ein Terminvorbereitungsentwurf, der durch die berechtigten Credits dieses Kontos finanziert wird. |
| Builder Aufschlag | Die zusätzliche Gebühr für die KI-Nutzung im akzeptierten Anwendungsvertrag. | Optionale Nutzungsmonetarisierung nach Genehmigung und Veröffentlichung des Vertrags. |
| Produktzahlungen | Ein bestimmter Kauf, der in einem separaten ShareAI-Checkout präsentiert wird. | Eine Erweiterung, die im [Zahlungsleitfaden erklärt wird](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/). Die Termin-Demo implementiert keinen Checkout. |

Haben Sie ein ShareAI-Konto, die Berechtigung zur Nutzung des persönlichen oder Organisationskontos, das die App besitzen wird, einen öffentlichen HTTPS-Callback, ein Logo sowie funktionierende Datenschutz-, Nutzungsbedingungen- und Kontolöschungsseiten. Um das Beispiel auszuführen, verwenden Sie Node.js 22 oder neuer und eine HTTPS-Adresse für Ihre Anwendung.

JamZY · Referenzanwendung für Termine [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LnBuZw.DZt_5dnvNF40T34-7MJsXw?v=219eca92cbe5)

Lokale Terminplanung und kundenfinanzierte KI-Vorbereitung sind separate Aktionen. Diese Demo sendet keine Kalendereinladung.

1. Wählen Sie den Termin-Typ und die Dauer aus.
2. Wählen Sie einen verfügbaren Demo-Slot aus.
3. Verbinden Sie ShareAI, um den optionalen KI-Assistenten zu nutzen.
4. KI wird nur nach dieser expliziten Aktion ausgeführt; allein die Buchung ruft ShareAI nicht auf.

**Verwenden Sie Ihre eigenen App-Details**

Screenshots verwenden Anwendungsdetails als Beispiel. ShareAI-Adressen in diesem Leitfaden sind Produktionsadressen. Die Vorbereitungsgenerierung stellt eine echte KI-Anfrage und kann Credits verbrauchen; das Auswählen oder Speichern eines Demo-Termins tut dies nicht. Verifizierungsprüfungen werden durch Ihre eigenen erfolgreichen Integrationstests abgeschlossen.

**Sie sind bereit, fortzufahren, wenn**

Sie können Kontoanmeldung, KI-Verbrauch, optionale Zusatzgebühr und einen bestätigten Produktkauf unterscheiden. Das Lesen dieses Leitfadens erfordert keine bezahlte Anfrage.

## Treten Sie dem Builder-Programm bei

Sie erstellen die Builder-Identität, die Ihre Anwendung und ihre Kundenbeziehungen besitzt.

Wo Sie arbeiten werden Konsole → Builder Program

1. Erstellen oder melden Sie sich bei Ihrem ShareAI-Konto an. Wählen Sie das persönliche oder Organisationskonto aus, das JamZY besitzen wird; verwenden Sie dasselbe Konto während der gesamten Einrichtung.
2. Öffnen [Builder Program in der ShareAI-Konsole](https://console.shareai.now/app/builder/)Wählen Sie die Builder-Aktivitäten aus, die zu Ihrer Arbeit passen. Für diesen Leitfaden wählen Sie den Produktunternehmen-Pfad für eine Anwendung, die Sie besitzen. Client Work ist für Dienstleistungen, die einem Kunden geliefert werden; eine Integration verbindet eine bestehende Anwendung.
3. Wählen Sie das persönliche oder Organisationskonto aus, das die Programmanmeldung besitzen wird, bevor Sie sich bewerben. Organisationen können eine Bewerbung vor der Verifizierung einreichen, aber die Genehmigung durch das Personal allein aktiviert den Zugriff nicht. Schließen Sie die Verifizierung der Organisations-E-Mail und der Unternehmensdaten aus der Onboarding-Checkliste in der Konsole ab. Eine genehmigte Organisation bleibt "Ausstehende Verifizierung", bis beide Prüfungen abgeschlossen sind. Builder, Anbieter- und Creator-Programme folgen dieser Regel.
4. Nach der Annahme öffnen Sie Builder Program → Produkt. Der Akteur-Umschalter identifiziert das Konto, das Sie bearbeiten.

Builder Program · Registrierungseinstiegspunkt [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Vucm9sbG1lbnQucG5n.qBq2qLDjzgk2_IqYv0zTco?v=2e8bf9ef5454)

Beginnen Sie mit dem Produktpfad und schließen Sie dann die Anmeldung für das Konto ab, das JamZY besitzen wird.

1. Fahren Sie in der Console fort, um sich für die Builder Program anzumelden.

**Sie sind bereit, fortzufahren, wenn**

Builder Program öffnet sich für den vorgesehenen Besitzer und bietet Neue App. Eine Einschreibungsentscheidung, Anwendungsprüfung, Überprüfung öffentlicher Informationen und Monetization Gateway Genehmigung sind separate Schritte.

Brauchen Sie die Details?[Builder-Programm ↗](https://shareai.now/builders/join/)[Builder-Dokumentation ↗](https://shareai.now/docs/builders/)

## Erstellen Sie Ihre Anwendung

Sie geben JamZY einen eigenen Anwendungsdatensatz, sodass Identität, Zugriff und kommerzielle Bedingungen zusammenbleiben.

Wo Sie arbeiten werden Builder Program → Produkt → Neue App

1. Wählen Sie in Produkt Neue App aus. Geben Sie Ihre öffentliche Website ein, um anfängliche Details auszufüllen, oder wählen Sie Ich werde sie manuell schreiben.
2. Laden Sie ein PNG- oder JPEG-Logo hoch, geben Sie JamZY als Namen ein und beschreiben Sie das Produkt in einem klaren Satz. Überprüfen Sie die Website und die Builder-Kontakt-E-Mail.
3. Fahren Sie mit den Einrichtungsfragen fort. Halten Sie die Antworten wahrheitsgemäß: Sie beschreiben, wie die Anwendung geliefert und bezahlt wird.

Anwendungseinrichtung · Details [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NyZWF0ZS1hcHAucG5n.26JD5PFhP3AdM9h-QLR4jI?v=89dd90b67cd9)

Überprüfen Sie den App-Namen, die Einführung, das Logo und die öffentliche Website, bevor Sie fortfahren. Die Kontaktdaten sind illustrativ.

1. Geben Sie der Anwendung einen klaren Namen.
2. Fahren Sie mit den Onboarding-Fragen fort.

Verwenden Sie eine erreichbare öffentliche Website für das Anwendungsprofil. Eine private oder nur lokal verfügbare Website kann die Validierung nicht bestehen, selbst wenn Ihr Entwicklungs-Callback korrekt registriert ist. Die neue Anwendung beginnt als Entwurf. Sie können die Bearbeitung fortsetzen, ohne sie öffentlich zu machen. Ihre Anwendungskennung unterscheidet sich von einer OAuth-Client-ID oder einer Abonnement-ID.

**Sie sind bereit, fortzufahren, wenn**

JamZY erscheint unter Produkt für den vorgesehenen Besitzer. Erstellen Sie keine zusätzliche Anwendung für jede Geräteplattform.

Brauchen Sie die Details?[Registrierungsreferenz ↗](https://shareai.now/docs/api/builders/auth/register-application/)[Leitfaden zur öffentlichen Präsentation ↗](https://shareai.now/application-guidance/)

## Beschreiben Sie, wie Ihre App bereitgestellt wird

Sie erhalten OAuth-Optionen, die zu dem Ort passen, an dem Ihre App ausgeführt wird, und zu denjenigen, die ihre Anmeldeinformationen kontrollieren.

Wo Sie arbeiten werden Neue App → Anwendungseinrichtung

Für eine JamZY-Bereitstellung, die Sie selbst betreiben, wählen Sie das Preismodell, das zu Ihrem Angebot passt: SaaS, Anbieter-gehostete Cloud-App, Der Kunde zahlt für seinen eigenen Verbrauch, und ShareAI für KI-Anfragen. Dies sind Beispielantworten, keine Anforderungen für jedes Produkt.

Anwendungseinrichtung · Bereitstellung [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2RlcGxveW1lbnQucG5n.z2CCFEuD_5FSexYeMPd83A?v=a4e84e4528c3)

Die Onboarding-Antwort bestimmt, ob ein Server-Client-Secret verfügbar ist.

1. Wählen Sie aus, wo Ihre Anwendung tatsächlich ausgeführt wird.

| Wo die App ausgeführt wird | OAuth-Auswahl | Wo Anmeldedaten gespeichert werden |
| --- | --- | --- |
| Ihr gehostetes Backend | Ein Webserver-Client kann ein Client-Secret verwenden. PKCE gilt weiterhin. | Das Secret und die Tokens bleiben auf Ihrem Server. |
| Browser-Anwendung / SPA | Öffentlicher Web-Client mit PKCE. | Kein eingebettetes Client-Secret. Verwenden Sie ein geeignetes Browser- oder Backend-Sitzungsdesign. |
| Selbstgehostete oder hybride Verteilung | Öffentlicher Client mit PKCE gemäß der Onboarding-Richtlinie. | Verteilen Sie kein gemeinsames Anbieter-Secret an Kundeninstallationen. |
| Windows, macOS, Linux, Android oder iOS | Ein öffentlicher Client für jede aktivierte Plattform. | PKCE und plattformgerechte sichere Speicherung; kein gebündeltes Secret. |

Das herunterladbare JamZY-Beispiel verwendet absichtlich einen öffentlichen Web-Client mit PKCE, obwohl es ein kleines Backend hat. Der Server hält Tokens aus dem Browser-Speicher heraus. Eine Anbieter-gehostete Antwort erlaubt einen Server-Client; sie zwingt Sie jedoch nicht, einen auszuwählen.

Sie können die gespeicherten Antworten unter Anwendungsinformationen → Anwendungseinrichtung erneut aufrufen. Änderungen an der Bereitstellung können inkompatible Client-Secrets entfernen und eine erneute Verifizierung erfordern. Überprüfen Sie diese Auswirkungen, bevor Sie speichern.

**Sie sind bereit, fortzufahren, wenn**

Die gespeicherte Bereitstellung beschreibt Ihre tatsächliche Architektur. Die Client-Secret-Option folgt dieser Antwort; eine deaktivierte Option ist eine Erklärung der Richtlinie, kein fehlendes Anmeldedatum.

Brauchen Sie die Details?[Client-Registrierung ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Stellen Sie Ihre Anwendung klar vor

Sie geben den Kunden die Produktdetails und Richtlinien, die sie benötigen, bevor sie sich entscheiden, eine Verbindung herzustellen.

Wo Sie arbeiten werden Anwendungsinformationen

Öffnen Sie Anwendungsinformationen nach dem Dashboard. Arbeiten Sie die dedizierten Abschnitte durch: Details, Anwendungseinrichtung, Präsentation, Branding, Galerie und Überprüfung. Geben Sie dem Produkt eine nützliche Beschreibung, eine genaue Website und klare Screenshots des Kunden-Workflows.

Anwendungsinformationen [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2luZm9ybWF0aW9uLnBuZw.gTT43COTCGPlcpxLYXCMCb?v=0ed11c1d57c9)

Geben Sie Ihrer Anwendung einen eigenen Namen, eine Einführung und eine öffentliche HTTPS-Website.

1. Entwickeln Sie die Details, Einrichtung, Präsentation und das Branding in eigenen Abschnitten.

Verwenden Sie Ihre eigene App-Identität. ShareAI-Branding gehört auf die Integrationsschaltfläche und das erläuternde Material; es sollte nicht Ihr Produktlogo ersetzen. Halten Sie Datenschutz-, Nutzungsbedingungen- und Löschlinks ohne Anmeldung erreichbar.

Speichern Sie Änderungen, wenn die schwebende Speicheraktion erscheint. Der Vorschlag für öffentliche Informationen hat eine eigene Überprüfung; das Bearbeiten eines genehmigten Vorschlags ersetzt nicht stillschweigend die Live-Öffentlichkeitspräsentation.

**Sie sind bereit, fortzufahren, wenn**

Ein Besucher kann verstehen, was JamZY tut, wer es betreibt und wie man eine Löschung beantragt. Öffentliche Details und Callback-Konfiguration beziehen sich auf dasselbe Produkt.

Brauchen Sie die Details?[Präsentations-Checkliste ↗](https://shareai.now/application-guidance/)[Logos & Schaltflächenverwendung ↗](https://shareai.now/brand-guidance/)

## Wählen Sie aus, was Kunden autorisieren können

Sie werden die Zugriffsrechte anfordern, die Ihre Termin-Erfahrung tatsächlich nutzt, und den Zweck der Abrechnung klarstellen.

Wo Sie arbeiten werden Anwendung → Anwendungsfälle

In Anwendungsfällen aktivieren Sie Login mit ShareAI für die Kontoverbindung und Pay with ShareAI für den kundenfinanzierten Ablauf, den Sie unterstützen möchten. Beantragen Sie Monetization Gateway-Zugriff nur, wenn Ihr Produkt eine zusätzliche Gebühr für die Nutzung von KI einbringen wird. Folgen Sie dem Genehmigungsstatus, der in der Konsole angezeigt wird.

Anwendungsfälle [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3VzZS1jYXNlcy5wbmc.zRU3Lp1TsQuYD7ClWUWS-X?v=090d8c81e6da)

Log-in with ShareAI, Pay with ShareAI und Monetization Gateway haben separate Konfigurations- und Genehmigungszustände.

1. Konfigurieren Sie die Anmeldung mit ShareAI.
2. Aktivieren Sie die nutzerfinanzierte Nutzung.

| Umfang | Warum Sie ihn anfordern würden |
| --- | --- |
| `openid` | Verbinden Sie ein Konto mit seiner client-spezifischen Identität. |
| `profile` / `email` | Fordern Sie Profil- oder E-Mail-Ansprüche nur an, wenn Ihr Produkt diese benötigt. |
| `inference` | Rufen Sie unterstützte KI-Inferenz-Endpunkte auf, wenn dies durch die Anwendungskonfiguration erlaubt ist. |
| `monetization_gateway` | Verwenden Sie die vom Kunden akzeptierte KI-Abrechnungsvereinbarung für Zuschlags-Inferenz. |
| `payments` | Erstellen und überprüfen Sie Kunden-Zahlungsanforderungen. Jeder Kauf muss dennoch bestätigt werden. |

JamZY-Anfragen `openid profile inference monetization_gateway`. Es fordert nicht an `payments` und verkauft kein Produkt über den Checkout. Das Aktivieren einer Funktion in Console gewährt sie nicht automatisch einem bestehenden Zugriffstoken: Der Kunde muss die Bereiche und Bedingungen autorisieren.

**Sie sind bereit, fortzufahren, wenn**

Die Funktionen, konfigurierten Bereiche und die Autorisierungsanfrage stimmen überein. Vermeiden Sie es, optionalen Zugriff anzufordern, den Ihre App niemals nutzt oder nicht überprüfen kann.

Brauchen Sie die Details?[Bereichsreferenz ↗](https://shareai.now/docs/api/builders/auth/scopes/)[Zahlungen & Zuschlagsanleitung ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)

## Richten Sie Ihre Web-Integration ein

Sie erstellen einen Web-Client für die browserbasierte JamZY-Erfahrung mit der richtigen Authentifizierungsmethode.

Wo Sie arbeiten werden OAuth-Einstellungen → Web

1. Öffnen Sie die OAuth-Einstellungen. Wählen Sie Web aus dem Plattformraster. Sie können einen Client pro Plattform konfigurieren: Web, Windows, macOS, Linux, Android und iOS.
2. Wählen Sie für dieses Beispiel "Browseranwendung / SPA", den öffentlichen PKCE-Client. Eine Server-Webanwendung ist nur dann geeignet, wenn Ihre Bereitstellungsrichtlinie dies erlaubt und Ihr Backend ein Geheimnis schützen kann.
3. Kopieren Sie Ihre eigene Web-Client-ID. Belassen Sie die Plattform im Testmodus, während Sie sie integrieren. Kopieren Sie niemals eine ID aus einem Screenshot oder verwenden Sie die Registrierung der freigegebenen Demo nicht für ein anderes Produkt erneut.

OAuth-Einstellungen · Plattformraster [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3BsYXRmb3Jtcy5wbmc.d1VzRklfuF_87b8KTVlPjn?v=1412f421168b)

Ein registrierter Client pro Plattform. Nicht konfigurierte Plattformen bleiben optional.

1. Öffnen Sie die einzelne Web-Integration.
2. Fügen Sie Android nur hinzu, wenn Ihr Produkt es unterstützt.

Web · Übersicht [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3dlYi1jbGllbnQucG5n.AQKecrfiIFG89MpuUlH8uP?v=8f56b706ab2d)

Ein öffentlicher Web-Client verwendet PKCE und hat kein Client-Geheimnis. Die Client-ID ist geschwärzt.

1. Kopieren Sie Ihre eigene Web-Client-ID.
2. Ein öffentlicher Client erhält kein Geheimnis.

Verschiedene Plattformen haben unterschiedliche Anmeldeinformationen und Rückrufregeln. Sie sind keine separaten Produkte: Abonnements und Kundenmanagement werden für die Anwendung aggregiert. Anwendungstester werden plattformübergreifend geteilt, mit maximal fünf Plätzen einschließlich ausstehender Einladungen; der Eigentümer verbraucht keinen Testerplatz.

**Sie sind bereit, fortzufahren, wenn**

Es existiert genau eine Web-Plattform. Nicht konfigurierte native Plattformen blockieren Ihren Start nicht.

Brauchen Sie die Details?[Plattformregistrierung ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Bringen Sie Kunden zurück zu Ihrer App

Sie leiten Kunden nach der Autorisierung zu Ihrer Anwendung zurück, indem Sie einen genauen Callback verwenden, den Sie besitzen.

Wo Sie arbeiten werden Web → Konfiguration

In Web → Konfiguration registrieren Sie den genauen HTTPS-Callback, den Ihre Anwendung verarbeitet. Dieser Leitfaden verwendet `https://jamzy.example/oauth/callback` als Beispiel. Ersetzen Sie `jamzy.example` durch die HTTPS-Domain, auf der Sie Ihre Kopie von JamZY bereitstellen, und verwenden Sie denselben Callback in Ihrer Anwendungskonfiguration.

Web · Konfiguration [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NhbGxiYWNrcy5wbmc.VYHbGU1Skc_78NvwYGAAz5?v=6af56597b3d7)

Registrieren Sie den Callback, den Ihre bereitgestellte Anwendung verarbeitet.

1. Registrieren Sie den Callback, den Ihre bereitgestellte Anwendung verarbeitet.

Geben Sie den Namen des Zustimmungsbildschirms, die Bedingungen, Datenschutz- und Löschinformationen an. Aktivieren Sie nur die benötigten Scopes und speichern Sie. Schema, Host, Pfad und anwendbare Abfragedetails müssen mit der Autorisierungsanfrage und dem Codeaustausch übereinstimmen. Verwenden Sie kein Wildcard oder URL-Fragment.

| Plattform | Callback zur Implementierung |
| --- | --- |
| Web | Exakte HTTPS-Adresse in Ihrer Anwendung. |
| Android | Ein umgekehrtes Domain-App-Schema, das mit der Anwendungs-ID übereinstimmt, oder ein verifiziertes HTTPS-App-Link mit dem Paket und dem SHA-256-Signatur-Fingerprint. |
| iOS | Ein übereinstimmendes App-Schema oder ein verifizierter HTTPS-Universal-Link mit Bundle-ID und Apple-App-ID-Präfix. |
| Windows / macOS / Linux | Ein erlaubter exakter HTTPS-Callback, ein übereinstimmendes umgekehrtes Domain-Anwendungsschema oder eine unterstützte Loopback-Umleitung auf 127.0.0.1 / \[::1\]. Der Loopback-Port kann variieren. |

Installierte Apps autorisieren im Systembrowser und kehren über den registrierten Callback zurück. Für beanspruchte HTTPS-App-Links veröffentlichen Sie die erforderliche Zuordnungsdatei und führen die Zuordnungsverifizierung in der Konsole durch. Ein Callback, der in einem Formular plausibel aussieht, ist kein Beweis dafür, dass Ihre installierte App ihn empfängt.

**Sie sind bereit, fortzufahren, wenn**

Das Öffnen des Callbacks durch den Autorisierungsfluss kehrt zu Ihrer App zurück. Ein zufälliger Code oder ein nicht übereinstimmender Status wird abgelehnt.

Brauchen Sie die Details?[PKCE & Umleitungen ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Discovery & Identität ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)

## Führen Sie Ihre eigene JamZY-Anwendung aus

Sie haben die Terminoberfläche und deren ShareAI-Verbindung mit Ihren eigenen Anwendungskennungen in Betrieb.

Wo Sie arbeiten werden Ihre Anwendung → Umgebungskonfiguration

JamZY ist eine Termin-Anwendung mit einem optionalen KI-Vorbereitungsassistenten. Ihr Planer ist eine reine Browser-Demonstration: Es gibt keinen Kalenderanbieter, keine E-Mail-Zustellung oder Terminzahlung. Die ShareAI-Autorisierung und KI-API-Integration verwenden die tatsächlich konfigurierte Upstream-Verbindung.

Laden Sie die [JamZY-Referenzquelle herunter](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJlZmVyZW5jZS56aXA.jOyG9kwmFZrdMQEhTNGl0J?v=248a37ba4612). Sie enthält den Node-Server, die Browser-Benutzeroberfläche, Tests und eine Setup-README-Datei; keine Zertifikate, Geheimnisse, Abhängigkeiten oder Sitzungen. Überprüfen Sie die Dateien, bevor Sie sie ausführen. Platzieren Sie den Node-Prozess hinter einem HTTPS-Reverse-Proxy, der den öffentlichen Ursprung beibehält.

```bash
# .env — replace both identifiers with YOUR registered application.
JAMZY_PUBLIC_ORIGIN=https://jamzy.example
SHAREAI_CLIENT_ID=YOUR_WEB_CLIENT_ID
SHAREAI_APP_ID=YOUR_APPLICATION_UUID
SHAREAI_AUTH_ORIGIN=https://auth.shareai.now
SHAREAI_API_BASE_URL=https://api.shareai.now/api/v1
SHAREAI_SCOPES="openid profile inference monetization_gateway"
PORT=3443
BIND_HOST=127.0.0.1
```

```bash
# Node 22+, behind your HTTPS reverse proxy
node --env-file=.env server.mjs

# Mocked upstream tests; these do not spend credits
node --test test/server.test.mjs
```

**Halten Sie Umgebungen zusammen**

Erstellen Sie Ihre Anwendung unter [konsole.shareai.jetzt](https://console.shareai.now/app/builder/). Verwenden Sie deren Produktions-Client-ID mit `https://auth.shareai.now` und `https://api.shareai.now/api/v1`. Die `jamzy.example` Adresse ist ein Platzhalter für Ihre App, kein gehostetes Demo. Stellen Sie Ihre eigene App über HTTPS bereit, damit deren Secure-Session-Cookie funktioniert.

JamZY bietet auch eine API-Schlüssel-Verbindung zum Vergleich. Diese Anleitung verwendet die Wallet/OAuth-Schaltfläche. Ein API-Schlüssel stellt keine JamZY-OAuth-Vereinbarung des Kunden her und ersetzt nicht den Kundenautorisierungsfluss.

**Sie sind bereit, fortzufahren, wenn**

Die App wird über HTTPS geladen. Ihr öffentlicher Ursprung, der registrierte Callback und die Client-ID stimmen mit Ihrer Registrierung überein. Kein Token oder Geheimnis erscheint im Seitenquelltext oder in localStorage.

## Verbinden Sie Ihren ersten Kunden

Sie lassen einen Kunden sein ShareAI-Konto auswählen und den Zugriff genehmigen, den Ihre App benötigt.

Wo Sie arbeiten werden JamZY → Bezahlen Sie mit Ihrem ShareAI-Wallet

Wählen Sie von JamZY aus "Bezahlen Sie mit Ihrem ShareAI-Wallet". Die App öffnet die ShareAI-Autorisierungsseite. Der Kunde meldet sich an, wählt ein persönliches oder Organisationskonto aus, überprüft die App und den angeforderten Zugriff und akzeptiert die geltenden Abonnementbedingungen.

1. **JamZY → Auth**Erstellen Sie einen zufälligen Zustand und einen PKCE-Verifier; senden Sie dessen S256-Challenge mit der Autorisierungsanfrage.
2. **Kunde → Auth**Wählen Sie das zahlende Konto aus und überprüfen Sie die Zugriffs- und Abrechnungsbedingungen. Ein Abbruch muss JamZY getrennt lassen.
3. **Auth → Callback**Empfangen Sie einen kurzlebigen, einmaligen Code und den Zustand. Validieren Sie den Zustand gegen dieselbe Sitzung.
4. **Backend → Token**Tauschen Sie diesen Code mit dem ursprünglichen Verifier und derselben Redirect-URI aus. Öffentliche Clients senden kein Client-Secret.
5. **Backend → Benutzerinfo**Verwenden Sie das Zugriffstoken, um die authentifizierte Identität zu lesen, und richten Sie dann eine eigene sichere Sitzung für JamZY ein.

Web · Produktionsendpunkte [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2VuZHBvaW50cy5wbmc.wcHciknhu_5PQG6wrO4zan?v=63ad6d9e8724)

Verwenden Sie diese Produktionsadressen ShareAI mit der Client-ID von console.shareai.now.

1. Autorisieren Sie unter auth.shareai.now/oauth/authorize.
2. Tauschen Sie Codes und Aktualisierungstoken unter auth.shareai.now/oauth/token aus.

```javascript
const verifier = randomBytes(32).toString('base64url');
const state = randomBytes(32).toString('base64url');
const challenge = createHash('sha256').update(verifier).digest('base64url');
const authorize = new URL('https://auth.shareai.now/oauth/authorize');
authorize.search = new URLSearchParams({
  client_id: clientId, response_type: 'code', redirect_uri: callback,
  scope: 'openid profile inference monetization_gateway', state,
  code_challenge: challenge, code_challenge_method: 'S256',
}).toString();
// Save state + verifier in the server session BEFORE redirecting.
// The downloadable server implements state expiry and one-time consumption.
```

Verknüpfen Sie den lokalen Kunden-Datensatz mit dem authentifizierten, client-spezifischen `sub` und dessen Aussteller-/Client-Kontext. Persönliche und organisatorische Autorisierungen können unterschiedliche zahlende Konten auswählen. Eine Kunden-ID ist keine globale Benutzer-ID, E-Mail-Adresse oder interne Organisationsdatenbank-ID. Zusammenführen von Identitäten über Plattformen hinweg durch Abgleich von Anzeigenamen ist nicht zulässig.

**Sie sind bereit, fortzufahren, wenn**

Abbruch, nicht übereinstimmender Zustand, wiederverwendeter Code und abgelaufene Autorisierung schlagen sicher fehl. Der normale Ablauf gibt ein authentifiziertes Konto zurück, ohne dessen Tokens offenzulegen.

Brauchen Sie die Details?[Code-Austausch abschließen ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Private Kundenidentitäten ↗](https://shareai.now/docs/api/builders/auth/pairwise-identities/)

## Halten Sie den Kunden sicher verbunden

Sie halten autorisierte Anfragen funktionsfähig, während Tokens ablaufen, und bieten dem Kunden eine zuverlässige Möglichkeit, die Verbindung zu trennen.

Wo Sie arbeiten werden Ihre Anwendung → Sitzungs- und Token-Verwaltung

| Anmeldedaten | Zweck | Wie man damit umgeht |
| --- | --- | --- |
| Autorisierungscode | Einmalige Übergabe von der Autorisierungsseite. | Einmal austauschen, mit dem passenden Verifier und Callback. Es ist kein API-Token. |
| Zugriffstoken | Autorisiert API-Aufrufe innerhalb der akzeptierten Berechtigung und Bereiche. | Senden als `Authorization: Bearer …`. Respektieren Sie Ablauf und Endpunkt-Autorisierungsfehler. |
| Refresh-Token | Erhält Ersatz-Zugriffstokens ohne erneutes Anmelden, solange die Berechtigung gültig bleibt. | Sicher speichern. Serialisieren Sie Refresh-Operationen und ersetzen Sie gedrehte Anmeldeinformationen atomar. |
| ID-Token | Eine OpenID Connect-Identitätsaussage für den Client. | Wenn Sie es verwenden, validieren Sie Signatur, Aussteller, Zielgruppe, Ablauf und Nonce, falls zutreffend. Verwenden Sie es nicht als Inferenz-Bearer-Token. |
| Client-Secret | Authentifiziert einen zulässigen vertraulichen Server-Client. | Auf dem Server speichern. Es unterscheidet sich von allen Tokens und wird niemals in einem öffentlichen Client gebündelt. |

```bash
# Public client refresh; run on a trusted terminal with scoped test credentials.
curl --fail-with-body 'https://auth.shareai.now/oauth/token' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-urlencode 'grant_type=refresh_token' \
  --data-urlencode "client_id=$SHAREAI_CLIENT_ID" \
  --data-urlencode "refresh_token=$SHAREAI_REFRESH_TOKEN"
```

Verwenden Sie die zurückgegebenen `expires_in` anstelle einer erfundenen Lebensdauer. Wenn Refresh ein Ersatz-Refresh-Token zurückgibt, speichern Sie es zusammen mit dem neuen Zugriffstoken als ein Update. Erlauben Sie einen Refresh pro Sitzung, damit gleichzeitige Anfragen kein gedrehtes Token wiederverwenden. Eine ungültige oder widerrufene Refresh-Berechtigung erfordert eine erneute Verbindung; nicht endlos schleifen.

Aktualisierungen können keinen Scope hinzufügen oder stillschweigend einen neuen Monetization Gateway-Vertrag akzeptieren. Senden Sie den Kunden erneut durch die Autorisierung für neue Berechtigungen oder Bedingungen. JamZY speichert Anmeldeinformationen nur im Server-Speicher für maximal eine einstündige Demo-Sitzung, authentifiziert Benutzerinformationen anstelle des Vertrauens in ein nicht verifiziertes ID-Token und verwendet ein sicheres, HttpOnly, SameSite-Cookie. Ein Produktionsdienst benötigt sein eigenes dauerhaftes, geschütztes Sitzungsdesign.

Beim Trennen widerrufen Sie die Refresh-/Access-Anmeldedaten, wo zutreffend, und löschen die Anwendungssitzung. Das Löschen eines Browser-Cookies allein widerruft keinen ShareAI-Grant oder kündigt ein kostenpflichtiges Abonnement. Vermeiden Sie das Protokollieren von Codes, Tokens, Geheimnissen oder persönlichen Eingabeinhalten.

**Sie sind bereit, fortzufahren, wenn**

Der Ablauf löst eine kontrollierte Aktualisierung aus; neue Tokens ersetzen alte. Das Trennen löscht die Anwendungssitzung und meldet jeden Widerrufsfehler.

Brauchen Sie die Details?[Aktualisierung & Rotation ↗](https://shareai.now/docs/api/builders/auth/refresh-tokens/)[Widerruf & Introspektion ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Benutzerinfo & Entdeckung ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)[OAuth-Sicherheitsbestpractice ↗](https://www.rfc-editor.org/rfc/rfc9700.html)

## Bereiten Sie den ersten Termin mit KI vor

Sie verwandeln ein Terminziel in eine Agenda und nützliche Fragen, mit einer expliziten kundenfinanzierten KI-Anfrage.

Wo Sie arbeiten werden Verfügbare Modelle → JamZY → Bereiten Sie sich vor

Öffnen Sie Verfügbare Modelle in der Anwendung. Wählen Sie die Modelle und Anbieter aus, die Ihr Produkt anbieten wird, und speichern Sie die Konfiguration. Wenn der Katalog nicht geladen werden kann, beheben Sie den Verfügbarkeitsfehler der Quelle, bevor Sie fortfahren; wiederholtes Ändern von OAuth-Clients wird dies nicht beheben.

Verfügbare Modelle [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL21vZGVscy5wbmc.PXvmpf7nx9UhAHYgLQ8HHi?v=7c62a7dcb41c)

Wählen Sie aus, welche Modelle und Anbieter Ihre Kunden nutzen können. Beheben Sie alle Katalogfehler, bevor Sie fortfahren.

1. Der Modellkatalog gehört zu dieser Anwendung.

JamZY lädt seinen Katalog erst nach der Verbindung. Wählen Sie ein erlaubtes Textmodell, geben Sie ein kurzes Terminziel ein und wählen Sie Vorbereitung gezielt generieren. Das ausgewählte Konto benötigt berechtigte Credits und alle erforderlichen akzeptierten KI-Abrechnungsbedingungen. Das Auswählen eines Datums, Überprüfen eines Termins und Speichern führt keine Inferenzanfrage aus.

```bash
curl --fail-with-body 'https://api.shareai.now/api/v1/chat/completions' \
  -H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"model":"YOUR_ENABLED_MODEL_SLUG","messages":[{"role":"user","content":"Create a short agenda and three questions for a 15-minute appointment about planning a booking app."}],"stream":false,"max_tokens":192}'
```

### Folgen Sie dem Terminablauf in JamZY

1. Wählen Sie im Zeitplan einen Service: eine 15-minütige Einführung, 30-minütige Projektplanung oder 60-minütige tiefere Unterhaltung.
2. Wählen Sie einen Tag und eine verfügbare Zeit. Zeiten verwenden die im Browser angezeigte Zeitzone. Die Verfügbarkeit ist illustrativ und gespeicherte Termine wirken sich nur auf diesen Browser aus.
3. Geben Sie in Bereiten Sie sich vor ein Beispielziel ohne persönliche Details ein. Wählen Sie ein Modell aus und wählen Sie Vorbereitung generieren. JamZY sendet den ausgewählten Service und Ihr Ziel an ShareAI, rendert den zurückgegebenen Text sicher und lässt die Buchung unverändert.
4. Überprüfen Sie die Agenda selbst. Wählen Sie Termin überprüfen, prüfen Sie dessen Service, Tag, Zeit und Dauer und bestätigen Sie den Demo-Termin. Diese Aktion ruft keine KI auf und nimmt keine Zahlung entgegen.
5. Öffnen Sie Meine Termine, um den gespeicherten Demodatensatz zu sehen. Laden Sie neu, um zu bestätigen, dass er bestehen bleibt, oder entfernen Sie ihn, um den Slot wieder verfügbar zu machen. Nur der Service, Tag, Zeit und eine zufällige lokale Referenz werden gespeichert; KI-Entwürfe, Ziele, Tokens und Schlüssel werden nicht mit Terminen gespeichert.

Überprüfen Sie den Service, das Datum, die Uhrzeit und die Dauer, bevor Sie diesen browserbasierten Demo-Termin speichern. [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJldmlldy5wbmc.77e3cMlfs1G-t-jYrNxzoI?v=dcf04d3d6647)

Überprüfen Sie den Service, das Datum, die Uhrzeit und die Dauer, bevor Sie diesen browserbasierten Demo-Termin speichern.

1. Überprüfen Sie die vollständige Auswahl, bevor Sie bestätigen.
2. Diese Aktion speichert einen Demo-Datensatz; sie ruft weder KI auf noch nimmt sie eine Zahlung entgegen.

Meine Termine zeigt lokale Demo-Datensätze an. Das Entfernen eines Datensatzes macht seinen illustrativen Slot wieder verfügbar. [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LWFwcG9pbnRtZW50cy5wbmc.KGiTkFaDpNeep2RKpzxHNE?v=1d5bce9412c4)

Meine Termine zeigt lokale Demo-Datensätze an. Das Entfernen eines Datensatzes macht seinen illustrativen Slot wieder verfügbar.

1. Der Datensatz bleibt in diesem Browser ohne persönliche Daten oder KI-Notizen bestehen.
2. Entfernen Sie den Demo-Termin und geben Sie seinen Slot frei.

Ein echtes Terminplanungsprodukt benötigt einen serverseitigen Buchungsspeicher, Verfügbarkeitsprüfungen, Zeitzonenverarbeitung, Stornierungsrichtlinien und Kalender- oder Benachrichtigungsintegration. Diese sind getrennt von der ShareAI-Autorisierung. Halten Sie KI-Ausgaben als Vorschlag; validieren Sie jede zukünftige Buchungsaktion durch die Regeln Ihrer eigenen Anwendung.

Verwenden Sie einen Modell-Slug, der vom erlaubten Katalog zurückgegeben wird. Bearbeiten Sie den tatsächlichen Antwortvertrag: JamZY unterstützt ShareAI’s native `message.content` Umschlag und OpenAI-Stil `choices[0].message.content`. HTTP 200 mit einer unvollständigen oder verschachtelten Fehlerantwort ist keine erfolgreiche Antwort.

Bei einer Antwort mit Ausgabenlimit oder unzureichendem Guthaben zeigen Sie eine nützliche Erklärung und den bereitgestellten Kundenabrechnungslink an. Bewahren Sie das ausgewählte Konto. Überschreiten Sie nicht dessen Limit, wechseln Sie nicht stillschweigend den Zahler und wiederholen Sie keine belastete Operation in einer Schleife.

**Sie sind bereit, fortzufahren, wenn**

Die Generierung der Vorbereitung liefert eine verwendbare Agenda und Fragen. Die Anfrage wird dem autorisierten Kunden und der Anwendung zugeordnet, mit dem ausgewählten Modell und den akzeptierten Bedingungen. Der KI-Entwurf kann keinen Termin buchen oder ändern.

Brauchen Sie die Details?[OAuth-Chat-Anfragen ↗](https://shareai.now/docs/api/builders/chat-completions/chat-with-oauth/)[Abrechnungswiederherstellung ↗](https://shareai.now/docs/api/builders/billing-errors-and-spending-limits/)

## Legen Sie Ihre optionalen KI-Einnahmen fest

Sie erklären Ihre zusätzliche KI-Gebühr in einem Abonnementangebot und veröffentlichen die Bedingungen, die Kunden akzeptieren können.

Wo Sie arbeiten werden Anwendung → Abonnements

Beantragen Sie Monetization Gateway-Zugriff über die Anwendungsfälle der App, wenn dies nicht bereits durch die geltende Verwaltungspolitik genehmigt wurde. Füllen Sie den Fragebogen aus und verfolgen Sie dessen Status. Die Genehmigung ermöglicht die Konfiguration; Kundenberechtigung und Abrechnungszustimmung bleiben getrennt.

Abonnements · Übersicht [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbnMucG5n.1fAD7CKPa38_SZFh5zuI9P?v=f1ef4ee6680b)

Neue Anwendungen starten ohne veröffentlichten Vertrag. Fügen Sie ein Angebot hinzu, bevor Sie dessen Bedingungen veröffentlichen.

1. Erstellen Sie ein Angebot in einem eigenen Editor.

1. Öffnen Sie Abonnements. Fügen Sie ein Angebot hinzu, geben Sie ihm einen klaren Namen und beschreiben Sie den Builder-Aufschlag, den Kunden zahlen werden. Die generierte Abonnement-ID ist schreibgeschützt und auf diese Anwendung beschränkt; kopieren Sie sie, wenn Ihre Integration sie benötigt.
2. Bearbeiten Sie jedes Abonnement in dessen eigenem Editor. Verwenden Sie Estimate, um die Netzwerkkosten und Ihre Einnahmen für das ausgewählte Modell und die Nutzungsannahmen zu überprüfen. Schätzungen sind Vorschauen, keine garantierten Preise oder akzeptierten Bedingungen.
3. Überprüfen Sie den Entwurf gemeinsam, und veröffentlichen Sie die Vertragsversion, wenn deren Anforderungen erfüllt sind. Die veröffentlichte Version beschreibt, was neue Kunden akzeptieren können.
4. Verwenden Sie die Übersicht und die Vertragsverteilung, um zu sehen, wie viele Konten auf jeder akzeptierten Version verbleiben. Ein Kunde behält akzeptierte Bedingungen, bis er ausdrücklich eine Ersatzversion akzeptiert; das Veröffentlichen einer neuen Version migriert sie nicht stillschweigend. Behalten Sie die Standardübergangsoption bei, die akzeptierte Verträge bewahrt. Wenn Sie bewusst Erneute Zustimmung vor weiteren App-Aktionen erforderlich wählen, kann der bestehende Zugriff unterbrochen werden, bis der Kunde die neuen Bedingungen genehmigt.

Nur Beispiel: Ein 20% Builder-Aufschlag auf €1.00 der berechtigten Netzwerkkosten fügt €0.20 hinzu. Bei Standardpreisen gilt die ShareAI-Gebühr von 5% nur für diesen €0.20-Aufschlag, vor jeglicher abrechenbarer Ereignisaufnahme. Verwenden Sie den Live-Schätzer und den akzeptierten Vertrag für die tatsächliche Berechnung. Ein Abonnementangebot in diesem Ablauf ist eine KI-Abrechnungsvereinbarung; die Kontoverbindung allein belastet keinen festen wiederkehrenden Preis.

Abonnements · Angebotseditor [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbi1lZGl0b3IucG5n.ajS-FCMdefa7Br_i-9U6yV?v=028a19d93ad7)

Ein illustrativer Entwurf eines Angebots. Die generierte Abonnement-ID ist schreibgeschützt und auf diese Anwendung beschränkt.

1. Verwenden Sie einen kundenorientierten Angebotsnamen.
2. Legen Sie die KI `surcharge` für dieses Angebot fest.

Der ShareAI-Zustimmungsbildschirm ist maßgeblich für akzeptierte Bedingungen. Der öffentliche Client von JamZY kann den akzeptierten Abrechnungsplan nicht aus den Benutzerinformationen ableiten, daher beansprucht sein Verbindungsfeld kein aktives Abonnement und erfindet keinen Preis für den Termin.

**Sie sind bereit, fortzufahren, wenn**

Das Angebot erklärt die Gebühr; der Vertrag kann vom Kunden akzeptiert werden. Sie verstehen, welche Kunden auf älteren Bedingungen bleiben und warum.

Brauchen Sie die Details?[Monetarisierungsanleitung abschließen ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Akzeptierte Vereinbarungen ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## Beweisen Sie, dass die enthaltenen Plattformen funktionieren

Sie sammeln die tatsächlichen Endpunkt- und Bereichsprüfungen, die erforderlich sind, um Ihre Anwendung zur Überprüfung einzureichen.

Wo Sie arbeiten werden OAuth-Einstellungen → Tester und Verifizierung

Öffnen Sie OAuth-Einstellungen → Tester und laden Sie bis zu fünf anwendungsweite Tester ein. Ausstehende Einladungen verbrauchen einen Platz, gewähren jedoch keinen Zugriff; der Empfänger muss akzeptieren. Eigentümerzugriff und eingeladener Testerzugriff unterscheiden sich vom öffentlichen Produktionszugriff.

Anwendungstester [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3Rlc3RlcnMucG5n.3_3h6Y0TjTv3r0ttIn9bok?v=60cba368b3d5)

Eine einzige Tester-Liste dient allen Plattformen. Ausstehende Einladungen zählen zur Fünf-Plätze-Grenze.

1. Fünf Plätze werden von der gesamten Anwendung geteilt.
2. Laden Sie hier einen Tester ein und warten Sie auf dessen Annahme.

Web · Verifizierung [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3ZlcmlmaWNhdGlvbi5wbmc.xLD6z4RV0ddX6p0qkaLhqc?v=d758a8f881d9)

Eine neue Integration zeigt ausstehende Prüfungen an, bis tatsächlich erfolgreiche Aufrufe aufgezeichnet werden. Dieser Referenzentwurf wurde noch nicht überprüft.

1. Die Konsole zeichnet tatsächliche Endpunkt-Erfolge auf.
2. Jeder angeforderte Scope muss ebenfalls ausgeführt werden.

Für jede Plattform, die Sie veröffentlichen möchten, öffnen Sie die Verifizierung. Führen Sie echte erfolgreiche Aufrufe für die erforderlichen Endpunkte und jeden konfigurierten Bereich durch. Überprüfen Sie Discovery- und Signaturschlüssel; testen Sie Autorisierung/Callback, Codeaustausch, Aktualisierung, authentifizierte Benutzerinformationen und Widerruf. Vertrauliche Clients müssen auch die anwendbare Introspektion testen. Native beanspruchte HTTPS-Links benötigen eine Verifizierungsassoziation.

Ein Profil-/E-Mail-Bereich benötigt seine tatsächlich zurückgegebenen Ansprüche; verwenden Sie ein persönliches Testkonto, bei dem eine E-Mail erforderlich ist. Die `inference` und `monetization_gateway` Bereiche benötigen eine abgeschlossene autorisierte KI-Anfrage. Zahlungen erfordern einen erfolgreichen API-Aufruf für den Bereich Zahlung. Eine generische erfolgreiche HTTP-Antwort, ein Browser-Screenshot oder eine manuelle Checkliste ersetzen nicht die in der Konsole aufgezeichneten Prüfungen.

Sie haben drei Möglichkeiten für eine unvollständige Plattform: abschließen und verifizieren, von der Veröffentlichung ausschließen, sodass sie nur für Eigentümer/Tester bleibt, oder entfernen. Schließen Sie keine Plattform mit Callbacks oder Bereichen ein, die Sie nicht ausgeübt haben. Konfigurationsänderungen können Prüfungen ungültig machen, daher aktualisieren Sie den aufgezeichneten Status nach Ihren endgültigen Änderungen.

**Sie sind bereit, fortzufahren, wenn**

Jede eingeschlossene Plattform zeigt die erforderliche Konfiguration, Endpunkt- und Bereichsprüfungen als abgeschlossen an. Die persönliche Checkliste des Leitfadens dient nur als Leshilfe.

Brauchen Sie die Details?[Endpunkt-Verifizierung ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Referenz starten ↗](https://shareai.now/docs/builders/applications/launch-application/)

## Reichen Sie Ihre App ein und verfolgen Sie deren Kunden

Sie wissen, was zur Überprüfung bereit ist, wie die Veröffentlichung funktioniert und wo Sie anschließend den Kundenzugriff verfolgen können.

Wo Sie arbeiten werden Anwendung → Dashboard

1. Kehren Sie zum Dashboard zurück und lösen Sie jede ausstehende Aktion. Die Überprüfungseinreichung muss weiterhin nicht verfügbar bleiben, bis die Anwendung und alle eingeschlossenen Plattformen ihre Anforderungen erfüllen.
2. Reichen Sie die Anwendung zur Überprüfung durch ShareAI ein. Verfolgen Sie die Entscheidung und alle angeforderten Änderungen im Dashboard sowie unter Aktivität & Entscheidungen. Öffentliche Präsentationen und Anfragen für das Monetarisierungs-Gateway können separate Entscheidungen haben.
3. Nach der Genehmigung veröffentlichen Sie die Anwendung mit den verfügbaren Veröffentlichungskontrollen. Bestätigen Sie, dass die eingeschlossenen Plattformen produktionsbereit sind; ausgeschlossene bleiben im Testmodus.
4. Öffnen Sie Kunden für anwendungsbezogene Konten und Abonnements für die Verteilung akzeptierter Verträge. Analytics hilft Ihnen, die zugewiesene KI-Nutzung und Einnahmen zu verfolgen. Kundenkennungen bleiben privat im entsprechenden Kunden-/Autorisierungskontext.

Dashboard · Startbereitschaft [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Rhc2hib2FyZC5wbmc.2hIAeRjQpgXmhBWVPD5_zB?v=38be9c6d668e)

Die Überprüfung bleibt blockiert, solange die Anwendung und die enthaltenen Plattformen ausstehende Anforderungen haben.

1. Beheben Sie erforderliche Aktionen, bevor Sie zur Überprüfung einreichen.

Kunden [Screenshot vergrößern ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2N1c3RvbWVycy5wbmc.qbIDq-R5JMA6K48ws4kWaB?v=cc0470083fec)

Die Anwendungsansicht fasst verbundene Konten zusammen, ohne interne Organisationsdatenbank-IDs anzuzeigen.

1. Das Kundenmanagement wird für die Anwendung aggregiert.

Probieren Sie den gesamten Ablauf erneut mit einem berechtigten Kunden nach dem Start aus: verbinden, das Konto und die Zustimmung überprüfen, einen kurzen Terminvorbereitungsentwurf erstellen, sicher aktualisieren, einen Abrechnungsfehler behandeln und dann trennen. Überprüfen Sie die Live-Benutzererfahrung, anstatt davon auszugehen, dass ein erfolgreicher Speicher beweist, dass es funktioniert.

**Wenn etwas nicht funktioniert**

**Callback-Mismatch:** Vergleichen Sie die registrierte URL und beide Anforderungswerte genau. **Nicht autorisierter Tester:** Bestätigen Sie die Annahme der Einladung und das ausgewählte Konto. **Fehlender Umfang oder Vertrag:** Fordern Sie nur aktivierten Zugriff an und verbinden Sie sich erneut, um ihn zu akzeptieren. **Keine Modelle:** Überprüfen Sie Verfügbare Modelle und Anbieterbeschränkungen. **Aktualisierungsfehler:** Löschen Sie die fehlgeschlagene lokale Sitzung und verbinden Sie sich erneut. **Überprüfung blockiert:** Überprüfen Sie die Plattformprüfungen, anstatt einen weiteren OAuth-Client zu erstellen.

**Sie sind bereit, fortzufahren, wenn**

Die App funktioniert für den vorgesehenen Kunden, aufgezeichnete Prüfungen unterstützen ihren Veröffentlichungsstatus, und der Kunde kann die Autorisierung kontrollieren oder widerrufen.

Brauchen Sie die Details?[Weiter: Bezahlen mit ShareAI ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Builder API-Referenz ↗](https://shareai.now/docs/api/builders/)

## Organisationsverifizierung und Programmzugang

Wählen Sie das persönliche oder Organisationskonto aus, das die Programmanmeldung besitzen wird, bevor Sie sich bewerben. Organisationen können eine Bewerbung vor der Verifizierung einreichen, aber die Genehmigung durch das Personal allein aktiviert den Zugriff nicht. Schließen Sie die Verifizierung der Organisations-E-Mail und der Unternehmensdaten aus der Onboarding-Checkliste in der Konsole ab. Eine genehmigte Organisation bleibt "Ausstehende Verifizierung", bis beide Prüfungen abgeschlossen sind. Builder, Anbieter- und Creator-Programme folgen dieser Regel.

[Anzeigen von Monetization Gateway Preisgestaltung](https://shareai.now/de/entwickler-2/monetarisierungs-gateway/#mg-pricing) · [Erkunden Sie ShareAI for Startups](https://shareai.now/de/startup-programm/) · [Scopes und Berechtigungen](https://shareai.now/de/dokumentation-2/api/entwickler-2/auth/oauth-berechtigungen-und-kontogrenzen/)

## Berechtigungen und akzeptierte Bedingungen

Ihre öffentlichen Allgemeinen Geschäftsbedingungen, Datenschutzrichtlinien und Löschanweisungen müssen mit der Anwendung übereinstimmen und ohne Anmeldung erreichbar bleiben. Die Programmannahme ShareAI, die Genehmigung Monetization Gateway, die OAuth-Berechtigung des Kunden und der akzeptierte Abrechnungsvertrag sind separate Entscheidungen. Eine Aktualisierung kann keine Berechtigungen hinzufügen oder neue kommerzielle Bedingungen akzeptieren.

Der Legacy-Scope `surcharge` bleibt für bestehende Integrationen akzeptiert. Neue Beispiele verwenden `monetization_gateway`. Behalten Sie bestehende Wire-Felder wie `surcharge_bps` und `surcharge_percentage` unverändert bei.

[Anzeigen von Monetization Gateway Preisgestaltung](https://shareai.now/de/entwickler-2/monetarisierungs-gateway/#mg-pricing) · [Erkunden Sie ShareAI for Startups](https://shareai.now/de/startup-programm/) · [Scopes und Berechtigungen](https://shareai.now/de/dokumentation-2/api/entwickler-2/auth/oauth-berechtigungen-und-kontogrenzen/)

## Gateway-Gebühren und Startup-Unterstützung

Standardgebühren 5% des Builder-Zuschlags. Für €2.00 der KI-Netzwerkkosten und einen 10%-Zuschlag zahlt der Kunde €2.20. ShareAI erhält €0.01 des €0.20-Zuschlags; das Builder hat €0.19 vor Event Ingestion.

Die ersten 1,000 abgeschlossenen Produktionsanfragen Monetization Gateway sind jeden Kalendermonat (UTC) kostenlos und werden über das Builder-Konto geteilt. Zusätzliche Anfragen kosten €0.04 pro 1,000 vor anwendbaren Rabatten. Eine abgeschlossene Anfrage erzeugt ein Ereignis.

Pay with ShareAI allein, `inference`-Zugriff ausschließlich, gewöhnliche Konto-API-Schlüssel und Staging- oder Testverkehr verursachen keine Monetization Gateway-Event-Ingestion.

ShareAI for Startups bietet ein gemeinsames monatliches Budget für tatsächliche ShareAI-Gebühren auf einer genehmigten Anwendung. Die aktuellen Launch-, Growth- und Momentum-Stufen listen €1,000, €5,000 und €10,000 pro Monat. Dasselbe Budget deckt die prozentuale Gebühr von ShareAI auf Builder-Markup und abrechenbare Event-Ingestion zusammen ab. Es ist kein Brutto-Markup-Budget, kein separates Freievent-Kontingent oder kostenlose KI-`inference`. Die ersten 1,000 freien Events des Kontos verbrauchen es nicht.

Verbleibende Event-Ingestion-Gebühren werden aus den neuen Einnahmen des Antrags Builder bezahlt, dann aus verfügbaren Builder KI-Einnahmen und uneingeschränkten KI-Guthaben. Kunden-KI-Gebühren und Produkt `payments` bleiben getrennt.

ShareAI kann anwendungsspezifische Gebühren oder Gebührenerleichterungen für einen festen Zeitraum oder bis zur Änderung genehmigen. Überprüfen Sie die aktuellen Preise und Sonderprogramme der Anwendung in der Konsole auf genehmigte Bedingungen, Gültigkeit und verbrauchtes Budget. Eine Stufenänderung oder Preisüberschreibung setzt die monatliche Nutzung der Anwendung nicht zurück.

Launch hält "Log in with ShareAI" optional. Growth und Momentum erfordern es; Momentum erfordert außerdem das offizielle ShareAI for Startups-Abzeichen im Anwendungsfooter. ShareAI überprüft das Abzeichen wöchentlich. Bestätigte Versuche, Anforderungen zu umgehen, können zu einer Herabstufung, Entfernung aus dem Startup-Programm oder einem Ausschluss vom Marktplatz gemäß den akzeptierten Programmrichtlinien führen.

Unternehmenskonditionen werden vom ShareAI-Team für das Builder-Konto konfiguriert, nachdem ein personalisiertes Angebot vereinbart wurde. Der zugewiesene Prozentsatz und die Ereignisrate gelten für zukünftige Anfragen.

[Anzeigen von Monetization Gateway Preisgestaltung](https://shareai.now/de/entwickler-2/monetarisierungs-gateway/#mg-pricing) · [Erkunden Sie ShareAI for Startups](https://shareai.now/de/startup-programm/) · [Scopes und Berechtigungen](https://shareai.now/de/dokumentation-2/api/entwickler-2/auth/oauth-berechtigungen-und-kontogrenzen/)

Source: https://shareai.now/de/blogs/produkt/bauprogramm/anleitungen-how-to/so-verbinden-sie-eine-anwendung-mit-shareai-builder-schritt-fur-schritt/