AI Prosumer
ID

BANGUN DENGAN SHAREAI

Cara menghubungkan aplikasi ke ShareAI Builder, langkah demi langkah

Bangun aplikasi janji temu yang menghubungkan pelanggan ke ShareAI, mempersiapkan agenda AI yang berguna, dan memberikan kontrol atas pengeluaran AI mereka.

Pengalaman yang akan Anda bangun

JamZY · Janji Temu
Demo janji temu JamZY yang sebenarnya: pilih layanan dan waktu, lalu opsional hubungkan ShareAI untuk menghasilkan persiapan.

Pilih janji temu. Hubungkan ShareAI. Datang dengan rencana.

IMPLEMENTASI ANDA

Koneksi pelanggan yang dapat Anda bangun.

Tiga hasil konkret: hubungkan pelanggan, persiapkan janji temu mereka, dan buat integrasi siap untuk diverifikasi.

Dapatkan referensi implementasi
01AKSES PELANGGAN

Masuk dan sesi yang dapat diperbarui

Pelanggan memilih akun ShareAI mereka, menyetujui aplikasi Anda, dan kembali ke JamZY.

OAuth + PKCEPersetujuan akun
Anda dapat memverifikasinya ketika

Masuk, perbarui sesi, dan putuskan koneksi dengan sukses.

Bangun koneksi pelanggan
02AI JANJI TEMU

Draf persiapan yang berguna

Ubah tujuan janji temu menjadi agenda dan pertanyaan melalui permintaan AI yang terencana.

AI yang didanai pelangganAkses model
Anda dapat memverifikasinya ketika

Hasilkan draf; menyimpan janji temu tidak membuat panggilan AI.

Bangun alur persiapan
03SYARAT & TINJAUAN

Pengaturan yang dapat Anda verifikasi

Jelaskan biaya AI opsional dan kumpulkan pemeriksaan platform yang diperlukan untuk pengajuan tinjauan Anda.

Kontrak yang diterimaPemeriksaan platform
Anda dapat memverifikasinya ketika

Setiap platform yang disertakan dan cakupan yang diminta memiliki pemeriksaan yang tercatat.

Tetapkan syarat dan verifikasi aplikasi

BAWA KE EDITOR ANDA

Bangun dengan agen Anda.

Salin panduan lengkap dengan tujuan implementasi, input yang diperlukan, dan pemeriksaan penerimaan. Simpan contoh kode, tabel, dan tautan dokumentasi bersama-sama.

Panduan lengkapKonteks implementasiPemeriksaan verifikasi
Format lainnya
Lihat sebagai Markdown Unduh Markdown

Siap untuk proyek Anda, dalam format yang Anda butuhkan.

Diperbarui

Lihat apa yang akan Anda bangun

Anda akan membangun koneksi yang dapat dipahami pelanggan Anda: akun ShareAI mereka, draf persiapan AI opsional, dan jalur yang jelas kembali ke janji temu mereka.

Tempat Anda akan bekerja Contoh selesai Anda

Hubungkan aplikasi Anda ke ShareAI Builder, dari pendaftaran hingga integrasi yang telah diuji siap untuk ditinjau. Panduan ini menggunakan JamZY, aplikasi janji temu Node.js kecil, untuk menunjukkan setiap langkah: daftarkan aplikasi, konfigurasikan platform Web-nya, hubungkan akun ShareAI pelanggan dan kirimkan permintaan AI yang diotorisasi. Terapkan langkah yang sama ke produk Anda sendiri.

KemampuanApa yang disetujui pelangganApa yang ditunjukkan oleh JamZY
Login dengan ShareAIKoneksi akun dan informasi identitas yang diminta aplikasi Anda.Identitas pelanggan pribadi dari info Pengguna yang diautentikasi.
Bayar dengan ShareAI · penggunaan AIMenggunakan akun pribadi atau organisasi yang dipilih pelanggan untuk inferensi yang diotorisasi.Draf persiapan janji temu yang didanai oleh kredit yang memenuhi syarat dari akun tersebut.
Builder markupBiaya penggunaan AI tambahan dalam kontrak aplikasi yang diterima.Monetisasi penggunaan opsional, setelah persetujuan dan publikasi kontrak.
Pembayaran produkPembelian tertentu yang disajikan dalam checkout ShareAI terpisah.Ekstensi dijelaskan dalam panduan pembayaran. Demo janji temu tidak menerapkan checkout.

Miliki akun ShareAI, izin untuk menggunakan akun pribadi atau organisasi yang akan memiliki aplikasi, callback HTTPS publik, logo, dan halaman privasi, syarat, serta penghapusan akun yang berfungsi. Untuk menjalankan contoh, gunakan Node.js 22 atau lebih baru dan alamat HTTPS untuk aplikasi Anda.

JamZY · aplikasi referensi janji temu Perbesar tangkapan layar ↗
Demo janji temu JamZY yang sebenarnya: pilih layanan dan waktu, lalu opsional hubungkan ShareAI untuk menghasilkan persiapan.
Penjadwalan janji temu lokal dan persiapan AI yang didanai pelanggan adalah tindakan terpisah. Tidak ada undangan kalender yang dikirim oleh demo ini.
  1. Pilih jenis dan durasi janji temu.
  2. Pilih slot demo yang tersedia.
  3. Hubungkan ShareAI untuk menggunakan asisten AI opsional.
  4. AI hanya berjalan setelah tindakan eksplisit ini; pemesanan saja tidak memanggil ShareAI.
Gunakan detail aplikasi Anda sendiri

Screenshot menggunakan detail aplikasi contoh. Alamat ShareAI dalam panduan ini adalah alamat produksi. Pembuatan persiapan membuat permintaan AI nyata dan dapat menghabiskan kredit; memilih atau menyimpan janji demo tidak. Pemeriksaan verifikasi diselesaikan oleh pengujian integrasi Anda yang berhasil.

Anda siap melanjutkan ketika

Anda dapat membedakan login akun, konsumsi AI, biaya tambahan opsional, dan pembelian produk yang dikonfirmasi. Membaca panduan ini tidak memerlukan permintaan berbayar.

Bergabung dengan Program Builder

Anda akan membuat identitas Builder yang memiliki aplikasi Anda dan hubungan pelanggan.

Tempat Anda akan bekerja Konsol → Builder Program

  1. Buat atau masuk ke akun ShareAI Anda. Pilih akun pribadi atau organisasi yang akan memiliki JamZY; gunakan akun yang sama selama pengaturan.
  2. Buka Builder Program di Konsol ShareAIPilih aktivitas builder yang sesuai dengan pekerjaan Anda. Untuk panduan ini, pilih jalur perusahaan produk untuk aplikasi yang Anda miliki. Client Work adalah untuk layanan yang diberikan kepada pelanggan; integrasi menghubungkan aplikasi yang sudah ada.
  3. Pilih akun pribadi atau organisasi yang akan memiliki pendaftaran program sebelum mengajukan. Organisasi dapat mengirimkan aplikasi sebelum verifikasi, tetapi persetujuan staf saja tidak mengaktifkan akses. Lengkapi verifikasi email organisasi dan perusahaan dari daftar tugas onboarding di Console. Organisasi yang disetujui tetap Pending verification hingga kedua pemeriksaan selesai. Builder, Provider, dan program Creator mengikuti aturan ini.
  4. Setelah diterima, buka Builder Program → Product. Pengalih aktor mengidentifikasi akun yang sedang Anda edit.
Builder Program · titik masuk pendaftaran Perbesar tangkapan layar ↗
Halaman arahan Builder Program memperkenalkan jalur produk dan menautkan ke pendaftaran di Console.
Mulai dengan jalur produk, lalu selesaikan pendaftaran untuk akun yang akan memiliki JamZY.
  1. Lanjutkan ke Console untuk mendaftar di Builder Program.
Anda siap melanjutkan ketika

Builder Program terbuka untuk pemilik yang dimaksud dan menawarkan Aplikasi Baru. Keputusan pendaftaran, tinjauan aplikasi, tinjauan informasi publik, dan persetujuan Monetization Gateway adalah langkah-langkah terpisah.

Buat aplikasi Anda

Anda akan memberikan JamZY catatan aplikasinya sendiri, sehingga identitas, akses, dan ketentuan komersialnya tetap bersama.

Tempat Anda akan bekerja Builder Program → Product → Aplikasi Baru

  1. Di Product, pilih Aplikasi Baru. Masukkan situs web publik Anda untuk mengisi detail awal, atau pilih Saya akan menulisnya secara manual.
  2. Unggah logo PNG atau JPEG, masukkan JamZY sebagai nama, dan deskripsikan produk dalam satu kalimat yang jelas. Tinjau situs web dan email kontak builder.
  3. Lanjutkan ke pertanyaan pengaturan. Tetap jujur dalam menjawab: mereka menjelaskan bagaimana aplikasi disampaikan dan dibayar.
Pengaturan aplikasi · detail Perbesar tangkapan layar ↗
Tinjau nama aplikasi, pengantar, logo, dan situs web publik sebelum melanjutkan. Detail kontak bersifat ilustratif.
Tinjau nama aplikasi, pengantar, logo, dan situs web publik sebelum melanjutkan. Detail kontak bersifat ilustratif.
  1. Berikan nama yang jelas untuk aplikasi.
  2. Lanjutkan ke pertanyaan onboarding.

Gunakan situs web publik yang dapat diakses untuk profil aplikasi. Situs web pribadi atau hanya-lokal dapat gagal validasi bahkan ketika callback pengembangan Anda telah terdaftar dengan benar. Aplikasi baru dimulai sebagai draft. Anda dapat terus mengedit tanpa membuatnya publik. Identifier aplikasi berbeda dari OAuth client ID atau subscription ID.

Anda siap melanjutkan ketika

JamZY muncul di bawah Produk untuk pemilik yang dimaksud. Jangan buat aplikasi tambahan untuk setiap platform perangkat.

Jelaskan bagaimana aplikasi Anda disampaikan

Anda akan mendapatkan opsi OAuth yang sesuai dengan tempat aplikasi Anda berjalan dan siapa yang mengontrol kredensialnya.

Tempat Anda akan bekerja Aplikasi baru → Pengaturan aplikasi

Untuk JamZY deployment yang Anda operasikan sendiri, pilih model harga yang sesuai dengan penawaran Anda, SaaS, aplikasi cloud yang di-host oleh Vendor, Pelanggan membayar untuk konsumsi mereka sendiri, dan ShareAI untuk permintaan AI. Ini adalah jawaban contoh, bukan persyaratan untuk setiap produk.

Pengaturan aplikasi · deployment Perbesar tangkapan layar ↗
Jawaban onboarding menentukan apakah secret klien server tersedia.
Jawaban onboarding menentukan apakah secret klien server tersedia.
  1. Pilih di mana aplikasi Anda sebenarnya berjalan.
Di mana aplikasi berjalanPilihan OAuthDi mana kredensial disimpan
Backend yang Anda hostKlien server web dapat menggunakan secret client. PKCE tetap berlaku.Secret dan token tetap berada di server Anda.
Aplikasi browser / SPAKlien Web publik dengan PKCE.Tidak ada secret client yang disematkan. Gunakan desain sesi browser atau backend yang sesuai.
Distribusi self-hosted atau hybridKlien publik dengan PKCE di bawah kebijakan onboarding.Jangan mendistribusikan secret vendor bersama ke instalasi pelanggan.
Windows, macOS, Linux, Android atau iOSSatu klien publik untuk setiap platform yang diaktifkan.PKCE dan penyimpanan aman yang sesuai dengan platform; tidak ada secret yang disertakan.

Contoh unduhan JamZY sengaja menggunakan klien Web publik dengan PKCE, meskipun memiliki backend kecil. Server menjaga token agar tidak tersimpan di penyimpanan browser. Jawaban yang di-host oleh vendor mengizinkan klien server; ini tidak memaksa Anda untuk memilih satu.

Anda dapat meninjau kembali jawaban yang disimpan di bawah Informasi Aplikasi → Pengaturan aplikasi. Perubahan deployment dapat menghapus secret client yang tidak kompatibel dan memerlukan verifikasi ulang. Tinjau dampaknya sebelum menyimpan.

Anda siap melanjutkan ketika

Deployment yang disimpan menggambarkan arsitektur nyata Anda. Opsi secret client mengikuti jawaban tersebut; opsi yang dinonaktifkan adalah penjelasan kebijakan, bukan kredensial yang hilang.

Butuh detailnya?Registrasi klien ↗

Perkenalkan aplikasi Anda dengan jelas

Anda akan memberikan pelanggan detail produk dan kebijakan yang mereka butuhkan sebelum mereka memutuskan untuk terhubung.

Tempat Anda akan bekerja Informasi Aplikasi

Buka Informasi Aplikasi setelah Dashboard. Kerjakan bagian-bagian khusus: detail, pengaturan aplikasi, presentasi, branding, galeri, dan tinjauan. Berikan deskripsi produk yang berguna, situs web yang akurat, dan tangkapan layar yang jelas tentang alur kerja pelanggan.

Informasi Aplikasi Perbesar tangkapan layar ↗
Berikan nama, pengantar, dan situs web HTTPS publik untuk aplikasi Anda.
Berikan nama, pengantar, dan situs web HTTPS publik untuk aplikasi Anda.
  1. Kembangkan detail, pengaturan, presentasi, dan branding di bagian mereka sendiri.

Gunakan identitas aplikasi Anda sendiri. Branding ShareAI milik tombol integrasi dan materi penjelasan; ini tidak boleh menggantikan logo produk Anda. Pastikan tautan privasi, syarat, dan penghapusan dapat diakses tanpa masuk.

Simpan perubahan saat tindakan simpan mengambang muncul. Proposal informasi publik memiliki tinjauan tersendiri; mengedit proposal yang disetujui tidak secara diam-diam menggantikan presentasi publik yang aktif.

Anda siap melanjutkan ketika

Pengunjung dapat memahami apa yang dilakukan JamZY, siapa yang mengoperasikannya, dan bagaimana cara meminta penghapusan. Detail publik dan konfigurasi callback merujuk pada produk yang sama.

Pilih apa yang dapat diotorisasi pelanggan

Anda akan meminta akses yang benar-benar digunakan oleh pengalaman janji temu Anda dan menjelaskan tujuan penagihannya dengan jelas.

Tempat Anda akan bekerja Aplikasi → Use Cases

Dalam Kasus Penggunaan, aktifkan Login dengan ShareAI untuk koneksi akun dan Pay with ShareAI untuk alur yang didanai pelanggan yang ingin Anda dukung. Minta akses Monetization Gateway hanya jika produk Anda akan menghasilkan biaya tambahan pada penggunaan AI. Ikuti status persetujuan yang ditampilkan di Console.

Log-in with ShareAI, Pay with ShareAI dan Monetization Gateway memiliki konfigurasi dan status persetujuan yang terpisah.
Log-in with ShareAI, Pay with ShareAI dan Monetization Gateway memiliki konfigurasi dan status persetujuan yang terpisah.
  1. Konfigurasikan Login dengan ShareAI.
  2. Aktifkan penggunaan yang didanai pelanggan.
LingkupMengapa Anda akan memintanya
openidHubungkan akun menggunakan identitas yang terikat pada client.
profile / emailMinta klaim profil atau email hanya jika produk Anda membutuhkannya.
inferencePanggil endpoint inferensi AI yang didukung saat diizinkan oleh konfigurasi aplikasi.
monetization_gatewayGunakan perjanjian penagihan AI yang diterima oleh pelanggan untuk inferensi dengan surcharge.
paymentsBuat dan periksa permintaan pembayaran pelanggan. Setiap pembelian masih memerlukan konfirmasi.

JamZY permintaan openid profile inference monetization_gateway. Itu tidak meminta payments dan tidak menjual produk melalui checkout. Mengaktifkan kemampuan di Console tidak memberikannya pada token akses yang ada: pelanggan harus mengotorisasi scope dan syarat.

Anda siap melanjutkan ketika

Kemampuan, scope yang dikonfigurasi, dan permintaan otorisasi sesuai. Hindari meminta akses opsional yang tidak pernah digunakan atau tidak dapat diverifikasi oleh aplikasi Anda.

Siapkan integrasi Web Anda

Anda akan membuat satu Web client untuk pengalaman berbasis browser JamZY, dengan metode autentikasi yang tepat.

Tempat Anda akan bekerja Pengaturan OAuth → Web

  1. Buka pengaturan OAuth. Pilih Web dari grid platform. Anda dapat mengonfigurasi satu client per platform: Web, Windows, macOS, Linux, Android, dan iOS.
  2. Untuk contoh ini pilih Browser application / SPA, client PKCE publik. Aplikasi web Server hanya sesuai jika kebijakan deployment Anda mengizinkannya dan backend Anda dapat melindungi sebuah secret.
  3. Salin ID Web client Anda sendiri. Tetap gunakan platform dalam Testing saat Anda mengintegrasikannya. Jangan pernah menyalin ID dari tangkapan layar atau menggunakan ulang registrasi demo bersama untuk produk yang berbeda.
Pengaturan OAuth · grid platform Perbesar tangkapan layar ↗
Satu klien terdaftar per platform. Platform yang tidak dikonfigurasi tetap opsional.
Satu klien terdaftar per platform. Platform yang tidak dikonfigurasi tetap opsional.
  1. Buka integrasi Web tunggal.
  2. Tambahkan Android hanya jika produk Anda mendukungnya.
Klien Web publik menggunakan PKCE dan tidak memiliki rahasia klien. ID klien disembunyikan.
Klien Web publik menggunakan PKCE dan tidak memiliki rahasia klien. ID klien disembunyikan.
  1. Salin ID klien Web Anda sendiri.
  2. Klien publik tidak menerima rahasia.

Platform yang berbeda memiliki kredensial dan aturan callback yang berbeda. Mereka bukan produk terpisah: langganan dan manajemen pelanggan digabungkan untuk aplikasi. Penguji aplikasi dibagikan di seluruh platform, dengan maksimum lima tempat termasuk undangan yang tertunda; pemilik tidak mengonsumsi tempat penguji.

Anda siap melanjutkan ketika

Tepat satu platform Web ada. Platform native yang belum Anda konfigurasi tidak akan menghalangi peluncuran Anda.

Butuh detailnya?Registrasi Platform ↗

Bawa pelanggan kembali ke aplikasi Anda

Anda akan mengembalikan pelanggan ke aplikasi Anda setelah otorisasi, menggunakan callback yang tepat yang Anda miliki.

Tempat Anda akan bekerja Web → Konfigurasi

Dalam Web → Konfigurasi, daftarkan callback HTTPS yang tepat yang ditangani oleh aplikasi Anda. Panduan ini menggunakan https://jamzy.example/oauth/callback sebagai contoh. Ganti jamzy.example dengan domain HTTPS tempat Anda menerapkan salinan JamZY, dan gunakan callback yang sama dalam konfigurasi aplikasi Anda.

Web · Konfigurasi Perbesar tangkapan layar ↗
Daftarkan callback yang ditangani oleh aplikasi yang Anda terapkan.
Daftarkan callback yang ditangani oleh aplikasi yang Anda terapkan.
  1. Daftarkan callback yang ditangani oleh aplikasi yang Anda terapkan.

Berikan nama layar persetujuan, syarat, informasi privasi, dan penghapusan. Aktifkan hanya cakupan yang Anda perlukan, lalu simpan. Skema, host, path, dan detail query yang berlaku harus sesuai dengan permintaan otorisasi dan pertukaran kode. Jangan gunakan wildcard atau fragmen URL.

PlatformCallback untuk diimplementasikan
WebAlamat HTTPS yang tepat pada aplikasi Anda.
AndroidSkema aplikasi reverse-domain yang sesuai dengan ID aplikasi, atau HTTPS App Link yang terverifikasi dengan paket dan fingerprint penandatanganan SHA-256.
iOSSkema aplikasi yang sesuai, atau HTTPS Universal Link yang terverifikasi dengan bundle ID dan prefix Apple App ID.
Windows / macOS / LinuxCallback HTTPS yang diizinkan, skema aplikasi reverse-domain yang sesuai, atau redirect loopback yang didukung pada 127.0.0.1 / [::1]. Port loopback dapat bervariasi.

Aplikasi yang terinstal mengotorisasi di browser sistem dan kembali melalui callback yang terdaftar. Untuk HTTPS app link yang diklaim, publikasikan file asosiasi yang diperlukan dan jalankan verifikasi asosiasi di Console. Callback yang terlihat masuk akal dalam sebuah formulir bukanlah bukti bahwa aplikasi yang terinstal menerima callback tersebut.

Anda siap melanjutkan ketika

Membuka callback melalui alur otorisasi kembali ke aplikasi Anda. Kode acak atau state yang tidak cocok akan ditolak.

Jalankan aplikasi JamZY Anda sendiri

Anda akan memiliki antarmuka janji temu dan koneksi ShareAI yang berjalan dengan pengidentifikasi aplikasi Anda sendiri.

Tempat Anda akan bekerja Aplikasi Anda → Konfigurasi lingkungan

JamZY adalah aplikasi janji temu dengan asisten persiapan AI opsional. Penjadwalnya adalah demonstrasi berbasis browser saja: tidak ada penyedia kalender, pengiriman email, atau pembayaran janji temu. Integrasi otorisasi ShareAI dan API AI menggunakan upstream yang dikonfigurasi secara nyata.

Unduh Referensi sumber JamZY. Ini berisi server Node, UI browser, pengujian, dan README pengaturan; tidak ada sertifikat, rahasia, dependensi, atau sesi. Tinjau file sebelum menjalankannya. Tempatkan proses Node di belakang proxy reverse HTTPS yang mempertahankan asal publik.

# .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
Jaga lingkungan tetap bersama

Buat aplikasi Anda di console.shareai.sekarang. Gunakan ID klien produksinya dengan https://auth.shareai.now dan https://api.shareai.now/api/v1. Alamat jamzy.example adalah placeholder untuk aplikasi Anda, bukan demo yang di-host. Layani aplikasi Anda sendiri melalui HTTPS agar cookie sesi aman berfungsi.

JamZY juga menawarkan koneksi API-key untuk perbandingan. Panduan ini menggunakan tombol wallet/OAuth. API key tidak menetapkan perjanjian OAuth JamZY pelanggan dan bukan pengganti alur otorisasi pelanggan.

Anda siap melanjutkan ketika

Aplikasi dimuat melalui HTTPS. Asal publiknya, callback yang terdaftar, dan ID klien sesuai dengan pendaftaran Anda. Tidak ada token atau rahasia yang muncul di sumber halaman atau localStorage.

Hubungkan pelanggan pertama Anda

Anda akan membiarkan pelanggan memilih akun ShareAI mereka dan menyetujui akses yang diperlukan oleh aplikasi Anda.

Tempat Anda akan bekerja JamZY → Bayar dengan ShareAI Wallet Anda

Dari JamZY, pilih Bayar dengan ShareAI Wallet Anda. Aplikasi membuka halaman otorisasi ShareAI. Pelanggan masuk, memilih akun pribadi atau organisasi, memeriksa aplikasi dan akses yang diminta, serta menerima syarat langganan yang berlaku.

  1. JamZY → AuthBuat state acak dan PKCE verifier; kirim tantangan S256-nya bersama permintaan otorisasi.
  2. Customer → AuthPilih akun pembayaran dan tinjau akses serta ketentuan penagihan. Pembatalan harus meninggalkan JamZY tidak terhubung.
  3. Auth → callbackTerima kode satu kali yang berumur pendek dan state. Validasi state terhadap sesi yang sama.
  4. Backend → tokenTukarkan kode tersebut dengan verifier asli dan URI pengalihan yang identik. Klien publik tidak mengirimkan client secret.
  5. Backend → Informasi penggunaGunakan access token untuk membaca identitas yang terautentikasi, lalu buat sesi aman milik JamZY.
Web · Titik akhir produksi Perbesar tangkapan layar ↗
Gunakan alamat produksi ShareAI ini dengan ID klien dari console.shareai.now.
Gunakan alamat produksi ShareAI ini dengan ID klien dari console.shareai.now.
  1. Otorisasi di auth.shareai.now/oauth/authorize.
  2. Tukarkan kode dan refresh token di 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.

Kunci catatan pelanggan lokal berdasarkan client-scoped yang terautentikasi sub dan konteks penerbit/kliennya. Otorisasi pribadi dan organisasi dapat memilih akun pembayaran yang berbeda. ID pelanggan bukanlah ID pengguna global, alamat email, atau ID database organisasi internal. Jangan menggabungkan identitas lintas platform dengan mencocokkan nama tampilan.

Anda siap melanjutkan ketika

Pembatalan, state yang tidak cocok, kode yang digunakan ulang, dan otorisasi yang kadaluarsa akan gagal dengan aman. Alur normal mengembalikan akun yang terautentikasi tanpa mengekspos tokennya.

Jaga agar pelanggan tetap terhubung dengan aman

Anda akan menjaga permintaan yang telah diotorisasi tetap berfungsi saat token kadaluarsa, sambil memberikan cara yang dapat diandalkan kepada pelanggan untuk memutuskan koneksi.

Tempat Anda akan bekerja Aplikasi Anda → Penanganan sesi dan token

KredensialTujuanCara menanganinya
Kode otorisasiPenyerahan satu kali dari halaman otorisasi.Tukarkan sekali, menggunakan verifier dan callback yang sesuai. Ini bukan API token.
Token aksesMengotorisasi panggilan API dalam grant dan scope yang diterima.Kirim sebagai Authorization: Bearer …. Hormati kadaluarsa dan kesalahan otorisasi endpoint.
Token penyegaranMendapatkan pengganti access token tanpa perlu masuk ulang selama grant tetap berlaku.Simpan dengan aman. Serialisasi operasi refresh dan ganti kredensial yang diputar secara atomik.
Token IDPernyataan identitas OpenID Connect untuk klien.Jika Anda menggunakannya, validasi tanda tangan, penerbit, audiens, kadaluarsa, dan nonce sesuai kebutuhan. Jangan gunakan sebagai token Bearer inferensi.
Rahasia klienMengautentikasi klien server rahasia yang diizinkan.Simpan di server. Ini berbeda dari semua token dan tidak pernah disertakan dalam klien publik.
# 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"

Gunakan yang dikembalikan expires_in alih-alih menciptakan masa berlaku. Jika refresh mengembalikan refresh token pengganti, simpan bersama access token baru sebagai satu pembaruan. Izinkan satu refresh dalam proses per sesi sehingga permintaan bersamaan tidak menggunakan token yang diputar ulang. Grant refresh yang tidak valid atau dicabut memerlukan koneksi ulang; jangan melakukan loop tanpa batas.

Penyegaran tidak dapat menambahkan cakupan atau diam-diam menerima kontrak baru Monetization Gateway. Kirim pelanggan melalui otorisasi lagi untuk izin atau persyaratan baru. JamZY menyimpan kredensial hanya dalam memori server untuk sesi demo maksimum satu jam, mengautentikasi informasi Pengguna daripada mempercayai token ID yang tidak terverifikasi, dan menggunakan cookie Secure, HttpOnly, SameSite. Layanan produksi membutuhkan desain sesi yang tahan lama dan terlindungi sendiri.

Saat terputus, cabut kredensial penyegaran/akses jika berlaku dan hapus sesi aplikasi. Menghapus cookie browser saja tidak mencabut pemberian ShareAI atau membatalkan langganan berbayar. Hindari mencatat kode, token, rahasia, atau konten prompt pribadi.

Anda siap melanjutkan ketika

Kedaluwarsa memicu satu penyegaran yang terkontrol; token baru menggantikan yang lama. Pemutusan menghapus sesi aplikasi dan melaporkan kegagalan pencabutan apa pun.

Persiapkan janji temu pertama dengan AI

Anda akan mengubah tujuan janji temu menjadi agenda dan pertanyaan yang berguna, dengan permintaan AI yang didanai pelanggan secara eksplisit.

Tempat Anda akan bekerja Model Tersedia → JamZY → Datang dengan persiapan

Buka Model Tersedia di aplikasi. Pilih model dan penyedia yang akan ditawarkan produk Anda dan simpan konfigurasinya. Jika katalog tidak dapat dimuat, selesaikan kesalahan ketersediaan upstream sebelum melanjutkan; mengubah klien OAuth berulang kali tidak akan memperbaikinya.

Pilih model dan penyedia mana yang dapat digunakan pelanggan Anda. Selesaikan kesalahan katalog sebelum melanjutkan.
Pilih model dan penyedia mana yang dapat digunakan pelanggan Anda. Selesaikan kesalahan katalog sebelum melanjutkan.
  1. Katalog model adalah milik aplikasi ini.

JamZY memuat katalognya hanya setelah koneksi. Pilih model teks yang diizinkan, masukkan tujuan janji temu singkat dan pilih Hasilkan persiapan secara sengaja. Akun yang dipilih memerlukan kredit yang memenuhi syarat dan syarat penagihan AI yang diterima. Memilih tanggal, meninjau janji temu, dan menyimpannya tidak mengirimkan permintaan inferensi.

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

Ikuti alur janji temu di JamZY

  1. Di Jadwal, pilih layanan: pengenalan 15 menit, perencanaan proyek 30 menit, atau percakapan mendalam 60 menit.
  2. Pilih hari dan waktu yang tersedia. Waktu menggunakan zona waktu yang ditampilkan di browser. Ketersediaan bersifat ilustratif dan janji temu yang disimpan hanya memengaruhi browser ini.
  3. Di Datang dengan persiapan, masukkan tujuan contoh tanpa detail pribadi. Pilih model, lalu pilih Hasilkan persiapan. JamZY mengirimkan layanan yang dipilih dan tujuan Anda ke ShareAI, merender teks yang dikembalikan dengan aman dan membiarkan pemesanan tidak berubah.
  4. Tinjau agenda Anda sendiri. Pilih Tinjau janji temu, periksa layanannya, hari, waktu, dan durasinya, lalu Konfirmasi janji temu demo. Tindakan ini tidak memanggil AI atau melakukan pembayaran.
  5. Buka Janji temu saya untuk melihat catatan demo yang disimpan. Muat ulang untuk memastikan catatan tetap ada, atau hapus untuk membuat slot tersedia lagi. Hanya layanan, hari, waktu, dan referensi lokal acak yang disimpan; draf AI, tujuan, token, dan kunci tidak disimpan dengan janji temu.
Tinjau layanan, tanggal, waktu, dan durasi sebelum menyimpan janji temu demo hanya di browser ini. Perbesar tangkapan layar ↗
Tinjau layanan, tanggal, waktu, dan durasi sebelum menyimpan janji temu demo hanya di browser ini.
Tinjau layanan, tanggal, waktu, dan durasi sebelum menyimpan janji temu demo hanya di browser ini.
  1. Tinjau pilihan lengkap sebelum mengonfirmasi.
  2. Tindakan ini menyimpan catatan demo; tidak memanggil AI atau menerima pembayaran.
Janji temu saya menunjukkan catatan demo lokal. Menghapus catatan membuat slot ilustratifnya tersedia kembali. Perbesar tangkapan layar ↗
Janji temu saya menunjukkan catatan demo lokal. Menghapus catatan membuat slot ilustratifnya tersedia kembali.
Janji temu saya menunjukkan catatan demo lokal. Menghapus catatan membuat slot ilustratifnya tersedia kembali.
  1. Catatan tetap ada di browser ini tanpa detail pribadi atau catatan AI.
  2. Hapus janji temu demo dan lepaskan slotnya.

Produk penjadwalan nyata memerlukan penyimpanan pemesanan di sisi server, pemeriksaan ketersediaan, penanganan zona waktu, kebijakan pembatalan, dan integrasi kalender atau notifikasi. Ini terpisah dari otorisasi ShareAI. Pertahankan keluaran AI sebagai proposal; validasi setiap tindakan pemesanan di masa depan melalui aturan aplikasi Anda sendiri.

Gunakan model slug yang dikembalikan oleh katalog yang diizinkan. Tangani kontrak respons aktual: JamZY mendukung ShareAI secara native message.content envelope dan gaya OpenAI choices[0].message.content. HTTP 200 dengan respons error yang tidak lengkap atau bersarang bukanlah balasan yang berhasil.

Pada respons batas pengeluaran atau kredit tidak mencukupi, tampilkan penjelasan yang berguna dan tautan tagihan pelanggan yang disediakan. Pertahankan akun yang dipilih. Jangan melewati batasnya, mengganti pembayar secara diam-diam, atau mencoba ulang operasi yang dikenakan biaya dalam sebuah loop.

Anda siap melanjutkan ketika

Pengembalian persiapan menghasilkan agenda dan pertanyaan yang dapat digunakan. Permintaan ini dikaitkan dengan pelanggan dan aplikasi yang diotorisasi, dengan model yang dipilih dan syarat yang diterima. Draf AI tidak dapat memesan atau mengubah janji temu.

Tetapkan penghasilan AI opsional Anda

Anda akan menjelaskan biaya tambahan AI Anda dalam penawaran langganan dan mempublikasikan syarat yang dapat diterima pelanggan.

Tempat Anda akan bekerja Aplikasi → Langganan

Minta akses Monetization Gateway melalui Kasus Penggunaan aplikasi jika belum disetujui oleh kebijakan administratif yang berlaku. Lengkapi kuesioner dan ikuti statusnya. Persetujuan memungkinkan konfigurasi; izin pelanggan dan persetujuan penagihan tetap terpisah.

Langganan · Ikhtisar Perbesar tangkapan layar ↗
Aplikasi baru dimulai tanpa kontrak yang diterbitkan. Tambahkan penawaran sebelum menerbitkan ketentuannya.
Aplikasi baru dimulai tanpa kontrak yang diterbitkan. Tambahkan penawaran sebelum menerbitkan ketentuannya.
  1. Buat penawaran di editor tersendiri.
  1. Langganan Terbuka. Tambahkan penawaran, beri nama yang jelas, dan jelaskan markup Builder yang akan dibayar pelanggan. ID langganan yang dihasilkan hanya dapat dibaca dan cakupannya terbatas pada aplikasi ini; salin saat integrasi Anda membutuhkannya.
  2. Edit setiap langganan di editornya sendiri. Gunakan Estimasi untuk memeriksa biaya jaringan dan penghasilan Anda untuk model yang dipilih dan asumsi penggunaan. Estimasi adalah pratinjau, bukan harga yang dijamin atau syarat yang diterima.
  3. Tinjau draf bersama, lalu publikasikan versi kontrak saat persyaratannya terpenuhi. Versi yang dipublikasikan menjelaskan apa yang dapat diterima pelanggan baru.
  4. Gunakan ikhtisar dan distribusi kontrak untuk melihat berapa banyak akun yang tetap pada setiap versi yang diterima. Pelanggan mempertahankan syarat yang diterima hingga mereka secara eksplisit menerima penggantinya; mempublikasikan versi baru tidak secara diam-diam memigrasi mereka. Pertahankan transisi default yang menjaga kontrak yang diterima. Jika Anda dengan sengaja memilih Memerlukan persetujuan ulang sebelum tindakan aplikasi lebih lanjut, akses yang ada dapat terganggu hingga pelanggan menyetujui syarat baru.

Contoh saja: markup 20% Builder pada €1.00 dari biaya jaringan yang memenuhi syarat menambahkan €0.20. Pada harga Standar, biaya ShareAI 5% hanya berlaku untuk markup €0.20 tersebut, sebelum Event Ingestion yang dapat ditagih. Gunakan estimator langsung dan kontrak yang diterima untuk perhitungan sebenarnya. Penawaran langganan dalam alur ini adalah perjanjian penagihan AI; koneksi akun saja tidak mendebit harga tetap berulang.

Langganan · editor penawaran Perbesar tangkapan layar ↗
Draf penawaran ilustratif. ID langganan yang dihasilkan bersifat hanya-baca dan cakupannya terbatas pada aplikasi ini.
Draf penawaran ilustratif. ID langganan yang dihasilkan bersifat hanya-baca dan cakupannya terbatas pada aplikasi ini.
  1. Gunakan nama penawaran yang menghadap pelanggan.
  2. Tetapkan AI surcharge untuk penawaran ini.

Layar persetujuan ShareAI adalah otoritatif untuk syarat yang diterima. Klien publik JamZY tidak dapat menyimpulkan rencana penagihan yang diterima dari informasi Pengguna, sehingga panel koneksinya tidak mengklaim langganan aktif atau menciptakan harga untuk janji temu.

Anda siap melanjutkan ketika

Penawaran menjelaskan biaya; kontrak dapat diterima oleh pelanggan. Anda memahami pelanggan mana yang tetap menggunakan syarat lama dan alasannya.

Buktikan platform yang disertakan berfungsi

Anda akan mengumpulkan endpoint nyata dan pemeriksaan cakupan yang diperlukan untuk mengajukan aplikasi Anda untuk ditinjau.

Tempat Anda akan bekerja Pengaturan OAuth → Penguji dan Verifikasi

Buka pengaturan OAuth → Penguji dan undang hingga lima penguji aplikasi secara keseluruhan. Undangan yang tertunda mengonsumsi tempat tetapi tidak memberikan akses; penerima harus menerima. Akses pemilik dan akses penguji yang diundang berbeda dari akses produksi publik.

Daftar penguji tunggal melayani semua platform. Undangan yang tertunda dihitung dalam batas lima tempat.
Daftar penguji tunggal melayani semua platform. Undangan yang tertunda dihitung dalam batas lima tempat.
  1. Lima tempat dibagi oleh seluruh aplikasi.
  2. Undang penguji di sini, lalu tunggu penerimaan mereka.
Integrasi baru menunjukkan pemeriksaan tertunda hingga panggilan sukses nyata tercatat. Draf referensi ini belum lulus tinjauan.
Integrasi baru menunjukkan pemeriksaan tertunda hingga panggilan sukses nyata tercatat. Draf referensi ini belum lulus tinjauan.
  1. Konsol mencatat keberhasilan endpoint yang sebenarnya.
  2. Setiap cakupan yang diminta juga harus digunakan.

Untuk setiap platform yang ingin Anda publikasikan, buka Verifikasi. Selesaikan panggilan sukses nyata untuk endpoint yang diperlukan dan setiap cakupan yang dikonfigurasi. Periksa kunci penemuan dan penandatanganan; uji otorisasi/callback, pertukaran kode, penyegaran, informasi Pengguna yang diautentikasi, dan pencabutan. Klien rahasia juga harus menguji introspeksi yang berlaku. Tautan HTTPS yang diklaim secara native memerlukan verifikasi asosiasi.

Cakupan profil/email membutuhkan klaim yang sebenarnya dikembalikan; gunakan akun uji pribadi di mana email diperlukan. Cakupan inference dan monetization_gateway membutuhkan permintaan AI yang diotorisasi yang telah selesai. Pembayaran membutuhkan panggilan API pembayaran yang berhasil dengan cakupan. Respons HTTP yang berhasil secara umum, tangkapan layar browser, atau daftar periksa manual tidak menggantikan pemeriksaan yang tercatat di Console.

Anda memiliki tiga pilihan untuk platform yang belum selesai: selesaikan dan verifikasi, kecualikan dari publikasi sehingga tetap hanya untuk pemilik/penguji, atau hapus. Jangan sertakan platform dengan callback atau cakupan yang belum Anda jalankan. Perubahan konfigurasi dapat membatalkan pemeriksaan, jadi segarkan status yang tercatat setelah perubahan terakhir Anda.

Anda siap melanjutkan ketika

Setiap platform yang disertakan menunjukkan konfigurasi yang diperlukan, endpoint, dan pemeriksaan cakupan sebagai selesai. Daftar periksa pribadi panduan ini hanya sebagai alat baca.

Kirimkan aplikasi Anda dan ikuti pelanggannya

Anda akan mengetahui apa yang siap untuk ditinjau, bagaimana publikasi bekerja, dan di mana mengikuti akses pelanggan setelahnya.

Tempat Anda akan bekerja Aplikasi → Dasbor

  1. Kembali ke Dasbor dan selesaikan setiap tindakan yang belum selesai. Pengajuan tinjauan harus tetap tidak tersedia hingga aplikasi dan semua platform yang disertakan memenuhi persyaratan mereka.
  2. Ajukan aplikasi untuk ditinjau oleh ShareAI. Pantau keputusan dan perubahan yang diminta di Dashboard dan Aktivitas & Keputusan. Permintaan presentasi publik dan Monetization Gateway dapat memiliki keputusan terpisah.
  3. Setelah disetujui, publikasikan aplikasi menggunakan kontrol publikasi yang tersedia. Pastikan platform yang disertakan siap produksi; platform yang dikecualikan tetap dalam Testing.
  4. Buka Customers untuk akun tingkat aplikasi dan Subscriptions untuk distribusi kontrak yang diterima. Analytics membantu Anda mengikuti penggunaan AI yang diatribusikan dan pendapatan. Identifier pelanggan tetap bersifat pribadi sesuai dengan konteks klien/otorisasi yang sesuai.
Dashboard · kesiapan peluncuran Perbesar tangkapan layar ↗
Tinjauan tetap terblokir selama aplikasi dan platform yang disertakan memiliki persyaratan yang belum terpenuhi.
Tinjauan tetap terblokir selama aplikasi dan platform yang disertakan memiliki persyaratan yang belum terpenuhi.
  1. Selesaikan tindakan yang diperlukan sebelum mengajukan untuk tinjauan.
Tampilan aplikasi menggabungkan akun yang terhubung tanpa menampilkan ID database organisasi internal.
Tampilan aplikasi menggabungkan akun yang terhubung tanpa menampilkan ID database organisasi internal.
  1. Manajemen pelanggan digabungkan untuk aplikasi ini.

Coba seluruh alur lagi dengan pelanggan yang memenuhi syarat setelah peluncuran: hubungkan, periksa akun dan persetujuan, buat draf persiapan janji singkat, segarkan dengan aman, tangani kegagalan penagihan, lalu putuskan koneksi. Verifikasi pengalaman pengguna langsung alih-alih mengasumsikan bahwa penyimpanan yang berhasil membuktikan itu berfungsi.

Ketika sesuatu tidak berfungsi

Ketidakcocokan callback: bandingkan URL yang terdaftar dan kedua nilai permintaan secara persis. Penguji tidak sah: konfirmasi penerimaan undangan dan akun yang dipilih. Lingkup atau kontrak hilang: minta hanya akses yang diaktifkan dan sambungkan kembali untuk menerimanya. Tidak ada model: periksa Model yang Tersedia dan batasan penyedia. Kegagalan penyegaran: hapus sesi lokal yang gagal dan sambungkan kembali. Tinjauan diblokir: periksa pemeriksaan platform daripada membuat klien OAuth lain.

Anda siap melanjutkan ketika

Aplikasi berfungsi untuk pelanggan yang dimaksudkan, pemeriksaan yang tercatat mendukung status publikasinya, dan pelanggan dapat mengontrol atau mencabut otorisasi.

Verifikasi organisasi dan akses program

Pilih akun pribadi atau organisasi yang akan memiliki pendaftaran program sebelum mengajukan. Organisasi dapat mengirimkan aplikasi sebelum verifikasi, tetapi persetujuan staf saja tidak mengaktifkan akses. Lengkapi verifikasi email organisasi dan perusahaan dari daftar tugas onboarding di Console. Organisasi yang disetujui tetap Pending verification hingga kedua pemeriksaan selesai. Builder, Provider, dan program Creator mengikuti aturan ini.

Lihat harga Monetization Gateway · Jelajahi ShareAI for Startups · Scope dan izin

Izin dan persyaratan yang diterima

Syarat & Ketentuan, Kebijakan Privasi, dan instruksi penghapusan publik Anda harus sesuai dengan aplikasi dan tetap dapat diakses tanpa masuk. Penerimaan program ShareAI, persetujuan Monetization Gateway, izin OAuth pelanggan, dan kontrak penagihan yang diterima adalah keputusan terpisah. Penyegaran tidak dapat menambahkan izin atau menerima persyaratan komersial baru.

Lingkup warisan surcharge tetap diterima untuk integrasi yang ada. Contoh baru menggunakan monetization_gateway. Pertahankan bidang wire yang ada seperti surcharge_bps dan surcharge_percentage tanpa perubahan.

Lihat harga Monetization Gateway · Jelajahi ShareAI for Startups · Scope dan izin

Biaya Gateway dan dukungan Startup

Biaya standar 5% dari markup Builder. Untuk €2.00 dari biaya jaringan AI dan markup 10%, pelanggan membayar €2.20. ShareAI menerima €0.01 dari markup €0.20; Builder memiliki €0.19 sebelum Event Ingestion.

Permintaan Produksi 1,000 yang pertama diselesaikan Monetization Gateway gratis setiap bulan kalender (UTC), dibagi di seluruh akun Builder. Permintaan tambahan dikenakan biaya €0.04 per 1,000 sebelum diskon yang memenuhi syarat. Satu permintaan yang diselesaikan menghasilkan satu peristiwa.

Pay with ShareAI sendiri, akses hanya inference, kunci API akun biasa, dan lalu lintas Staging atau pengujian tidak dikenakan biaya Event Ingestion Monetization Gateway.

ShareAI for Startups menawarkan tunjangan bulanan bersama untuk biaya aktual ShareAI pada aplikasi yang disetujui. Tingkat Launch, Growth, dan Momentum saat ini mencantumkan €1,000, €5,000, dan €10,000 per bulan. Anggaran yang sama mencakup biaya persentase ShareAI pada markup Builder dan Ingestion Event yang dapat ditagih secara bersamaan. Ini bukan tunjangan markup bruto, kuota acara gratis terpisah, atau AI gratis inference. 1.000 acara gratis pertama akun 1,000 tidak mengonsumsinya.

Biaya Ingestion Event yang tersisa dibayar dari pendapatan baru permintaan Builder, kemudian pendapatan AI yang tersedia Builder dan kredit AI yang tidak terbatas. Biaya AI pelanggan dan produk payments tetap terpisah.

ShareAI dapat menyetujui biaya spesifik aplikasi atau dukungan biaya untuk periode tetap atau hingga diubah. Tinjau harga aplikasi saat ini dan Program Khusus di Console untuk persyaratan yang disetujui, validitas, dan tunjangan yang telah digunakan. Perubahan tingkat atau penggantian harga tidak mengatur ulang penggunaan bulanan aplikasi.

Launch menjaga Log in dengan ShareAI sebagai opsional. Growth dan Momentum membutuhkannya; Momentum juga membutuhkan lencana resmi ShareAI for Startups di footer aplikasi. ShareAI memeriksa lencana setiap minggu. Upaya yang dikonfirmasi untuk melewati persyaratan dapat menyebabkan penurunan tingkat, penghapusan dari Program Startup, atau penarikan dari Marketplace sesuai dengan persyaratan program yang diterima.

Tarif Enterprise dikonfigurasi oleh tim ShareAI untuk akun Builder setelah menyetujui penawaran yang dipersonalisasi. Persentase yang ditetapkan dan tarif event berlaku untuk permintaan di masa depan.

Lihat harga Monetization Gateway · Jelajahi ShareAI for Startups · Scope dan izin

Tanyakan tentang halaman ini

Pilih asisten untuk menjelajahi halaman ini. Anda juga dapat menyalin halaman dan menempelkannya ke dalam percakapan Anda.

Ask ChatGPTAsk ClaudeAsk GrokAsk ShareAI