Halkan, waxaad ka heli doontaa shuruudaha iyo xaaladaha si gaar ah ula xiriira Isticmaalayaasha API-geena (“Shuruudaha API”). Shuruudahan API waa in lala akhriyaa Shuruudaha Guud ee Shirkadaha Iskaashiga (“Shuruudaha Guud”). Erayada la qeexay ee lagu isticmaalo Shuruudahan API waxay yeelan doonaan macnaha lagu siiyay Shuruudaha Guud.
1. Waajibaadka Isticmaalayaasha API
1.1. Marka la eego oggolaanshahaaga buuxa oo joogtada ah ee ku socda Shuruudahan API, waxaan ku siinaynaa shatiga xaddidan, aan gaarka ahayn, aan la wareejin karin, aan loo wareejin karin, laguna soo celin karo ee loo isticmaalo API-geena si aad u horumariso, u tijaabiso, u taageerto barnaamij software ah, websayd, ama alaab aad abuurto ama adeeg aad bixiso (“Barnaamijka”) kuna ogolaato macaamiishaada inay isticmaalaan isku xirnaanta API-geena ee Barnaamijkaaga.
1.2. Waxaad ku raacsan tahay inaadan sameynin waxyaabaha soo socda:
1.2.1. Sublicensing ama u ogolaanshaha qof kale xaqyo ka mid ah kuwa lagu siiyay Shuruudahan API;
1.2.2. Isticmaalka ama taraarnaynta API-geena marka laga reebo xaaladaha si cad loogu ogolaaday Shuruudahan API;
1.2.3. Isticmaalka API-geena ujeedo kasta oo ku xadgudubta sharci ama qaanuun, ama xaq kasta oo qof leeyahay, oo ay ku jiraan xuquuqda hantida fikradeed, xuquuqda sirta gaarka ah, ama xuquuqda shakhsiyadda; ama
1.2.4. Isticmaalka API-geena si aan waafaqsanayn Shuruudahan API.
1.3. API-geenu wuxuu leeyahay xadka isticmaalka si looga hortago xad-gudubka iyo/ama isbeddelka ujeedada API-geena. Xadadkan isticmaalka waa la beddeli karaa iyada oo aan ogeysiis la bixin. Haddii aad si joogto ah uga tagto xadka isticmaalka ama si kale ugu xad-gudubto adeegga, waxaan xidhi karnaa gelidaada API-geena.
2. Kaydinta Waxyaabaha
2.1. Lama oggola inaad kaydiso wax content ah (sida feed data) oo laga soo saaray ama ka yimid websaydkeenna ama laga helo API-geena.
2.2. Waxaad kaydin kartaa aqoonsiyada isticmaalaha ee xaraf-iyo-lambar ah ee la bixiyay ee gaarka ah Barnaamijka (API tokens) ama tokens-ka xaqiijinta ee laga bixiyo Open Authorisation Standard (OAuth tokens).
2.3. Waxaad kaydin kartaa (cache) content kasta oo laga soo saaray websaydkeenna ama laga helo API-geena ilaa afar iyo labaatan (24) saacadood laga bilaabo codsiga contentkaas ee loo sameeyay iyadoo la adeegsanayo API-geena.
2.4. Haddii xiriirkeenna uu ku dhammaado sabab kasta, waa inaad si joogto ah u tirtirto dhammaan content-ka laga soo saaray ama ka yimid websaydkeenna ama laga helo API-geena, marka laga reebo xaaladaha ay tirtiriddan ku xadgudbi karto sharci kasta oo khuseeya ama waajib uu soo rogay hay'ad dawladeed.
3. Lahaanshaha
3.1. Hantideenna
3.1.1. Waxaan iska leenahay dhammaan xuquuqda, cinwaanka, iyo danta, oo ay ku jiraan dhammaan xuquuqda hantida fikradeed, ee API-geena iyo dhammaan qaybaha, isku-dhafka, iyo fulinta API-geena, mana aanu kuu siin xaq, cinwaan, ama danayn API-geena marka laga reebo shatiga lagu siiyay Shuruudahan API.
3.1.2. Isticmaalkaaga API-geena kuguma siin doono xuquuq hantida fikradeed oo noogu dhasay ama cinwaan ama danayn ku saabsan xuquuqdaas, oo ay ku jiraan xuquuqda ku xiran madaladeena ganacsiga iyo websaydkeenna.
3.1.3. Marnaba ma aad doodi doontid ama ma aad caawin doontid cid saddexaad oo doodaysa xuquuqdeenna ku saabsan API-geena ama hanti kale oo fikradeed oo aan iska leenahay ama shati noogu siiyay ama laga siiyay shirkadaha xidhiidhka la leh.
3.1.4. Waxaad ku raacsan tahay inaad qaadato tallaabooyin xoogaa macquul ah oo aan ku weydiisanno si looga ilaaliyo xuquuqdeenna API-geena.
3.1.5. Waxaad aqoonsanaysaa inaan sii wadan karno inaan sameyno isbeddelo iyo horumarin ku saabsan API-gayaga, iyo in aan iska leenahay isbeddelladaas iyo horumarintaas.
3.1.6. Waxaad hadda u wareejinaysaa oo u gudbinaysaa annaga dhammaan xuquuqdaada, cinwaanka, iyo xiisahaaga ku saabsan wax kasta oo beddel ah ama shaqooyinka ka soo baxay API-gayaga ee aad sameysay ama laguu sameeyay, iyadoon loo eegin inay ku sameysmeen sida ku xusan Shuruudaha API ama in kale. Wareejintan waxay dhaqan gasha marka la abuuro beddeladan ama shaqooyinka ka soo baxay, waxayna ku jiri doontaa dhammaan xuquuqda ku xeeran sharciyada hantida fikirka ee kala duwan, oo ay ku jiraan xuquuqda daabacaadda (copyright).
3.1.7. Waa inaadan qaadan wax tallaabo ah oo khatar gelinaysa, xaddidaysa, ama la wadaagaysa qof ama shirkad saddexaad si kasta oo ah lahaanshaheenna API-gayaga iyo xuquuqdeenna ku saabsan, ama wax kasta oo ka soo baxay ama cusboonaysiin ah.
3.1.8. Qaybo kasta ama farsamooyinka nidaamka ama barnaamijka API ee ka soo baxay API-gayaga ama dhaqamadeenna ganacsiga, iyo xuquuq, cinwaan, ama xiiso kasta oo la xiriira, oo ay ku jiraan dhammaan xuquuqda hantida fikirka, waxay keligeed noqon doonaan kuwa aan iska leenahay.
3.2. Hantidaada
3.2.1. Ma sheegano lahaanshaha Application-kaaga marka laga reebo intii Application-kaagu isticmaalayo API-gayaga.
3.2.2. Waxaad na siinaysaa xaq aan lacag-dalag lahayn, aan gaar u ahayn qof kaliya, adduunka oo dhan, iyo aan la soo celin karin, kaas oo hoos yimaada dhammaan xuquuqdaada hantida fikirka, si aan u samayno waxyaabaha soo socda:
3.2.2.1. Inaan daabacno magacaaga iyo astaantaada (logo) (hadday ku jirto ama aysan ku jirin link u socota Application-kaaga) websaydkeenna, warsaxaafadeedyada, iyo waraaqaha xayeysiinta iyadoon laga baahnayn ogolaanshaha hoose;
3.2.2.2. Inaan isticmaalno, bandhigno, oo soo tusno Application-kaaga iyo nuxurkiisa ujeedooyin suuqgeyn ama muujin ah;
3.2.2.3. Inaan Application-kaaga u diyaarino macaamiisheenna; iyo
3.2.2.4. Inaan macaamiisheenna ku tilmaamno Application-kaaga anagoo link uga xir una xirna.
3.3. Wax-ku-biirinta API-gayaga
3.3.1. Marka aad soo gudbiso soo jeedino ama jawaab-celin kale oo ku saabsan API-gayaga (“Wax-ku-biirinnada”), waxaad ku raacsantahay waxyaabaha soo socda:
3.3.1.1. Annaga ma nihin wax waajib qarsoodi ah oo la xiriira Wax-ku-biirinnadaada;
3.3.1.2. Waxaan isticmaali karnaa ama daaha ka qaadi karnaa (ama doorasho inaanan isticmaalin ama daaha ka qaadin) Wax-ku-biirinnadaas ujeedo kasta, si kasta, iyo warbaahin kasta oo adduunka ah;
3.3.1.3. Si aan la soo celin karin oo gaar ahaan ah ayaad na siinaysaa xuquuqda inaan isticmaalno Wax-ku-biirinnadaada si kasta oo aan rabno; iyo
3.3.1.4. Xaalad kasta ma xaq u lihid magdhaw ama lacag celin nooc kasta ah oo xagganna ka timaada.
3.4. Dib-u-eegista API-gayaga
3.4.1. Waxaan soo saari karnaa nooca ka dambeeya ee API-gayaga oo aan kaa dalban karno inaad isticmaasho nooca ka dambeeya. Sii wadista isticmaalkaaga API-yada ka dib marka la soo saaro noocyo cusub waxaa loo arki doonaa inay tahay aqbalaadaada beddeladaas.
3.4.2. Waa inaad joojisaa isticmaalka dhammaan noocyada hore ee API-gayaga si aad u adeegsato API-gayaga la dib-u-eegay.
3.4.3. Waxaan samayn karnaa isbeddel, joojin ku meel gaar ah, ka tagid, ama hakin dhinac kasta oo API-geenna ah, oo ay ku jiraan heli karista adeegyada, macluumaadka, sifooyinka, ama shaqooyinka lagu gaari karo iyadoo la isticmaalayo API-geenna. Waxaan dadaalayaa inaan kaa ogeysiino isbeddelladan, joojinta ku meel gaarka ah, ka tagidda, ama hakinta ugu yaraan toddoba (7) maalmood ka hor marka la eego kanaalladayada Telegram iyo foorumka Vanilla.
3.4.4. In kasta oo ujeedkeennu yahay in API-ga aan dib u habeynay uu la shaqeeyo nooca hore ee API-geenna, ma dammaanad qaadayno tan oo ma noqon doono kuwo xil saaran si kasta oo ku saabsan guuldarrada API-ga la dib u habeeyay inuu la shaqeeyo nooc kasta oo hore oo API-geenna ah.
4. Dammaanadaha iyo xaddidaadaha xilka
4.1. Waxaad dammaanad qaadaysaa inaad xaq u leedahay inaad isticmaalid, soo saarto, gudbiso, nuqul ka samayso, si guud u muujiso, si guud u sameyso, oo qaybiso Application-kaaga, marka laga reebo waxyaabaha ka soo jeeda ama ka yimaadda websaydkeenna ama lagu gaaro API-geenna.
4.2. Waxaad isticmaaleysaa API-geenna khatar kaaga ah. Waxaad qaadanaysaa xil buuxa iyo khatarta lumis kasta oo aad soo gaadhi karto natiijadii isticmaalka ama gelitaanka API-geenna.
4.3. Marka lagu daro xaddidaadaha xilka ee ku xusan Shuruudaha Guud, fadlan ogsoonow waxyaabaha soo socda:
4.3.1. Ma noqon doonno mas'uul ah nooc kasta oo khasaare ah ama waxyeello ah oo ka dhalata macluumaad ama qiimo lagu daabacay ama lagu bixiyay API-gayaga ama cilado ama waxyaabo laga tagay API-gayaga.
4.3.2. Ma lahaan doono wax xil ah oo ka dhasha dalabaadka, go'aamada maalgelinta, ama iibsiga alaabta ama adeegyada dhinaca saddexaad (oo ay ku jiraan qalabka maalgelinta iyo lacagta) ee ku salaysan macluumaadka lagu daabacay ama lagu bixiyay API-geenna.
4.3.3. App markup-ka waxaa lagu xisaabiyaa heer-ganacsi kasta, iyadoo lagu salaynayo lacagta la bixiyo ee heshiiska iyo boqolleyda markup-ka ee loo habeeyay Application-kaaga, waxaana lagu bixiyaa lacagta akoonkaaga. Haddii qadarka markup-ka ee la xisaabiyay ganacsi ka yar yahay unugga ugu yar ee lacagta akoonkaaga (tusaale ahaan, 0.01 USD), qadarkaas waxaa laga dhigayaa eber. Ma hayno waajibaad ah inaan isu kaydsano, u sii wadno, ama si kale u bixinno qadarrada markup-ka ee ka hooseeya heerkan.
5. Afeef
5.1. Afeefta dammaanadda
5.1.1. Waxaan ku bixinaa API-geenna si 'sida ay tahay' iyo 'sida ay heli karto' iyada oo aan lahayn dammaanad, mid muujisan ama mid lagu fahmo, nooc kasta oo ah. Ilaa heerka ugu badan ee sharciga la fiirsan karo, waxaan diidaynaa dammaanad iyo matalaad kasta, oo ay ku jiraan, iyada oo aan ku xaddidnayn, dammaanad kasta oo lagu fahmo oo ku saabsan suuq-geyn, ku habboonaan ujeeddo gaar ah, cinwaan, saxnaanta xogta, iyo in aan la xad-gudbin xuquuq kasta.
5.1.2. Ma dammaanad qaadayno in API-geenna shaqayn doono iyada oo aan jirin kala go'id ama khaladaad. Gaar ahaan, hawlgalka API-geenna waxaa laga yaabaa inuu kala go'o sababo ay ka mid yihiin dayactir, cusboonaysiin, ama guuldarro nidaamka ama shabakadda. Waxaan diidaynaa xil kasta oo ka dhasha dhaawac ay keento kala go'id ama khaladaad hawlgalka.
5.1.3. Waxaan diidaynaa xil kasta oo ka dhasha wax shaqayn la'aan, awoodla'aan gelitaan, ama xaalad isticmaal oo liita ee API-geenna sababtoodu tahay qalab aan ku habboonayn, dhibaatooyin la xidhiidha bixiyeyaasha adeegga internetka, buuxsanaanta shabakadda internetka, ama sabab kasta oo kale.
5.2. Afeefta amniga
5.2.1. Waxaad ogolaataa in adiga oo keliya aad mas'uul ka tahay kontoroolka, hawlgalka, iyo amniga wax kasta oo macaamil ah iyo isgaarsiin lagu sameeyo iyadoo la isticmaalayo ama lagu gelayo API-geenna.
5.2.2. Waxaa jira khataro la xidhiidha isticmaalka nidaam ganacsi oo fulinta heshiiska ku salaysan internetka, oo ay ku jiraan guuldarrada qalabka adag, software-ka, iyo xiriirrada internetka. Ma kontoroolno xoogga calaamadda, helitaankeeda ama jidka ay maraan internetka, habaynta qalabkaaga, ama kalsoonida xiriirkeeda. Ma noqon doono kuwo xil saaran si kasta oo ku saabsan guuldarro isgaarsiin, carqalado, khaladaad, qalloocyo, ama raagid aad la kulmi karto marka aad ku ganacsato internetka iyadoo la isticmaalayo API-geenna.
6. Magdhawga
6.1. Waxyaabaha soo socda waxay noqon doonaan mas'uuliyaddaada keliya, waxaana lagama maarmaan ah inaad naga magdhowtid oo naga ilaalisid wax kasta oo dacwad, dhaawac, ama dacwadaha dhinaca saddexaad ah (oo ay ku jiraan khasaarayaasha natiijada ah, lumista faa'iidada, iyo kharashyada iyo qarashyada sharciga ee macquulka ah haddii ay khusayso) kuwaas oo ka dhasha waxyaabaha soo socda:
6.1.1. Guuldarro kasta oo aad ka geysato xagga ilaalinta amniga qalabka amniga ama hababka la isticmaalo ama la xidhiidha API-geenna;
6.1.2. Isticmaalka, hawlgalka, ama isku-darka API-ga, xogta, qalabka, ama dukumentiyada ee annaga noo baahan oo la isku dartay kuwa aan annaga noo baahnayn kuwaas oo keenta xil; iyo
6.1.3. Dacwado kasta oo dhinaca saddexaad ah oo ka dhasha, ama la xidhiidha, isticmaalkaaga, ama awoodla'aantaada inaad isticmaasho, API-geenna.
7. Amniga
7.1. Haddii aad ogaato cillad kasta oo amniga ku saabsan, ama faragelin lagu geystay, Application-kaaga, waa inaad si degdeg ah noogu soo warrantid annaga iyadoo aad ka furtid thread wada-xaajood ah Vanilla Community, oo qayb ka ah websaydka horumariyeyaasha, ama adigoo email u diraya api-support@deriv.com.
7.2. Waxaad nala shaqeyn doontaa si aad si degdeg ah u saxdo nuqul kasta oo cillad amni ah, waxaadna si degdeg ah ka googo'in doontaa gelitaan sharci-darro ah ama dadka faragelinaya.
7.3. Haddii ay dhacdo cillad amni ah ama gelitaan sharci-darro ah oo khuseeya Application-ka, APIs-ka, ama waxyaabaha ku jira websaydkeenna ama laga heli karo API, ma bixin doontid bayaan dadweyne (oo ay ku jiraan saxaafadda, blog-yada, baraha bulshada, boorarka fariimaha, iwm.) iyadoo aan la helin ogolaanshahayaga qoran oo cad hore markasta.
8. Joojinta
8.1. Wakhti kasta iyo sabab kasta ama sabab la'aan, annaga, iyadoo lagu salaynayo go'aankeenna gaarka ah, waxaannu joojin karnaa isticmaalkaaga API-geenna iyadoo aan ogeysiis la soo dirin.
8.2. Joojin ku meel gaar ah: Marka lagu daro xaqa aan ku leenahay Qodobka 8.1, waxaanu, iyadoo lagu salaynayo go'aan keligeen ah oo aan ogeysiis hore la bixin, si ku meel gaar ah u joojin karnaa gelitaankaaga API-gayaga ama u shid karaynaa Application-kaaga (oo ay ku jiraan App ID kasta oo la xiriira) marka aan si macquul ah u aaminsan nahay in:
8.2.1. Application-kaagu uu wato bug muhiim ah, qalad farsamo, ama meel bananaan oo amni ah, oo ay ku jiraan cillad kasta oo ku saabsan sida uu u maareeyo caddaynta, token-nada, ama warqadaha aqoonsiga;
8.2.2. Waxqabadka ama dhaqanka Application-kaagu uu khatar ku yahay annaga, macaamiisheenna, ama daacadnimada nidaamyadeenna;
8.2.3. Waxaan helnay tiro kordhay oo cabashooyin macaamiil oo la xiriira Application-kaaga; ama
8.2.4. Waxaan baadhayaa jebin lagu tuhmayo Shuruudahan API ama Shuruudaha Guud.
Joojin kasta oo ku salaysan Qodobkan 8.2 waxay sii socon doontaa ilaa dhibaatada hoose la xaliyo ilaa heerka aan ku qanacsan nahay, ama ilaa aan isticmaalno xaqayaga ku saleysan Qodobka 8.1 si aan u joojino. Waxaan isku dayi doonnaa inaan kuu ogeysiino joojinta iyo sababtaas gudaha wakhti macquul ah.
8.3. Haddii aan isticmaalno xaqayaga ku saleysan Qodobka 8.1, dhammaan xuquuqaha iyo liisennada laguu siiyay Shuruudahan API waxay si degdeg ah u joojin doonaan. Waxaad ku raacsan tahay inaad si degdeg ah uga joogsato dhammaan isticmaalka API-gayaga.
