توکن، رفرشتوکن و سشن
در این روش، کاربر با شمارهی موبایل خود وارد میشود و برنامهی شما یک Access Token کوتاهمدت و یک Refresh Token دریافت میکند. Access Token در هدر Authorization: Bearer فرستاده میشود و پس از انقضا با Refresh Token نوسازی میگردد. این روش برای نرمافزارهای چندمشتری مناسب است؛ الگوی کامل آن در اتصال برنامههای چندمشتری آمده است.
هدرهای مشترک
هر سه endpoint این صفحه به هدرهای زیر نیاز دارند:
| هدر | توضیح | الزامی |
|---|---|---|
X-Client-App | کلید ClientApp که پشتیبانی به شما داده است | بله |
X-Session-Key | کلید یکتای سشن همان مشتری | بله، در هر سه endpoint |
اگر X-Client-App ارسال نشود، پاسخ 401 برمیگردد. اگر X-Session-Key در verify یا register نباشد، پاسخ 400 با پیام «Session Key not found!» است. برای token نیز همیشه X-Session-Key را بفرستید؛ نبودن آن باعث خطای سرور میشود.
گام ۱: شروع ورود (verify)
این endpoint یک پیامک تأیید به شمارهی کاربر میفرستد و شناسهی ارجاع را برمیگرداند.
POST /auth/api/verify
بدنهی درخواست
| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
phoneNumber | رشته | بله | شمارهی موبایل کاربر، حداقل ۱۱ رقم |
- curl
- C#
- Python
- Node.js
- PHP
- Go
curl -X POST "https://api.payavasms.com/auth/api/verify" \
-H "X-Client-App: YOUR_CLIENT_APP_KEY" \
-H "X-Session-Key: YOUR_SESSION_KEY" \
-H "Content-Type: application/json" \
-d '{
"phoneNumber": "09120000000"
}'
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Client-App", "YOUR_CLIENT_APP_KEY");
client.DefaultRequestHeaders.Add("X-Session-Key", "YOUR_SESSION_KEY");
var json = """
{
"phoneNumber": "09120000000"
}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.payavasms.com/auth/api/verify", content);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import requests
url = "https://api.payavasms.com/auth/api/verify"
headers = {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
}
payload = {
"phoneNumber": "09120000000"
}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.text)
const response = await fetch("https://api.payavasms.com/auth/api/verify", {
method: "POST",
headers: {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"phoneNumber": "09120000000"
}),
});
console.log(response.status, await response.text());
<?php
$ch = curl_init("https://api.payavasms.com/auth/api/verify");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"X-Client-App: YOUR_CLIENT_APP_KEY",
"X-Session-Key: YOUR_SESSION_KEY",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"phoneNumber": "09120000000"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"phoneNumber": "09120000000"
}`)
req, _ := http.NewRequest("POST", "https://api.payavasms.com/auth/api/verify", body)
req.Header.Set("X-Client-App", "YOUR_CLIENT_APP_KEY")
req.Header.Set("X-Session-Key", "YOUR_SESSION_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(data))
}
نمونهی پاسخ موفق
{
"isError": false,
"errorMessage": "",
"client": "YOUR_CLIENT_ID",
"phoneNumber": "09120000000",
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000"
}
فیلدهای پاسخ
| فیلد | نوع | توضیح |
|---|---|---|
isError | بولی | true در صورت خطا |
errorMessage | رشته | متن خطا، در حالت موفق خالی |
client | رشته | شناسهی کلاینت |
phoneNumber | رشته | شمارهی ورودی |
referenceId | رشته | شناسهی ارجاع برای مرحلهی بعد |
خطاها
خطاها با isError برابر true و پیام فارسی در errorMessage برگردانده میشوند:
| پیام | علت |
|---|---|
| شماره تلفن وارد شده معتبر نمی باشد. | شماره کمتر از ۱۱ رقم است |
| کلید وارد شده معتبر نمی باشد. | مقدار X-Client-App شناخته نمیشود |
| کاربری با این شماره موبایل پیدا نشد | برای این شماره حسابی در پایاوا وجود ندارد |
| خطا در اعتبار سنجی | X-Session-Key با سشن ثبتشدهی کاربر مطابقت ندارد |
| دسترسی غیرمجاز درخواست مسدود شد | آیپی یا سشن مسدود شده است |
| خطا در ارسال پیامک | ارسال پیامک تأیید ناموفق بود |
گام ۲: تکمیل ورود (register)
کد پیامکشده را همراه شناسهی ارجاع بفرستید تا توکنها صادر شوند و سشن ثبت گردد.
POST /auth/api/register
بدنهی درخواست
| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
referenceId | رشته | بله | مقدار برگشتی از verify |
code | رشته | بله | کد تأییدی که با پیامک آمده است |
- curl
- C#
- Python
- Node.js
- PHP
- Go
curl -X POST "https://api.payavasms.com/auth/api/register" \
-H "X-Client-App: YOUR_CLIENT_APP_KEY" \
-H "X-Session-Key: YOUR_SESSION_KEY" \
-H "Content-Type: application/json" \
-d '{
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}'
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Client-App", "YOUR_CLIENT_APP_KEY");
client.DefaultRequestHeaders.Add("X-Session-Key", "YOUR_SESSION_KEY");
var json = """
{
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.payavasms.com/auth/api/register", content);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import requests
url = "https://api.payavasms.com/auth/api/register"
headers = {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
}
payload = {
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.text)
const response = await fetch("https://api.payavasms.com/auth/api/register", {
method: "POST",
headers: {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}),
});
console.log(response.status, await response.text());
<?php
$ch = curl_init("https://api.payavasms.com/auth/api/register");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"X-Client-App: YOUR_CLIENT_APP_KEY",
"X-Session-Key: YOUR_SESSION_KEY",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"referenceId": "3f2b8c1e-0000-0000-0000-000000000000",
"code": "123456"
}`)
req, _ := http.NewRequest("POST", "https://api.payavasms.com/auth/api/register", body)
req.Header.Set("X-Client-App", "YOUR_CLIENT_APP_KEY")
req.Header.Set("X-Session-Key", "YOUR_SESSION_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(data))
}
نمونهی پاسخ موفق
{
"isError": false,
"errorMessage": null,
"accessToken": "YOUR_ACCESS_TOKEN",
"refreshToken": "YOUR_REFRESH_TOKEN",
"client": "YOUR_CLIENT_ID",
"expireInSeconds": 3600,
"expireAtUtc": "2026-11-19T12:00:00.0000000Z"
}
فیلدهای پاسخ (مشترک بین register و token)
| فیلد | نوع | توضیح |
|---|---|---|
isError | بولی | true در صورت خطا |
errorMessage | رشته | متن خطا |
accessToken | رشته | توکن دسترسی برای هدر Authorization |
refreshToken | رشته | توکن نوسازی |
client | رشته | شناسهی کلاینت |
expireInSeconds | عدد | مدت اعتبار accessToken به ثانیه |
expireAtUtc | رشته | زمان دقیق انقضا به UTC با قالب ISO 8601 |
خطاها
| پیام | علت |
|---|---|
| کد ارجاع ورودی نامعتبر است! | referenceId وجود ندارد یا قبلاً استفاده شده است |
| کد وارد شده اشتباه می باشد! | code درست نیست |
| کلید وارد شده معتبر نمی باشد. | X-Client-App شناخته نمیشود |
گام ۳: نوسازی توکن (token)
با Refresh Token، بدون ورود مجدد، توکن جدید بگیرید. همان X-Session-Key ورود را بفرستید.
POST /auth/api/token
بدنهی درخواست
| فیلد | نوع | الزامی | توضیح |
|---|---|---|---|
refreshToken | رشته | بله | آخرین Refresh Token دریافتشده |
- curl
- C#
- Python
- Node.js
- PHP
- Go
curl -X POST "https://api.payavasms.com/auth/api/token" \
-H "X-Client-App: YOUR_CLIENT_APP_KEY" \
-H "X-Session-Key: YOUR_SESSION_KEY" \
-H "Content-Type: application/json" \
-d '{
"refreshToken": "YOUR_REFRESH_TOKEN"
}'
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Client-App", "YOUR_CLIENT_APP_KEY");
client.DefaultRequestHeaders.Add("X-Session-Key", "YOUR_SESSION_KEY");
var json = """
{
"refreshToken": "YOUR_REFRESH_TOKEN"
}
""";
using var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://api.payavasms.com/auth/api/token", content);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");
import requests
url = "https://api.payavasms.com/auth/api/token"
headers = {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
}
payload = {
"refreshToken": "YOUR_REFRESH_TOKEN"
}
response = requests.post(url, headers=headers, json=payload)
print(response.status_code, response.text)
const response = await fetch("https://api.payavasms.com/auth/api/token", {
method: "POST",
headers: {
"X-Client-App": "YOUR_CLIENT_APP_KEY",
"X-Session-Key": "YOUR_SESSION_KEY",
"Content-Type": "application/json",
},
body: JSON.stringify({
"refreshToken": "YOUR_REFRESH_TOKEN"
}),
});
console.log(response.status, await response.text());
<?php
$ch = curl_init("https://api.payavasms.com/auth/api/token");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"X-Client-App: YOUR_CLIENT_APP_KEY",
"X-Session-Key: YOUR_SESSION_KEY",
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => <<<'JSON'
{
"refreshToken": "YOUR_REFRESH_TOKEN"
}
JSON,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;
package main
import (
"fmt"
"io"
"net/http"
"strings"
)
func main() {
body := strings.NewReader(`{
"refreshToken": "YOUR_REFRESH_TOKEN"
}`)
req, _ := http.NewRequest("POST", "https://api.payavasms.com/auth/api/token", body)
req.Header.Set("X-Client-App", "YOUR_CLIENT_APP_KEY")
req.Header.Set("X-Session-Key", "YOUR_SESSION_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(data))
}
نمونهی پاسخ موفق
{
"isError": false,
"errorMessage": null,
"accessToken": "YOUR_NEW_ACCESS_TOKEN",
"refreshToken": "YOUR_NEW_REFRESH_TOKEN",
"client": "YOUR_CLIENT_ID",
"expireInSeconds": 3600,
"expireAtUtc": "2026-11-19T13:00:00.0000000Z"
}
خطاها
| پیام | علت |
|---|---|
| مقدار رفرش توکن وارد نشده. | refreshToken خالی است |
| کلید وارد شده معتبر نمی باشد. | X-Client-App شناخته نمیشود |
| اشتراک شما منقضی شده است. لطفا برای تمدید آن اقدام فرمایید. | اشتراک کاربر تمام شده است |
| متن خطای سرویس هویتسنجی | Refresh Token نامعتبر یا ابطالشده است |
راهکار پیشنهادی مدیریت توکن
مدت اعتبار توکنها ممکن است تغییر کند؛ بنابراین هیچ مقدار ثابتی را در برنامهی خود فرض نکنید و فقط از مقدارهای برگشتی همین پاسخها استفاده کنید. روش پیشنهادی:
- پس از هر
registerو هرtoken، علاوه برaccessTokenوrefreshToken، زمان دقیق انقضا (expireAtUtc) را هم ذخیره کنید. - پیش از هر درخواست به API، زمان انقضا را با زمان فعلی بسنجید. اگر گذشته است (یا کمتر از یک دقیقه مانده)، ابتدا نوسازی کنید و سپس درخواست را بفرستید.
- اگر با وجود بررسی بالا پاسخ
401گرفتید (مثلاً توکن ابطال شده است)، یک بار نوسازی کنید و درخواست را تکرار کنید. اگر نوسازی هم خطا داد، کاربر باید دوباره باverifyوregisterوارد شود. - پس از هر نوسازی، مقدار تازهی
refreshTokenرا جایگزین قبلی کنید. - نوسازی را برای هر مشتری جداگانه و پشت یک قفل انجام دهید تا دو درخواست همزمان باعث چند نوسازی نشوند.
نمونهی زیر این منطق را پیاده میکند. ذخیرهسازی پایدار (پایگاه داده یا فایل رمزنگاریشده) را متناسب با برنامهی خود جایگزین کنید.
- C#
- Python
- Node.js
- PHP
- Go
- curl
using System.Net;
using System.Net.Http.Json;
public sealed class TokenState
{
public string AccessToken { get; set; } = "";
public string RefreshToken { get; set; } = "";
public DateTimeOffset ExpireAtUtc { get; set; }
}
public sealed class PayavaClient(HttpClient http, TokenState state, string clientAppKey, string sessionKey)
{
private static readonly TimeSpan Skew = TimeSpan.FromSeconds(60);
private readonly SemaphoreSlim _lock = new(1, 1);
public async Task<HttpResponseMessage> SendAsync(Func<HttpRequestMessage> build)
{
if (DateTimeOffset.UtcNow >= state.ExpireAtUtc - Skew)
await RefreshAsync();
var response = await http.SendAsync(Authorize(build()));
if (response.StatusCode != HttpStatusCode.Unauthorized)
return response;
await RefreshAsync(force: true);
return await http.SendAsync(Authorize(build()));
}
private HttpRequestMessage Authorize(HttpRequestMessage request)
{
request.Headers.Add("Authorization", "Bearer " + state.AccessToken);
return request;
}
private async Task RefreshAsync(bool force = false)
{
await _lock.WaitAsync();
try
{
if (!force && DateTimeOffset.UtcNow < state.ExpireAtUtc - Skew) return;
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.payavasms.com/auth/api/token")
{
Content = JsonContent.Create(new { refreshToken = state.RefreshToken })
};
request.Headers.Add("X-Client-App", clientAppKey);
request.Headers.Add("X-Session-Key", sessionKey);
var result = await (await http.SendAsync(request)).Content.ReadFromJsonAsync<TokenResult>();
if (result is null || result.IsError)
throw new InvalidOperationException(result?.ErrorMessage ?? "Token refresh failed");
state.AccessToken = result.AccessToken!;
state.RefreshToken = result.RefreshToken!;
state.ExpireAtUtc = DateTimeOffset.Parse(result.ExpireAtUtc!);
// اینجا state را در محل ذخیرهسازی پایدار بنویسید
}
finally { _lock.Release(); }
}
private sealed record TokenResult(bool IsError, string? ErrorMessage, string? AccessToken,
string? RefreshToken, string? ExpireAtUtc);
}
import re
import threading
from datetime import datetime, timedelta, timezone
import requests
BASE = "https://api.payavasms.com"
SKEW = timedelta(seconds=60)
def parse_utc(value: str) -> datetime:
# ثانیهی کسری سامانه ۷ رقم دارد؛ به ۶ رقم کوتاه میشود
value = re.sub(r"(\.\d{6})\d*", r"\1", value).replace("Z", "+00:00")
return datetime.fromisoformat(value)
class PayavaClient:
def __init__(self, state, client_app_key, session_key):
# state: dict با کلیدهای access_token، refresh_token و expire_at (datetime آگاه از منطقهی زمانی)
self.state = state
self.client_app_key = client_app_key
self.session_key = session_key
self._lock = threading.Lock()
def request(self, method, path, **kwargs):
if datetime.now(timezone.utc) >= self.state["expire_at"] - SKEW:
self.refresh()
response = self._send(method, path, **kwargs)
if response.status_code == 401:
self.refresh(force=True)
response = self._send(method, path, **kwargs)
return response
def _send(self, method, path, **kwargs):
headers = {"Authorization": "Bearer " + self.state["access_token"]}
return requests.request(method, BASE + path, headers=headers, **kwargs)
def refresh(self, force=False):
with self._lock:
if not force and datetime.now(timezone.utc) < self.state["expire_at"] - SKEW:
return
response = requests.post(
BASE + "/auth/api/token",
headers={"X-Client-App": self.client_app_key, "X-Session-Key": self.session_key},
json={"refreshToken": self.state["refresh_token"]},
)
data = response.json()
if data.get("isError"):
raise RuntimeError(data.get("errorMessage") or "Token refresh failed")
self.state["access_token"] = data["accessToken"]
self.state["refresh_token"] = data["refreshToken"]
self.state["expire_at"] = parse_utc(data["expireAtUtc"])
# اینجا state را در محل ذخیرهسازی پایدار بنویسید
const BASE = "https://api.payavasms.com";
const SKEW_MS = 60_000;
class PayavaClient {
// state: { accessToken, refreshToken, expireAt: Date }
constructor(state, clientAppKey, sessionKey) {
this.state = state;
this.clientAppKey = clientAppKey;
this.sessionKey = sessionKey;
this.refreshing = null;
}
async request(path, options = {}) {
if (Date.now() >= this.state.expireAt.getTime() - SKEW_MS) {
await this.refresh();
}
let response = await this.send(path, options);
if (response.status === 401) {
await this.refresh(true);
response = await this.send(path, options);
}
return response;
}
send(path, options) {
const headers = { ...(options.headers ?? {}), Authorization: `Bearer ${this.state.accessToken}` };
return fetch(BASE + path, { ...options, headers });
}
refresh(force = false) {
// درخواستهای همزمان از یک نوسازی مشترک استفاده میکنند
if (!this.refreshing) {
this.refreshing = this.doRefresh(force).finally(() => (this.refreshing = null));
}
return this.refreshing;
}
async doRefresh(force) {
if (!force && Date.now() < this.state.expireAt.getTime() - SKEW_MS) return;
const response = await fetch(`${BASE}/auth/api/token`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Client-App": this.clientAppKey,
"X-Session-Key": this.sessionKey,
},
body: JSON.stringify({ refreshToken: this.state.refreshToken }),
});
const data = await response.json();
if (data.isError) throw new Error(data.errorMessage ?? "Token refresh failed");
this.state.accessToken = data.accessToken;
this.state.refreshToken = data.refreshToken;
this.state.expireAt = new Date(data.expireAtUtc);
// اینجا state را در محل ذخیرهسازی پایدار بنویسید
}
}
<?php
class PayavaClient
{
private const BASE = 'https://api.payavasms.com';
private const SKEW = 60;
// $state: ['accessToken' => ..., 'refreshToken' => ..., 'expireAt' => DateTimeImmutable]
public function __construct(
private array $state,
private string $clientAppKey,
private string $sessionKey
) {}
public function request(string $method, string $path, ?string $jsonBody = null): array
{
if (time() >= $this->state['expireAt']->getTimestamp() - self::SKEW) {
$this->refresh();
}
[$status, $body] = $this->send($method, $path, $jsonBody);
if ($status === 401) {
$this->refresh(true);
[$status, $body] = $this->send($method, $path, $jsonBody);
}
return [$status, $body];
}
private function send(string $method, string $path, ?string $jsonBody): array
{
$headers = ['Authorization: Bearer ' . $this->state['accessToken']];
if ($jsonBody !== null) {
$headers[] = 'Content-Type: application/json';
}
$ch = curl_init(self::BASE . $path);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers,
CURLOPT_POSTFIELDS => $jsonBody,
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return [$status, $body];
}
private function refresh(bool $force = false): void
{
if (!$force && time() < $this->state['expireAt']->getTimestamp() - self::SKEW) {
return;
}
$ch = curl_init(self::BASE . '/auth/api/token');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-Client-App: ' . $this->clientAppKey,
'X-Session-Key: ' . $this->sessionKey,
],
CURLOPT_POSTFIELDS => json_encode(['refreshToken' => $this->state['refreshToken']]),
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);
if (!empty($data['isError'])) {
throw new RuntimeException($data['errorMessage'] ?? 'Token refresh failed');
}
$this->state['accessToken'] = $data['accessToken'];
$this->state['refreshToken'] = $data['refreshToken'];
$this->state['expireAt'] = new DateTimeImmutable($data['expireAtUtc']);
// اینجا state را در محل ذخیرهسازی پایدار بنویسید
}
}
package payava
import (
"bytes"
"encoding/json"
"errors"
"io"
"net/http"
"sync"
"time"
)
const base = "https://api.payavasms.com"
const skew = 60 * time.Second
type Client struct {
mu sync.Mutex
AccessToken string
RefreshToken string
ExpireAt time.Time
ClientApp string
SessionKey string
}
type tokenResult struct {
IsError bool `json:"isError"`
ErrorMessage string `json:"errorMessage"`
AccessToken string `json:"accessToken"`
RefreshToken string `json:"refreshToken"`
ExpireAtUtc string `json:"expireAtUtc"`
}
// Do درخواست را با Bearer ارسال میکند و در صورت نیاز توکن را نوسازی میکند.
func (c *Client) Do(method, path string, body []byte) (*http.Response, error) {
if time.Now().After(c.ExpireAt.Add(-skew)) {
if err := c.refresh(false); err != nil {
return nil, err
}
}
res, err := c.send(method, path, body)
if err != nil || res.StatusCode != http.StatusUnauthorized {
return res, err
}
res.Body.Close()
if err := c.refresh(true); err != nil {
return nil, err
}
return c.send(method, path, body)
}
func (c *Client) send(method, path string, body []byte) (*http.Response, error) {
req, err := http.NewRequest(method, base+path, bytes.NewReader(body))
if err != nil {
return nil, err
}
req.Header.Set("Authorization", "Bearer "+c.AccessToken)
if body != nil {
req.Header.Set("Content-Type", "application/json")
}
return http.DefaultClient.Do(req)
}
func (c *Client) refresh(force bool) error {
c.mu.Lock()
defer c.mu.Unlock()
if !force && time.Now().Before(c.ExpireAt.Add(-skew)) {
return nil
}
payload, _ := json.Marshal(map[string]string{"refreshToken": c.RefreshToken})
req, _ := http.NewRequest("POST", base+"/auth/api/token", bytes.NewReader(payload))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-Client-App", c.ClientApp)
req.Header.Set("X-Session-Key", c.SessionKey)
res, err := http.DefaultClient.Do(req)
if err != nil {
return err
}
defer res.Body.Close()
data, _ := io.ReadAll(res.Body)
var result tokenResult
if err := json.Unmarshal(data, &result); err != nil {
return err
}
if result.IsError {
return errors.New(result.ErrorMessage)
}
expire, err := time.Parse(time.RFC3339Nano, result.ExpireAtUtc)
if err != nil {
return err
}
c.AccessToken = result.AccessToken
c.RefreshToken = result.RefreshToken
c.ExpireAt = expire
// اینجا وضعیت را در محل ذخیرهسازی پایدار بنویسید
return nil
}
# نوسازی دستی توکن
curl -X POST "https://api.payavasms.com/auth/api/token" \
-H "X-Client-App: YOUR_CLIENT_APP_KEY" \
-H "X-Session-Key: YOUR_SESSION_KEY" \
-H "Content-Type: application/json" \
-d '{ "refreshToken": "YOUR_REFRESH_TOKEN" }'