Anmeldung und erneuerbare Sitzungen
Ein Kunde wählt sein ShareAI-Konto aus, genehmigt Ihre App und kehrt zu JamZY zurück.
Melden Sie sich an, aktualisieren Sie die Sitzung und trennen Sie erfolgreich.
BAUEN MIT SHAREAI
Erstellen Sie eine Termin-App, die Kunden mit ShareAI verbindet, nützliche KI-Agenden vorbereitet und ihnen die Kontrolle über ihre KI-Ausgaben gibt.
Die Erfahrung, die Sie aufbauen werden
JamZY · TermineWählen Sie einen Termin. Verbinden Sie ShareAI. Kommen Sie mit einem Plan an.
IHRE IMPLEMENTIERUNG
Drei konkrete Ergebnisse: den Kunden verbinden, seinen Termin vorbereiten und die Integration zur Überprüfung bereitstellen.
Ein Kunde wählt sein ShareAI-Konto aus, genehmigt Ihre App und kehrt zu JamZY zurück.
Melden Sie sich an, aktualisieren Sie die Sitzung und trennen Sie erfolgreich.
Wandeln Sie ein Terminziel durch eine gezielte KI-Anfrage in eine Agenda und Fragen um.
Erstellen Sie einen Entwurf; das Speichern eines Termins löst keinen KI-Aufruf aus.
Erklären Sie optionale KI-Gebühren und sammeln Sie die Plattformprüfungen, die Ihre Überprüfungseinreichung benötigt.
Jede eingeschlossene Plattform und angeforderte Berechtigung hat aufgezeichnete Prüfungen.
NEHMEN SIE ES IN IHREN EDITOR
Kopieren Sie die vollständige Anleitung mit dem Implementierungsziel, den erforderlichen Eingaben und den Akzeptanzprüfungen. Halten Sie Codebeispiele, Tabellen und Dokumentationslinks zusammen.
Bereit für Ihr Projekt, im benötigten Format.
Aktualisiert
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. 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.
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 können Kontoanmeldung, KI-Verbrauch, optionale Zusatzgebühr und einen bestätigten Produktkauf unterscheiden. Das Lesen dieses Leitfadens erfordert keine bezahlte Anfrage.
Sie erstellen die Builder-Identität, die Ihre Anwendung und ihre Kundenbeziehungen besitzt.
Wo Sie arbeiten werden Konsole → Builder Program
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.
Sie geben JamZY einen eigenen Anwendungsdatensatz, sodass Identität, Zugriff und kommerzielle Bedingungen zusammenbleiben.
Wo Sie arbeiten werden Builder Program → Produkt → Neue App
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.
JamZY erscheint unter Produkt für den vorgesehenen Besitzer. Erstellen Sie keine zusätzliche Anwendung für jede Geräteplattform.
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.
| 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.
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.
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.
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.
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.
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.
| 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.
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.
Sie erstellen einen Web-Client für die browserbasierte JamZY-Erfahrung mit der richtigen Authentifizierungsmethode.
Wo Sie arbeiten werden OAuth-Einstellungen → Web
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.
Es existiert genau eine Web-Plattform. Nicht konfigurierte native Plattformen blockieren Ihren Start nicht.
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.
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.
Das Öffnen des Callbacks durch den Autorisierungsfluss kehrt zu Ihrer App zurück. Ein zufälliger Code oder ein nicht übereinstimmender Status wird abgelehnt.
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. 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.
# .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# 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.mjsErstellen Sie Ihre Anwendung unter konsole.shareai.jetzt. 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.
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.
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.
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.
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.
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. |
# 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.
Der Ablauf löst eine kontrollierte Aktualisierung aus; neue Tokens ersetzen alte. Das Trennen löscht die Anwendungssitzung und meldet jeden Widerrufsfehler.
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.
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.
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}'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.
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.
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.
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.
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.
Das Angebot erklärt die Gebühr; der Vertrag kann vom Kunden akzeptiert werden. Sie verstehen, welche Kunden auf älteren Bedingungen bleiben und warum.
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.
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.
Jede eingeschlossene Plattform zeigt die erforderliche Konfiguration, Endpunkt- und Bereichsprüfungen als abgeschlossen an. Die persönliche Checkliste des Leitfadens dient nur als Leshilfe.
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
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.
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.
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.
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 · Erkunden Sie ShareAI for Startups · Scopes und Berechtigungen
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 · Erkunden Sie ShareAI for Startups · Scopes und Berechtigungen
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 · Erkunden Sie ShareAI for Startups · Scopes und Berechtigungen