1.1 Tạo Cuộc Gọi

Gọi API HTTP Post với API-Key đã được cấp

Tạo Cuộc Gọi Xác Thực

POST /api/v1/voice/create-call

Tạo cuộc gọi với SDT và OTP cần gửi đến người dùng

Headers

Name

Value

Content-Type

application/json

API-Key

API Key theo từng đối tác

Body

Giải thích các field trong json

Field

Kiểu dữ liệu

Giải thích

phone

string

SĐT Nhận OTP , sdt bắt đầu với số 0.

otp

string

OTP thường từ 4 đến 6 số.

callbackUrl

string

Callback Url nhận kết quả cuộc gọi .xem chi tiết trong phần Callback

requestId

string

unique key của cuộc gọi dùng để tra cứu và gọ lại trong callback

Body JSON

{
  "phone": "0xxx",
  "otp": "123456",
  "callbackUrl": "http://google.com",
  "requestId": "unique_123212"
}

curl --location 'https://localhost/api/v1/voice/create-call' \
--header 'API-Key: Nx' \
--header 'Content-Type: application/json' \
--data '{
  "phone": "090xxxx",
  "otp": "12345",
  "callbackUrl": "string",
  "requestId": "131stringun3ique"
}'

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://localhost/api/v1/voice/create-call',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "phone": "09xxx",
  "otp": "12345",
  "callbackUrl": "string",
  "requestId": "131stringun3ique"
}',
  CURLOPT_HTTPHEADER => array(
    'API-Key: Nx',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

Response

{
    "data": true,
    "code": 0,
    "message": "Thành công"
}

Bảng Mã Code Trả Về

Code

Miêu tả

Make call Thành công

Thất bại. Chi tiết trong mesage

Có lỗi xảy ra .( chi tiết trong message)

PreviousDịch Vụ OTP Voice Next1.2 Callback nhận kết quả cuộc gọi

Last updated 1 year ago