GetPostbackSettingsForPhoneNumber

This method returns postback settings for a number.

Endpoint

GET:
https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber?LicenseKey={LICENSEKEY}&PhoneNumber={PHONENUMBER}&Country={COUNTRY}

Syntax

GetPostbackSettingsForPhoneNumber(LicenseKey, PhoneNumber, Country)

Request Parameters

Parameter Name	Description	Data Type	Required	Sample Value
LicenseKey	Your license key.	GUID	True	00000000-0000-0000-0000-000000000000
PhoneNumber	Number to check for postback settings.	String	True	7575550000
Country	Origin country for number.	String	True	US

Response

Returns: Array of PostbackSettingsResponse objects

Code Samples

You can use any programming language you want with our API, as long as it can make a REST or SOAP call. Here are examples for some of the most common platforms.

• C#
• Java
• JavaScript
• JSON Response
• PHP with cURL
• Python
• Ruby
• XML Response

C#

// https://messaging.esendex.us/Messaging.svc?wsdl was added as a Service Reference and given the name WSDL

using WSDL;

var client = new MessagingClient(MessagingClient.EndpointConfiguration.mms2wsHttpBindingSecure);
var country = "USA";
var settings = await client.GetPostbackSettingsForPhoneNumberAsync(YOUR_LICENSE_KEY, YOUR_NUMBER, country);

foreach (var postback in settings)
{
    Console.WriteLine(
        "Country: " + postback.Country + Environment.NewLine +
        "Phone Number: " + postback.PhoneNumber + Environment.NewLine +
        "Postback Enabled: " + postback.PostbackEnabled + Environment.NewLine +
        "Postback Type: " + postback.PostbackType + Environment.NewLine +
        "Postback URL: " + postback.PostbackUrl + Environment.NewLine +
        "Return Code: " + postback.ReturnCode + Environment.NewLine);
}

Java

import java.io.ByteArrayOutputStream;
import java.io.InputStream;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.Properties;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Source;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;

public final class GetPostbackSettingsForPhoneNumber {
    public static void main(String[] args) {
        try {
            URL url = new URL("https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber?"
                    + "LicenseKey=00000000-0000-0000-0000-000000000000"
                    + "&PhoneNumber=17575550000"
                    + "&Country=US");
            try {
                InputStream in = url.openStream();
                StreamSource source = new StreamSource(in);
                printResult(source);
            } catch (java.io.IOException e) {
            }
        } catch (MalformedURLException e) {
        }
    }

    private static void printResult(Source source) {
        try {
            ByteArrayOutputStream bos = new ByteArrayOutputStream();
            StreamResult sr = new StreamResult(bos);
            Transformer trans = TransformerFactory.newInstance().newTransformer();
            Properties oprops = new Properties();
            oprops.put(OutputKeys.OMIT_XML_DECLARATION, "yes");
            trans.setOutputProperties(oprops);
            trans.transform(source, sr);

            System.out.println("**** Response ******");
            System.out.println(bos.toString());

            bos.close();
            System.out.println();
        } catch (Exception e) {
        }
    }
}

JavaScript

const params = new URLSearchParams({
    'LicenseKey': '00000000-0000-0000-0000-000000000000',
    'PhoneNumber': '7575550000',
    'Country': 'USA'
});
const url = 'https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber?' + params.toString();
const response = await fetch(url, {
    headers: {
        'Accept': 'application/json',
        'Content-Type': 'application/json'
    }
});
const keywords = await response.json();

console.log(keywords);

JSON Response

[
	{
		"Country": "String content",
		"PhoneNumber": "String content",
		"PostbackEnabled": true,
		"PostbackType": 0,
		"PostbackUrl": "String content",
		"ReturnCode": 0
	}
]

PHP with cURL

<?php

$url = 'https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber?LicenseKey=00000000-0000-0000-0000-000000000000&PhoneNumber=17575550000&Country=US';
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPGET, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json', 'Accept: application/json'));

$response = curl_exec($ch);
curl_close($ch);

print_r($response);

?>

Python

import httpx

headers = {"Accept": "application/json"}
url = "https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber"
request = {
    "LicenseKey": "00000000-0000-0000-0000-000000000000",
    "PhoneNumber": "7575550000",
    "Country": "USA",
}

with httpx.Client(headers=headers) as client:
    response = client.get(url=url, params=request)

response.raise_for_status()

print(response.json())

Ruby

require 'json'
require 'net/http'

headers = { Accept: 'application/json', 'Content-Type': 'application/json' }
uri = URI('https://messaging.esendex.us/Messaging.svc/GetPostbackSettingsForPhoneNumber')

params = {
  'LicenseKey': '00000000-0000-0000-0000-000000000000',
  'PhoneNumber': '7575550000',
  'Country': 'USA'
}

uri.query = URI.encode_www_form(params)
response = Net::HTTP.get(uri, headers)
raise response.message if response.is_a?(Net::HTTPClientError) || response.is_a?(Net::HTTPServerError)

puts JSON.parse(response)

XML Response

<ArrayOfPostbackSettingsResponse xmlns="http://sms2.cdyne.com">
  <PostbackSettingsResponse>
    <Country>String content</Country>
    <PhoneNumber>String content</PhoneNumber>
    <PostbackEnabled>true</PostbackEnabled>
    <PostbackType>All</PostbackType>
    <PostbackUrl>String content</PostbackUrl>
    <ReturnCode>NoError</ReturnCode>
  </PostbackSettingsResponse>
  <PostbackSettingsResponse>
    <Country>String content</Country>
    <PhoneNumber>String content</PhoneNumber>
    <PostbackEnabled>true</PostbackEnabled>
    <PostbackType>All</PostbackType>
    <PostbackUrl>String content</PostbackUrl>
    <ReturnCode>NoError</ReturnCode>
  </PostbackSettingsResponse>
</ArrayOfPostbackSettingsResponse>