وب سرویس زرین کال چیست؟

آیا تا به حال فکر کرده‌اید وقتی در یک سایت ثبت‌نام می‌کنید، کد تایید چطور در چند ثانیه به دستتان می‌رسد؟ یا وقتی پیامک به گوشی مشتری ارسال نمی شود راهکار جایگزین پیدا کردید؟ این کارها دستی انجام نمی‌شود؛
وب سرویس زرین کال این امکان را می‌دهد تا نرم‌افزار شما مستقیماً دستور برقراری تماس صوتی، تماس تعاملی یا ارسال کد OTP را به سامانه بفرستد.

گزارش وضعیت و وب‌هوک

وضعیت هر تماس را استعلام کنید یا رویدادها را لحظه‌ای از طریق وب‌هوک روی سامانه خود دریافت کنید.

ارسال از نرم‌افزار شما

تماس صوتی، تماس تعاملی و ارسال کد تایید را مستقیم از داخل سامانه خودتان به زرین کال دستور بدهید.

مستندات و نمونه کد

مستندات Postman و Swagger به‌همراه نمونه JSON ورودی و خروجی هر متد، برای پیاده‌سازی سریع در دسترس است.

معماری RESTful

وب سرویس بر اساس استاندارد REST پیاده‌سازی شده و در تمام زبان‌های برنامه‌نویسی به‌آسانی قابل استفاده است.

مرکز توسعه‌دهندگان

پیاده سازی وب سرویس

برای هر متد وب سرویس یک نمونه کامل و تست‌شده آماده کرده‌ایم؛ از ارسال کد تایید تا تماس تعاملی و گزارش وضعیت. کلید خودتان را جایگزین کنید و همان لحظه اجرا بگیرید.

ساده

بدون پیچیدگی پیاده‌سازی

استاندارد

بر پایه REST و JSON

سریع

از کپی تا اولین تماس

<?php
$ch = curl_init('https://ws.zarincall.ir/apiv2/Message/SendOTP');

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'Authorization: Bearer eyJhbGciOiJIU ...'
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        'Code'   => '192983',
        'Number' => '09121110000'
    ])
]);

$result = json_decode(curl_exec($ch), true);

if ($result['R_Success']) {
    echo $result['MsgID'];
}

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer eyJhbGciOiJIU ...");

var body = new StringContent(
    "{\"Code\":\"192983\",\"Number\":\"09121110000\"}",
    Encoding.UTF8, "application/json");

var res = await client.PostAsync(
    "https://ws.zarincall.ir/apiv2/Message/SendOTP", body);

Console.WriteLine(await res.Content.ReadAsStringAsync());

import requests

result = requests.post(
    'https://ws.zarincall.ir/apiv2/Message/SendOTP',
    headers={'Authorization': 'Bearer eyJhbGciOiJIU ...'},
    json={'Code': '192983', 'Number': '09121110000'},
).json()

if result['R_Success']:
    print(result['MsgID'])

const res = await fetch('https://ws.zarincall.ir/apiv2/Message/SendOTP', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer eyJhbGciOiJIU ...'
  },
  body: JSON.stringify({ Code: '192983', Number: '09121110000' })
});

const result = await res.json();
if (result.R_Success) console.log(result.MsgID);

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://ws.zarincall.ir/apiv2/Message/SendOTP"))
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer eyJhbGciOiJIU ...")
    .POST(HttpRequest.BodyPublishers.ofString(
        "{\"Code\":\"192983\",\"Number\":\"09121110000\"}"))
    .build();

HttpResponse<String> response =
    client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

curl -X POST 'https://ws.zarincall.ir/apiv2/Message/SendOTP' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIU ...' \
  -d '{"Code":"192983","Number":"09121110000"}'