Skip to content

GetNumberGroupData.md

Latest commit

 

History

History
177 lines (142 loc) · 6.6 KB

GetNumberGroupData.md

File metadata and controls

177 lines (142 loc) · 6.6 KB

راهنمای متد GetNumberGroupData

برای دریافت اطلاعات گروه های موجود در دفتر تلفن سامانه مدیریت ارسال و دریافت پیام کوتاه خود از این متد استفاده نمایید . جهت به کارگیری آن آدرس URL زیر را فراخوانی نمایید :

https://sms.sunwaysms.com/smsws/HttpService.ashx?service=GetNumberGroupData&username=$UserName$&Password=$Password$

با توجه به جدول ذیل کلمات کلیدی این متد را مقدار دهی نمایید.

پارامترهای ورودی

نامنوعاجباری / اختیاریتوضیح
UserNameStringاجبارینام کاربری
PasswordStringاجباریکلمه عبور

خروجی Json

کلیدتوضیح
NumberGroupIDشناسه گروه شماره ها دفتر تلفن
NumberCountتعداد شماره های موجود در گروه
FarsiNameنام فارسی گروه
EnglishNameنام انگلیسی گروه
Priorityاولویت تعیین شده برای گروه توسط کاربر

نکات مهم در مورد کار با متد GetNumberGroupData

  • فقط کاربرانی می توانند از این متد استفاده کنند که هم کاربر وب سرویس و هم کاربر سامانه مدیریت پیام کوتاه باشند.
  • دقت کنید که خروجی این متد اطلاعات گروه دفتر تلفن شما است ، که با استفاده از این اطلاعات و متد SendNumberGroup یا SendNumberGroupSchedule می توانید پیام گروهی ارسال کنید .

نمونه کد

PHP

class SMS
{
    function get_data($Data) {
        $url = "https://sms.sunwaysms.com/smsws/HttpService?";
         $ch = curl_init();
         curl_setopt($ch, CURLOPT_URL, $url . $Data);
         curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
         curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
         $data = curl_exec($ch);
         curl_close($ch);
        return $data;
    }

    function GetNumberGroupData($UserName, $Password) {
        $result = $this->get_data("service=GetNumberGroupData&UserName=" . urlencode($UserName) . "&Password=" . urlencode($Password));
        return(json_decode($result));
    }
}

Java

import java.net.*;
import java.nio.charset.Charset;
import java.io.*;

import com.google.gson.*;

public class UrlAPI {

    static String link = "https://sms.sunwaysms.com/smsws/HttpService?";
    static Gson gson = new Gson();

    public static void main(String[] args) {
        
    }

    public static String getUrl(String Url) throws Exception {
        String temp = "";
        try {
            URL url = new URL(link + Url);
            // Get the response
            URLConnection urlConnection = url.openConnection();
            BufferedReader reader = new BufferedReader(new InputStreamReader(
                    urlConnection.getInputStream(), Charset.forName("UTF-8")));

            String line = "";
            while ((line = reader.readLine()) != null) {
                temp += line;
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
        return temp;
    }

    public static NumberGroupItem[] GetNumberGroupData(String UserName,
            String Password) throws Exception {
        String result = getUrl("service=GetNumberGroupData&UserName="
                + encode(UserName) + "&Password=" + encode(Password));
        NumberGroupItem[] groupItems = gson.fromJson(result,
                NumberGroupItem[].class);
        return groupItems;
    }
}

C#

public static class API {
    const string URL = "https://sms.sunwaysms.com/smsws/HttpService?";

    /// <summary>
    /// Get Number Group Data
    /// </summary>
    /// <param name="UserName">String</param>
    /// <param name="Password">String</param>
    /// <returns>NumberGroupItem</returns>
    public static NumberGroupItem[] GetNumberGroupData(string UserName, string Password) {
        WebRequest request = WebRequest.Create(URL + "service=GetNumberGroupData&UserName=" + UserName + "&Password=" + Password);
        request.Method = "GET";
        WebResponse response = request.GetResponse();

        using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8)) {
            var result = reader.ReadToEnd();
            JavaScriptSerializer serializer = new JavaScriptSerializer();
            return serializer.Deserialize<NumberGroupItem[]>(result);
        }
    }
}

VB.net

Imports System.Net
Imports System.IO
Imports System.Text
Imports System.Web.Script.Serialization

Public Class API
    Const URL As String = "https://sms.sunwaysms.com/smsws/HttpService?"

    ''' <summary>
    ''' Get Number Group Data
    ''' </summary>
    ''' <param name="UserName">String</param>
    ''' <param name="Password">String</param>
    ''' <returns>NumberGroupItem</returns>
    Public Shared Function GetNumberGroupData(UserName As String, Password As String) As NumberGroupItem()
        Dim request As WebRequest = WebRequest.Create(URL & "service=GetNumberGroupData&UserName=" & UserName & "&Password=" & Password)
        request.Method = "GET"
        Dim response As WebResponse = request.GetResponse()

        Using reader As New StreamReader(response.GetResponseStream(), Encoding.UTF8)
            Dim result = reader.ReadToEnd()
            Dim serializer As New JavaScriptSerializer()
            Return serializer.Deserialize(Of NumberGroupItem())(result)
        End Using
    End Function
    
End Class