Fa, lo tla fitlhela dipeelano le maemo tse di amanang ka kotlolo le Badirisi ba rona ba API (“Melawana ya API”). Melawana e ya API e tshwanetse go balwa mmogo le Melawana e e Akaretsang ya Balekane ba Kgwebo (“Melawana e e Akaretsang”). Mareo ape a a tlhalositsweng a a dirisitsweng mo Melawaneng e ya API a tla nna le bokao jo bo neetsweng mo Melawaneng e e Akaretsang.
1. Maikarabelo a Badirisi ba API
1.1. Go ya ka go ikobela ga lona ka botlalo le ka metlha Melawana e ya API, re lo naya laesense e e beilweng melelwane, e e seng ya bosolesole, e e sa fetiseletsegeng, e e sa fetisediweng ba bangwe, e e ka gogwang morago, ya go dirisa API ya rona go tlhama, go leka, le go tshegetsa software application, webosaete, kgotsa sedirisiwa se lo se dirang kgotsa tirelo e lo e neelang (“Application”) le go letla bareki ba lona go dirisa tlhomagano ya lona ya API ya rona mo teng ga Application ya lona.
1.2. Lo dumalana gore ga lo na go dira dilo tse di latelang:
1.2.1. Go naya ope ba bangwe laesense ya ditshwanelo dipe tse di neetsweng mo Melawaneng e ya API;
1.2.2. Go dirisa kgotsa go gatisa API ya rona ka ntle ga mabaka a a tlhomamisitsweng ke Melawana e ya API;
1.2.3. Go dirisa API ya rona ka maikaelelo ape a a tlolang molao ope kgotsa melawana ope kgotsa tshwanelo ya motho ope, go akaretsa ditshwanelo tsa dikgopolo, ditshwanelo tsa boiphitlho, kgotsa ditshwanelo tsa botho; kgotsa
1.2.4. Go dirisa API ya rona ka tsela epe e e sa dumalaneng le Melawana e ya API.
1.3. API ya rona e na le melelwane ya tiriso go thibela tiriso e e sa siamang le/kgotsa go dirisediwa mabaka a mangwe. Melelwane e ya tiriso e ka fetolwa kwa ntle ga kitsiso. Fa lo tlwaetse go feta melelwane ya tiriso kgotsa lo dirisa tirelo ka tsela e e sa siamang, re ka thibela phitlhelelo ya lona mo API ya rona.
2. Polokelo ya diteng
2.1. Ga lo letlelelwe go boloka diteng dipe (jaaka data ya feed) tse di tswang kgotsa di simologa mo webosaeteng ya rona kgotsa tse di fitlhelelwang ka API ya rona.
2.2. Lo ka boloka dinomoro tsa tshupiso ya moreki tse di tlhomameditsweng Application (dikhaonto tsa API) kgotsa dikhaonto tsa netefatso tse di neelwang ka Open Authorisation Standard (dikhaonto tsa OAuth).
2.3. Lo ka boloka ka nakwana diteng dipe tse di tswang mo webosaeteng ya rona kgotsa tse di fitlhelelwang ka API ya rona ka nako e e ka nnang diura tse di masome mabedi le bone (24) go tswa fa kopo ya diteng tseo e dirilweng ka API ya rona.
2.4. Fa kamano ya rona e khutla ka lebaka lepe, lo tshwanetse go phimola ka botlalo diteng tsotlhe tse di tswang kgotsa di simologa mo webosaeteng ya rona kgotsa tse di fitlhelelwang ka API ya rona, ntle le fa go dira jalo go tla dira gore lo tlole molao ope o o dirang kgotsa maikarabelo ape a a beilweng ke bolaodi jwa mmuso.
3. Beng
3.1. Thoto ya rona
3.1.1. Re na le ditshwanelo tsotlhe, thaetlele, le kgatlhego, go akaretsa ditshwanelo tsotlhe tsa dikgopolo, mo API ya rona le mo dikarolwaneng tsotlhe, dielemente, le mananeo a a diragatsegang a API ya rona, mme ga re go neye tshwanelo, thaetlele, kgotsa kgatlhego epe mo API ya rona ntle le laesense e e neetsweng mo Melawaneng e ya API.
3.1.2. Tiriso ya lona ya API ya rona ga e na go lo naya ditshwanelo dipe tsa dikgopolo tse e leng tsa rona kgotsa thaetlele epe kgotsa kgatlhego ya bong mo ditshwanelong tseo, go akaretsa ditshwanelo tse di amanang le dipolatefomo tsa rona tsa kgwebisano le webosaete.
3.1.3. Ga lo na go, ka nako epe, ganetsa kgotsa thusa mothoope wa boraro go ganetsa ditshwanelo tsa rona mo API ya rona kgotsa dikgopolo dipe tse dingwe tse re nang natso kgotsa tse di neetsweng laesense ke rona kgotsa balekane ba rona.
3.1.4. Lo dumalana go tsaya dikgato tse re ka di kopang ka tekatekano go sireletsa ditshwanelo tsa rona mo API ya rona.
3.1.5. Lo a itse gore re ka tswelela go dira diphetogo le go tokafatsa API ya rona mme re tla nna le diphetogo le ditokafatso tseo.
3.1.6. Ka fa tlase fa, lo fetisetsa mo go rona ditshwanelo tsotlhe, thaetlele, le kgatlhego ya lona mo diphetogong dipe kgotsa mesebetsi e e tswang mo API ya rona e e dirilweng ke lona kgotsa go lona, go sa kgathalesege gore a e dirilwe go ya ka Melawana e ya API. Phetisetso e e ntseng jalo e a dira fa go simolwa go dirwa diphetogo tseo kgotsa mesebetsi eo mme e tla akaretsa ditshwanelo tsotlhe fa tlase ga melao yotlhe ya dikgopolo, go akaretsa ditshwanelo tsa mongwadi.
3.1.7. Ga lo na go tsaya kgato epe go baya mo kotsing, go beela melelwane, kgotsa go abelana ka tsela epe le motho ope wa boraro bonei jwa rona jwa API ya rona le ditshwanelo tsa rona mo go yona kgotsa mesebetsi epe e e tswang mo go yona kgotsa dintlafatso.
3.1.8. Dikarolo dipe kgotsa mekgwa ya tsamaiso ya sistimo epe kgotsa lenaneo la API le le tswang mo API ya rona kgotsa mekgwa ya rona ya kgwebo, le ditshwanelo dipe tse di amanang natso, thaetlele, kgotsa kgatlhego mo go tsone, go akaretsa ditshwanelo tsotlhe tsa dikgopolo, e tla nna tsa rona fela.
3.2. Thoto ya lona
3.2.1. Ga re re re na le Application ya lona ntle le fa e le gore Application ya lona e dirisa API ya rona.
3.2.2. Lo re naya tshwanelo e e se nang tuelo, e e seng ya bosolesole, e e akaretsang lefatshe lotlhe, le e e sa ka keng ya gogwa morago, ka fa tlase ga ditshwanelo tsotlhe tsa lona tsa dikgopolo, go dira dilo tse di latelang:
3.2.2.1. Go phasalatsa leina la lona le logo (ka kgokagano kgotsa ntle ga kgokagano go ya kwa Application ya lona) mo webosaeteng ya rona, mo dipegelong tsa dikuranta, le mo dithuson tsa papatso kwa ntle ga tetlelelo e nngwe ya lona;
3.2.2.2. Go dirisa, go diragatsa, le go bontsha Application ya lona le diteng tsa yona mo maikaelelong ape a papatso kgotsa a go bontsha;
3.2.2.3. Go dira gore Application ya lona e fitlheletswe ke bareki ba rona; le
3.2.2.4. Go kaela bareki ba rona kwa Application ya lona ka kgokagano.
3.3. Dintshetso tsa lona mo API ya rona
3.3.1. Ka go romela dikakantsho kgotsa maikutlo a mangwe kaga API ya rona go rona (“Dintshetso”), lo dumalana ka tse di latelang:
3.3.1.1. Ga re na maikarabelo ape a boiphitlho mabapi le Dintshetso tsa lona;
3.3.1.2. Re ka dirisa kgotsa go senolela (kgotsa go itlhopholela go sa dirise kgotsa go sa senolele) Dintshetso tseo mo maikaelelong ape, ka tsela epe, le mo dimetsheng dipe tsa lefatshe lotlhe;
3.3.1.3. Lo re naya, ka tsela e e sa gogweng morago le ka botlalo, ditshwanelo tsa go dirisa Dintshetso tsa lona ka tsela epe e re ka e batlang; le
3.3.1.4. Ga lo na tshwanelo ya tuelo epe kgotsa tefeletso ya mofuta ope go tswa mo go rona mo maemong ape.
3.4. Ditokafatso mo API ya rona
3.4.1. Re ka phasalatsa dikarolo tse di latelang tsa API ya rona mme ra batla gore lo dirise dikarolo tseo tse di latelang. Go tswelela ga lona go dirisa di-API morago ga phasaladi e nngwe ya sengwe se se tlang morago, go tla tsewa jaaka go dumela ga lona diphetogo.
3.4.2. Lo tshwanetse go emisa go dirisa dikarolo tsotlhe tse di fetileng tsa API ya rona mo boemong jwa API ya rona e e tokafaditsweng.
3.4.3. Re ka fetola, re emisa, re khaola, kgotsa re tlogela karolo epe ya API ya rona, go akaretsa go nna teng ga ditirelo, tshedimosetso, dilo tse di kgethegileng, kgotsa mesola epe e e fitlhelelwang ka API ya rona. Re tla leka go lo itsise ka diphetogo tse, go emisiwa, go khaolwa, kgotsa go tlogelwa jalo ka kitsiso ya bogare jwa malatsi a a se kafa tlase ga a supa (7) mo dikanaleng tsa rona tsa Telegram le mo forong ya Vanilla.
3.4.4. Le fa e le maikaelelo a rona gore API ya rona e e fetotsweng e tshwanetse go dumalana le tokololo e e neng e le teng pele ga yona, ga re netefatse seno mme ga re na maikarabelo epe mo go lona ka ntlha ya go palelwa ga API ya rona e e fetotsweng go dumalana le tokololo epe e e neng e le teng pele ga yona.
4. Diteseletso le melelwane ya maikarabelo
4.1. Lo netefatsa gore lo na le tshwanelo ya go dirisa, go tlhagisa gape, go romela, go kopa, go bontsha phatlalatsa, go dira phatlalatsa, le go abela Application ya lona, ntle le diteng tse di tswang kgotsa tse di simologang mo webosaeteng ya rona kgotsa tse di fitlhelelwang ka API ya rona.
4.2. Lo dirisa API ya rona ka kotsi ya lona ka bo lona. Lo ikarabela ka botlalo mo kotsing epe ya go latlhegelwa e lo ka e bonang ka ntlha ya go dirisa kgotsa go fitlhelela API ya rona.
4.3. Mo godimo ga melelwane ya maikarabelo e e beilweng mo Melawaneng e e Akaretsang, tsweetswee lemogang tse di latelang:
4.3.1. Ga re na maikarabelo epe a go latlhegelwa kgotsa go senyega go go bakwang ke tshedimosetso kgotsa ditheko tse di phatlaladitsweng kgotsa tse di neelwang ka API ya rona kgotsa diphoso epe kgotsa go tlogelwa ga sengwe mo, kgotsa ka, API ya rona.
4.3.2. Ga re na maikarabelo epe a a tswang mo diodareng, ditshwetso tsa matsete, kgotsa go rekiwa ga dithoto kgotsa ditirelo tsa mongwe yo o seng rona (go akaretsa didirisiwa tsa madi le madi a a farologanyeng) go ya ka tshedimosetso e e phatlaladitsweng kgotsa e e neelweng ka API ya rona.
4.3.3. Markup ya Application e balwa go ya ka kgwebisano nngwe le nngwe, go ya ka theko ya go reka ya kgwebisano eo le peresente ya markup e e beetsweng Application ya lona, mme e duelwa ka madi a akhaonto ya lona. Fa palo ya markup e e badilweng ya kgwebisano e le e nnye go feta yuniti e nnye ya madi a akhaonto ya lona (jaaka sekao, 0.01 USD/EUR), palo eo e fetolwa go nna lefela. Ga re na maikarabelo a go kgobokanya, go tsamaisa go ya pele, kgotsa go duela dipalo tsa markup tse di kwa tlase ga selekanyo se.
5. Ditemoso
5.1. Temoso ya teseletso
5.1.1. Re neela API ya rona ka mokgwa wa ‘jaaka e le teng’ le ‘jaaka e le teng gore e dirisiwe’ kwa ntle ga diteseletso, e ka tswa di boletswe kgotsa di akaretswa, tsa mofuta ope. Go ya kwa boleng jo bo letleletsweng ke molao o o dirang, re gana diteseletso le ditemoso tsotlhe, go akaretsa, kwa ntle ga selekanyo, teseletso epe e e akaretswang ya go rekisega, go tshwanela ga maikaelelo a a rileng, tshwanelo ya bonngwe, tshekatsheko ya data, le go sa tlolweng ga tshwanelo epe.
5.1.2. Ga re netefatse gore API ya rona e tla dira kwa ntle ga go kgaogana kgotsa diphoso. Segolo bogolo, tiro ya API ya rona e ka kgaoganngwa ka mabaka a a akaretsang tokafatso, dikatiso, kgotsa go palelwa ga sistimi kgotsa neteweke. Re gana maikarabelo otlhe a go senyega gongwe le gongwe go go bakwang ke go kgaogana kgotsa diphoso mo tirong.
5.1.3. Re gana maikarabelo otlhe a go se dire sentle, go sa kgonagaleng go fitlhelela, kgotsa maemo a a sa siamang a tiriso ya API ya rona ka ntlha ya didirisiwa tse di sa siamang, matshwenyego a a amanang le batlamedi ba ditirelo tsa internet, go tlala ga neteweke ya internet, kgotsa lebaka lepe fela le lengwe.
5.2. Temoso ya tshireletso
5.2.1. Lo dumalana gore ke lona fela ba lo ikarabelang ka taolo, tiro, le tshireletso ya dithekiso tsotlhe le dikgokagano tse di dirilweng ka go fitlhelela kgotsa go dirisa API ya rona.
5.2.2. Go na le dikotsi tse di amanang le go dirisa sistimi ya kgwebisano e e diragatsang dikuno ka internet, tse di akaretsang go palelwa ga hardware, software, le dikgokagano tsa internet. Ga re laole thata ya matshwao, go amogelwa ga one kgotsa go tsamaisiwa ga one ka internet, thulaganyo ya didirisiwa tsa lona, kgotsa go ikanyega ga kgokagano ya lona. Ga re na maikarabelo epe a go palelwa ga kgokagano, dikgaoganyo, diphoso, go sokamisiwa, kgotsa go diega mo lo ka go bonang fa lo dira kgwebisano ka internet lo dirisa API ya rona.
6. Tefo ya Tshenyego
6.1. Tse di latelang e tla nna maikarabelo a lona a le nosi, mme lo tshwanetse go re duelela le go re sireletsa mo dikopong, tshenyego, kgotsa dikatlholo dingwe le dingwe tsa mongwe yo o seng rona (go akaretsa go latlhegelwa gongwe le gongwe go go tlang morago, go latlhegelwa ga poelo, le ditshenyegelo tsa rona tsa semolao tse di lekaneng fa go tshwanetse) tse di tswang mo go tse di latelang:
6.1.1. Go palelwa gape ke lona go tshegetsa tshireletso ya didirisiwa dipe tsa tshireletso kgotsa dithulaganyo tse di dirisiwang mo go, kgotsa mo kopanong le, API ya rona;
6.1.2. Tiriso, tiro, kgotsa kopanyo ya API, data, didirisiwa, kgotsa dikwalo tse e leng tsa rona le tse e seng tsa rona, e e felelang mo maikarabelong; le
6.1.3. Dikopo dipe tsa mongwe yo o seng rona tse di tswang mo, kgotsa tse di amanang le, tiriso ya lona ya, kgotsa go palelwa ga lona go dirisa, API ya rona.
7. Tshireletso
7.1. Fa lo fitlhela bokoa gongwe jwa tshireletso mo, kgotsa go tsenwa mo, Application ya lona, lo tshwanetse go re begela ka bonako ka go simolola motlhale wa puisano mo Vanilla Community, e leng karolo ya webosaete ya rona ya batlhami, kgotsa ka go romela imeile go api-support@ deriv.com.
7.2. Lo tla dira le rona go baakanya ka bonako bokoa bongwe jwa tshireletso mme lo tla kgaola ka bonako go tsenwa gongwe kgotsa batseneledi bape.
7.3. Fa go diragala bokoa bongwe jwa tshireletso kgotsa go tsenwa mo go amanang le Application, di-API, kgotsa diteng tse di leng mo webosaeteng ya rona kgotsa tse di fitlhelelwang ka API, ga lo a tshwanela go dira dipolelo dipe phatlalatsa (go akaretsa ka mafapha a dikgang, diblog, mafelo a tsa loago, dibolane, jalojalo) kwa ntle ga tumelelo ya rona e e kwadilweng le e e supang pele, mo tiragalong nngwe le nngwe.
8. Go Khaolwa
8.1. Ka nako epe le ka lebaka lepe kgotsa go se nne le lebaka, rona, ka boitshwaro jwa rona bo le bosi, re ka khaola tiriso ya lona ya API ya rona kwa ntle ga kitsiso.
8.2. Fa re dirisa tshwanelo ya rona ka fa tlase ga Karolo 8.1, ditshwanelo tsotlhe le dilaesense tse di neetsweng lona mo Melawaneng eno ya API di tla khaolwa ka bonako. Lo dumalana go emisa ka bonako tiriso yotlhe ya API ya rona.
