اطلاعات پایه
GET
/auth/status
- نام API: وضعیت حساب
- آدرس:
/auth/status - متد: GET
پارامترهای درخواست
هدرها
| کلید | مقدار | توضیحات |
|---|---|---|
| Authorization | Bearer {token} | توکن احراز هویت |
پاسخهای ممکن
موفقیت (200 OK)
{
"balance": 1000.0,
"currency": "IRR"
}
خطاها
401 Unauthorized - توکن نامعتبر
{
"error": "توکن احراز هویت نامعتبر است"
}
مثالهای کد
cURL
curl -X GET \
'{base_url}/auth/status' \
-H 'Authorization: Bearer {your_token}'
PHP
$ch = curl_init('{base_url}/auth/status');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer {your_token}'
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
ASP.NET
using (var client = new HttpClient())
{
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "{your_token}");
var response = await client.GetAsync("{base_url}/auth/status");
var content = await response.Content.ReadAsStringAsync();
var result = JsonConvert.DeserializeObject(content);
}
.NET Core
public async Task GetAccountStatus()
{
var client = _httpClientFactory.CreateClient();
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", "{your_token}");
var response = await client.GetAsync("{base_url}/auth/status");
var content = await response.Content.ReadAsStringAsync();
return Ok(JsonConvert.DeserializeObject(content));
}
Python
import requests
headers = {
'Authorization': 'Bearer {your_token}'
}
response = requests.get('{base_url}/auth/status', headers=headers)
data = response.json()
Node.js
const axios = require('axios');
const response = await axios.get('{base_url}/auth/status', {
headers: {
'Authorization': `Bearer ${your_token}`
}
});
const data = response.data;
Java
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("{base_url}/auth/status"))
.header("Authorization", "Bearer {your_token}")
.GET()
.build();
HttpResponse response = client.send(request,
HttpResponse.BodyHandlers.ofString());
String body = response.body();
Go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "{base_url}/auth/status", nil)
req.Header.Add("Authorization", "Bearer {your_token}")
resp, _ := client.Do(req)
body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))
}
نکات مهم
- این API برای بررسی موجودی حساب کاربری استفاده میشود.
- نیاز به توکن معتبر در هدر Authorization دارد.
- موجودی به صورت عدد اعشاری و واحد پول به صورت کد سه حرفی برگردانده میشود.



















