AI Prosumer
RO

CONSTRUIEȘTE CU SHAREAI

Cum să conectezi o aplicație la ShareAI Builder, pas cu pas

Construiește o aplicație de programări care conectează clienții la ShareAI, pregătește agende AI utile și le oferă control asupra cheltuielilor AI.

Experiența pe care o vei construi

JamZY · Programări
Demo-ul real JamZY pentru programări: alegeți un serviciu și o oră, apoi conectați opțional ShareAI pentru a genera pregătirea.

Alege o programare. Conectează ShareAI. Ajungi cu un plan.

IMPLEMENTAREA TA

O conexiune cu clientul pe care te poți baza.

Trei livrabile concrete: conectează clientul, pregătește programarea și fă integrarea gata de verificare.

Obține referința de implementare
01ACCESUL CLIENTULUI

Autentificare și sesiuni reînnoibile

Un client își selectează contul ShareAI, aprobă aplicația ta și revine la JamZY.

OAuth + PKCEConsimțământul contului
Poți verifica când

Autentifică-te, reîmprospătează sesiunea și deconectează-te cu succes.

Construiește conexiunea cu clientul
02AI PENTRU PROGRAMĂRI

Un proiect util de pregătire

Transformă un obiectiv de programare într-o agendă și întrebări printr-o cerere AI deliberată.

AI finanțat de clientAcces la model
Poți verifica când

Generează un proiect; salvarea unei programări nu face niciun apel AI.

Construiește fluxul de pregătire
03TERMENI & REVIZUIRE

O configurare pe care o poți verifica

Explică taxele opționale AI și colectează verificările platformei necesare pentru trimiterea revizuirii.

Contracte acceptateVerificări ale platformei
Poți verifica când

Fiecare platformă inclusă și domeniul solicitat au verificări înregistrate.

Setează termenii și verifică aplicația

DU-O ÎN EDITORUL TĂU

Construiește cu agentul tău.

Copiază ghidul complet cu obiectivul implementării, intrările necesare și verificările de acceptare. Păstrează exemplele de cod, tabelele și linkurile de documentație împreună.

Ghid completContextul implementăriiVerificări de validare
Mai multe formate
Vizualizează ca Markdown Descarcă Markdown

Gata pentru proiectul tău, în formatul de care ai nevoie.

Actualizat

Vezi ce vei construi

Veți construi o conexiune pe care clienții dvs. o pot înțelege: contul lor ShareAI, un proiect opțional de pregătire AI și o cale clară înapoi la programarea lor.

Unde veți lucra Exemplul dvs. finalizat

Conectați aplicația dvs. la Builder ShareAI, de la înscriere până la o integrare testată gata pentru revizuire. Acest ghid practic utilizează JamZY, o mică aplicație de programare Node.js, pentru a arăta fiecare pas: înregistrați aplicația, configurați platforma sa Web, conectați un cont ShareAI al unui client și trimiteți o cerere AI autorizată. Aplicați aceiași pași pentru propriul dvs. produs.

CapacitateLa ce este de acord clientulCe demonstrează JamZY
Conectați-vă cu ShareAIO conexiune de cont și informațiile de identitate pe care aplicația dvs. le solicită.O identitate privată a clientului din informațiile autentificate ale Utilizatorului.
Plătiți cu ShareAI · Utilizare AIUtilizarea contului personal sau organizațional selectat de client pentru inferență autorizată.Un proiect de pregătire a programării finanțat de creditele eligibile ale acelui cont.
Builder marcajTaxa suplimentară pentru utilizarea AI în contractul de aplicație acceptat.Monetizarea opțională a utilizării, după aprobare și publicarea contractului.
Plăți pentru produsO achiziție specifică prezentată într-un checkout separat ShareAI.O extensie explicată în ghidul de plată. Demo-ul programării nu implementează checkout-ul.

Aveți un cont ShareAI, permisiunea de a utiliza contul personal sau organizațional care va deține aplicația, un callback public HTTPS, un logo și pagini funcționale de confidențialitate, termeni și ștergere a contului. Pentru a rula exemplul, utilizați Node.js 22 sau o versiune mai nouă și o adresă HTTPS pentru aplicația dvs.

JamZY · aplicație de referință pentru programări Mărește captura de ecran ↗
Demo-ul real JamZY pentru programări: alegeți un serviciu și o oră, apoi conectați opțional ShareAI pentru a genera pregătirea.
Programarea locală și pregătirea AI finanțată de client sunt acțiuni separate. Nicio invitație de calendar nu este trimisă de acest demo.
  1. Alegeți tipul și durata programării.
  2. Selectați un interval de demo disponibil.
  3. Conectați ShareAI pentru a utiliza asistentul AI opțional.
  4. AI rulează doar după această acțiune explicită; rezervarea singură nu apelează ShareAI.
Utilizați detaliile propriei aplicații

Capturile de ecran utilizează detalii de aplicație exemplu. Adresele ShareAI din acest ghid sunt adrese de producție. Generarea pregătirii face o cerere reală de AI și poate consuma credite; selectarea sau salvarea unei programări demo nu face acest lucru. Verificările de validare sunt finalizate prin testele de integrare reușite proprii.

Sunteți gata să continuați când

Puteți distinge între autentificarea contului, consumul AI, suprataxa opțională și o achiziție confirmată a produsului. Citirea acestui ghid nu necesită o cerere plătită.

Alătură-te Programului Builder

Veți crea identitatea Builder care deține aplicația dvs. și relațiile sale cu clienții.

Unde veți lucra Consolă → Builder Program

  1. Creați sau conectați-vă la contul dvs. ShareAI. Alegeți contul personal sau al organizației care va deține JamZY; utilizați același cont pe parcursul configurării.
  2. Deschide Builder Program în Consola ShareAIAlegeți activitățile builder care se potrivesc cu munca dvs. Pentru acest ghid, alegeți calea companiei de produse pentru o aplicație pe care o dețineți. Client Work este pentru servicii livrate unui client; o integrare conectează o aplicație existentă.
  3. Selectați contul personal sau organizațional care va deține înscrierea în program înainte de aplicare. Organizațiile pot trimite o aplicație înainte de verificare, dar aprobarea personalului singură nu activează accesul. Finalizați verificarea emailului organizației și a companiei din lista de verificare de onboarding în Console. O organizație aprobată rămâne În așteptarea verificării până când ambele verificări sunt complete. Builder, Provider și Creator programele urmează această regulă.
  4. După acceptare, deschideți Builder Program → Product. Comutatorul de actori identifică contul pe care îl editați.
Builder Program · punct de intrare pentru înscriere Mărește captura de ecran ↗
Pagina de destinație Builder Program introduce calea produsului și oferă linkuri pentru înscrierea în Console.
Începeți cu calea produsului, apoi finalizați înscrierea pentru contul care va deține JamZY.
  1. Continuați în Console pentru a vă înscrie în Builder Program.
Sunteți gata să continuați când

Builder Program se deschide pentru proprietarul intenționat și oferă aplicație nouă. O decizie de înscriere, o revizuire a aplicației, o revizuire a informațiilor publice și aprobarea Monetization Gateway sunt pași separați.

Creează-ți aplicația

Veți oferi JamZY propriul său registru de aplicație, astfel încât identitatea, accesul și termenii comerciali să rămână împreună.

Unde veți lucra Programul Builder → Produs → Aplicație nouă

  1. În Product, selectați New app. Introduceți site-ul dvs. public pentru a completa detaliile inițiale sau alegeți I will write them manually.
  2. Încărcați un logo PNG sau JPEG, introduceți JamZY ca nume și descrieți produsul într-o propoziție clară. Revizuiți site-ul web și e-mailul de contact al builder-ului.
  3. Continuați cu întrebările de configurare. Păstrați răspunsurile sincere: ele descriu modul în care aplicația este livrată și plătită.
Configurarea aplicației · detalii Mărește captura de ecran ↗
Examinați numele aplicației, introducerea, logo-ul și site-ul public înainte de a continua. Detaliile de contact sunt ilustrative.
Examinați numele aplicației, introducerea, logo-ul și site-ul public înainte de a continua. Detaliile de contact sunt ilustrative.
  1. Dați aplicației un nume clar.
  2. Continuați cu întrebările de onboarding.

Utilizați un site web public accesibil pentru profilul aplicației. Un site web privat sau disponibil doar local poate eșua validarea chiar și atunci când callback-ul de dezvoltare este înregistrat corect. Noua aplicație începe ca un draft. Puteți continua editarea fără a o face publică. Identificatorul aplicației este diferit de un ID client OAuth sau un ID de abonament.

Sunteți gata să continuați când

JamZY apare sub Produs pentru proprietarul vizat. Nu creați o aplicație suplimentară pentru fiecare platformă de dispozitiv.

Descrieți cum este livrată aplicația dvs.

Veți primi opțiuni OAuth care se potrivesc locului unde rulează aplicația dvs. și cine controlează acreditivele acesteia.

Unde veți lucra Aplicație nouă → Configurare aplicație

Pentru o implementare JamZY pe care o operați singur, alegeți modelul de tarifare care se potrivește cu oferta dvs., SaaS, aplicație cloud găzduită de furnizor, Clientul plătește pentru propriul consum și ShareAI pentru cererile AI. Acestea sunt răspunsuri exemplu, nu o cerință pentru fiecare produs.

Configurare aplicație · implementare Mărește captura de ecran ↗
Răspunsul la onboarding determină dacă este disponibil un secret de client server.
Răspunsul la onboarding determină dacă este disponibil un secret de client server.
  1. Alegeți unde rulează efectiv aplicația dvs.
Unde rulează aplicațiaAlegerea OAuthUnde se află acreditările
Backend-ul găzduit de dvs.Serverul web client poate utiliza un secret client. PKCE se aplică în continuare.Secretul și token-urile rămân pe serverul dvs.
Aplicație browser / SPAClient Web public cu PKCE.Fără secret client încorporat. Utilizați un design de sesiune browser sau backend adecvat.
Distribuție auto-găzduită sau hibridăClient public cu PKCE conform politicii de onboarding.Nu distribuiți un secret comun al furnizorului către instalările clientului.
Windows, macOS, Linux, Android sau iOSUn client public pentru fiecare platformă activată.PKCE și stocare securizată adecvată platformei; fără secret inclus.

Exemplul descărcabil JamZY folosește deliberat un client Web public cu PKCE, chiar dacă are un backend mic. Serverul păstrează token-urile în afara stocării browserului. Un răspuns găzduit de furnizor permite un client server; nu vă obligă să alegeți unul.

Puteți revizita răspunsurile salvate sub Informații Aplicație → Configurare aplicație. Modificările de implementare pot elimina secretele client incompatibile și pot necesita verificare repetată. Revizuiți impactul înainte de a salva.

Sunteți gata să continuați când

Implementarea salvată descrie arhitectura dvs. reală. Opțiunea secret-client urmează acel răspuns; o opțiune dezactivată este o explicație a politicii, nu o acreditare lipsă.

Aveți nevoie de detalii?Înregistrare client ↗

Introduceți clar aplicația dvs.

Veți oferi clienților detaliile produsului și politicile de care au nevoie înainte de a decide să se conecteze.

Unde veți lucra Informații Aplicație

Deschideți Informații Aplicație după Dashboard. Lucrați prin secțiunile dedicate: detalii, configurare aplicație, prezentare, branding, galerie și revizuire. Oferiți produsului o descriere utilă, un site web precis și capturi de ecran clare ale fluxului de lucru al clientului.

Informații Aplicație Mărește captura de ecran ↗
Dați aplicației dvs. un nume propriu, o introducere și un site web public HTTPS.
Dați aplicației dvs. un nume propriu, o introducere și un site web public HTTPS.
  1. Dezvoltați detaliile, configurarea, prezentarea și brandingul în secțiunile lor proprii.

Utilizați propria identitate a aplicației. Branding-ul ShareAI aparține butonului de integrare și materialului explicativ; nu ar trebui să înlocuiască logo-ul produsului dvs. Păstrați linkurile de confidențialitate, termeni și ștergere accesibile fără autentificare.

Salvați modificările când apare acțiunea de salvare flotantă. Propunerea de informații publice are propria revizuire; editarea unei propuneri aprobate nu înlocuiește în mod silențios prezentarea publică live.

Sunteți gata să continuați când

Un vizitator poate înțelege ce face JamZY, cine o operează și cum să solicite ștergerea. Detaliile publice și configurarea callback se referă la același produs.

Alegeți ce pot autoriza clienții

Veți solicita accesul pe care experiența programării dvs. îl utilizează efectiv și veți clarifica scopul său de facturare.

Unde veți lucra Aplicație → Cazuri de utilizare

În Cazuri de Utilizare, activați Login cu ShareAI pentru conectarea contului și Pay with ShareAI pentru fluxul finanțat de client pe care intenționați să îl susțineți. Solicitați accesul Monetization Gateway doar dacă produsul dvs. va genera o taxă suplimentară pentru utilizarea AI. Urmați starea de aprobare afișată în Console.

Cazuri de utilizare Mărește captura de ecran ↗
Log-in with ShareAI, Pay with ShareAI și Monetization Gateway au stări separate de configurare și aprobare.
Log-in with ShareAI, Pay with ShareAI și Monetization Gateway au stări separate de configurare și aprobare.
  1. Configurează autentificarea cu ShareAI.
  2. Activează utilizarea finanțată de client.
DomeniuDe ce ați solicita acest lucru
openidConectați un cont utilizând identitatea sa limitată la client.
profile / emailSolicitați revendicări de profil sau email doar dacă produsul dvs. are nevoie de ele.
inferenceApelați punctele de acces suportate pentru inferența AI atunci când sunt permise de configurația aplicației.
monetization_gatewayUtilizați acordul de facturare AI acceptat de client pentru inferența cu suprataxă.
paymentsCreați și inspectați cererile de plată ale clientului. Fiecare achiziție necesită în continuare confirmare.

Cereri JamZY openid profile inference monetization_gateway. Nu solicită payments și nu vinde un produs prin checkout. Activarea unei capabilități în Console nu o acordă unui token de acces existent: clientul trebuie să autorizeze domeniile și termenii.

Sunteți gata să continuați când

Capabilitățile, domeniile configurate și cererea de autorizare sunt de acord. Evitați solicitarea accesului opțional pe care aplicația dvs. nu îl utilizează niciodată sau nu îl poate verifica.

Configurați integrarea Web

Veți crea un client Web pentru experiența bazată pe browser JamZY, cu metoda de autentificare corectă.

Unde veți lucra Setări OAuth → Web

  1. Deschideți setările OAuth. Alegeți Web din grila platformei. Puteți configura un client pe platformă: Web, Windows, macOS, Linux, Android și iOS.
  2. Pentru acest exemplu, alegeți aplicația Browser / SPA, clientul public PKCE. O aplicație web server este potrivită doar atunci când politica dvs. de implementare o permite și backend-ul dvs. poate proteja un secret.
  3. Copiați propriul ID de client Web. Mențineți platforma în Testare în timp ce o integrați. Nu copiați niciodată un ID dintr-un screenshot sau reutilizați înregistrarea demo partajată pentru un alt produs.
Setări OAuth · grila platformei Mărește captura de ecran ↗
Un client înregistrat per platformă. Platformele neconfigurate rămân opționale.
Un client înregistrat per platformă. Platformele neconfigurate rămân opționale.
  1. Deschideți integrarea unică Web.
  2. Adăugați Android doar atunci când produsul dvs. îl suportă.
Web · Prezentare generală Mărește captura de ecran ↗
Un client Web public folosește PKCE și nu are secret de client. ID-ul clientului este redactat.
Un client Web public folosește PKCE și nu are secret de client. ID-ul clientului este redactat.
  1. Copiați propriul ID de client Web.
  2. Un client public nu primește un secret.

Platformele diferite au credențiale și reguli de callback diferite. Ele nu sunt produse separate: abonamentele și gestionarea clienților sunt agregate pentru aplicație. Testerii aplicației sunt partajați între platforme, cu un maxim de cinci locuri, inclusiv invitațiile în așteptare; proprietarul nu consumă un loc de tester.

Sunteți gata să continuați când

Există exact o platformă Web. Platformele native pe care nu le-ați configurat nu blochează lansarea dvs.

Aveți nevoie de detalii?Înregistrare platformă ↗

Aduceți clienții înapoi la aplicația dvs.

Veți returna clienții la aplicația dvs. după autorizare, folosind un callback exact pe care îl dețineți.

Unde veți lucra Web → Configurare

În Web → Configurare, înregistrați callback-ul exact HTTPS pe care aplicația dvs. îl gestionează. Acest ghid folosește https://jamzy.example/oauth/callback ca exemplu. Înlocuiți jamzy.example cu domeniul HTTPS unde implementați copia dvs. de JamZY, și utilizați același callback în configurarea aplicației dvs.

Înregistrează callback-ul pe care aplicația ta implementată îl gestionează.
Înregistrează callback-ul pe care aplicația ta implementată îl gestionează.
  1. Înregistrează callback-ul pe care aplicația ta implementată îl gestionează.

Furnizați numele ecranului de consimțământ, termenii, informațiile de confidențialitate și ștergere. Activați doar scopurile de care aveți nevoie, apoi salvați. Schema, gazda, calea și detaliile interogării aplicabile trebuie să se potrivească cu cererea de autorizare și schimbul de cod. Nu utilizați un wildcard sau un fragment URL.

PlatformăCallback de implementat
WebAdresa exactă HTTPS din aplicația dvs.
AndroidO schemă de aplicație inversă-domeniu care corespunde ID-ului aplicației sau un App Link HTTPS verificat cu pachetul și amprenta de semnare SHA-256.
iOSO schemă de aplicație corespunzătoare sau un Universal Link HTTPS verificat cu ID-ul pachetului și prefixul Apple App ID.
Windows / macOS / LinuxUn callback exact HTTPS permis, o schemă de aplicație inversă-domeniu corespunzătoare sau o redirecționare loopback suportată pe 127.0.0.1 / [::1]. Portul loopback poate varia.

Aplicațiile instalate autorizează în browserul sistemului și revin prin callback-ul înregistrat. Pentru linkurile HTTPS revendicate ale aplicației, publicați fișierul de asociere necesar și rulați verificarea asocierii în Console. Un callback care pare plauzibil într-un formular nu este dovada că aplicația dvs. instalată îl primește.

Sunteți gata să continuați când

Deschiderea callback-ului prin fluxul de autorizare revine la aplicația dvs. Un cod aleatoriu sau un stat nepotrivit este respins.

Rulați propria aplicație JamZY

Veți avea interfața de programare a întâlnirilor și conexiunea sa ShareAI rulând cu identificatorii aplicației dvs.

Unde veți lucra Aplicația dvs. → Configurarea mediului

JamZY este o aplicație de întâlniri cu un asistent opțional de pregătire AI. Programatorul său este o demonstrație doar în browser: nu există furnizor de calendar, livrare prin email sau plată pentru întâlniri. Integrarea de autorizare ShareAI și API-ul AI utilizează upstream-ul configurat real.

Descărcați JamZY sursa de referință. Conține serverul Node, interfața browserului, teste și un README de configurare; fără certificate, secrete, dependențe sau sesiuni. Revizuiți fișierele înainte de a le rula. Puneți procesul Node în spatele unui proxy invers HTTPS care păstrează originea publică.

# .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.mjs
Mențineți mediile împreună

Creați aplicația dvs. la consolă.shareai.acum. Utilizați ID-ul clientului de producție cu https://auth.shareai.now și https://api.shareai.now/api/v1. Adresa jamzy.example este un substitut pentru aplicația dvs., nu o demonstrație găzduită. Serviți propria aplicație prin HTTPS astfel încât cookie-ul său de sesiune securizată să funcționeze.

JamZY oferă, de asemenea, o conexiune cu cheie API pentru comparație. Acest ghid utilizează butonul portofel/OAuth. O cheie API nu stabilește acordul OAuth al clientului JamZY și nu este un înlocuitor pentru fluxul de autorizare al clientului.

Sunteți gata să continuați când

Aplicația se încarcă prin HTTPS. Originea sa publică, callback-ul înregistrat și ID-ul clientului corespund înregistrării dvs. Niciun token sau secret nu apare în sursa paginii sau în localStorage.

Conectați primul client

Veți permite unui client să își aleagă contul ShareAI și să aprobe accesul de care are nevoie aplicația dvs.

Unde veți lucra JamZY → Plătiți cu Portofelul dvs. ShareAI

Din JamZY, selectați Plătiți cu Portofelul dvs. ShareAI. Aplicația deschide pagina de autorizare ShareAI. Clientul se autentifică, selectează un cont personal sau de organizație, verifică aplicația și accesul solicitat și acceptă termenii de abonament aplicabili.

  1. JamZY → AutentificareCreați un state aleatoriu și un verificator PKCE; trimiteți provocarea S256 împreună cu cererea de autorizare.
  2. Client → AutentificareAlegeți contul de plată și revizuiți accesul și termenii de facturare. Anularea trebuie să lase JamZY deconectat.
  3. Autentificare → callbackPrimiți un cod unic, de scurtă durată, și state-ul. Validați state-ul în raport cu aceeași sesiune.
  4. Backend → tokenSchimbați acel cod cu verificatorul original și URI-ul de redirecționare identic. Clienții publici nu trimit un secret de client.
  5. Backend → Informații utilizatorUtilizați token-ul de acces pentru a citi identitatea autentificată, apoi stabiliți sesiunea securizată proprie a JamZY.
Web · Endpoint-uri de producție Mărește captura de ecran ↗
Utilizați aceste adrese de producție ShareAI cu ID-ul clientului din console.shareai.now.
Utilizați aceste adrese de producție ShareAI cu ID-ul clientului din console.shareai.now.
  1. Autorizați la auth.shareai.now/oauth/authorize.
  2. Schimbați coduri și tokenuri de reîmprospătare la auth.shareai.now/oauth/token.
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.

Identificați înregistrarea locală a clientului prin sub și contextul emitent/client al acestuia. Autorizările personale și organizaționale pot selecta conturi de plată diferite. Un ID de client nu este un ID global de utilizator, adresă de e-mail sau ID intern al bazei de date organizaționale. Nu combinați identitățile între platforme prin potrivirea numelor afișate.

Sunteți gata să continuați când

Anularea, state-ul nepotrivit, codul reutilizat și autorizarea expirată eșuează în siguranță. Fluxul normal returnează un cont autentificat fără a expune token-urile acestuia.

Mențineți clientul conectat în siguranță

Veți menține cererile autorizate funcționale pe măsură ce token-urile expiră, oferind în același timp clientului o modalitate fiabilă de deconectare.

Unde veți lucra Aplicația dvs. → Gestionarea sesiunii și a token-urilor

AcreditivScopCum să îl gestionați
Cod de autorizareTransfer unic de pe pagina de autorizare.Schimbați o singură dată, utilizând verificatorul și callback-ul corespunzător. Nu este un token API.
Token de accesAutorizează apelurile API în cadrul grantului și domeniilor acceptate.Trimiteți ca Authorization: Bearer …. Respectați expirarea și erorile de autorizare ale endpoint-ului.
Token de reîmprospătareObține token-uri de acces înlocuitoare fără o altă autentificare, cât timp grantul rămâne valabil.Stocați în siguranță. Serializați operațiunile de reîmprospătare și înlocuiți atomic acreditivele rotite.
Token IDO aserțiune de identitate OpenID Connect pentru client.Dacă îl utilizați, validați semnătura, emitentul, audiența, expirarea și nonce-ul, după caz. Nu îl utilizați ca un token Bearer inferențial.
Secretul clientuluiAutentifică un client server confidențial permis.Stocați pe server. Este diferit de toate token-urile și nu este niciodată inclus într-un client public.
# 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"

Utilizați expires_in în loc să inventați o durată de viață. Dacă reîmprospătarea returnează un token de reîmprospătare înlocuitor, persistați-l împreună cu noul token de acces ca o singură actualizare. Permiteți o singură reîmprospătare în desfășurare per sesiune, astfel încât cererile concurente să nu reutilizeze un token rotit. Un grant de reîmprospătare invalid sau revocat necesită reconectare; nu repetați la nesfârșit.

Reîmprospătarea nu poate adăuga un scop sau accepta în mod silențios un nou contract Monetization Gateway. Trimiteți clientul prin autorizare din nou pentru noi permisiuni sau termeni. JamZY stochează acreditările doar în memoria serverului pentru o sesiune demo de maximum o oră, autentifică informațiile utilizatorului în loc să se bazeze pe un token ID neverificat și folosește un cookie Secure, HttpOnly, SameSite. Un serviciu de producție are nevoie de propriul design de sesiune durabil și protejat.

La deconectare, revocați acreditivele de reîmprospătare/acces acolo unde este aplicabil și ștergeți sesiunea aplicației. Ștergerea unui cookie de browser singur nu revocă un grant ShareAI sau nu anulează un abonament plătit. Evitați logarea codurilor, token-urilor, secretelor sau conținutului personal al promptului.

Sunteți gata să continuați când

Expirarea declanșează o reîmprospătare controlată; noile token-uri înlocuiesc pe cele vechi. Deconectarea șterge sesiunea aplicației și raportează orice eșec de revocare.

Pregătiți prima programare cu AI

Veți transforma un obiectiv al întâlnirii într-o agendă și întrebări utile, cu o cerere explicită de AI finanțată de client.

Unde veți lucra Modele disponibile → JamZY → Veniți pregătit

Deschideți Modele disponibile în aplicație. Selectați modelele și furnizorii pe care produsul dvs. le va oferi și salvați configurația. Dacă catalogul nu poate fi încărcat, rezolvați eroarea de disponibilitate upstream înainte de a continua; schimbarea repetată a clienților OAuth nu o va repara.

Alegeți ce modele și furnizori pot folosi clienții dvs. Rezolvați orice eroare de catalog înainte de a continua.
Alegeți ce modele și furnizori pot folosi clienții dvs. Rezolvați orice eroare de catalog înainte de a continua.
  1. Catalogul de modele aparține acestei aplicații.

JamZY încarcă catalogul său doar după conectare. Alegeți un model de text permis, introduceți un obiectiv scurt al întâlnirii și selectați Generați pregătirea deliberat. Contul selectat are nevoie de credite eligibile și de orice termeni de facturare AI necesari acceptați. Alegerea unei date, revizuirea unei întâlniri și salvarea acesteia nu trimit o cerere de inferență.

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}'

Urmați fluxul întâlnirii în JamZY

  1. În Programare, alegeți un serviciu: o introducere de 15 minute, o planificare de proiect de 30 de minute sau o conversație mai aprofundată de 60 de minute.
  2. Alegeți o zi și o oră disponibilă. Orele folosesc fusul orar afișat de browser. Disponibilitatea este ilustrativă, iar întâlnirile salvate afectează doar acest browser.
  3. În Veniți pregătit, introduceți un exemplu de obiectiv fără detalii personale. Alegeți un model, apoi selectați Generați pregătirea. JamZY trimite serviciul selectat și obiectivul dvs. către ShareAI, redă textul returnat în siguranță și lasă rezervarea neschimbată.
  4. Revizuiți agenda dvs. Selectați Revizuire întâlnire, verificați serviciul, ziua, ora și durata, apoi Confirmați întâlnirea demo. Această acțiune nu apelează AI și nu efectuează o plată.
  5. Deschideți Întâlnirile mele pentru a vedea înregistrarea demo salvată. Reîncărcați pentru a confirma persistența acesteia sau eliminați-o pentru a face slotul din nou disponibil. Doar serviciul, ziua, ora și o referință locală aleatorie sunt stocate; schițele AI, obiectivele, token-urile și cheile nu sunt salvate cu întâlnirile.
Examinați serviciul, data, ora și durata înainte de a salva această programare demo doar în browser. Mărește captura de ecran ↗
Examinați serviciul, data, ora și durata înainte de a salva această programare demo doar în browser.
Examinați serviciul, data, ora și durata înainte de a salva această programare demo doar în browser.
  1. Examinați selecția completă înainte de a confirma.
  2. Această acțiune salvează un registru demo; nu apelează AI și nu efectuează plăți.
Programările mele afișează registrele demo locale. Eliminarea unui registru face ca intervalul său ilustrativ să fie din nou disponibil. Mărește captura de ecran ↗
Programările mele afișează registrele demo locale. Eliminarea unui registru face ca intervalul său ilustrativ să fie din nou disponibil.
Programările mele afișează registrele demo locale. Eliminarea unui registru face ca intervalul său ilustrativ să fie din nou disponibil.
  1. Registrul persistă în acest browser fără detalii personale sau note AI.
  2. Eliminați programarea demo și eliberați intervalul său.

Un produs real de programare necesită un depozit de rezervări pe partea de server, verificări de disponibilitate, gestionarea fusului orar, politici de anulare și integrare cu calendarul sau notificările. Acestea sunt separate de autorizarea ShareAI. Păstrați rezultatul AI ca o propunere; validați orice acțiune viitoare de rezervare prin regulile propriei aplicații.

Utilizați un model slug returnat de catalogul permis. Gestionați contractul de răspuns efectiv: JamZY suportă nativ ShareAI. message.content plicul și stilul OpenAI choices[0].message.content. HTTP 200 cu un răspuns de eroare incomplet sau imbricat nu este un răspuns de succes.

La un răspuns de limită de cheltuieli sau credit insuficient, afișați o explicație utilă și linkul de facturare furnizat clientului. Păstrați contul selectat. Nu depășiți limita acestuia, nu schimbați plătitorul în mod silențios și nu reluați o operațiune taxată într-un ciclu.

Sunteți gata să continuați când

Generarea pregătirii returnează o agendă utilizabilă și întrebări. Cererea este atribuită clientului și aplicației autorizate, cu modelul selectat și termenii acceptați. Schița AI nu poate programa sau modifica o întâlnire.

Setați câștigurile opționale AI

Veți explica taxa suplimentară AI în cadrul unei oferte de abonament și veți publica termenii pe care clienții îi pot accepta.

Unde veți lucra Aplicație → Abonamente

Solicitați accesul Monetization Gateway prin Cazurile de Utilizare ale aplicației dacă nu este deja aprobat de politica administrativă aplicabilă. Completați chestionarul și urmăriți starea acestuia. Aprobarea permite configurarea; permisiunea clientului și consimțământul de facturare rămân separate.

Abonamente · Prezentare generală Mărește captura de ecran ↗
Aplicațiile noi încep fără un contract publicat. Adăugați o ofertă înainte de a publica termenii acesteia.
Aplicațiile noi încep fără un contract publicat. Adăugați o ofertă înainte de a publica termenii acesteia.
  1. Creați o ofertă în propriul editor.
  1. Deschideți Abonamentele. Adăugați o ofertă, dați-i un nume clar și descrieți markup-ul Builder pe care clienții îl vor plăti. ID-ul de abonament generat este doar pentru citire și este limitat la această aplicație; copiați-l atunci când integrarea dvs. are nevoie de el.
  2. Editați fiecare abonament în propriul editor. Utilizați Estimare pentru a inspecta costul rețelei și câștigurile dvs. pentru modelul selectat și presupunerile de utilizare. Estimările sunt previzualizări, nu prețuri garantate sau termeni acceptați.
  3. Examinați împreună schița, apoi publicați versiunea contractului atunci când cerințele acesteia sunt îndeplinite. Versiunea publicată descrie ce pot accepta noii clienți.
  4. Utilizați prezentarea generală și distribuția contractelor pentru a vedea câte conturi rămân pe fiecare versiune acceptată. Un client păstrează termenii acceptați până când acceptă explicit un înlocuitor; publicarea unei noi versiuni nu îi migrează în mod silențios. Păstrați tranziția implicită care conservă contractele acceptate. Dacă alegeți în mod deliberat Solicitare consimțământ reînnoit înainte de alte acțiuni ale aplicației, accesul existent poate fi întrerupt până când clientul aprobă noii termeni.

Exemplu doar: un markup 20% Builder pe €1.00 din costul eligibil al rețelei adaugă €0.20. La prețurile Standard, taxa ShareAI 5% se aplică doar acelui markup €0.20, înainte de orice Ingestie de Evenimente facturabilă. Utilizați estimatorul live și contractul acceptat pentru calculul real. O ofertă de abonament în acest flux este un acord de facturare AI; conectarea contului singură nu debitează un preț fix recurent.

Abonamente · editor de oferte Mărește captura de ecran ↗
O ofertă ilustrativă de tip schiță. ID-ul de abonament generat este doar pentru citire și este limitat la această aplicație.
O ofertă ilustrativă de tip schiță. ID-ul de abonament generat este doar pentru citire și este limitat la această aplicație.
  1. Utilizați un nume de ofertă orientat către client.
  2. Setați AI surcharge pentru această ofertă.

Ecranul de consimțământ ShareAI este autoritar pentru termenii acceptați. Clientul public al JamZY nu poate deduce planul de facturare acceptat din informațiile utilizatorului, astfel încât panoul său de conexiune nu pretinde un abonament activ sau nu inventează un preț pentru programare.

Sunteți gata să continuați când

Oferta explică taxa; contractul poate fi acceptat de client. Înțelegi care clienți rămân pe termenii mai vechi și de ce.

Demonstrați că platformele incluse funcționează

Vei colecta endpoint-ul real și verificările de scope necesare pentru a trimite aplicația ta spre revizuire.

Unde veți lucra Setări OAuth → Testeri și Verificare

Deschide setările OAuth → Testeri și invită până la cinci testeri la nivel de aplicație. Invitările în așteptare ocupă un loc, dar nu oferă acces; destinatarul trebuie să accepte. Accesul proprietarului și accesul testerilor invitați sunt diferite de accesul public în producție.

Testeri ai aplicației Mărește captura de ecran ↗
O singură listă de testeri servește toate platformele. Invitările în așteptare contează pentru limita de cinci locuri.
O singură listă de testeri servește toate platformele. Invitările în așteptare contează pentru limita de cinci locuri.
  1. Cinci locuri sunt partajate de întreaga aplicație.
  2. Invitați un tester aici, apoi așteptați acceptarea acestuia.
O nouă integrare afișează verificări în așteptare până când sunt înregistrate apeluri reale de succes. Acest proiect de referință nu a trecut de revizuire.
O nouă integrare afișează verificări în așteptare până când sunt înregistrate apeluri reale de succes. Acest proiect de referință nu a trecut de revizuire.
  1. Consola înregistrează succesul efectiv al punctelor finale.
  2. Fiecare domeniu solicitat trebuie, de asemenea, exercitat.

Pentru fiecare platformă pe care intenționezi să o publici, deschide Verificare. Completează apeluri reale de succes pentru endpoint-urile necesare și fiecare scope configurat. Verifică descoperirea și cheile de semnare; testează autorizare/callback, schimb de cod, reîmprospătare, informații autentificate despre utilizator și revocare. Clienții confidențiali trebuie, de asemenea, să testeze introspecția aplicabilă. Linkurile HTTPS revendicate nativ necesită verificarea asocierii.

Un profil/domeniu de email necesită revendicările reale returnate; utilizați un cont personal de testare unde emailul este obligatoriu. Domeniile inference și monetization_gateway necesită o cerere AI autorizată completată. Plățile necesită un apel API de plată cu domeniu de succes. Un răspuns HTTP generic de succes, captură de ecran a browserului sau o listă de verificare manuală nu înlocuiește verificările înregistrate de Console.

Ai trei opțiuni pentru o platformă neterminată: finalizeaz-o și verific-o, exclude-o din publicare astfel încât să rămână doar pentru proprietar/testeri sau elimin-o. Nu include o platformă cu callback-uri sau scope-uri pe care nu le-ai utilizat. Modificările de configurare pot invalida verificările, așa că actualizează starea înregistrată după modificările finale.

Sunteți gata să continuați când

Fiecare platformă inclusă afișează configurația necesară, verificările endpoint-urilor și scope-urilor ca fiind complete. Lista de verificare personală a ghidului este doar un ajutor pentru citire.

Trimiteți aplicația dvs. și urmăriți clienții acesteia

Vei ști ce este gata pentru revizuire, cum funcționează publicarea și unde să urmărești accesul clienților ulterior.

Unde veți lucra Aplicație → Panou de control

  1. Revino la Panoul de control și rezolvă fiecare acțiune restantă. Trimiterea spre revizuire trebuie să rămână indisponibilă până când aplicația și toate platformele incluse îndeplinesc cerințele.
  2. Trimite aplicația pentru revizuirea ShareAI. Urmărește decizia și orice modificări solicitate în Dashboard și Activitate & Decizii. Cererile pentru prezentarea publică și Gateway-ul de Monetizare pot avea decizii separate.
  3. După aprobare, publică aplicația utilizând controalele de publicare disponibile. Confirmă că platformele incluse sunt pregătite pentru producție; cele excluse rămân în Testing.
  4. Deschide Customers pentru conturile la nivel de aplicație și Subscriptions pentru distribuția pe bază de contract acceptat. Analytics te ajută să urmărești utilizarea AI atribuită și câștigurile. Identificatorii clienților rămân privați în contextul corespunzător client/autorizație.
Dashboard · pregătire pentru lansare Mărește captura de ecran ↗
Revizuirea rămâne blocată în timp ce aplicația și platformele incluse au cerințe restante.
Revizuirea rămâne blocată în timp ce aplicația și platformele incluse au cerințe restante.
  1. Rezolvați acțiunile necesare înainte de a trimite pentru revizuire.
Vizualizarea aplicației reunește conturile conectate fără a afișa ID-urile interne ale bazei de date ale organizației.
Vizualizarea aplicației reunește conturile conectate fără a afișa ID-urile interne ale bazei de date ale organizației.
  1. Gestionarea clienților este agregată pentru aplicație.

Încearcă din nou întregul flux cu un client eligibil după lansare: conectează, inspectează contul și consimțământul, generează un draft scurt de pregătire pentru întâlnire, reîmprospătează în siguranță, gestionează un eșec de facturare, apoi deconectează. Verifică experiența utilizatorului live în loc să presupui că o salvare reușită dovedește că funcționează.

Când ceva nu funcționează

Nepotrivire Callback: compară exact URL-ul înregistrat și ambele valori ale cererii. Tester neautorizat: confirmă acceptarea invitației și contul selectat. Domeniu sau contract lipsă: solicită doar accesul activat și reconectează-te pentru a-l accepta. Niciun model: inspectează Modelele Disponibile și restricțiile furnizorului. Eșec la reîmprospătare: șterge sesiunea locală eșuată și reconectează-te. Revizuire blocată: inspectează verificările platformei în loc să creezi un alt client OAuth.

Sunteți gata să continuați când

Aplicația funcționează pentru clientul vizat, verificările înregistrate susțin starea sa de publicare, iar clientul poate controla sau revoca autorizarea.

Verificarea organizației și accesul la program

Selectați contul personal sau organizațional care va deține înscrierea în program înainte de aplicare. Organizațiile pot trimite o aplicație înainte de verificare, dar aprobarea personalului singură nu activează accesul. Finalizați verificarea emailului organizației și a companiei din lista de verificare de onboarding în Console. O organizație aprobată rămâne În așteptarea verificării până când ambele verificări sunt complete. Builder, Provider și Creator programele urmează această regulă.

Vizualizați prețurile Monetization Gateway. · Explorează ShareAI for Startups · Domenii și permisiuni

Permisiuni și termeni acceptați

Termenii și condițiile publice, Politica de confidențialitate și instrucțiunile de ștergere trebuie să corespundă aplicației și să rămână accesibile fără autentificare. Acceptarea programului ShareAI, aprobarea Monetization Gateway, permisiunea OAuth a clientului și contractul de facturare acceptat sunt decizii separate. Reîmprospătarea nu poate adăuga permisiuni sau accepta noi termeni comerciali.

Domeniul vechi surcharge rămâne acceptat pentru integrările existente. Noile exemple utilizează monetization_gateway. Păstrați câmpurile existente, cum ar fi surcharge_bps și surcharge_percentage, neschimbate.

Vizualizați prețurile Monetization Gateway. · Explorează ShareAI for Startups · Domenii și permisiuni

Taxe Gateway și suport Startup

Taxele standard 5% ale Builder markup. Pentru €2.00 din costul rețelei AI și un 10% markup, clientul plătește €2.20. ShareAI primește €0.01 din €0.20 markup; Builder are €0.19 înainte de Event Ingestion.

Primele 1,000 cereri de Producție stabilite Monetization Gateway sunt gratuite în fiecare lună calendaristică (UTC), partajate în contul Builder. Cererile suplimentare costă €0.04 per 1,000 înainte de aplicarea reducerilor eligibile. O cerere stabilită creează un eveniment.

Pay with ShareAI pe cont propriu, inference-acces exclusiv, cheile API ale conturilor obișnuite și traficul de Staging sau testare nu generează Monetization Gateway Ingestie de Evenimente.

ShareAI for Startups oferă o alocație lunară partajată pentru taxele reale ShareAI pe o aplicație aprobată. Nivelurile actuale Launch, Growth și Momentum listează €1,000, €5,000 și €10,000 pe lună. Același buget acoperă taxa procentuală ShareAI pe adaosul Builder și Ingestionarea Evenimentelor facturabile împreună. Nu este o alocație pentru adaos brut, o cotă separată de evenimente gratuite sau inferență AI gratuită inference. Primele 1,000 evenimente gratuite ale contului nu o consumă.

Taxele rămase pentru Ingestionarea Evenimentelor sunt plătite din noile câștiguri ale cererii Builder, apoi din câștigurile AI disponibile Builder și creditele AI nerestricționate. Taxele AI ale clientului și produsul payments rămân separate.

ShareAI poate aproba taxe specifice aplicației sau suport pentru taxe pentru o perioadă fixă sau până la modificare. Revizuiți prețurile actuale ale aplicației și Programele Speciale în Console pentru termenii aprobați, valabilitate și alocația consumată. O schimbare de nivel sau o suprascriere a prețurilor nu resetează utilizarea lunară a aplicației.

Launch păstrează opțional Log in with ShareAI. Growth și Momentum îl necesită; Momentum necesită, de asemenea, insigna oficială ShareAI for Startups în subsolul aplicației. ShareAI verifică săptămânal insigna. Încercările confirmate de a ocoli cerințele pot duce la retrogradare, eliminare din Programul Startup sau retragere din Marketplace conform termenilor programului acceptați.

Tarifele pentru Enterprise sunt configurate de echipa ShareAI pentru contul Builder după ce se ajunge la un acord personalizat. Procentajul atribuit și rata evenimentului se aplică cererilor viitoare.

Vizualizați prețurile Monetization Gateway. · Explorează ShareAI for Startups · Domenii și permisiuni

Întreabă despre această pagină

Alege un asistent pentru a explora această pagină. Poți, de asemenea, să copiezi pagina și să o inserezi în conversația ta.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI