ක්‍රීඩක තහවුරු කිරීමේ එන්ඩ්පොයින්ට්

මුදල් හුවමාරුවක් සිදු වීමට පෙර ක්‍රීඩක තොරතුරු තහවුරු කිරීමෙන් ගේම් ගිණුම හඳුනා ගනී. ලබා දුන් හැඳුනුම අදාළ නිෂ්පාදනය සඳහා පවතින බව තහවුරු කර, ගැනුම්කරුට පරීක්ෂා කිරීමට ගේම් එකේ භාවිත වන නම ලබා දෙයි. ගිණුමේ කලාපයද පෙන්වන නිසා කලාපය නොගැළපෙන ඇණවුමක් ගෙවීමෙන් පසු අසාර්ථක වීමට පෙර මුල් අදියරේදීම ප්‍රතික්ෂේප කළ හැක.

යැවිය යුතු ක්ෂේත්‍ර

ඔබ යවන ඉල්ලීමේ අන්තර්ගතය සකස් වන්නේ සෑම විටම යැවිය යුතු ස්ථාවර ක්ෂේත්‍ර දෙකකින් සහ අදාළ ගේම් එක විසින්ම ඉල්ලා සිටින අමතර ක්ෂේත්‍රවලිනි. ඒ නිසා ඉල්ලීම යැවීමට පෙර, මුලින්ම GET /catalog/category/:categoryId/requirements ඇමතීමෙන් එම ගේම් එකට අවශ්‍ය ක්ෂේත්‍ර මොනවාදැයි බලා ගන්න. ඉන්පසු එහි ලැබෙන සෑම field_name එකකටම නිවැරදි අගයක් ලබාදී, ස්ථාවර ක්ෂේත්‍ර දෙක වන sub_category_id සහ player_id සමඟ එකම ඉල්ලීමකින් යවන්න. single_select හෝ multi_select වර්ගයේ ක්ෂේත්‍රයක් පිළිගන්නේ එම ක්ෂේත්‍රයටම අයත් select_options ලැයිස්තුවේ ඇති අගයක් පමණි. වෙනත් ඕනෑම අගයක් පිළිගනු නොලැබේ. අවශ්‍ය ක්ෂේත්‍රයක් ඉල්ලීමෙන් අඩු වී ඇත්නම්, එවැනි ඉල්ලීමක් MISSING_REQUIRED_FIELD දෝෂය සමඟ ප්‍රතික්ෂේප වේ. යවන අගය එම ක්ෂේත්‍රයට නියම කර ඇති නීති කඩ කරන්නේ නම්, කඩ වූ නීතිය අනුව ලැබෙන දෝෂය INVALID_PARAMETER_FORMAT, INVALID_PARAMETER_VALUE හෝ INVALID_PARAMETER_LENGTH වේ. මේ අවස්ථා දෙකේදීම, දෝෂය ඇති වූයේ කුමන ක්ෂේත්‍රය නිසාදැයි details.field මගින් දැනගත හැක.

සාර්ථක response එකකින් in-game නම සහ identifier එකට අදාළ කලාපය ලැබේ. ඔබ විකිණීමට යන product එක සමඟ එම කලාපය සසඳන්න. නොගැළපීමක් REGION_MISMATCH සමඟ ප්‍රතික්ෂේප වේ. Validation අවස්ථාවේදීම එය හඳුනා ගැනීමට වැය වන්නේ එක් request එකක් පමණි. ඇණවුම් අවස්ථාවේදී හඳුනා ගතහොත් සම්පූර්ණ මුදල් ආපසු ගෙවීමේ ක්‍රියාවලියක් අවශ්‍ය වේ.

POST

/player/validate

ක්‍රීඩකයා තහවුරු කරන්න

යම් ගේම් එකක් සඳහා Player ID එකක් තහවුරු කරන්න. “කාණ්ඩයේ අවශ්‍යතා ලබා ගන්න” endpoint එකෙන් ලැබෙන ගතික අවශ්‍යතා ක්ෂේත්‍රද ඇතුළත් කරන්න.

ඉල්ලීම් සීමාවඔබේ ගිණුමට දිනකට හිමි ප්ලේයර් පරීක්ෂා කිරීම් සීමාව. X-RateLimit හෙඩර් එවන්නේ නැත.

සටහන: එක් එක් ගේම් එකට අවශ්‍ය ක්ෂේත්‍ර මොනවාදැයි දැන ගැනීමට “කාණ්ඩයේ අවශ්‍යතා ලබා ගන්න” endpoint එක භාවිත කරන්න. අවශ්‍ය සියලු ක්ෂේත්‍ර request body එකට ඇතුළත් කරන්න. PLAYER_NOT_FOUND යනු එම ID එක නොපවතින බව ගේම් එක තහවුරු කළ බවයි; PLAYER_CHECK_UNAVAILABLE (HTTP 503, නැවත උත්සාහ කළ හැක) යනු ID එක මේ මොහොතේ පරීක්ෂා කළ නොහැකි වූ බවත්, එය ප්‍රතික්ෂේප නොකළ බවත්ය.

ඉල්ලීමේ body එක

නමවර්ගයඅනිවාර්යදවිස්තරයඋදාහරණය
sub_category_idnumberඔව්නිෂ්පාදනයේ උප කාණ්ඩ ID එක. එය සොයා ගැනීමට Catalog Explorer භාවිත කරන්න.999
player_idstringඔව්ගේම් එක තුළ ඇති Player ID එක.123456789
...requirementsvariesනැත“කාණ්ඩයේ අවශ්‍යතා ලබා ගන්න” endpoint එකෙන් ලැබෙන අමතර ක්ෂේත්‍ර. සෑම field_name එකක්ම key එකක් ලෙස, පරිශීලකයා ලබා දුන් අගය සමඟ ඇතුළත් කරන්න."server": "Asia"
ඉල්ලීම
curl -s -X POST "https://shop2topup.com/api/endpoints/v1/player/validate" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
  "sub_category_id": 999,
  "player_id": 123456789
}'
උදාහරණ ප්‍රතිචාරය
{
  "success": true,
  "player": {
    "player_id": "123456789",
    "player_name": "ProGamer99",
    "region": "Asia"
  }
}

මෙම පිටුවෙන්ම සැබෑ request එකක් යවන්න

මෙම එන්ඩ්පොයින්ට් සජීවීව ඇමතීමට ඔබේ API key එක මෙහි පේස්ට් කරන්න. යතුර මෙම බ්‍රවුසර් ටැබය තුළ පමණක් රැඳෙන අතර, එය යැවෙන්නේ API එක වෙත පමණි.

Enter your API key to use the interactive playground. Get your API key

එන්ඩ්පොයින්ට් එකක් තෝරන්න

Use Catalog Explorer to find this

No requirements for this category.

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

Platform එකට අලුත් නම් මුලින්ම රීසෙලර්ලා සඳහා ගේම් ටොප් අප් API හැඳින්වීම, නැතහොත් SHOP2TOPUP රීසෙලර් වැඩසටහනේ හැඳින්වීම කියවා පාර්ට්නර් ගිණුම ක්‍රියා කරන ආකාරය දැනගන්න.

ක්‍රීඩක තහවුරු කිරීමේ එන්ඩ්පොයින්ට් එක සඳහා වන යොමු ලේඛනය: POST /player/validate