Utangulizi

Madhumuni ya hati hii ni kutoa mwongozo wa kina ili kutoa maarifa ya kina katika mazingira yetu ya API, na mbinu za Uthibitishaji zitakazotumika wakati wa kujumuisha.

KUMBUKA: tunakomesha mzee nyaraka

1. Mazingira.

1.1. Kujaribu (Sanduku la mchanga).

Kabla ya kuunganishwa na mfumo wa uzalishaji wa moja kwa moja, una chaguo la kujaribu vipengele kwenye seva yetu ya majaribio iliyojitolea. Fikia data ya sampuli na miamala iliyoigizwa ili kuhakikisha mchakato laini na usio na hitilafu wa ujumuishaji. Jaribio na utendakazi katika mazingira yaliyodhibitiwa kabla ya kupeleka kwenye mfumo wa uzalishaji ili upate hali ya utumiaji iliyofumwa.

URL ya msingi ya Sandbox https://test.xprizo.com/api

1.2 Uzalishaji (Moja kwa moja).

Mara tu unapokamilisha awamu yako ya majaribio, unaweza kuhamia mazingira ya moja kwa moja kwa kuelekeza mfumo wako kwa seva ya uzalishaji.

URL ya Msingi ya Moja kwa Moja https://wallet.xprizo.com/api

2. Uthibitishaji

Xprizo hutumia tokeni za JWT na vitufe vya API kama mbinu za uthibitishaji za kufikia vitendaji vya API. Una uwezo wa kuchagua njia mojawapo ya uthibitishaji unapoingiliana na sehemu za mwisho. Unahitaji kupitisha tokeni ya JWT au kitufe cha API kwenye kichwa cha kila ombi.

**Kumbuka: Unahitaji kutumia wasifu wa kuchakata ili kuunda tokeni au ufunguo ili kutumia ncha za API.

2.1. Tokeni za Wavuti za JSON (JWT).

2.1.1. Kuunda Ishara.

Kuunda ishara hufanywa kwa kupiga simu ya mwisho ya GetToken na jina lako la mtumiaji na nywila. Ikiwa wewe si mtumiaji aliyesajiliwa unaweza kujiandikisha kwa kwenda kwa Sanduku la mchanga au Ishi seva..

Ingia kwenye mfumo kwa kutumia jina la mtumiaji na nenosiri. Utapokea tena tokeni ya JWT Bearer ambayo utahitaji kufanya maombi salama ya API.

curl --eneo '{baseurl}/Security/GetToken' \
--kichwa 'kukubali: maandishi / wazi; toleo la x-api=1.0' \
--kichwa 'toleo la x-api: 1.0' \
--kichwa 'Aina ya Yaliyomo: application/json; toleo la x-api=1.0' \
--data-mbichi '{
  "jina la mtumiaji": "tumia jina la mtumiaji, nambari ya simu kutuma barua pepe",
  "nenosiri": "nenosiri lako"
}'

{
  "kitambulisho": <a kipekee Kitambulisho>,
  "ishara": <use hii ishara kwa baadaye simu>,
  "inaisha muda": <the wakati ya ishara inaisha muda wake>
}

2.1.2. Matumizi ya Ishara

Tumia ishara hii kwenye kichwa cha salama zote

maombi kwa ncha nyingine

curl -X 'PATA' \
  '{baseurl}/Wallet/Info?contact=1' \
  -H 'kukubali: maandishi / wazi' \
  -H 'Uidhinishaji: mtoaji>

2.2. Vifunguo vya API.

2.2.1. Kuunda Ufunguo wa API

Ili kusanidi ufunguo wako wa API, fikia Akaunti yako ya Mtumiaji, nenda kwenye 'mipangilio' kwa kubofya aikoni ya wasifu, na utafute 'usalama' kwenye orodha. Ndani ya mipangilio ya usalama, utapata chaguo la kuweka ufunguo wa API. Ni muhimu kutambua kwamba ikiwa ufunguo wa API utaondolewa, ufunguo mpya lazima utolewe na utumike kwa shughuli za malipo.

2.2.2. Matumizi ya Ufunguo wa API

Tumia kitufe cha API kwenye kichwa kwa njia ifuatayo.

curl -X 'PATA' \
  '{baseurl}/Wasifu' \
  -H 'kukubali: maandishi / wazi' \
  -H 'ufunguo wa x-api:>

2.3. Jua kitambulisho cha akaunti yako

Ili kuwasilisha amana kwa ajili ya kuchakatwa, utahitaji kitambulisho cha akaunti yako (kitambulisho cha pochi) kutoka kwa akaunti yako. Unaweza kupata hii kwa mchakato ufuatao, ingia kwenye akaunti yako na ufungue mipangilio, pata 'mkoba' kwenye orodha na utapata kitambulisho kinachohusishwa na mkoba. Ikiwa pochi haipo, utahitajika kuunda moja kwa kubofya  kitufe.