کد ورود و تأیید هویت، با یک درخواست.
متن پیام را یک بار در قالب ثبت میکنید؛ هر بار فقط شماره گیرنده و کد را میفرستید. قالب تأییدشده یعنی متن ثابت، و متن ثابت یعنی تحویل قابل پیشبینی.
curl -G "https://api.payamras.ir/v1/YOUR_API_KEY/verify/lookup.json" \
--data-urlencode "receptor=09121234567" \
--data-urlencode "template=login" \
--data-urlencode "token=4821"
<?php
$apiKey = 'YOUR_API_KEY';
$params = [
'receptor' => '09121234567',
'template' => 'login',
'token' => '4821',
];
$ch = curl_init("https://api.payamras.ir/v1/{$apiKey}/verify/lookup.json?" . http_build_query($params));
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 params = new URLSearchParams({
receptor: "09121234567",
template: "login",
token: "4821",
});
const response = await fetch(`https://api.payamras.ir/v1/${apiKey}/verify/lookup.json?${params}`);
const result = await response.json();
if (result.return.status !== 200) {
throw new Error(result.return.message);
}
import requests
api_key = "YOUR_API_KEY"
params = {
"receptor": "09121234567",
"template": "login",
"token": "4821",
}
response = requests.get(f"https://api.payamras.ir/v1/{api_key}/verify/lookup.json", params=params)
result = response.json()
if result["return"]["status"] != 200:
raise RuntimeError(result["return"]["message"])
آنچه در کد یکبارمصرف میگیرید
قالب ثبتشده
متن پیام با جای خالی برای کد در قالب ذخیره میشود. در هر ارسال فقط token را میفرستید، نه کل متن.
تماس صوتی
برای کاربرانی که پیامک دریافت نمیکنند، همان کد را میتوان با تماس صوتی خواند.
وضعیت تحویل
برای هر کد شناسه پیام برمیگردد و وضعیت تحویل آن را از API یا پنل مشتریان میبینید.
قالبها در پنل مشتریان
فهرست قالبهای حساب و وضعیت تأیید هرکدام در پنل مشتریان دیده میشود.
از راهاندازی تا اولین پیام
قالب را ثبت میکنید
متن پیام و جای کد را برای تیم پشتیبانی میفرستید یا با API قالب را میسازید. قالب تا تأیید در وضعیت «در انتظار بررسی» میماند.
کد را با یک درخواست میفرستید
شماره گیرنده، نام قالب و کد را به verify/lookup میفرستید. پاسخ همان لحظه شناسه پیام را برمیگرداند.
تحویل را پیگیری میکنید
با شناسه پیام، وضعیت تحویل را میپرسید یا در تاریخچه پیامهای ارسالی پنل میبینید.
درباره پروژهتان بنویسید؛ یک کارشناس فنی پاسخ میدهد.
حجم ارسال، نوع پیام و زمان راهاندازیتان را بنویسید. در ساعات کاری معمولاً زیر دو ساعت پاسخ میدهیم.
درخواست مشاوره
فیلدهای ستارهدار الزامی است. اطلاعات شما فقط برای پاسخ به همین درخواست استفاده میشود.