Panimula

Ang layunin ng dokumentong ito ay magbigay ng isang komprehensibong gabay upang mag-alok ng mga detalyadong insight sa aming mga API environment, at mga pamamaraan ng Pagpapatunay na gagamitin sa oras ng pagsasama.

TANDAAN: pina-phase out namin ang luma dokumentasyon

1. Kapaligiranang

1.1. Pagsubok (Sandbox)ang

Bago isama sa live na sistema ng produksyon, mayroon kang opsyon na subukan ang mga feature sa aming nakalaang test server. I-access ang sample na data at simulate na mga transaksyon para matiyak ang maayos at walang error na proseso ng pagsasama. Mag-eksperimento sa mga functionality sa isang kinokontrol na kapaligiran bago i-deploy sa production system para sa isang tuluy-tuloy na karanasan.

Base URL para sa Sandbox https://test.xprizo.com/api

1.2 Produksyon (Live)ang

Kapag nakumpleto mo na ang iyong yugto ng pagsubok, maaari kang lumipat sa live na kapaligiran sa pamamagitan ng pagdidirekta sa iyong system sa server ng produksyon.

Base URL para sa Live https://wallet.xprizo.com/api

2. Pagpapatunay

Gumagamit ang Xprizo ng mga JWT token at API key bilang mga paraan ng pagpapatunay para sa pag-access sa mga function ng API. Mayroon kang kakayahang umangkop na pumili ng alinman sa paraan ng pagpapatunay kapag nakikipag-ugnayan sa mga endpoint. Kailangan mong magpasa ng JWT token o API key sa header ng bawat kahilingan.

**Tandaan: Kailangan mong gumamit ng profile sa pagpoproseso upang lumikha ng token o key upang magamit ang mga endpoint ng API.

2.1. JSON Web Token (JWT)ang

2.1.1. Paglikha ng Tokenang

Ang paggawa ng token ay ginagawa sa pamamagitan ng pagtawag sa GetToken endpoint gamit ang iyong username at password. Kung hindi ka rehistradong user maaari kang magparehistro sa pamamagitan ng pagpunta sa Sandbox o Mabuhay server.ang

Mag-log in sa system gamit ang isang username at password. Makakatanggap ka ng isang token ng JWT Bearer na kakailanganin mong gumawa ng mga secure na kahilingan sa API.

kulot --lokasyon '{baseurl}/Security/GetToken' \
--header 'tanggapin: text/plain; x-api-version=1.0' \
--header 'x-api-bersyon: 1.0' \
--header 'Uri ng Nilalaman: application/json; x-api-version=1.0' \
--datos-hilaw '{
  "UserName": "gumamit ng username, mobile number sa email",
  "password": "ang iyong password"
}'

{
  "id": <a kakaiba Id>,
  "token": <use ito token para sa furture mga tawag>,
  "mag-e-expire": <the oras ang token mag-e-expire>
}

2.1.2. Mga Paggamit ng Token

Gamitin ang token na ito sa header ng lahat ng secure

mga kahilingan sa ibang endpoint

kulot -X 'GET' \
  '{baseurl}/Wallet/Info?contact=1' \
  -H 'tanggapin: text/plain' \
  -H 'Awtorisasyon: tagadala>

2.2. Mga API Keyang

2.2.1. Paggawa ng API Key

Upang i-configure ang iyong API key, i-access ang iyong User Account, mag-navigate sa 'mga setting' sa pamamagitan ng pag-click sa icon ng profile, at hanapin ang 'seguridad' sa listahan. Sa loob ng mga setting ng seguridad, makakahanap ka ng opsyon para itakda ang API key. Mahalagang tandaan na kung aalisin ang API key, dapat magbigay ng bagong key at gamitin para sa mga transaksyon.

2.2.2. Mga paggamit ng API Key

Gamitin ang API key sa header sa sumusunod na paraan.

kulot -X 'GET' \
  '{baseurl}/Profile' \
  -H 'tanggapin: text/plain' \
  -H 'x-api-key:>

2.3. Alamin ang iyong account ID

Upang magsumite ng mga deposito para sa pagproseso, kakailanganin mo ang iyong accountId (wallet ID) mula sa iyong account. Mahahanap mo ito sa pamamagitan ng sumusunod na proseso, mag-log in sa iyong account at magbukas ng mga setting, hanapin ang 'wallet' sa listahan at makakahanap ka ng ID na nauugnay sa wallet. Kung walang wallet, kakailanganin mong gumawa nito sa pamamagitan ng pag-click sa  pindutan.