සත්‍යාපනය සහ ගිණුම් endpoint එක

සෑම request එකක් සමඟම යවන්නේ එක header එකක් පමණි. API key එක ක්‍රියා කරන බව තහවුරු කරගැනීමට, ඇණවුම් සඳහා මුදල් අඩු වන වොලට් ශේෂය බැලීමට සහ batch එකක් ආරම්භ කිරීමට පෙර ගිණුම සක්‍රිය දැයි පරීක්ෂා කිරීමට GET /account භාවිත කරන්න.

Request එකක් සත්‍යාපනය වන හැටි

Authorization හෙඩරයේ Bearer අක්තපත්‍රයක් යැවේ. එය සෑදී ඇත්තේ යතුරු ID එක සහ රහස් යතුර තිතකින් එකට එකතු කිරීමෙනි. යතුරු ID එකෙන් ගිණුම තෝරාගන්නා අතර, රහස් යතුර HMAC සංසන්දනයකින් පරීක්ෂා කෙරේ. මෙම පරීක්ෂාව අසාර්ථකයි නම්, ඉල්ලූ එන්ඩ්පොයින්ට් එක ක්‍රියාත්මක වීමටත් පෙර MISSING_API_KEY හෝ INVALID_API_KEY සමඟ 401 ප්‍රතිචාරය ලැබේ. කුකී, CSRF ටෝකනය හෝ Origin හෙඩරය වැනි වෙනත් කිසිවක් පරීක්ෂා නොකෙරේ.

IP අවසර ලැයිස්තුව

Key එකක් නිශ්චිත source ලිපින කිහිපයකට සීමා කළ හැක. එම ලැයිස්තුව හිස් නැති තාක්, වෙනත් ලිපිනයකින් එන request එකක් IP_NOT_ALLOWED සහ HTTP 403 සමඟ ප්‍රතික්ෂේප වේ. මෙය rate limit පරීක්ෂාවටත් වොලට් සෙවීමටත් පෙර සිදු වන නිසා, සොරකම් කළ credential එකක් ඔබේම infrastructure එකෙන් පිටත භාවිත කළ නොහැක. ලැයිස්තුව හිස් නම් key එක ඕනෑම තැනක සිට ක්‍රියා කරයි.

ගිණුමේ තත්ත්වය

ගිණුම් මට්ටමේ එක් තත්ත්වයක් සෑම endpoint එකක්ම වහාම නවත්වනවා: අත්හිටුවා ඇති ගිණුමකට HTTP 403 සමඟ ACCOUNT_FROZEN පිළිතුර ලැබෙනවා. එය ඉබේ ඉවත් වන්නේ නැහැ. ඒ නිසා loop එකක නැවත නැවත උත්සාහ කරනවා වෙනුවට අපේ කණ්ඩායමේ කෙනෙකුට දන්වන්න.

Key මාරු කිරීම

Keys සෑදීම සහ මකා දැමීම රීසෙලර් පැනලයේ API Access පිටුවෙන් කෙරේ. Secret එක පෙන්වන්නේ සෑදූ මොහොතේ එක් වරක් පමණි. ඒ නිසා rotation යනු පවතින key එක සංස්කරණය කිරීම නොව, අලුත් එකක් සාදා deploy කර පැරණි එක මකා දැමීමයි. Credentials ඉබේ කල් ඉකුත් නොවන බැවින් rotation කාලසටහන තීරණය කළ යුත්තේ ඔබයි.

GET

/account

ගිණුම් තොරතුරු ලබා ගන්න

වොලට් ශේෂය, ගිණුමේ තත්ත්වය සහ ගිණුම සෑදූ දිනය ඇතුළු සවිස්තර ගිණුම් තොරතුරු ලබා ගන්න.

ඉල්ලීම් සීමාවඑක් ගිණුමකට තත්පර 60කට ඉල්ලීම් 60

ඉල්ලීම

curl -s "https://shop2topup.com/api/endpoints/v1/account" \
  -H "Authorization: Bearer YOUR_KEY_ID.YOUR_KEY_SECRET"

උදාහරණ ප්‍රතිචාරය

{
  "success": true,
  "account": {
    "id": 42,
    "email": "[email protected]",
    "username": "partner_store",
    "client_type": "reseller",
    "wallet": "1250.500000",
    "enabled": true,
    "verified": true,
    "created_at": "2024-01-15T10:30:00Z"
  }
}

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

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

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

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

Enter your API key above to try this endpoint.

Response will appear here after sending a request.

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