# Bir uygulamayı ShareAI Builder'a bağlama, adım adım

Müşterileri ShareAI'a bağlayan, faydalı AI gündemleri hazırlayan ve AI harcamalarını kontrol altına alan bir randevu uygulaması oluşturun.

45–60 dakika · 18 pratik adımlar · Uygulama geliştiricileri · Node.js örneği

UYGULAMANIZ

## Üzerine inşa edebileceğiniz bir müşteri bağlantısı.

Üç somut teslimat: müşteriyi bağlayın, randevularını hazırlayın ve entegrasyonu doğrulamaya hazır hale getirin.

### Oturum açma ve yenilenebilir oturumlar

Bir müşteri ShareAI hesabını seçer, uygulamanızı onaylar ve JamZY'a geri döner.

**Şunu doğrulayabilirsiniz:**

Oturum açma, oturumu yenileme ve başarıyla bağlantıyı kesme.

### Faydalı bir hazırlık taslağı

Bir randevu hedefini, kasıtlı bir AI isteğiyle bir gündeme ve sorulara dönüştürün.

**Şunu doğrulayabilirsiniz:**

Bir taslak oluşturun; bir randevuyu kaydetmek herhangi bir AI çağrısı yapmaz.

### Doğrulayabileceğiniz bir kurulum

Opsiyonel AI ücretlerini açıklayın ve inceleme gönderiminizin ihtiyaç duyduğu platform kontrollerini toplayın.

**Şunu doğrulayabilirsiniz:**

Dahil edilen her platform ve talep edilen kapsam için kayıtlı kontroller vardır.

## Ne inşa edeceğinizi görün

Müşterilerinizin anlayabileceği bir bağlantı oluşturacaksınız: onların ShareAI hesabı, isteğe bağlı bir AI hazırlık taslağı ve randevularına geri dönüş için açık bir yol.

Çalışacağınız yer Tamamlanmış örneğiniz

Uygulamanızı ShareAI Builder'a bağlayın, kayıttan test edilmiş entegrasyon incelemesine hazır hale getirin. Bu rehber, her adımı göstermek için küçük bir Node.js randevu uygulaması olan JamZY'i kullanır: uygulamayı kaydedin, Web platformunu yapılandırın, bir müşterinin ShareAI hesabını bağlayın ve yetkilendirilmiş bir AI isteği gönderin. Aynı adımları kendi ürününüze uygulayın.

| Yetenek | Müşterinin kabul ettiği şey | JamZY'in gösterdiği şey |
| --- | --- | --- |
| ShareAI ile giriş yapın | Bir hesap bağlantısı ve uygulamanızın talep ettiği kimlik bilgileri. | Kimliği doğrulanmış Kullanıcı bilgilerinden özel müşteri kimliği. |
| ShareAI ile ödeme yapın · AI kullanımı | Müşterinin seçtiği kişisel veya organizasyon hesabını yetkilendirilmiş çıkarım için kullanma. | Bu hesabın uygun kredileriyle finanse edilen bir randevu hazırlık taslağı. |
| Builder işaretleme | Kabul edilen uygulama sözleşmesindeki ek AI kullanım ücreti. | Onay ve sözleşme yayını sonrası isteğe bağlı kullanım gelirleri. |
| Ürün ödemeleri | Ayrı bir ShareAI ödeme işleminde sunulan belirli bir satın alma. | Bir uzatma şu şekilde açıklanır [ödeme rehberi](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/). Randevu demosu ödeme işlemini uygulamaz. |

Bir ShareAI hesabına, uygulamaya sahip olacak kişisel veya organizasyon hesabını kullanma iznine, bir genel HTTPS geri çağrısına, bir logoya ve çalışan gizlilik, şartlar ve hesap silme sayfalarına sahip olun. Örneği çalıştırmak için Node.js 22 veya daha yeni bir sürüm ve uygulamanız için bir HTTPS adresi kullanın.

JamZY · randevu referans uygulaması [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LnBuZw.DZt_5dnvNF40T34-7MJsXw?v=219eca92cbe5)

Yerel randevu planlama ve müşteri tarafından finanse edilen AI hazırlığı ayrı işlemlerdir. Bu demo tarafından takvim daveti gönderilmez.

1. Randevu türünü ve süresini seçin.
2. Uygun bir demo zaman dilimi seçin.
3. İsteğe bağlı AI asistanını kullanmak için ShareAI'yi bağlayın.
4. AI yalnızca bu açık işlemden sonra çalışır; rezervasyon tek başına ShareAI'yi çağırmaz.

**Kendi uygulama detaylarınızı kullanın**

Ekran görüntüleri örnek uygulama detaylarını kullanır. Bu kılavuzdaki ShareAI adresleri üretim adresleridir. Hazırlık oluşturma, gerçek bir AI isteği oluşturur ve kredi harcayabilir; bir demo randevusu seçmek veya kaydetmek bunu yapmaz. Doğrulama kontrolleri, kendi başarılı entegrasyon testleriniz tarafından tamamlanır.

**Devam etmeye hazır olduğunuzda**

Hesap girişini, AI tüketimini, isteğe bağlı ek ücreti ve onaylanmış bir ürün satın alımını ayırt edebilirsiniz. Bu kılavuzu okumak, ücretli bir istekte bulunmayı gerektirmez.

## Builder Programına katılın

Uygulamanıza ve müşteri ilişkilerinize sahip olacak Builder kimliğini oluşturacaksınız.

Çalışacağınız yer Konsol → Builder Program

1. ShareAI hesabınıza giriş yapın veya yeni bir hesap oluşturun. JamZY'e sahip olacak kişisel veya organizasyon hesabını seçin; kurulum boyunca aynı hesabı kullanın.
2. Aç [Builder Program'ı ShareAI Konsolunda](https://console.shareai.now/app/builder/). Çalışmanıza uygun builder aktivitelerini seçin. Bu kılavuz için, sahip olduğunuz bir uygulama için ürün şirketi yolunu seçin. Müşteri Çalışması, bir müşteriye sunulan hizmetler içindir; bir entegrasyon mevcut bir uygulamayı bağlar.
3. Program kaydını sahiplenmek için kişisel veya organizasyon hesabını başvurmadan önce seçin. Organizasyonlar doğrulamadan önce bir başvuru gönderebilir, ancak yalnızca personel onayı erişimi etkinleştirmez. Console'daki başlangıç kontrol listesinden organizasyon e-postası ve şirket doğrulamasını tamamlayın. Onaylanmış bir organizasyon, her iki kontrol tamamlanana kadar Doğrulama Bekleniyor durumunda kalır. Builder, Sağlayıcı ve Creator programları bu kurala uyar.
4. Kabul edildikten sonra, Builder Program → Ürün'ü açın. Aktör değiştirici, düzenlediğiniz hesabı tanımlar.

Builder Program · kayıt giriş noktası [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Vucm9sbG1lbnQucG5n.qBq2qLDjzgk2_IqYv0zTco?v=2e8bf9ef5454)

Ürün yoluyla başlayın, ardından JamZY'ye sahip olacak hesap için kaydı tamamlayın.

1. Builder Program'ye kaydolmak için Console'a devam edin.

**Devam etmeye hazır olduğunuzda**

Builder Program hedeflenen sahip için açılır ve Yeni uygulama sunar. Kayıt kararı, uygulama incelemesi, genel bilgi incelemesi ve Monetization Gateway onayı ayrı adımlardır.

Detaylara mı ihtiyacınız var?[Builder Program ↗](https://shareai.now/builders/join/)[Builder belgeleri ↗](https://shareai.now/docs/builders/)

## Başvurunuzu oluşturun

JamZY'a kendi uygulama kaydını vereceksiniz, böylece kimliği, erişimi ve ticari şartları bir arada kalır.

Çalışacağınız yer Builder Program → Ürün → Yeni uygulama

1. Ürün içinde, Yeni uygulama'yı seçin. İlk detayları doldurmak için genel web sitenizi girin veya manuel olarak yazmayı seçin.
2. Bir PNG veya JPEG logo yükleyin, JamZY'yi ad olarak girin ve ürünü net bir cümleyle tanımlayın. Web sitesini ve builder iletişim e-postasını gözden geçirin.
3. Kurulum sorularına devam edin. Cevapları doğru tutun: bunlar uygulamanın nasıl teslim edildiğini ve ödendiğini açıklar.

Uygulama kurulumu · detaylar [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NyZWF0ZS1hcHAucG5n.26JD5PFhP3AdM9h-QLR4jI?v=89dd90b67cd9)

Devam etmeden önce uygulama adını, girişini, logosunu ve genel web sitesini inceleyin. İletişim bilgileri örnektir.

1. Uygulamaya net bir ad verin.
2. Onboarding sorularına devam edin.

Uygulama profili için erişilebilir bir genel web sitesi kullanın. Özel veya yalnızca yerel bir web sitesi, geliştirme geri çağrınız doğru şekilde kaydedilmiş olsa bile doğrulamayı başarısız olabilir. Yeni uygulama taslak olarak başlar. Uygulamayı herkese açık hale getirmeden düzenlemeye devam edebilirsiniz. Uygulama tanımlayıcısı, bir OAuth istemci kimliği veya bir abonelik kimliğinden farklıdır.

**Devam etmeye hazır olduğunuzda**

JamZY ilgili sahip için Ürün altında görünür. Her cihaz platformu için ekstra bir uygulama oluşturmayın.

Detaylara mı ihtiyacınız var?[Kayıt referansı ↗](https://shareai.now/docs/api/builders/auth/register-application/)[Genel sunum rehberi ↗](https://shareai.now/application-guidance/)

## Uygulamanızın nasıl teslim edildiğini açıklayın

Uygulamanızın çalıştığı yer ve kimlik bilgilerinin kontrolünü kimin yaptığına uygun OAuth seçenekleri alacaksınız.

Çalışacağınız yer Yeni uygulama → Uygulama kurulumu

Kendi işlettiğiniz bir JamZY dağıtımı için, teklifinize uygun fiyatlandırma modelini seçin: SaaS, Satıcı barındırmalı bulut uygulaması, Müşteri kendi tüketimini öder ve ShareAI AI istekleri için. Bunlar her ürün için bir gereklilik değil, örnek yanıtlardır.

Uygulama kurulumu · dağıtım [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2RlcGxveW1lbnQucG5n.z2CCFEuD_5FSexYeMPd83A?v=a4e84e4528c3)

Onboarding cevabı, bir sunucu istemci sırrının mevcut olup olmadığını belirler.

1. Uygulamanızın gerçekten nerede çalıştığını seçin.

| Uygulamanın çalıştığı yer | OAuth seçimi | Kimlik bilgilerinin bulunduğu yer |
| --- | --- | --- |
| Barındırılan arka ucunuz | Web sunucusu istemcisi bir istemci sırrı kullanabilir. PKCE yine de geçerlidir. | Sır ve jetonlar sunucunuzda kalır. |
| Tarayıcı uygulaması / SPA | PKCE ile Genel Web istemcisi. | Gömülü istemci sırrı yok. Uygun bir tarayıcı veya arka uç oturum tasarımı kullanın. |
| Kendi kendine barındırılan veya hibrit dağıtım | Başlangıç politikasına göre PKCE ile genel istemci. | Müşteri kurulumlarına paylaşılan bir satıcı sırrı dağıtmayın. |
| Windows, macOS, Linux, Android veya iOS | Etkinleştirilen her platform için bir genel istemci. | PKCE ve platforma uygun güvenli depolama; gömülü sır yok. |

İndirilebilir JamZY örneği, küçük bir arka uca sahip olmasına rağmen kasıtlı olarak PKCE ile bir genel Web istemcisi kullanır. Sunucu, jetonları tarayıcı depolamasından uzak tutar. Satıcı barındırmalı bir yanıt, bir sunucu istemcisine izin verir; sizi birini seçmeye zorlamaz.

Kaydedilen yanıtları Uygulama Bilgileri → Uygulama kurulumu altında yeniden gözden geçirebilirsiniz. Dağıtım değişiklikleri uyumsuz istemci sırlarını kaldırabilir ve tekrar doğrulama gerektirebilir. Kaydetmeden önce bu etkiyi gözden geçirin.

**Devam etmeye hazır olduğunuzda**

Kaydedilen dağıtım gerçek mimarinizi tanımlar. İstemci sırrı seçeneği bu yanıta bağlıdır; devre dışı bırakılmış bir seçenek, bir politikanın açıklamasıdır, eksik bir kimlik bilgisi değildir.

Detaylara mı ihtiyacınız var?[İstemci kaydı ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Uygulamanızı açık bir şekilde tanıtın

Müşterilere bağlanmaya karar vermeden önce ihtiyaç duydukları ürün detaylarını ve politikaları vereceksiniz.

Çalışacağınız yer Uygulama Bilgileri

Dashboard'dan sonra Uygulama Bilgilerini açın. Ayrılmış bölümlerden geçin: detaylar, uygulama kurulumu, sunum, markalama, galeri ve inceleme. Ürüne faydalı bir açıklama, doğru bir web sitesi ve müşteri iş akışının net ekran görüntülerini verin.

Uygulama Bilgileri [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2luZm9ybWF0aW9uLnBuZw.gTT43COTCGPlcpxLYXCMCb?v=0ed11c1d57c9)

Uygulamanıza kendi adını, tanıtımını ve genel HTTPS web sitesini verin.

1. Ayrı bölümlerde detayları, kurulumu, sunumu ve markalamayı geliştirin.

Kendi uygulama kimliğinizi kullanın. ShareAI markası entegrasyon düğmesi ve açıklayıcı materyallerde yer alır; ürün logonuzun yerini almamalıdır. Gizlilik, şartlar ve silme bağlantılarını giriş yapmadan erişilebilir tutun.

Yüzer kaydetme eylemi göründüğünde değişiklikleri kaydedin. Genel bilgi önerisinin kendi incelemesi vardır; onaylanmış bir öneriyi düzenlemek, canlı genel sunumu sessizce değiştirmez.

**Devam etmeye hazır olduğunuzda**

Bir ziyaretçi, JamZY'nin ne yaptığını, kimin işlettiğini ve nasıl silme talebinde bulunacağını anlayabilir. Genel detaylar ve geri çağırma yapılandırması aynı ürüne atıfta bulunur.

Detaylara mı ihtiyacınız var?[Sunum kontrol listesi ↗](https://shareai.now/application-guidance/)[Logolar & düğme kullanımı ↗](https://shareai.now/brand-guidance/)

## Müşterilerin neyi yetkilendirebileceğini seçin

Randevu deneyiminizin gerçekten kullandığı erişimi isteyecek ve faturalandırma amacını netleştireceksiniz.

Çalışacağınız yer Uygulama → Kullanım Durumları

Kullanım Durumlarında, hesap bağlantısı için ShareAI'yi ve desteklemek istediğiniz müşteri tarafından finanse edilen akış için Pay with ShareAI'i etkinleştirin. Ürününüzün AI kullanımında ek bir ücret kazanacağı durumlarda yalnızca Monetization Gateway erişimi talep edin. Console'da gösterilen onay durumunu takip edin.

Kullanım Durumları [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3VzZS1jYXNlcy5wbmc.zRU3Lp1TsQuYD7ClWUWS-X?v=090d8c81e6da)

Log-in with ShareAI, Pay with ShareAI ve Monetization Gateway ayrı yapılandırma ve onay durumlarına sahiptir.

1. ShareAI ile Giriş Yapmayı Yapılandırın.
2. Müşteri tarafından finanse edilen kullanımı etkinleştirin.

| Kapsam | Neden bunu isteyebilirsiniz |
| --- | --- |
| `openid` | Bir hesabı, istemci kapsamlı kimliği kullanarak bağlayın. |
| `profile` / `email` | Ürününüzün bunlara ihtiyacı varsa yalnızca profil veya e-posta taleplerini isteyin. |
| `inference` | Uygulama yapılandırması tarafından izin verildiğinde desteklenen AI çıkarım uç noktalarını çağırın. |
| `monetization_gateway` | Ek ücretli çıkarım için müşteri tarafından kabul edilen AI faturalandırma anlaşmasını kullanın. |
| `payments` | Müşteri ödeme talepleri oluşturun ve inceleyin. Her satın alma yine de onay gerektirir. |

JamZY talepleri `openid profile inference monetization_gateway`. Talep etmez `payments` ve bir ürünü ödeme yoluyla satmaz. Console'da bir yetenek etkinleştirmek, mevcut bir erişim jetonuna bunu vermez: müşteri kapsamları ve şartları yetkilendirmelidir.

**Devam etmeye hazır olduğunuzda**

Yetenekler, yapılandırılmış kapsamlar ve yetkilendirme talebi uyumludur. Uygulamanızın asla kullanmadığı veya doğrulayamayacağı isteğe bağlı erişimi talep etmekten kaçının.

Detaylara mı ihtiyacınız var?[Kapsam referansı ↗](https://shareai.now/docs/api/builders/auth/scopes/)[Ödemeler & ek ücret rehberi ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)

## Web entegrasyonunuzu ayarlayın

Tarayıcı tabanlı JamZY deneyimi için bir Web istemcisi oluşturacaksınız, doğru kimlik doğrulama yöntemiyle.

Çalışacağınız yer OAuth ayarları → Web

1. OAuth ayarlarını açın. Platform ızgarasından Web'i seçin. Platform başına bir istemci yapılandırabilirsiniz: Web, Windows, macOS, Linux, Android ve iOS.
2. Bu örnek için Tarayıcı uygulaması / SPA, genel PKCE istemcisini seçin. Bir Sunucu web uygulaması yalnızca dağıtım politikanız buna izin verdiğinde ve arka ucunuz bir sırrı koruyabildiğinde uygundur.
3. Kendi Web istemci kimliğinizi kopyalayın. Platformu entegrasyon sırasında Test modunda tutun. Asla bir ekran görüntüsünden kimlik kopyalamayın veya paylaşılan demonun kaydını farklı bir ürün için yeniden kullanmayın.

OAuth ayarları · platform ızgarası [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3BsYXRmb3Jtcy5wbmc.d1VzRklfuF_87b8KTVlPjn?v=1412f421168b)

Platform başına bir kayıtlı istemci. Yapılandırılmamış platformlar isteğe bağlı kalır.

1. Tek bir Web entegrasyonunu açın.
2. Ürününüz destekliyorsa yalnızca Android ekleyin.

Web · Genel Bakış [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3dlYi1jbGllbnQucG5n.AQKecrfiIFG89MpuUlH8uP?v=8f56b706ab2d)

Genel bir Web istemcisi PKCE kullanır ve istemci sırrı yoktur. İstemci kimliği gizlenmiştir.

1. Kendi Web istemci kimliğinizi kopyalayın.
2. Genel bir istemci sır almaz.

Farklı platformların farklı kimlik bilgileri ve geri çağırma kuralları vardır. Bunlar ayrı ürünler değildir: abonelikler ve müşteri yönetimi uygulama için birleştirilir. Uygulama testçileri platformlar arasında paylaşılır, bekleyen davetler dahil en fazla beş yer ile; sahip bir testçi yerini tüketmez.

**Devam etmeye hazır olduğunuzda**

Tam olarak bir Web platformu vardır. Yapılandırmadığınız yerel platformlar lansmanınızı engellemez.

Detaylara mı ihtiyacınız var?[Platform kaydı ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Müşterileri uygulamanıza geri getirin

Yetkilendirme sonrasında müşterileri uygulamanıza geri döndüreceksiniz, sahip olduğunuz tam bir geri çağırma kullanarak.

Çalışacağınız yer Web → Yapılandırma

Web → Yapılandırma bölümünde, uygulamanızın işlediği tam HTTPS geri çağırmayı kaydedin. Bu kılavuz `https://jamzy.example/oauth/callback` bir örnek olarak kullanır. Şununla değiştirin: `jamzy.example` JamZY kopyanızı dağıttığınız HTTPS alan adıyla ve aynı geri çağırmayı uygulama yapılandırmanızda kullanın.

Web · Yapılandırma [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NhbGxiYWNrcy5wbmc.VYHbGU1Skc_78NvwYGAAz5?v=6af56597b3d7)

Dağıtılmış uygulamanızın işlediği geri çağırmayı kaydedin.

1. Dağıtılmış uygulamanızın işlediği geri çağırmayı kaydedin.

Onay ekranı adını, şartları, gizlilik ve silme bilgilerini sağlayın. Yalnızca ihtiyaç duyduğunuz kapsamları etkinleştirin, ardından kaydedin. Şema, ana bilgisayar, yol ve uygulanabilir sorgu detayları yetkilendirme isteği ve kod değişimiyle eşleşmelidir. Joker karakter veya URL parçası kullanmayın.

| Platform | Uygulanacak geri çağırma |
| --- | --- |
| Web | Uygulamanızdaki tam HTTPS adresi. |
| Android | Uygulama kimliğiyle eşleşen ters alan adı uygulama şeması veya paket ve SHA-256 imza parmak izi ile doğrulanmış bir HTTPS Uygulama Bağlantısı. |
| iOS | Eşleşen bir uygulama şeması veya paket kimliği ve Apple Uygulama Kimliği ön eki ile doğrulanmış bir HTTPS Evrensel Bağlantı. |
| Windows / macOS / Linux | İzin verilen tam HTTPS geri çağırma, eşleşen ters alan adı uygulama şeması veya 127.0.0.1 / \[::1\] üzerinde desteklenen bir döngüsel yönlendirme. Döngüsel bağlantı noktası değişebilir. |

Yüklü uygulamalar sistem tarayıcısında yetkilendirilir ve kayıtlı geri çağırma üzerinden döner. Talep edilen HTTPS uygulama bağlantıları için gerekli ilişkilendirme dosyasını yayınlayın ve Console'da ilişkilendirme doğrulamasını çalıştırın. Bir formda makul görünen bir geri çağırma, yüklü uygulamanızın bunu aldığına dair kanıt değildir.

**Devam etmeye hazır olduğunuzda**

Yetkilendirme akışı üzerinden geri çağırmayı açmak uygulamanıza döner. Rastgele bir kod veya uyumsuz durum reddedilir.

Detaylara mı ihtiyacınız var?[PKCE & yönlendirmeler ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Keşif & kimlik ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)

## Kendi JamZY uygulamanızı çalıştırın

Randevu arayüzüne ve kendi uygulama tanımlayıcılarınızla çalışan ShareAI bağlantısına sahip olacaksınız.

Çalışacağınız yer Uygulamanız → Ortam yapılandırması

JamZY, isteğe bağlı bir AI hazırlık asistanı içeren bir randevu uygulamasıdır. Zamanlayıcı yalnızca tarayıcıda bir gösterimdir: takvim sağlayıcısı, e-posta teslimi veya randevu ödemesi yoktur. ShareAI yetkilendirme ve AI API entegrasyonu gerçek yapılandırılmış üst akışı kullanır.

İndirin [JamZY referans kaynağı](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJlZmVyZW5jZS56aXA.jOyG9kwmFZrdMQEhTNGl0J?v=248a37ba4612). Node sunucusu, tarayıcı arayüzü, testler ve bir kurulum README içerir; sertifikalar, sırlar, bağımlılıklar veya oturumlar içermez. Çalıştırmadan önce dosyaları inceleyin. Node işlemini genel kökeni koruyan bir HTTPS ters proxy'nin arkasına yerleştirin.

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

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

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

**Ortamları bir arada tutun**

Uygulamanızı oluşturun [konsol.paylaşai.şimdi](https://console.shareai.now/app/builder/). Üretim istemci kimliğini kullanın `https://auth.shareai.now` ve `https://api.shareai.now/api/v1`. `jamzy.example` Adres uygulamanız için bir yer tutucudur, barındırılan bir demo değildir. Güvenli oturum çerezinin çalışması için kendi uygulamanızı HTTPS üzerinden sunun.

JamZY ayrıca karşılaştırma için bir API anahtarı bağlantısı sunar. Bu kılavuz cüzdan/OAuth düğmesini kullanır. Bir API anahtarı müşterinin JamZY OAuth anlaşmasını oluşturmaz ve müşteri yetkilendirme akışının yerine geçmez.

**Devam etmeye hazır olduğunuzda**

Uygulama HTTPS üzerinden yüklenir. Genel kökeni, kayıtlı geri çağırması ve istemci kimliği kaydınızla eşleşir. Sayfa kaynağında veya localStorage'da hiçbir token veya sır görünmez.

## İlk müşterinizi bağlayın

Bir müşterinin ShareAI hesabını seçmesine ve uygulamanızın ihtiyaç duyduğu erişimi onaylamasına izin vereceksiniz.

Çalışacağınız yer JamZY → ShareAI Cüzdanınızla Ödeyin

JamZY'dan, ShareAI Cüzdanınızla Ödeyin'i seçin. Uygulama ShareAI yetkilendirme sayfasını açar. Müşteri oturum açar, kişisel veya organizasyon hesabını seçer, uygulamayı ve istenen erişimi kontrol eder ve geçerli abonelik şartlarını kabul eder.

1. **JamZY → Kimlik Doğrulama**Rastgele bir durum ve PKCE doğrulayıcı oluşturun; yetkilendirme isteğiyle birlikte S256 zorluğunu gönderin.
2. **Müşteri → Kimlik Doğrulama**Ödeme hesabını seçin ve erişim ile faturalandırma koşullarını gözden geçirin. İptal etmek JamZY'yi bağlantısız bırakmalıdır.
3. **Kimlik Doğrulama → geri çağırma**Kısa ömürlü, tek seferlik bir kod ve durumu alın. Durumu aynı oturuma karşı doğrulayın.
4. **Backend → arka uç**Bu kodu orijinal doğrulayıcı ve aynı yönlendirme URI'si ile değiştirin. Genel istemciler istemci gizliliği göndermez.
5. **Backend → Kullanıcı bilgisi**Erişim jetonunu kullanarak kimliği doğrulanmış kimliği okuyun, ardından JamZY'nin kendi güvenli oturumunu oluşturun.

Web · Üretim uç noktaları [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2VuZHBvaW50cy5wbmc.wcHciknhu_5PQG6wrO4zan?v=63ad6d9e8724)

Bu üretim ShareAI adreslerini console.shareai.now'dan istemci kimliği ile kullanın.

1. auth.shareai.now/oauth/authorize adresinde yetkilendirin.
2. auth.shareai.now/oauth/token adresinde kodları ve yenileme jetonlarını değiştirin.

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

Kimliği doğrulanmış, istemciye özgü müşteri kaydını anahtar olarak kullanın `sub` ve onun yayıcı/istemci bağlamını. Kişisel ve organizasyon yetkilendirmeleri farklı ödeme hesaplarını seçebilir. Bir müşteri kimliği, küresel bir kullanıcı kimliği, e-posta adresi veya dahili organizasyon veritabanı kimliği değildir. Görünen adları eşleştirerek platformlar arasında kimlikleri birleştirmeyin.

**Devam etmeye hazır olduğunuzda**

İptal, uyumsuz durum, yeniden oynatılmış kod ve süresi dolmuş yetkilendirme güvenli bir şekilde başarısız olur. Normal akış, jetonlarını açığa çıkarmadan kimliği doğrulanmış bir hesap döndürür.

Detaylara mı ihtiyacınız var?[Tam kod değişimi ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Özel müşteri kimlikleri ↗](https://shareai.now/docs/api/builders/auth/pairwise-identities/)

## Müşteriyi güvenli bir şekilde bağlı tutun

Yetkilendirilmiş istekleri jetonlar süresi dolarken çalışır durumda tutacak ve müşteriye bağlantıyı kesmek için güvenilir bir yol sağlayacaksınız.

Çalışacağınız yer Uygulamanız → Oturum ve jeton işleme

| Kimlik Bilgisi | Amaç | Nasıl işlenir |
| --- | --- | --- |
| Yetkilendirme kodu | Yetkilendirme sayfasından tek seferlik teslim. | Eşleşen doğrulayıcı ve geri çağırma kullanarak bir kez değiştirin. Bu bir API jetonu değildir. |
| Erişim jetonu | Kabul edilen izin ve kapsamlar dahilinde API çağrılarını yetkilendirir. | Şu şekilde gönderin `Authorization: Bearer …`. Süre sonu ve uç nokta yetkilendirme hatalarına saygı gösterin. |
| Yenileme jetonu | İzin geçerli olduğu sürece başka bir oturum açma olmadan yeni erişim jetonları alır. | Güvenli bir şekilde saklayın. Yenileme işlemlerini serileştirin ve döndürülen kimlik bilgilerini atomik olarak değiştirin. |
| ID jetonu | İstemci için bir OpenID Connect kimlik doğrulama beyanı. | Kullanıyorsanız, imza, yayıcı, hedef kitle, süre sonu ve nonce doğrulamasını gerektiği şekilde yapın. Bunu bir Bearer jetonu olarak çıkarım yapmak için kullanmayın. |
| İstemci gizliliği | İzin verilen gizli sunucu istemcisini kimlik doğrular. | Sunucuda saklayın. Bu, tüm jetonlardan farklıdır ve hiçbir zaman genel bir istemciye dahil edilmez. |

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

Döndürülen `expires_in` bir ömür icat etmek yerine kullanın. Yenileme, bir yenileme jetonu değiştirirse, yeni erişim jetonu ile bir güncelleme olarak bunu kalıcı hale getirin. Oturum başına bir yenilemeye izin verin, böylece eşzamanlı istekler döndürülen bir jetonu yeniden kullanmaz. Geçersiz veya iptal edilmiş yenileme izni yeniden bağlantı gerektirir; sonsuz döngüye girmeyin.

Yenileme, bir kapsam ekleyemez veya yeni bir Monetization Gateway sözleşmesini sessizce kabul edemez. Yeni izinler veya şartlar için müşteriyi yeniden yetkilendirme işlemine yönlendirin. JamZY, kimlik bilgilerini yalnızca sunucu belleğinde maksimum bir saatlik demo oturumu için saklar, doğrulanmamış bir ID jetonuna güvenmek yerine Kullanıcı bilgilerini doğrular ve Güvenli, HttpOnly, SameSite çerezi kullanır. Üretim hizmeti, kendi dayanıklı ve korumalı oturum tasarımına ihtiyaç duyar.

Bağlantı kesildiğinde, yenileme/erişim kimlik bilgilerini uygun olduğu yerlerde iptal edin ve uygulama oturumunu temizleyin. Yalnızca bir tarayıcı çerezini temizlemek, bir ShareAI yetkisini iptal etmez veya ücretli bir aboneliği sonlandırmaz. Kodları, tokenları, sırları veya kişisel istem içeriklerini kaydetmekten kaçının.

**Devam etmeye hazır olduğunuzda**

Süre sonu, kontrollü bir yenilemeyi tetikler; yeni tokenlar eskilerinin yerini alır. Bağlantı kesme, uygulama oturumunu temizler ve herhangi bir iptal başarısızlığını rapor eder.

Detaylara mı ihtiyacınız var?[Yenileme & döndürme ↗](https://shareai.now/docs/api/builders/auth/refresh-tokens/)[İptal & introspeksiyon ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Kullanıcı bilgisi & keşif ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)[OAuth güvenlik en iyi uygulamaları ↗](https://www.rfc-editor.org/rfc/rfc9700.html)

## AI ile ilk randevuyu hazırlayın

Bir randevu hedefini bir gündeme ve faydalı sorulara dönüştüreceksiniz, açıkça müşteri tarafından finanse edilen bir AI talebiyle.

Çalışacağınız yer Mevcut Modeller → JamZY → Hazırlıklı olun

Uygulamada Mevcut Modelleri açın. Ürününüzün sunacağı modelleri ve sağlayıcıları seçin ve yapılandırmayı kaydedin. Katalog yüklenemiyorsa, devam etmeden önce yukarı akış kullanılabilirlik hatasını çözün; OAuth istemcilerini tekrar tekrar değiştirmek bunu düzeltmez.

Mevcut Modeller [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL21vZGVscy5wbmc.PXvmpf7nx9UhAHYgLQ8HHi?v=7c62a7dcb41c)

Müşterilerinizin hangi modelleri ve sağlayıcıları kullanabileceğini seçin. Devam etmeden önce herhangi bir katalog hatasını çözün.

1. Model kataloğu bu uygulamaya aittir.

JamZY kataloğunu yalnızca bağlantıdan sonra yükler. İzin verilen bir metin modeli seçin, kısa bir randevu hedefi girin ve Hazırlık oluştur'u kasıtlı olarak seçin. Seçilen hesabın uygun kredilere ve gerekli kabul edilmiş AI faturalandırma şartlarına ihtiyacı vardır. Bir tarih seçmek, bir randevuyu gözden geçirmek ve kaydetmek bir çıkarım talebi göndermez.

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

### Randevu akışını JamZY'da takip edin.

1. Takvimde bir hizmet seçin: 15 dakikalık bir tanıtım, 30 dakikalık proje planlaması veya 60 dakikalık daha derin bir görüşme.
2. Bir gün ve uygun bir saat seçin. Saatler tarayıcının görüntülenen saat dilimini kullanır. Uygunluk örnektir ve kaydedilen randevular yalnızca bu tarayıcıyı etkiler.
3. Hazırlıklı olun bölümünde, kişisel ayrıntılar olmadan bir örnek hedef girin. Bir model seçin, ardından Hazırlık oluştur'u seçin. JamZY, seçilen hizmeti ve hedefinizi ShareAI'e gönderir, döndürülen metni güvenli bir şekilde işler ve rezervasyonu değiştirmeden bırakır.
4. Gündemi kendiniz gözden geçirin. Randevuyu gözden geçir'i seçin, hizmetini, gününü, saatini ve süresini kontrol edin, ardından Demo randevusunu onayla'yı seçin. Bu işlem AI çağırmaz veya ödeme almaz.
5. Kaydedilen demo kaydını görmek için Randevularım'ı açın. Kalıcılığını doğrulamak için yeniden yükleyin veya yuvayı tekrar kullanılabilir hale getirmek için kaldırın. Yalnızca hizmet, gün, saat ve rastgele bir yerel referans saklanır; AI taslakları, hedefler, jetonlar ve anahtarlar randevularla birlikte kaydedilmez.

Bu yalnızca tarayıcı demosu randevusunu kaydetmeden önce hizmeti, tarihi, zamanı ve süresini inceleyin. [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJldmlldy5wbmc.77e3cMlfs1G-t-jYrNxzoI?v=dcf04d3d6647)

Bu yalnızca tarayıcı demosu randevusunu kaydetmeden önce hizmeti, tarihi, zamanı ve süresini inceleyin.

1. Onaylamadan önce tam seçimi gözden geçirin.
2. Bu işlem bir demo kaydı kaydeder; AI çağırmaz veya ödeme almaz.

Randevularım yerel demo kayıtlarını gösterir. Bir kaydı kaldırmak, örnek zaman dilimini tekrar kullanılabilir hale getirir. [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LWFwcG9pbnRtZW50cy5wbmc.KGiTkFaDpNeep2RKpzxHNE?v=1d5bce9412c4)

Randevularım yerel demo kayıtlarını gösterir. Bir kaydı kaldırmak, örnek zaman dilimini tekrar kullanılabilir hale getirir.

1. Kayıt, kişisel bilgiler veya AI notları olmadan bu tarayıcıda kalır.
2. Demo randevusunu kaldırın ve zaman dilimini serbest bırakın.

Gerçek bir planlama ürünü, sunucu tarafı bir rezervasyon deposu, uygunluk kontrolleri, saat dilimi işleme, iptal politikası ve takvim veya bildirim entegrasyonu gerektirir. Bunlar ShareAI yetkilendirmesinden ayrıdır. AI çıktısını bir öneri olarak tutun; gelecekteki herhangi bir rezervasyon eylemini kendi uygulama kurallarınız aracılığıyla doğrulayın.

İzin verilen katalog tarafından döndürülen bir model slug kullanın. Gerçek yanıt sözleşmesini yönetin: JamZY, ShareAI’in yerel `message.content` zarfını ve OpenAI tarzını destekler. `choices[0].message.content`HTTP 200 ile eksik veya iç içe geçmiş bir hata yanıtı başarılı bir yanıt değildir.

Harcama limiti veya yetersiz kredi yanıtında, faydalı bir açıklama ve sağlanan müşteri faturalandırma bağlantısını gösterin. Seçilen hesabı koruyun. Limitini aşmayın, ödeyiciyi sessizce değiştirmeyin veya ücretli bir işlemi döngüde yeniden denemeyin.

**Devam etmeye hazır olduğunuzda**

Hazırlık oluşturma, kullanılabilir bir gündem ve sorular döndürür. İstek, yetkilendirilmiş müşteri ve uygulamaya, seçilen modele ve kabul edilen şartlara atfedilir. AI taslağı bir randevu ayarlayamaz veya değiştiremez.

Detaylara mı ihtiyacınız var?[OAuth sohbet istekleri ↗](https://shareai.now/docs/api/builders/chat-completions/chat-with-oauth/)[Faturalandırma kurtarma ↗](https://shareai.now/docs/api/builders/billing-errors-and-spending-limits/)

## İsteğe bağlı AI kazançlarınızı ayarlayın

Ek AI ücretinizi bir abonelik teklifinde açıklayacak ve müşterilerin kabul edebileceği şartları yayınlayacaksınız.

Çalışacağınız yer Uygulama → Abonelikler

Uygulamanın Kullanım Durumları aracılığıyla Monetization Gateway erişimi talep edin, eğer ilgili idari politika tarafından zaten onaylanmamışsa. Anketi tamamlayın ve durumunu takip edin. Onay, yapılandırmayı etkinleştirir; müşteri izni ve faturalandırma onayı ayrı kalır.

Abonelikler · Genel Bakış [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbnMucG5n.1fAD7CKPa38_SZFh5zuI9P?v=f1ef4ee6680b)

Yeni uygulamalar yayınlanmış bir sözleşme olmadan başlar. Şartlarını yayınlamadan önce bir teklif ekleyin.

1. Kendi düzenleyicisinde bir teklif oluşturun.

1. Abonelikleri Aç. Bir teklif ekleyin, ona net bir ad verin ve müşterilerin ödeyeceği Builder işaretlemesini açıklayın. Oluşturulan abonelik kimliği salt okunurdur ve bu uygulamaya özeldir; entegrasyonunuzun buna ihtiyacı olduğunda kopyalayın.
2. Her aboneliği kendi düzenleyicisinde düzenleyin. Seçilen model ve kullanım varsayımları için ağ maliyetini ve kazançlarınızı incelemek için Tahmin’i kullanın. Tahminler önizlemelerdir, garanti edilen fiyatlar veya kabul edilen şartlar değildir.
3. Taslağı birlikte gözden geçirin, ardından gereksinimleri karşılandığında sözleşme sürümünü yayınlayın. Yayınlanan sürüm, yeni müşterilerin kabul edebileceği şartları açıklar.
4. Genel bakış ve sözleşme dağıtımını kullanarak kaç hesabın her kabul edilen sürümde kaldığını görün. Bir müşteri, açıkça bir yedek kabul edene kadar kabul edilen şartları korur; yeni bir sürüm yayınlamak onları sessizce geçirmez. Kabul edilen sözleşmeleri koruyan varsayılan geçişi koruyun. Daha fazla uygulama işlemi öncesinde Yeniden onay gerektir seçeneğini kasıtlı olarak seçerseniz, mevcut erişim müşteri yeni şartları onaylayana kadar kesilebilir.

Sadece örnek: uygun ağ maliyetinin 20% Builder işaretlemesi €1.00'ye ekler €0.20. Standart fiyatlandırmada, ShareAI'ün 5% ücreti yalnızca o €0.20 işaretlemesine uygulanır, herhangi bir faturalandırılabilir Olay Alımından önce. Gerçek hesaplama için canlı tahmin aracını ve kabul edilen sözleşmeyi kullanın. Bu akıştaki bir abonelik teklifi, bir AI faturalandırma anlaşmasıdır; hesap bağlantısı tek başına sabit bir yinelenen fiyatı borçlandırmaz.

Abonelikler · teklif düzenleyici [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbi1lZGl0b3IucG5n.ajS-FCMdefa7Br_i-9U6yV?v=028a19d93ad7)

Örnek bir taslak teklif. Oluşturulan abonelik kimliği yalnızca okunabilir ve bu uygulamayla sınırlıdır.

1. Müşteri odaklı bir teklif adı kullanın.
2. Bu teklif için AI `surcharge`'yi ayarlayın.

ShareAI onay ekranı, kabul edilen şartlar için yetkilidir. JamZY’in genel istemcisi, Kullanıcı bilgileri üzerinden kabul edilen faturalama planını çıkaramaz, bu nedenle bağlantı paneli aktif bir abonelik iddiasında bulunmaz veya randevu için bir fiyat uydurmaz.

**Devam etmeye hazır olduğunuzda**

Teklif ücreti açıklar; sözleşme müşteri tarafından kabul edilebilir. Hangi müşterilerin eski şartlarda kaldığını ve nedenini anlarsınız.

Detaylara mı ihtiyacınız var?[Tam monetizasyon kılavuzu ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Kabul edilen anlaşmalar ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## Dahil edilen platformların çalıştığını kanıtlayın

Uygulamanızı inceleme için göndermek için gereken gerçek uç nokta ve kapsam kontrollerini toplayacaksınız.

Çalışacağınız yer OAuth ayarları → Testçiler ve Doğrulama

OAuth ayarlarını açın → Testçiler ve uygulama genelinde en fazla beş testçi davet edin. Bekleyen davetler bir yer kaplar ancak erişim sağlamaz; alıcı kabul etmelidir. Sahip erişimi ve davet edilen testçi erişimi, genel üretim erişiminden farklıdır.

Uygulama testçileri [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3Rlc3RlcnMucG5n.3_3h6Y0TjTv3r0ttIn9bok?v=60cba368b3d5)

Tek bir testçi listesi tüm platformlara hizmet eder. Bekleyen davetler beş kişilik sınırın bir parçası olarak sayılır.

1. Beş yer tüm uygulama tarafından paylaşılır.
2. Buradan bir testçi davet edin, ardından kabul etmelerini bekleyin.

Web · Doğrulama [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3ZlcmlmaWNhdGlvbi5wbmc.xLD6z4RV0ddX6p0qkaLhqc?v=d758a8f881d9)

Yeni bir entegrasyon, gerçek başarılı çağrılar kaydedilene kadar bekleyen kontrolleri gösterir. Bu referans taslağı incelemeden geçmemiştir.

1. Konsol, gerçek uç nokta başarısını kaydeder.
2. İstenen her kapsam aynı zamanda kullanılmalıdır.

Yayınlamayı planladığınız her platform için Doğrulama’yı açın. Gerekli uç noktalar ve yapılandırılmış her kapsam için gerçek başarılı çağrıları tamamlayın. Keşif ve imzalama anahtarlarını kontrol edin; yetkilendirme/geri çağırma, kod değişimi, yenileme, kimlik doğrulamalı Kullanıcı bilgisi ve iptali test edin. Gizli istemciler ayrıca ilgili içgörü testlerini de yapmalıdır. Yerel talep edilen HTTPS bağlantıları ilişkilendirme doğrulaması gerektirir.

Bir profil/e-posta kapsamı, döndürülen gerçek iddialarını gerektirir; e-postanın gerekli olduğu bir kişisel test hesabı kullanın. `inference` ve `monetization_gateway` kapsamları, tamamlanmış yetkilendirilmiş bir AI isteği gerektirir. Ödemeler, başarılı bir kapsamlı ödeme API çağrısı gerektirir. Genel bir başarılı HTTP yanıtı, tarayıcı ekran görüntüsü veya manuel kontrol listesi, Console’un kaydedilmiş kontrollerinin yerini almaz.

Bitmemiş bir platform için üç seçeneğiniz vardır: tamamlayıp doğrulamak, yayınlamadan hariç tutarak yalnızca sahip/testçi erişiminde bırakmak veya kaldırmak. Egzersiz yapmadığınız geri çağırmalar veya kapsamlarla bir platformu dahil etmeyin. Yapılandırma değişiklikleri kontrolleri geçersiz kılabilir, bu nedenle son değişikliklerinizden sonra kaydedilen durumu yenileyin.

**Devam etmeye hazır olduğunuzda**

Dahil edilen her platform, gerekli yapılandırma, uç nokta ve kapsam kontrollerini tamamlanmış olarak gösterir. Kılavuzun kişisel kontrol listesi yalnızca bir okuma yardımcısıdır.

Detaylara mı ihtiyacınız var?[Uç nokta doğrulama ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Referans başlatma ↗](https://shareai.now/docs/builders/applications/launch-application/)

## Uygulamanızı gönderin ve müşterilerini takip edin

İnceleme için neyin hazır olduğunu, yayınlamanın nasıl çalıştığını ve ardından müşteri erişimini nerede takip edeceğinizi bileceksiniz.

Çalışacağınız yer Uygulama → Gösterge Tablosu

1. Gösterge Tablosuna dönün ve her bekleyen eylemi çözün. İnceleme gönderimi, uygulama ve dahil edilen tüm platformlar gereksinimlerini karşılayana kadar kullanılamaz durumda kalmalıdır.
2. Uygulamayı ShareAI incelemesi için gönderin. Kararı ve talep edilen değişiklikleri Dashboard ve Activity & Decisions üzerinden takip edin. Genel sunum ve Monetization Gateway talepleri için ayrı kararlar olabilir.
3. Onaylandıktan sonra, mevcut yayınlama kontrollerini kullanarak uygulamayı yayınlayın. Dahil edilen platformların üretime hazır olduğunu doğrulayın; hariç tutulanlar Testing'de kalır.
4. Uygulama düzeyindeki hesaplar için Customers ve kabul edilen sözleşme dağıtımı için Subscriptions'u açın. Analytics, atfedilen AI kullanımını ve kazançları takip etmenize yardımcı olur. Müşteri tanımlayıcıları, uygun müşteri/yetkilendirme bağlamına özel olarak gizli kalır.

Dashboard · başlatma hazırlığı [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Rhc2hib2FyZC5wbmc.2hIAeRjQpgXmhBWVPD5_zB?v=38be9c6d668e)

Uygulama ve dahil edilen platformların bekleyen gereksinimleri olduğu sürece inceleme engellenir.

1. İnceleme için göndermeden önce gerekli işlemleri tamamlayın.

Müşteriler [Ekran görüntüsünü büyüt ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2N1c3RvbWVycy5wbmc.qbIDq-R5JMA6K48ws4kWaB?v=cc0470083fec)

Uygulama görünümü, bağlı hesapları bir araya getirir ancak dahili organizasyon veritabanı kimliklerini göstermez.

1. Müşteri yönetimi uygulama için birleştirilmiştir.

Başlatmadan sonra uygun bir müşteriyle tüm akışı tekrar deneyin: bağlanın, hesabı ve onayı inceleyin, kısa bir randevu hazırlık taslağı oluşturun, güvenli bir şekilde yenileyin, bir faturalama hatasını yönetin, ardından bağlantıyı kesin. Başarılı bir kaydetmenin çalıştığını varsaymak yerine canlı kullanıcı deneyimini doğrulayın.

**Bir şey çalışmadığında**

**Callback uyuşmazlığı:** kayıtlı URL'yi ve her iki istek değerini tam olarak karşılaştırın. **Yetkisiz test kullanıcısı:** davet kabulünü ve seçilen hesabı onaylayın. **Eksik kapsam veya sözleşme:** yalnızca etkinleştirilmiş erişimi talep edin ve kabul etmek için yeniden bağlanın. **Model yok:** Mevcut Modelleri ve sağlayıcı kısıtlamalarını inceleyin. **Yenileme hatası:** başarısız yerel oturumu temizleyin ve yeniden bağlanın. **İnceleme engellendi:** başka bir OAuth istemcisi oluşturmaktan ziyade platform kontrollerini inceleyin.

**Devam etmeye hazır olduğunuzda**

Uygulama, hedef müşteri için çalışır, kaydedilen kontroller yayın durumu için destek sağlar ve müşteri yetkilendirmeyi kontrol edebilir veya iptal edebilir.

Detaylara mı ihtiyacınız var?[Devam et: ShareAI ile öde ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Builder API referansı ↗](https://shareai.now/docs/api/builders/)

## Organizasyon doğrulama ve program erişimi

Program kaydını sahiplenmek için kişisel veya organizasyon hesabını başvurmadan önce seçin. Organizasyonlar doğrulamadan önce bir başvuru gönderebilir, ancak yalnızca personel onayı erişimi etkinleştirmez. Console'daki başlangıç kontrol listesinden organizasyon e-postası ve şirket doğrulamasını tamamlayın. Onaylanmış bir organizasyon, her iki kontrol tamamlanana kadar Doğrulama Bekleniyor durumunda kalır. Builder, Sağlayıcı ve Creator programları bu kurala uyar.

[Monetization Gateway fiyatlandırmayı görüntüleyin](https://shareai.now/tr/gelistiriciler-2/gelir-elde-etme-gecidi/#mg-pricing) · [Keşfedin ShareAI for Startups](https://shareai.now/tr/girisim-programi/) · [Kapsamlar ve izinler](https://shareai.now/tr/dokumanlar/api/gelistiriciler-2/kimlik-dogrulama/oauth-kapsamlari-ve-hesap-sinirlari/)

## İzinler ve kabul edilen şartlar

Genel Şartlar & Koşullarınız, Gizlilik Politikanız ve silme talimatlarınız uygulamayla eşleşmeli ve oturum açmadan erişilebilir durumda kalmalıdır. ShareAI program kabulü, Monetization Gateway onayı, müşterinin OAuth izni ve kabul edilen faturalandırma sözleşmesi ayrı kararlardır. Yenileme, izin ekleyemez veya yeni ticari şartları kabul edemez.

Eski `surcharge` kapsamı mevcut entegrasyonlar için kabul edilmeye devam etmektedir. Yeni örnekler `monetization_gateway` kullanır. `surcharge_bps` ve `surcharge_percentage` gibi mevcut kablo alanlarını değiştirmeden bırakın.

[Monetization Gateway fiyatlandırmayı görüntüleyin](https://shareai.now/tr/gelistiriciler-2/gelir-elde-etme-gecidi/#mg-pricing) · [Keşfedin ShareAI for Startups](https://shareai.now/tr/girisim-programi/) · [Kapsamlar ve izinler](https://shareai.now/tr/dokumanlar/api/gelistiriciler-2/kimlik-dogrulama/oauth-kapsamlari-ve-hesap-sinirlari/)

## Geçit ücretleri ve Startup desteği

Standart ücretler 5% ve Builder işaretlemesi üzerinden alınır. AI ağ maliyetinin €2.00 ve bir 10% işaretlemesi için müşteri €2.20 öder. ShareAI, €0.01 işaretlemesinin €0.20'sini alır; Builder, Event Ingestion öncesinde €0.19'ye sahiptir.

İlk 1,000 yerleşik Üretim Monetization Gateway talepleri her takvim ayında (UTC) ücretsizdir ve Builder hesabı genelinde paylaşılır. Ek talepler, uygun indirimlerden önce €0.04 başına 1,000 maliyetindedir. Bir yerleşik talep bir olay oluşturur.

Pay with ShareAI kendi başına, `inference`-yalnızca erişim, sıradan hesap API anahtarları ve Staging veya test trafiği Monetization Gateway Olay Yutma işlemini tetiklemez.

ShareAI for Startups, onaylanmış bir uygulama için gerçek ShareAI ücretleri için paylaşılan bir aylık ödenek sunar. Mevcut Launch, Growth ve Momentum seviyeleri aylık €1,000, €5,000 ve €10,000 olarak listelenmiştir. Aynı bütçe, ShareAI’in Builder üzerindeki yüzde ücretini ve faturalandırılabilir Etkinlik Alımını birlikte kapsar. Bu, brüt kar marjı ödeneği, ayrı bir ücretsiz etkinlik kotası veya ücretsiz AI `inference` değildir. Hesabın ilk 1,000 ücretsiz etkinlikleri bunu tüketmez.

Kalan Etkinlik Alımı ücretleri, isteğin yeni Builder kazançlarından, ardından mevcut Builder AI kazançlarından ve sınırsız AI kredilerinden ödenir. Müşteri AI ücretleri ve ürün `payments` ayrı kalır.

ShareAI, belirli bir süre için veya değişene kadar uygulamaya özel ücretleri veya ücret desteğini onaylayabilir. Uygulamanın mevcut fiyatlandırmasını ve Konsol’daki Özel Programları onaylı koşulları, geçerliliği ve tüketilen ödeneği için inceleyin. Bir seviye değişikliği veya fiyatlandırma geçersiz kılma, uygulamanın aylık kullanımını sıfırlamaz.

Launch, ShareAI ile Giriş Yapmayı isteğe bağlı tutar. Growth ve Momentum bunu gerektirir; Momentum ayrıca uygulama altbilgisinde resmi ShareAI for Startups rozetini gerektirir. ShareAI, rozeti haftalık olarak kontrol eder. Gereksinimleri atlama girişimlerinin doğrulanması, Startup Programından düşürülmeye, kaldırılmaya veya kabul edilen program koşulları kapsamında Marketplace’ten çekilmeye yol açabilir.

Kurumsal oranlar, ShareAI ekibi tarafından Builder hesabı için kişiselleştirilmiş bir teklif üzerinde anlaşmaya varıldıktan sonra yapılandırılır. Atanan yüzde ve olay oranı gelecekteki isteklere uygulanır.

[Monetization Gateway fiyatlandırmayı görüntüleyin](https://shareai.now/tr/gelistiriciler-2/gelir-elde-etme-gecidi/#mg-pricing) · [Keşfedin ShareAI for Startups](https://shareai.now/tr/girisim-programi/) · [Kapsamlar ve izinler](https://shareai.now/tr/dokumanlar/api/gelistiriciler-2/kimlik-dogrulama/oauth-kapsamlari-ve-hesap-sinirlari/)

Source: https://shareai.now/tr/bloglar/urun/olusturucu-program/kilavuzlar-nasil-yapilir/bir-uygulamayi-shareai-buildera-baglama-adim-adim/