# Yadda ake haɗa aikace-aikace zuwa ShareAI Builder, mataki-mataki

Gina manhajar alƙawari da ke haɗa abokan ciniki zuwa ShareAI, tana shirya jadawalin AI mai amfani kuma tana ba su iko akan kashewar AI ɗinsu.

Minti 45–60 · 18 matakan aiki · Masu gina aikace-aikace · Misalin Node.js

AIKI DA KAI

## Haɗin abokin ciniki wanda za ka iya gina shi akai.

Abubuwa uku na ainihi: haɗa abokin ciniki, shirya alƙawarinsu, kuma ka tabbatar da haɗin kai.

### Shiga da sabunta zaman

Abokin ciniki yana zaɓar asusun ShareAI, yana amincewa da aikace-aikacenka kuma yana komawa zuwa JamZY.

**Za ka iya tabbatar da shi lokacin da**

Ka shiga, sabunta zaman kuma ka cire haɗin cikin nasara.

### Wani shiri mai amfani

Juya burin alƙawari zuwa jadawali da tambayoyi ta hanyar buƙatar AI mai natsuwa.

**Za ka iya tabbatar da shi lokacin da**

Samar da rubutaccen shiri; adana alƙawari baya kiran AI.

### Saitin da za ka iya tabbatarwa

Bayyana kuɗin AI na zaɓi kuma tattara duba dandalin da buƙatar gabatar da nazarinka ke buƙata.

**Za ka iya tabbatar da shi lokacin da**

Kowace dandamali da aka haɗa da iyakar da aka nema tana da dubawa da aka rubuta.

## Duba abin da za ka gina

Za ku gina haɗin da abokan cinikin ku za su iya fahimta: asusun su na ShareAI, ƙirar shirye-shiryen AI na zaɓi, da hanya mai tsabta zuwa alƙawarin su.

Inda za ku yi aiki Misalin ku da aka gama

Haɗa aikace-aikacen ku zuwa ShareAI Builder, daga rajista zuwa haɗin da aka gwada wanda ya shirya don dubawa. Wannan jagorar yana amfani da JamZY, ƙaramin aikace-aikacen alƙawari na Node.js, don nuna kowane mataki: rajistar aikace-aikacen, daidaita dandamali na yanar gizo, haɗa asusun abokin ciniki na ShareAI kuma aika buƙatar AI da aka ba da izini. Yi amfani da matakai iri ɗaya ga samfurin ku.

| Iyawa | Abin da abokin ciniki ya yarda da shi | Abin da JamZY ke nunawa |
| --- | --- | --- |
| Shiga tare da ShareAI | Haɗin asusu da bayanan tantancewa da aikace-aikacen ku ke nema. | Keɓaɓɓen tantancewar abokin ciniki daga bayanan mai amfani da aka tabbatar. |
| Biyan kuɗi tare da ShareAI · Amfani da AI | Yin amfani da asusun mutum ko ƙungiyar da abokin ciniki ya zaɓa don fassarar da aka ba da izini. | Tsarin shirye-shiryen alƙawari wanda aka biya ta hanyar kuɗin da suka cancanta na asusun. |
| Builder alamar | Ƙarin kuɗin amfani da AI a cikin kwangilar aikace-aikacen da aka yarda da ita. | Monetization na zaɓi, bayan amincewa da wallafa kwangila. |
| Biyan kuɗin samfur | Siyan musamman da aka gabatar a cikin ShareAI checkout daban. | Ƙarin bayani a cikin [jagorar biyan kuɗi](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/). Demo na alƙawari ba ya aiwatar da checkout. |

Samu asusun ShareAI, izinin amfani da asusun mutum ko ƙungiyar da za ta mallaki aikace-aikacen, HTTPS callback na jama'a, tambari, da shafukan sirri, sharuɗɗa da share asusu masu aiki. Don gudanar da misalin, yi amfani da Node.js 22 ko mafi sabo da adireshin HTTPS don aikace-aikacen ku.

JamZY · aikace-aikacen tunani na alƙawari [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LnBuZw.DZt_5dnvNF40T34-7MJsXw?v=219eca92cbe5)

Tsarin alƙawarin gida da shirye-shiryen AI da abokan ciniki suka biya ayyuka ne daban-daban. Babu gayyatar kalanda da aka aika ta wannan nunin.

1. Zaɓi nau'in alƙawari da tsawon lokaci.
2. Zaɓi wani lokacin nunin da ake da shi.
3. Haɗa ShareAI don amfani da mataimakin AI na zaɓi.
4. AI yana gudana ne kawai bayan wannan aikin da aka bayyana; yin rajista kaɗai ba ya kira ShareAI.

**Yi amfani da bayanan aikace-aikacen ku.**

Hotunan allo suna amfani da bayanan misali na aikace-aikace. ShareAI adireshi a cikin wannan jagorar adireshi ne na samarwa. Samar da shirye-shirye yana yin ainihin buƙatun AI kuma zai iya kashe kuɗi; zaɓar ko adana alƙawarin gwaji ba ya yin hakan. Tabbatarwa ana kammala ta gwajin haɗin kai mai nasara na ku.

**Kun shirya ci gaba lokacin**

Kuna iya bambanta shiga asusu, amfani da AI, ƙarin caji na zaɓi da tabbatar da sayan samfur. Karanta wannan jagorar ba ya buƙatar buƙatun da aka biya.

## Shiga cikin Shirin Builder

Za ku ƙirƙiri asalin Builder wanda ke mallakar aikace-aikacen ku da dangantakar abokan cinikinsa.

Inda za ku yi aiki Console → Shirin Gini

1. Ƙirƙiri ko shiga cikin asusun ShareAI. Zaɓi asusun mutum ko ƙungiya wanda zai mallaki JamZY; yi amfani da asusun ɗaya a duk tsari.
2. Bude [Builder Program a cikin ShareAI Console](https://console.shareai.now/app/builder/). Zaɓi ayyukan builder da suka dace da aikin ku. Don wannan jagorar, zaɓi hanyar kamfanin samfur don aikace-aikacen da kuka mallaka. Aikin Abokin ciniki yana nufin ayyuka da aka isar wa abokin ciniki; haɗin kai yana haɗa aikace-aikacen da ke akwai.
3. Zaɓi asusun mutum ko na ƙungiya wanda zai mallaki shirin rajista kafin yin amfani. Ƙungiyoyi na iya gabatar da aikace-aikace kafin tabbatarwa, amma amincewar ma'aikata kawai ba ta kunna damar shiga ba. Cika tabbacin imel na ƙungiya da tabbacin kamfani daga jerin abubuwan onboarding a cikin Console. Ƙungiyar da aka amince da ita za ta kasance Pending verification har sai an kammala duka binciken. Builder, Provider da Creator shirye-shirye suna bin wannan ƙa'ida.
4. Bayan karɓa, buɗe Builder Program → Product. Mai sauya mai aiki yana gano asusun da kuke gyarawa.

Builder Program · wurin shiga rajista [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Vucm9sbG1lbnQucG5n.qBq2qLDjzgk2_IqYv0zTco?v=2e8bf9ef5454)

Fara da hanyar samfur, sannan kammala rajista don asusun da zai mallaki JamZY.

1. Ci gaba zuwa Console don yin rajista a cikin Builder Program.

**Kun shirya ci gaba lokacin**

Builder Program yana buɗewa ga mai niyya kuma yana bayar da Sabon app. Shawarar rajista, nazarin aikace-aikace, nazarin bayanan jama'a da Monetization Gateway amincewa matakai ne daban-daban.

Kuna buƙatar bayanai?[Shirin Gini ↗](https://shareai.now/builders/join/)[Takardun Shirin Gini ↗](https://shareai.now/docs/builders/)

## Ƙirƙiri aikace-aikacen ku

Za ku ba JamZY rikodin aikace-aikacen nasa, don haka asalin sa, samun dama da sharuɗɗan kasuwanci su kasance tare.

Inda za ku yi aiki Shirin Gini → Samfur → Sabuwar manhaja

1. A cikin Product, zaɓi Sabon app. Shigar da gidan yanar gizon ku na jama'a don cika bayanan farko, ko zaɓi Zan rubuta su da hannu.
2. Loda PNG ko JPEG tambari, shigar da JamZY a matsayin suna, kuma bayyana samfurin a cikin jumla ɗaya mai bayyanawa. Duba gidan yanar gizon da imel ɗin tuntuɓar builder.
3. Ci gaba cikin tambayoyin saitin. Ku kiyaye amsoshin gaskiya: suna bayyana yadda aikace-aikacen ke isarwa da kuma biyan kuɗi.

Saitin aikace-aikace · bayanai [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NyZWF0ZS1hcHAucG5n.26JD5PFhP3AdM9h-QLR4jI?v=89dd90b67cd9)

Duba sunan app, gabatarwa, tambari da gidan yanar gizon jama'a kafin ci gaba. Bayanai na tuntuɓar suna misali ne kawai.

1. Ba wa aikace-aikacen suna mai bayyanawa.
2. Ci gaba zuwa tambayoyin shiga.

Yi amfani da gidan yanar gizon jama'a mai iya isa don bayanin bayanan aikace-aikacen. Gidan yanar gizon sirri ko wanda ke na gida kawai zai iya kasa samun tabbaci ko da lokacin da aka yi rajistar dawowar ci gaba daidai. Sabon aikace-aikacen yana farawa a matsayin zane. Kuna iya ci gaba da gyarawa ba tare da sanya shi jama'a ba. Mai ganowa aikace-aikacen ya bambanta da OAuth client ID ko subscription ID.

**Kun shirya ci gaba lokacin**

JamZY yana bayyana a ƙarƙashin Samfurin don mai shi da aka nufa. Kada ku ƙirƙiri ƙarin aikace-aikace don kowanne dandamali na na'ura.

Kuna buƙatar bayanai?[Bayanin rajista ↗](https://shareai.now/docs/api/builders/auth/register-application/)[Jagorar gabatarwar jama'a ↗](https://shareai.now/application-guidance/)

## Bayyana yadda aikace-aikacen ku ke isarwa

Za ku sami zaɓuɓɓukan OAuth waɗanda suka dace da inda aikace-aikacenku ke gudana da wanda ke sarrafa takardun shaidarsa.

Inda za ku yi aiki Sabuwar manhaja → Saitin aikace-aikace

Don wani JamZY rarraba wanda kake gudanarwa da kanka, zaɓi tsarin farashi wanda ya dace da abin da kake bayarwa, SaaS, manhajar girgije mai masaukin mai siyarwa, Abokin ciniki yana biyan amfani da kansa, da ShareAI don buƙatun AI. Waɗannan misalai ne na amsoshi, ba buƙata ba ne ga kowanne samfur.

Saitin aikace-aikace · rarraba [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2RlcGxveW1lbnQucG5n.z2CCFEuD_5FSexYeMPd83A?v=a4e84e4528c3)

Amsar shiga tana ƙayyade ko sirrin abokin ciniki na uwar garke yana samuwa.

1. Zaɓi inda aikace-aikacenku zai yi aiki a zahiri.

| Inda manhajar ke gudana | Zaɓin OAuth | Inda takardun shaida suke |
| --- | --- | --- |
| Uwar garken ka mai masaukin kansa | Abokin ciniki na uwar garken yanar gizo na iya amfani da sirrin abokin ciniki. PKCE har yanzu yana aiki. | Sirrin da alamomin suna zama a kan uwar garken ka. |
| Manhajar burauza / SPA | Abokin ciniki na Yanar Gizo na Jama'a tare da PKCE. | Babu sirrin abokin ciniki da aka haɗa. Yi amfani da tsarin zaman burauza ko uwar garken da ya dace. |
| Rarraba mai masaukin kansa ko haɗin gwiwa | Abokin ciniki na jama'a tare da PKCE ƙarƙashin manufar shiga. | Kada a rarraba sirrin mai siyarwa da aka raba zuwa shigarwar abokin ciniki. |
| Windows, macOS, Linux, Android ko iOS | Abokin ciniki na jama'a ɗaya ga kowanne dandamali da aka kunna. | PKCE da adana tsaro mai dacewa da dandamali; babu sirrin da aka haɗa. |

Samfurin da za a sauke JamZY da gangan yana amfani da abokin ciniki na Yanar Gizo na Jama'a tare da PKCE, ko da yake yana da ƙaramin uwar garke. Uwar garken yana riƙe da alamomin daga adana burauza. Amsar mai masaukin mai siyarwa tana ba da damar uwar garken abokin ciniki; ba ta tilasta maka zaɓar ɗaya ba.

Za ka iya sake duba amsoshin da aka adana ƙarƙashin Bayanin Aikace-aikace → Saitin Aikace-aikace. Canje-canje na rarraba na iya cire sirrin abokin ciniki mara dacewa kuma suna buƙatar sake tabbatarwa. Duba tasirin hakan kafin adanawa.

**Kun shirya ci gaba lokacin**

Rarraba da aka adana yana bayyana ainihin tsarin ka. Zaɓin sirrin abokin ciniki yana bin wannan amsar; zaɓin da aka kashe bayani ne na manufar, ba takardun shaida da suka ɓace ba.

Kuna buƙatar bayanai?[Rajistar abokin ciniki ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Gabatar da aikace-aikacen ku a fili

Za ka ba abokan ciniki cikakkun bayanan samfur da manufofin da suke buƙata kafin su yanke shawarar haɗawa.

Inda za ku yi aiki Bayanin Aikace-aikace

Buɗe Bayanin Aikace-aikace bayan Dashboard. Yi aiki ta cikin sassan da aka keɓe: cikakkun bayanai, saitin aikace-aikace, gabatarwa, alama, hotuna da bita. Ka ba samfurin bayanin da ya dace, gidan yanar gizo mai inganci da hotunan kariyar kwamfuta masu bayyanawa na tsarin aiki na abokin ciniki.

Bayanin Aikace-aikace [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2luZm9ybWF0aW9uLnBuZw.gTT43COTCGPlcpxLYXCMCb?v=0ed11c1d57c9)

Ba wa aikace-aikacen ku sunansa, gabatarwa da gidan yanar gizo na jama'a HTTPS.

1. Haɓaka bayanai, saitawa, gabatarwa da alama a cikin sassan su.

Yi amfani da ainihin aikace-aikacen ka. ShareAI alama tana da alaƙa da maɓallin haɗin kai da kayan bayani; bai kamata ya maye gurbin tambarin samfurin ka ba. Ka tabbatar da sirri, sharuɗɗa da hanyoyin gogewa suna iya isa ba tare da shiga ba.

Adana canje-canje lokacin da aikin adana mai iyo ya bayyana. Shawarar bayani na jama'a tana da bita na kanta; gyara shawarar da aka amince da ita ba ta maye gurbin gabatarwar jama'a ba a hankali.

**Kun shirya ci gaba lokacin**

Baƙo zai iya fahimtar abin da JamZY ke yi, wanda ke gudanar da shi, da yadda za a nemi gogewa. Cikakkun bayanai na jama'a da daidaiton kiran suna nuni ga samfurin ɗaya.

Kuna buƙatar bayanai?[Jerin abubuwan gabatarwa ↗](https://shareai.now/application-guidance/)[Tambura & amfani da maɓalli ↗](https://shareai.now/brand-guidance/)

## Zaɓi abin da abokan ciniki za su iya ba da izini

Za ku nemi damar da kwarewar alƙawarin ku ke amfani da ita a zahiri kuma ku bayyana manufar biyan kuɗin ta a sarari.

Inda za ku yi aiki Aikace-aikace → Amfani

A cikin Amfani, kunna Shiga tare da ShareAI don haɗin asusu da Pay with ShareAI don tsarin da abokin ciniki ke biya wanda kake son tallafawa. Nemi damar Monetization Gateway kawai idan samfurinka zai sami ƙarin kuɗi akan amfani da AI. Bi matsayin amincewa da aka nuna a Console.

Amfani [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3VzZS1jYXNlcy5wbmc.zRU3Lp1TsQuYD7ClWUWS-X?v=090d8c81e6da)

Log-in with ShareAI, Pay with ShareAI da Monetization Gateway suna da yanayin daidaitawa da amincewa daban-daban.

1. Daidaita Shiga tare da ShareAI.
2. Kunna amfani da kuɗin da abokin ciniki ya bayar.

| Izini | Dalilin da zai sa ku nemi shi |
| --- | --- |
| `openid` | Haɗa asusu ta amfani da asalin mai amfani da abokin ciniki. |
| `profile` / `email` | Nemi bayanin martaba ko da'awar imel kawai idan samfurin ku yana buƙatar su. |
| `inference` | Kira wuraren ƙarshen AI da aka tallafawa lokacin da aka ba da izini ta hanyar daidaitawar aikace-aikace. |
| `monetization_gateway` | Yi amfani da yarjejeniyar biyan kuɗin AI da abokin ciniki ya amince da ita don amfani da AI mai ƙarin kuɗi. |
| `payments` | Ƙirƙira da duba buƙatun biyan kuɗin abokin ciniki. Kowace sayayya har yanzu tana buƙatar tabbatarwa. |

JamZY buƙatun `openid profile inference monetization_gateway`. Ba ya buƙata `payments` kuma ba ya siyar da samfur ta hanyar dubawa. Kunna wata damar a Console ba ya ba ta ga alamar samun damar da ke akwai: dole ne abokin ciniki ya ba da izini ga scopes da sharuɗɗa.

**Kun shirya ci gaba lokacin**

Damar, daidaitattun scopes da buƙatun izini sun yarda. Guji neman damar zaɓi da aikace-aikacen ku ba ya amfani da ita ko ba zai iya tabbatar da ita ba.

Kuna buƙatar bayanai?[Scope reference ↗](https://shareai.now/docs/api/builders/auth/scopes/)[Biyan kuɗi & ƙarin kuɗi walkthrough ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)

## Saita haɗin yanar gizon ku

Za ku ƙirƙiri ɗaya Web client don kwarewar JamZY na tushen burauza, tare da hanyar tantancewa da ta dace.

Inda za ku yi aiki Saitunan OAuth → Web

1. Buɗe saitunan OAuth. Zaɓi Web daga grid ɗin dandamali. Kuna iya daidaita ɗaya client a kowane dandamali: Web, Windows, macOS, Linux, Android da iOS.
2. Don wannan samfurin zaɓi Aikace-aikacen burauza / SPA, client PKCE na jama'a. Aikace-aikacen yanar gizo na uwar garke ya dace ne kawai lokacin da manufar tura ku ta ba da izini kuma backend ɗin ku zai iya kare sirri.
3. Kwafi ID ɗin Web client ɗin ku. Ci gaba da dandamali a Gwaji yayin da kuke haɗa shi. Kada ku kwafi ID daga hoton allo ko sake amfani da rajistar demo da aka raba don samfur daban.

Saitunan OAuth · grid ɗin dandamali [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3BsYXRmb3Jtcy5wbmc.d1VzRklfuF_87b8KTVlPjn?v=1412f421168b)

Abokin ciniki ɗaya da aka yi rajista a kowace dandamali. Dandalin da ba a saita ba ya kasance na zaɓi.

1. Buɗe haɗin Web guda ɗaya.
2. Ƙara Android kawai lokacin da samfurin ku ya tallafa masa.

Web · Bayani [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3dlYi1jbGllbnQucG5n.AQKecrfiIFG89MpuUlH8uP?v=8f56b706ab2d)

Abokin ciniki na Web na jama'a yana amfani da PKCE kuma ba shi da sirrin abokin ciniki. An ɓoye ID ɗin abokin ciniki.

1. Kwafi ID ɗin abokin ciniki na Web ɗin ku.
2. Abokin ciniki na jama'a ba ya karɓar sirri.

Dandamali daban-daban suna da takardu da ƙa'idodin dawowa daban-daban. Ba su samfurori daban-daban ba: rajistar kuɗi da gudanarwar abokin ciniki an haɗa su don aikace-aikacen. Masu gwajin aikace-aikace ana raba su a duk dandamali, tare da matsakaicin wurare guda biyar ciki har da gayyatar da ke jiran amsa; mai shi ba ya cinye wurin gwaji.

**Kun shirya ci gaba lokacin**

Dandamali ɗaya na Web ne kawai ke akwai. Dandamali na asali da ba ku daidaita ba ba sa hana ƙaddamar da ku.

Kuna buƙatar bayanai?[Rajistar dandamali ↗](https://shareai.now/docs/api/builders/auth/register-application/)

## Mayar da abokan ciniki zuwa aikace-aikacen ku

Za ku mayar da abokan ciniki zuwa aikace-aikacenku bayan izini, ta amfani da madaidaicin adireshin dawowa da kuke da shi.

Inda za ku yi aiki Web → Saitin

A cikin Web → Saitin, ku yi rajista da madaidaicin adireshin dawowa na HTTPS da aikace-aikacenku ke sarrafawa. Wannan jagorar tana amfani da `https://jamzy.example/oauth/callback` a matsayin misali. Sauya `jamzy.example` da yankin HTTPS inda kuka girka kwafin JamZY, kuma ku yi amfani da wannan adireshin dawowa iri ɗaya a cikin saitin aikace-aikacenku.

Web · Saitin [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2NhbGxiYWNrcy5wbmc.VYHbGU1Skc_78NvwYGAAz5?v=6af56597b3d7)

Yi rajistar callback da aikace-aikacen da aka girka ke sarrafawa.

1. Yi rajistar callback da aikace-aikacen da aka girka ke sarrafawa.

Bayar da sunan allon izini, sharuɗɗa, bayanan sirri da bayani kan gogewa. Kunna kawai ikon da kuke buƙata, sannan ku ajiye. Tsarin, mai masauki, hanya da cikakkun bayanan tambaya masu dacewa dole ne su dace da buƙatar izini da musayar lambar. Kada ku yi amfani da alamar tauraro ko wani yanki na URL.

| Dandalin | Kira don aiwatarwa |
| --- | --- |
| Yanar gizo | Daidai adireshin HTTPS akan aikace-aikacenku. |
| Android | Tsarin aikace-aikacen baya mai juyawa wanda ya dace da ID na aikace-aikacen, ko kuma haɗin HTTPS App Link da aka tabbatar tare da fakitin da alamar sa hannu ta SHA-256. |
| iOS | Tsarin aikace-aikacen da ya dace, ko kuma haɗin HTTPS Universal Link da aka tabbatar tare da ID na fakitin da kuma Apple App ID prefix. |
| Windows / macOS / Linux | Daidai adireshin HTTPS da aka yarda, tsarin aikace-aikacen baya mai juyawa da ya dace, ko kuma goyon bayan sake jagorantar loopback akan 127.0.0.1 / \[::1\]. Port na loopback na iya bambanta. |

Aikace-aikacen da aka girka suna ba da izini a cikin burauzar tsarin kuma suna dawowa ta hanyar kira da aka yi rajista. Don haɗin HTTPS app links da aka tabbatar, buga fayil ɗin haɗin da ake buƙata kuma gudanar da tabbatarwa na haɗin a Console. Kira da ke da alama mai yiwuwa a cikin tsari ba hujja ba ce cewa aikace-aikacen da aka girka yana karɓar shi.

**Kun shirya ci gaba lokacin**

Buɗe kira ta hanyar tsarin izini yana dawowa zuwa aikace-aikacenku. Lambar bazuwar ko yanayin da bai dace ba an ƙi.

Kuna buƙatar bayanai?[PKCE & sake jagorantarwa ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Gano & ganewa ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)

## Gudanar da aikace-aikacen ku na JamZY

Za ku sami keɓaɓɓen keɓaɓɓen alƙawari da haɗin ShareAI yana gudana tare da masu gano aikace-aikacenku.

Inda za ku yi aiki Aikace-aikacenku → Saitin yanayi

JamZY aikace-aikacen alƙawari ne tare da mataimaki na AI na zaɓi. Mai tsara jadawalin yana nuna kawai a cikin burauzar: babu mai bayar da kalanda, isar da imel ko biyan kuɗin alƙawari. Haɗin ShareAI izini da haɗin API na AI suna amfani da na ainihi da aka saita a sama.

Sauke [JamZY tushen tunani](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJlZmVyZW5jZS56aXA.jOyG9kwmFZrdMQEhTNGl0J?v=248a37ba4612). Ya ƙunshi uwar garken Node, UI na burauzar, gwaje-gwaje da README na saitawa; babu takardu, asirai, dogaro ko zaman. Duba fayilolin kafin gudanar da su. Sanya tsarin Node a bayan wakilin HTTPS mai juyawa wanda ke kiyaye asalinsa na jama'a.

```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
```

**Ci gaba da haɗa yanayi**

Ƙirƙiri aikace-aikacenku a [console.shareai.yanzu](https://console.shareai.now/app/builder/). Yi amfani da ID na abokin ciniki na samarwa tare da `https://auth.shareai.now` kuma `https://api.shareai.now/api/v1`. Adireshin `jamzy.example` adireshin ne na wucin gadi don aikace-aikacenku, ba demo da aka shirya ba. Yi hidimar aikace-aikacenku akan HTTPS don kuki na zaman Secure ya yi aiki.

JamZY kuma yana ba da haɗin API-key don kwatanta. Wannan jagorar yana amfani da maɓallin wallet/OAuth. Maɓallin API ba ya kafa yarjejeniyar OAuth na abokin ciniki JamZY kuma ba maye gurbin tsarin izini na abokin ciniki ba ne.

**Kun shirya ci gaba lokacin**

Aikace-aikacen yana loda ta hanyar HTTPS. Asalin jama'a, kira da aka yi rajista da ID na abokin ciniki sun dace da rajistar ku. Babu alama ko sirri da ke bayyana a cikin tushen shafi ko localStorage.

## Haɗa abokin ciniki na farko

Za ku bar abokin ciniki ya zaɓi asusun ShareAI ɗinsu kuma ya amince da damar da aikace-aikacenku ke buƙata.

Inda za ku yi aiki JamZY → Biyan kuɗi tare da Wallet ɗin ku ShareAI

Daga JamZY, zaɓi Biyan kuɗi tare da Wallet ɗin ku ShareAI. Aikace-aikacen yana buɗe shafin izini na ShareAI. Abokin ciniki yana shiga, yana zaɓar asusun mutum ko na ƙungiya, yana duba aikace-aikacen da damar da ake buƙata, kuma yana karɓar sharuɗɗan biyan kuɗi da suka dace.

1. **JamZY → Tantancewa**Ƙirƙiri yanayin bazuwar da PKCE verifier; aika ƙalubalen S256 tare da buƙatar izini.
2. **Abokin ciniki → Auth**Zaɓi asusun biyan kuɗi kuma duba sharuɗɗan samun dama da biyan kuɗi. Soke dole ne ya bar JamZY a cire haɗi.
3. **Tantancewa → dawowa**Karɓi lambar ɗan lokaci mai tsawo da yanayin. Tabbatar da yanayin daidai da zaman ɗaya.
4. **Baya → alama**Musanya wannan lambar tare da verifier na asali da adireshin sake jagora iri ɗaya. Abokan ciniki na jama'a ba sa aika sirrin abokin ciniki.
5. **Baya → Bayanin mai amfani**Yi amfani da alamar samun dama don karanta asalin da aka tabbatar, sannan kafa zaman tsaro na JamZY.

Yanar gizo · Maƙallan samarwa [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2VuZHBvaW50cy5wbmc.wcHciknhu_5PQG6wrO4zan?v=63ad6d9e8724)

Yi amfani da waɗannan adireshin samarwa ShareAI tare da ID ɗin abokin ciniki daga console.shareai.now.

1. Ba da izini a auth.shareai.now/oauth/authorize.
2. Musanya lambobi da alamun sabuntawa a auth.shareai.now/oauth/token.

```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.
```

Key rikodin abokin ciniki na gida ta hanyar da aka tabbatar, mai iyaka da abokin ciniki `sub` da mahallin mai bayarwa/abokin ciniki. Izini na mutum da na ƙungiya na iya zaɓar asusun biyan kuɗi daban-daban. ID ɗin abokin ciniki ba ID ɗin mai amfani na duniya ba ne, adireshin imel ko ID ɗin bayanan ƙungiya na cikin gida. Kada a haɗa asali a fadin dandamali ta hanyar daidaita sunayen nunawa.

**Kun shirya ci gaba lokacin**

Soke, yanayin da bai dace ba, lambar da aka sake amfani da ita da izinin da ya ƙare sun gaza lafiya. Al'adar al'ada tana dawo da asusun da aka tabbatar ba tare da bayyana alamominsa ba.

Kuna buƙatar bayanai?[Kammala musayar lamba ↗](https://shareai.now/docs/api/builders/auth/authorization-code-pkce/)[Asalin abokin ciniki na sirri ↗](https://shareai.now/docs/api/builders/auth/pairwise-identities/)

## Tabbatar da abokin ciniki ya kasance haɗe cikin aminci

Za ku ci gaba da aiki da buƙatun da aka ba da izini yayin da alamomi suka ƙare, yayin da kuke ba abokin ciniki hanya mai dogaro don cire haɗi.

Inda za ku yi aiki Aikace-aikacen ku → Sarrafa zaman da alama

| Takardar Shaida | Manufa | Yadda ake sarrafa shi |
| --- | --- | --- |
| Lambar izini | Handoff ɗaya daga shafin izini. | Musanya sau ɗaya, ta amfani da verifier da callback da suka dace. Ba alamar API ba ce. |
| Alamar samun dama | Yana ba da izinin kira na API a cikin yardar da aka karɓa da iyakoki. | Aika kamar `Authorization: Bearer …`. Girmama ƙarewa da kurakuran izinin ƙarshen. |
| Sabunta alama | Yana samun alamomin samun dama na maye gurbin ba tare da wani shiga ba yayin da yardar ta kasance mai inganci. | Adana cikin aminci. Serialize ayyukan sabuntawa kuma maye gurbin takardun shaida da aka jujjuya atomically. |
| ID alama | Tabbatar da asalin OpenID Connect don abokin ciniki. | Idan kuna amfani da shi, tabbatar da sa hannu, mai bayarwa, masu sauraro, ƙarewa da nonce kamar yadda ya dace. Kada a yi amfani da shi azaman alamar Bearer inference. |
| Sirrin abokin ciniki | Tabbatar da abokin ciniki na sirri da aka yarda. | Adana a kan uwar garke. Ya bambanta da duk alamomi kuma ba a taɓa haɗa shi a cikin abokin ciniki na jama'a. |

```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"
```

Yi amfani da dawowa `expires_in` maimakon ƙirƙirar rayuwa. Idan sabuntawa ya dawo da sabunta alamar sabuntawa, adana shi tare da sabon alamar samun dama azaman sabuntawa ɗaya. Ba da izini ɗaya sabuntawa a cikin jirgin ruwa a kowane zaman don haka buƙatun da ke gudana ba sa sake amfani da alamar da aka jujjuya. Grant sabuntawa mara inganci ko wanda aka soke yana buƙatar sake haɗawa; kada a maimaita har abada.

Sabuntawa ba zai iya ƙara iyaka ko karɓar sabon Monetization Gateway kwangila ba a ɓoye. Tura abokin ciniki ta hanyar izini sake don sabbin izini ko sharuɗɗa. JamZY yana adana takardu kawai a cikin ƙwaƙwalwar ajiyar uwar garke na tsawon sa'o'i ɗaya na zaman gwaji, yana tabbatar da bayanan Mai amfani maimakon dogaro da alamar ID mara tabbaci, kuma yana amfani da Kuki mai Tsaro, HttpOnly, SameSite. Sabis na samarwa yana buƙatar nasa ƙira mai ɗorewa, mai kariya.

A lokacin cire haɗin, soke sabunta/bayanai na shiga inda ya dace kuma share zaman aikace-aikacen. Share cookie na burauza kaɗai ba ya soke ShareAI izini ko soke biyan kuɗi da aka biya. Ka guji yin rajista da lambobin shiga, alamomi, asirai ko abun ciki na tambayar mutum.

**Kun shirya ci gaba lokacin**

Karewar lokaci yana haifar da sabuntawa mai sarrafawa guda ɗaya; sabbin alamomi suna maye gurbin tsofaffi. Cire haɗin yana share zaman aikace-aikacen kuma yana bayar da rahoto kan duk gazawar sokewa.

Kuna buƙatar bayanai?[Sabuntawa & juyawa ↗](https://shareai.now/docs/api/builders/auth/refresh-tokens/)[Sokewa & bincike ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Bayanai na Mai amfani & gano ↗](https://shareai.now/docs/api/builders/auth/identity-discovery/)[Mafi kyawun aiki na tsaro na OAuth ↗](https://www.rfc-editor.org/rfc/rfc9700.html)

## Shirya alƙawari na farko tare da AI

Za ku juya burin alƙawari zuwa ajanda da tambayoyi masu amfani, tare da buƙatar AI mai bayyana wanda abokin ciniki ya biya.

Inda za ku yi aiki Samfura Masu Akwai → JamZY → Ku zo a shirye

Buɗe Samfura Masu Akwai a cikin aikace-aikacen. Zaɓi samfura da masu samarwa da samfurin ku zai bayar kuma ajiye saitin. Idan ba za a iya ɗaukar kundin ba, gyara kuskuren samuwa na sama kafin ci gaba; canza abokan ciniki na OAuth akai-akai ba zai gyara shi ba.

Samfura Masu Akwai [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL21vZGVscy5wbmc.PXvmpf7nx9UhAHYgLQ8HHi?v=7c62a7dcb41c)

Zaɓi waɗanne samfura da masu samarwa abokan cinikinku za su iya amfani da su. Magance duk wani kuskuren kundin samfura kafin ci gaba.

1. Kundin samfura na wannan aikace-aikacen ne.

JamZY yana ɗaukar kundinsa ne kawai bayan haɗi. Zaɓi samfurin rubutu da aka yarda, shigar da burin alƙawari mai gajarta kuma zaɓi Haifar da shiri da gangan. Asusun da aka zaɓa yana buƙatar kuɗaɗen da suka cancanta da duk wani sharuɗɗan biyan kuɗi na AI da aka karɓa. Zaɓar kwanan wata, duba alƙawari da ajiye shi ba sa aika buƙatar fahimta.

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

### Bi tsarin alƙawari a cikin JamZY

1. A cikin Jadawali, zaɓi sabis: gabatarwa na mintuna 15, tsara aikin na mintuna 30 ko tattaunawa mai zurfi na mintuna 60.
2. Zaɓi rana da lokaci mai samuwa. Lokutan suna amfani da yankin lokaci da burauzan ku ke nunawa. Samuwa na misali ne kuma alƙawuran da aka ajiye suna shafar wannan burauzan kawai.
3. A cikin Ku zo a shirye, shigar da misalin buri ba tare da cikakkun bayanan sirri ba. Zaɓi samfurin, sannan zaɓi Haifar da shiri. JamZY yana aika sabis ɗin da aka zaɓa da burin ku zuwa ShareAI, yana nuna rubutun da aka dawo lafiya kuma yana barin alƙawarin ba a canza ba.
4. Duba ajandar da kanku. Zaɓi Duba alƙawari, duba sabis ɗinsa, rana, lokaci da tsawon lokaci, sannan Tabbatar da alƙawarin demo. Wannan aiki ba ya kira AI ko ɗaukar biyan kuɗi.
5. Buɗe Alƙawurana don ganin rikodin demo da aka ajiye. Sake loda don tabbatar da yana nan, ko cire shi don sanya ramin ya sake samuwa. Sabis kawai, rana, lokaci da lambar gida ta bazuwar ne aka adana; rubutun AI, buri, alamomi da maɓallan ba a adana tare da alƙawura ba.

Duba sabis, kwanan wata, lokaci da tsawon lokaci kafin adana wannan nunin alƙawarin na burauza kawai. [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LXJldmlldy5wbmc.77e3cMlfs1G-t-jYrNxzoI?v=dcf04d3d6647)

Duba sabis, kwanan wata, lokaci da tsawon lokaci kafin adana wannan nunin alƙawarin na burauza kawai.

1. Duba zaɓin da aka kammala kafin tabbatarwa.
2. Wannan aikin yana adana rikodin nunin; ba ya kira AI kuma ba ya karɓar biyan kuɗi.

Alƙawaraina suna nuna rikodin nunin gida. Cire rikodin yana sa lokacin nuninsa ya sake samuwa. [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2phbXp5LWFwcG9pbnRtZW50cy5wbmc.KGiTkFaDpNeep2RKpzxHNE?v=1d5bce9412c4)

Alƙawaraina suna nuna rikodin nunin gida. Cire rikodin yana sa lokacin nuninsa ya sake samuwa.

1. Rikodin yana ci gaba da kasancewa a cikin wannan burauzar ba tare da bayanan sirri ko bayanan AI ba.
2. Cire alƙawarin nunin kuma saki lokacin nuninsa.

Samfurin tsara jadawali na gaske yana buƙatar ma'ajiyar alƙawari na gefe na uwar garke, duba samuwa, sarrafa yankin lokaci, manufofin sokewa da haɗin kalanda ko sanarwa. Waɗannan sun bambanta da izinin ShareAI. Ci gaba da fitarwar AI a matsayin shawara; tabbatar da duk wani aikin tsara jadawali na gaba ta hanyar dokokin aikace-aikacen ku.

Yi amfani da slug na samfurin da aka dawo da shi daga kundin da aka yarda. Yi sarrafa kwangilar amsa ta ainihi: JamZY tana goyan bayan ShareAI na asali `message.content` envelope da OpenAI-style `choices[0].message.content`. HTTP 200 tare da amsa kuskure mara cika ko mai hade ba amsa mai nasara ba ce.

A kan amsa iyakar kashe-kudi ko rashin isasshen kiredit, nuna bayani mai amfani da haɗin biyan kuɗi na abokin ciniki da aka bayar. Ajiye asusun da aka zaɓa. Kada ka wuce iyakarsa, sauya mai biyan kuɗi a ɓoye ko sake gwada aiki da aka caje a madauki.

**Kun shirya ci gaba lokacin**

Samar da shiri yana dawo da ajanda mai amfani da tambayoyi. An danganta buƙatar ga abokin ciniki da aikace-aikacen da aka yarda, tare da samfurin da aka zaɓa da sharuɗɗan da aka karɓa. Rubutun AI ba zai iya yin rajista ko canza alƙawari ba.

Kuna buƙatar bayanai?[Buƙatun tattaunawa na OAuth ↗](https://shareai.now/docs/api/builders/chat-completions/chat-with-oauth/)[Farfadowar biyan kuɗi ↗](https://shareai.now/docs/api/builders/billing-errors-and-spending-limits/)

## Saita kuɗin AI na zaɓi

Za ka bayyana ƙarin kuɗin AI naka a cikin tayin biyan kuɗi kuma ka buga sharuɗɗan da abokan ciniki za su iya karɓa.

Inda za ku yi aiki Aikace-aikace → Biyan kuɗi

Nemi damar Monetization Gateway ta hanyar Amfani da app idan ba a riga an amince da shi ba ta hanyar manufofin gudanarwa masu dacewa. Cika tambayoyin kuma bi matsayin sa. Amincewa yana ba da damar sanyi; izinin abokin ciniki da yardar biyan kuɗi suna ci gaba da zama daban.

Biyan kuɗi · Bayani gaba ɗaya [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbnMucG5n.1fAD7CKPa38_SZFh5zuI9P?v=f1ef4ee6680b)

Sabbin aikace-aikace suna farawa ba tare da kwangila da aka buga ba. Ƙara tayin kafin buga sharuɗɗansa.

1. Ƙirƙiri tayin a cikin edita nasa.

1. Buɗe Biyan kuɗi. Ƙara tayin, ba shi suna mai bayyanawa kuma bayyana Builder alamar da abokan ciniki za su biya. ID na biyan kuɗi da aka samar yana da karatu kawai kuma an iyakance ga wannan aikace-aikacen; kwafa shi lokacin da haɗin kai naka ke buƙatar shi.
2. Shirya kowane biyan kuɗi a cikin edita nasa. Yi amfani da Estimate don bincika farashin cibiyar sadarwa da ribar ku don samfurin da aka zaɓa da zato na amfani. Kimantawa suna zama hasashe, ba farashi da aka tabbatar ko sharuɗɗan da aka karɓa ba.
3. Duba rubutun tare, sannan ka buga sigar kwangilar lokacin da bukatunta suka gamsu. Sigar da aka buga tana bayyana abin da sabbin abokan ciniki za su iya karɓa.
4. Yi amfani da bayani gaba ɗaya da rarraba kwangiloli don ganin yawan asusun da suka rage akan kowace sigar da aka karɓa. Abokin ciniki yana riƙe da sharuɗɗan da aka karɓa har sai sun bayyana sun karɓi maye gurbin; buga sabuwar sigar ba ya canza su a ɓoye. Ka kiyaye canjin tsoho wanda ke kiyaye kwangilolin da aka karɓa. Idan ka zaɓi da gangan Buƙatar sabunta yarda kafin ƙarin ayyukan aikace-aikace, ana iya katse damar da ake da ita har sai abokin ciniki ya amince da sabbin sharuɗɗan.

Misali kawai: 20% Builder alamar akan €1.00 na farashin cibiyar da ta cancanta yana ƙara €0.20. A farashin Standard, ShareAI’s 5% kuɗin yana aiki ne kawai ga wannan €0.20 alamar, kafin kowane Ingestion Event da za a biya. Yi amfani da mai ƙididdigewa na kai tsaye da kwangilar da aka yarda don lissafin ainihi. Tayawar biyan kuɗi a cikin wannan tsarin shine yarjejeniyar biyan kuɗi na AI; haɗin asusu kaɗai ba ya cire farashin da ake maimaitawa.

Biyan kuɗi · edita na tayin [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3N1YnNjcmlwdGlvbi1lZGl0b3IucG5n.ajS-FCMdefa7Br_i-9U6yV?v=028a19d93ad7)

Wani misali na tayin da aka tsara. ID ɗin biyan kuɗinsa da aka samar yana karantawa kawai kuma yana da iyaka ga wannan aikace-aikacen.

1. Yi amfani da sunan tayin da ke fuskantar abokan ciniki.
2. Saita AI `surcharge` don wannan tayin.

Allon ShareAI na'urar yarda ita ce mai iko don sharuɗɗan da aka karɓa. Ba za a iya fahimtar shirin biyan kuɗi da aka karɓa daga bayanan Mai amfani ta hanyar abokin ciniki na jama'a na JamZY ba, don haka allon haɗin sa ba ya da'awar biyan kuɗi mai aiki ko ƙirƙirar farashi don alƙawarin.

**Kun shirya ci gaba lokacin**

Tayin yana bayyana kuɗin; kwangilar za a iya karɓa ta abokin ciniki. Kuna fahimtar waɗanne abokan ciniki suka kasance a kan tsoffin sharuɗɗa da dalilin hakan.

Kuna buƙatar bayanai?[Kammala jagorar samun kuɗi ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Yarjejeniyoyin da aka karɓa ↗](https://shareai.now/docs/api/builders/auth/billing-agreements/)

## Tabbatar da dandamali da aka haɗa suna aiki

Za ku tattara ainihin ƙarshen ƙarshen da binciken iyaka da ake buƙata don gabatar da aikace-aikacen ku don bita.

Inda za ku yi aiki Saitunan OAuth → Masu Gwaji da Tabbatarwa

Buɗe saitunan OAuth → Masu Gwaji kuma gayyaci har zuwa masu gwaji biyar na aikace-aikace gaba ɗaya. Gayyatar da ke jiran amsa tana cin wuri amma ba ta bayar da damar shiga ba; dole ne mai karɓa ya karɓa. Damar mai shi da damar mai gwaji da aka gayyata sun bambanta da damar samarwa ta jama'a.

Masu gwajin aikace-aikace [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3Rlc3RlcnMucG5n.3_3h6Y0TjTv3r0ttIn9bok?v=60cba368b3d5)

Jerin masu gwaji guda ɗaya yana hidimtawa duk dandamali. Gayyatar da ake jira suna ƙidaya zuwa iyakar wurare guda biyar.

1. Wurare biyar ana raba su ta hanyar duk aikace-aikacen.
2. Gayyaci mai gwaji a nan, sannan jira karɓuwarsu.

Yanar Gizo · Tabbatarwa [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL3ZlcmlmaWNhdGlvbi5wbmc.xLD6z4RV0ddX6p0qkaLhqc?v=d758a8f881d9)

Haɗin haɗin sabo yana nuna binciken da ake jira har sai an rubuta kiran da suka yi nasara na ainihi. Wannan tsararren tunani bai wuce duba ba.

1. Console yana rikodin nasarar ƙarshen ƙarshen ainihi.
2. Dole ne a yi amfani da kowane iyaka da aka nema.

Don kowane dandamali da kuke shirin wallafawa, buɗe Tabbatarwa. Kammala kiran nasara na gaske don ƙarshen ƙarshen da ake buƙata da kowane iyaka da aka saita. Duba gano maɓallan sa hannu; gwada izini/komawa, musayar lamba, sabuntawa, bayanan Mai amfani da aka tabbatar da izini da sokewa. Abokan ciniki masu sirri dole ne su gwada binciken da ya dace. Hanyoyin HTTPS da aka yi iƙirari na asali suna buƙatar tabbacin haɗin kai.

Wani iyaka na bayanan martaba/imel yana buƙatar ainihin da'awar da aka dawo; yi amfani da asusun gwaji na sirri inda imel ya zama dole. `inference` da `monetization_gateway` iyaka suna buƙatar kammala buƙatun AI da aka amince da su. Biyan kuɗi yana buƙatar nasarar kiran API na biyan kuɗi mai iyaka. Nasarar amsa HTTP na gama gari, hoton allo na burauza ko jerin duba na hannu ba ya maye gurbin binciken da aka rubuta na Console.

Kuna da zaɓuɓɓuka uku don dandamali da ba a gama ba: kammala shi kuma tabbatar da shi, cire shi daga wallafawa don haka ya kasance na mai shi/mai gwaji kawai, ko cire shi. Kada ku haɗa dandamali tare da komawa ko iyaka da ba ku yi amfani da su ba. Canje-canjen saiti na iya ɓata bincike, don haka sabunta matsayin da aka rubuta bayan canje-canjen ku na ƙarshe.

**Kun shirya ci gaba lokacin**

Kowane dandamali da aka haɗa yana nuna saiti da ake buƙata, ƙarshen ƙarshen da binciken iyaka a matsayin cikakke. Jerin binciken sirri na jagorar hanya ce kawai ta karatu.

Kuna buƙatar bayanai?[Tabbatar da ƙarshen ƙarshen ↗](https://shareai.now/docs/api/builders/auth/revoke-introspect/)[Kaddamar da tunani ↗](https://shareai.now/docs/builders/applications/launch-application/)

## Miƙa aikace-aikacen ku kuma bi abokan cinikinsa

Za ku san abin da ya shirya don bita, yadda wallafawa ke aiki da inda za ku bi damar abokin ciniki daga baya.

Inda za ku yi aiki Aikace-aikace → Dashboard

1. Komawa zuwa Dashboard kuma warware kowane aiki da ke jiran amsa. Gabatar da bita dole ne ya kasance ba a samu ba har sai aikace-aikacen da duk dandamali da aka haɗa sun cika buƙatunsu.
2. Gabatar da aikace-aikacen don bita na ShareAI. Bi diddigin shawarar da duk wani canje-canje da aka nema a Dashboard da Ayyuka & Shawarwari. Gabatarwar jama'a da buƙatun Monetization Gateway na iya samun shawara daban-daban.
3. Bayan amincewa, buga aikace-aikacen ta amfani da sarrafa buga da ake da su. Tabbatar da dandamali da aka haɗa sun shirya don samarwa; waɗanda aka cire su za su ci gaba da kasancewa a Gwaji.
4. Buɗe Customers don asusun matakin aikace-aikace da Subscriptions don rarraba kwangila da aka karɓa. Analytics yana taimaka maka bin amfani da AI da aka danganta da samun kudin shiga. Masu gano abokan ciniki suna zama masu zaman kansu ga abokin ciniki/matsayin izini da ya dace.

Dashboard · shirye-shiryen ƙaddamarwa [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2Rhc2hib2FyZC5wbmc.2hIAeRjQpgXmhBWVPD5_zB?v=38be9c6d668e)

Duba yana ci gaba da kasancewa a kulle yayin da aikace-aikacen da dandamali da aka haɗa suna da buƙatun da ba a cika ba.

1. Magance ayyukan da ake buƙata kafin miƙa don duba.

Abokan ciniki [Faɗaɗa hoton kari ↗](https://shareai.now/shareai-assets/L3dwLWNvbnRlbnQvdGhlbWVzL3NoYXJlYWktZnJvbnRlbmQtdGhlbWUvYXBwL21vZHVsZXMvZ3VpZGFuY2UvYXNzZXRzL2N1c3RvbWVycy5wbmc.qbIDq-R5JMA6K48ws4kWaB?v=cc0470083fec)

Duba aikace-aikacen yana haɗa asusun da aka haɗa tare ba tare da nuna ID ɗin bayanan ƙungiyar na ciki ba.

1. Gudanar da abokan ciniki an haɗa shi don aikace-aikacen.

Gwada dukkan tsarin daga farko tare da abokin ciniki da ya cancanta bayan ƙaddamarwa: haɗa, bincika asusun da izini, ƙirƙirar takaitaccen shirin shirye-shiryen alƙawari, sabunta lafiya, magance gazawar biyan kuɗi, sannan cire haɗin. Tabbatar da kwarewar mai amfani kai tsaye maimakon ɗauka cewa adanawa mai nasara yana tabbatar da aiki.

**Lokacin da wani abu bai yi aiki ba**

**Rashin daidaiton Callback:** kwatanta URL ɗin da aka yi rajista da duk ƙimar buƙatun guda biyu daidai. **Mai gwada ba da izini:** tabbatar da karɓar gayyata da asusun da aka zaɓa. **Rashin iyaka ko kwangila:** nemi damar da aka kunna kawai kuma sake haɗawa don karɓa. **Babu samfura:** bincika Samfuran da Ake da su da takunkumin mai bayarwa. **Gazawar sabunta:** share zaman gida da ya gaza kuma sake haɗawa. **Bincike an toshe:** bincika duba dandamali maimakon ƙirƙirar wani abokin OAuth.

**Kun shirya ci gaba lokacin**

Manhaja tana aiki ga abokin ciniki da aka nufa, dubawa da aka rubuta suna tallafawa yanayin buga ta, kuma abokin ciniki zai iya sarrafa ko janye izini.

Kuna buƙatar bayanai?[Ci gaba: Biya da ShareAI ↗](https://shareai.now/blogs/product/builder-program/guides-how-to/pay-with-shareai/)[Builder API reference ↗](https://shareai.now/docs/api/builders/)

## Tabbatarwar ƙungiya da samun damar shirin

Zaɓi asusun mutum ko na ƙungiya wanda zai mallaki shirin rajista kafin yin amfani. Ƙungiyoyi na iya gabatar da aikace-aikace kafin tabbatarwa, amma amincewar ma'aikata kawai ba ta kunna damar shiga ba. Cika tabbacin imel na ƙungiya da tabbacin kamfani daga jerin abubuwan onboarding a cikin Console. Ƙungiyar da aka amince da ita za ta kasance Pending verification har sai an kammala duka binciken. Builder, Provider da Creator shirye-shirye suna bin wannan ƙa'ida.

[Duba Monetization Gateway farashin](https://shareai.now/ha/masu-gini/%c6%99ofar-samun-ku%c9%97i/#mg-pricing) · [Bincika ShareAI for Startups](https://shareai.now/ha/shirin-farawa/) · [Scopes da izini](https://shareai.now/ha/takardu-2/api/masu-gini/tantancewa/maaunin-oauth-da-iyakokin-asusu/)

## Izini da sharuɗɗan da aka amince da su

Sharuwa da Dokokin Amfani na Jama'a, Manufar Sirri da umarnin gogewa dole su dace da aikace-aikacen kuma su kasance masu samuwa ba tare da shiga ba. Karɓar shirin ShareAI, amincewar Monetization Gateway, izinin OAuth na abokin ciniki da kwangilar biyan kuɗi da aka amince da ita su ne yanke shawara daban-daban. Sabuntawa ba zai iya ƙara izini ko karɓar sabbin sharuɗɗan kasuwanci ba.

Tsarin tsohon `surcharge` har yanzu ana karɓa don haɗin gwiwa da ke akwai. Sabbin misalai suna amfani da `monetization_gateway`. Ci gaba da amfani da filayen waya da ke akwai kamar `surcharge_bps` da `surcharge_percentage` ba tare da canji ba.

[Duba Monetization Gateway farashin](https://shareai.now/ha/masu-gini/%c6%99ofar-samun-ku%c9%97i/#mg-pricing) · [Bincika ShareAI for Startups](https://shareai.now/ha/shirin-farawa/) · [Scopes da izini](https://shareai.now/ha/takardu-2/api/masu-gini/tantancewa/maaunin-oauth-da-iyakokin-asusu/)

## Kudaden Gateway da tallafin Startup

Cajin da aka saba 5% na Builder markup. Don €2.00 na farashin cibiyar sadarwar AI da 10% markup, abokin ciniki yana biyan €2.20. ShareAI yana karɓar €0.01 na €0.20 markup; Builder yana da €0.19 kafin Event Ingestion.

Na farko 1,000 da aka kammala Production Monetization Gateway buƙatun kyauta ne a kowanne wata na kalanda (UTC), an raba su a cikin asusun Builder. Karin buƙatun suna da farashin €0.04 a kowane 1,000 kafin rangwamen da suka cancanta. Buƙatun da aka kammala guda ɗaya yana haifar da wani taron guda ɗaya.

Pay with ShareAI da kansa, samun dama na inference kawai, maɓallan API na asusun na yau da kullum da Staging ko zirga-zirgar gwaji ba sa haifar da Monetization Gateway Event Ingestion.

ShareAI for Startups yana bayar da rabo na wata-wata na gama-gari don ainihin ShareAI kudade akan aikace-aikacen da aka amince da shi. Matakan Launch, Growth da Momentum na yanzu suna lissafa €1,000, €5,000 da €10,000 a wata. Wannan kasafin kuɗi ɗaya yana rufe ShareAI’s percentage fee akan Builder markup da billable Event Ingestion tare. Ba allowance na gross-markup bane, ba rabo na abubuwan kyauta daban-daban bane ko kuma kyautar AI `inference`. Abubuwan farko na asusun 1,000 kyauta ba sa cin wannan.

Ana sauran kudaden shigarwa na Event Ingestion ana biya su daga sabon Builder na buƙatun, sannan ana samun Builder AI earnings da unrestricted AI credits. Kudaden AI na abokan ciniki da samfurin `payments` suna zama daban.

ShareAI na iya amincewa da kudade na musamman na aikace-aikace ko tallafin kudi na wani lokaci ko har sai an canza. Duba farashin aikace-aikacen na yanzu da Special Programs a Console don sharuɗɗan da aka amince da su, inganci da rabo da aka ci. Canjin mataki ko farashin override ba zai sake saita amfani na wata-wata na aikace-aikacen ba.

Launch yana riƙe Log in tare da ShareAI a matsayin zaɓi. Growth da Momentum suna buƙatar shi; Momentum kuma yana buƙatar alamar hukuma ShareAI for Startups a ƙasan aikace-aikacen. ShareAI yana duba alamar a kowane mako. Tabbatar da ƙoƙarin kaucewa buƙatun na iya haifar da rage matsayi, cirewa daga Startup Program ko janye daga Marketplace ƙarƙashin sharuɗɗan shirin da aka amince da su.

Farashin kamfanoni ana tsara su ta hanyar ƙungiyar ShareAI don asusun Builder bayan amincewa da tayin na musamman. Kashi da farashin taron da aka sanya suna aiki ga buƙatun nan gaba.

[Duba Monetization Gateway farashin](https://shareai.now/ha/masu-gini/%c6%99ofar-samun-ku%c9%97i/#mg-pricing) · [Bincika ShareAI for Startups](https://shareai.now/ha/shirin-farawa/) · [Scopes da izini](https://shareai.now/ha/takardu-2/api/masu-gini/tantancewa/maaunin-oauth-da-iyakokin-asusu/)

Source: https://shareai.now/ha/blogogi/samfur/shirin-gini/jagororin-yadda-ake-yi/yadda-ake-ha%C9%97a-aikace-aikace-zuwa-shareai-builder-mataki-mataki/