حساب کاربری
اطلاعات حساب
اعتبار باقیمانده و تاریخ انقضای حساب را برمیگرداند؛ برای هشدار کم شدن اعتبار در سیستم خودتان.
GET
POST
https://api.payamras.ir/v1/YOUR_API_KEY/account/info.json
پارامترها
این متد پارامتری ندارد؛ فقط کلید API در آدرس کافی است.
نمونه درخواست
curl -G "https://api.payamras.ir/v1/YOUR_API_KEY/account/info.json"
<?php
$apiKey = 'YOUR_API_KEY';
$ch = curl_init("https://api.payamras.ir/v1/{$apiKey}/account/info.json");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$result = json_decode(curl_exec($ch), true);
if ($result['return']['status'] !== 200) {
throw new RuntimeException($result['return']['message']);
}
const apiKey = "YOUR_API_KEY";
const response = await fetch(`https://api.payamras.ir/v1/${apiKey}/account/info.json`);
const result = await response.json();
if (result.return.status !== 200) {
throw new Error(result.return.message);
}
import requests
api_key = "YOUR_API_KEY"
response = requests.get(f"https://api.payamras.ir/v1/{api_key}/account/info.json")
result = response.json()
if result["return"]["status"] != 200:
raise RuntimeError(result["return"]["message"])
پاسخ
فیلدهای هر ردیف entries:
| فیلد | نوع | توضیح |
|---|---|---|
remaincredit |
Long | اعتبار باقیمانده به ریال. |
expiredate |
UnixTime | تاریخ انقضای حساب. |
type |
String | نوع حساب؛ برای حسابهای پیامرس child. |
{
"return": {
"status": 200,
"message": "تایید شد"
},
"entries": {
"remaincredit": 4855200,
"expiredate": 1792000000,
"type": "child"
}
}
خطاهای رایج
علاوه بر خطاهای عمومی مثل 403 و
418، این متد ممکن است این کدها را در
return.status برگرداند: