Mobile Message API Documentation

import requests
from requests.auth import HTTPBasicAuth

response = requests.get('https://api.mobilemessage.com.au/v1/messages', 
                        auth=HTTPBasicAuth('user123', 'mypassword'))
print(response.json())

const username = 'user123';
const password = 'mypassword';

fetch('https://api.mobilemessage.com.au/v1/messages', {
  headers: {
    'Authorization': 'Basic ' + btoa(`${username}:${password}`)
  }
})
.then(response => response.json())
.then(data => console.log(data));

<?php
$ch = curl_init('https://api.mobilemessage.com.au/v1/messages');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, "user123:mypassword");
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

public class APIRequest {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder().encodeToString("user123:mypassword".getBytes());
        URL url = new URL("https://api.mobilemessage.com.au/v1/messages");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestProperty("Authorization", "Basic " + credentials);
        connection.setRequestMethod("GET");
        // Process the response...
    }
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        var client = new HttpClient();
        var byteArray = Encoding.ASCII.GetBytes("user123:mypassword");
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));
        var response = await client.GetAsync("https://api.mobilemessage.com.au/v1/messages");
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

import requests
from requests.auth import HTTPBasicAuth

data = {
    "enable_unicode": True,
    "messages": [
        {
            "to": "0412345678",
            "message": "Hello, this is a test message",
            "sender": "CompanyABC",
            "custom_ref": "tracking001"
        },
        {
            "to": "0412345679",
            "message": "Hello 🌏 from Mobile Message",
            "sender": "CompanyABC",
            "custom_ref": "tracking002",
            "unicode": true
        }
    ]
}

response = requests.post('https://api.mobilemessage.com.au/v1/messages',
                         json=data, auth=HTTPBasicAuth('user123', 'mypassword'))
print(response.json())

const body = {
  enable_unicode: true,
  messages: [
    {
      to: "0412345678",
      message: "Hello, this is a test message",
      sender: "CompanyABC",
      custom_ref: "tracking001"
    },
    {
      to: "0412345679",
      message: "Hello 🌏 from Mobile Message",
      sender: "CompanyABC",
      custom_ref: "tracking002",
      unicode: true
    }
  ]
};

fetch('https://api.mobilemessage.com.au/v1/messages', {
  method: 'POST',
  headers: {
    'Authorization': 'Basic ' + btoa('user123:mypassword'),
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(body)
})
.then(r => r.json())
.then(console.log);

<?php
$data = [
  "enable_unicode" => true,
  "messages" => [
    [
      "to" => "0412345678",
      "message" => "Hello, this is a test message",
      "sender" => "CompanyABC",
      "custom_ref" => "tracking001"
    ],
    [
      "to" => "0412345679",
      "message" => "Hello 🌏 from Mobile Message",
      "sender" => "CompanyABC",
      "custom_ref" => "tracking002",
      "unicode" => true
    ]
  ]
];

$ch = curl_init('https://api.mobilemessage.com.au/v1/messages');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, "user123:mypassword");
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

public class SendSMS {
    public static void main(String[] args) throws Exception {
        String json = """
        {
          "enable_unicode": true,
          "messages": [
            {"to":"0412345678","message":"Hello, this is a test message","sender":"CompanyABC","custom_ref":"tracking001"},
            {"to":"0412345679","message":"Hello 🌏 from Mobile Message","sender":"CompanyABC","custom_ref":"tracking002","unicode":true}
          ]
        }""";
        String credentials = Base64.getEncoder().encodeToString("user123:mypassword".getBytes());
        URL url = new URL("https://api.mobilemessage.com.au/v1/messages");
        HttpURLConnection c = (HttpURLConnection) url.openConnection();
        c.setRequestMethod("POST");
        c.setRequestProperty("Authorization", "Basic " + credentials);
        c.setRequestProperty("Content-Type", "application/json");
        c.setDoOutput(true);
        try (OutputStream os = c.getOutputStream()) { os.write(json.getBytes("utf-8")); }
        // Handle response...
    }
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

class Program {
  static async Task Main() {
    var body = new {
      enable_unicode = true,
      messages = new[] {
        new { to = "0412345678", message = "Hello, this is a test message", sender = "CompanyABC", custom_ref = "tracking001" },
        new { to = "0412345679", message = "Hello 🌏 from Mobile Message", sender = "CompanyABC", custom_ref = "tracking002", unicode = true }
      }
    };
    var client = new HttpClient();
    var creds = Convert.ToBase64String(Encoding.ASCII.GetBytes("user123:mypassword"));
    client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", creds);
    var content = new StringContent(JsonConvert.SerializeObject(body), Encoding.UTF8, "application/json");
    var resp = await client.PostAsync("https://api.mobilemessage.com.au/v1/messages", content);
    Console.WriteLine(await resp.Content.ReadAsStringAsync());
  }
}

import requests
from requests.auth import HTTPBasicAuth

url = "https://api.mobilemessage.com.au/v1/messages?message_id=abcd1234-efgh-5678-ijkl-9876543210mn"
response = requests.get(url, auth=HTTPBasicAuth('user123', 'mypassword'))
print(response.json())

const messageId = "abcd1234-efgh-5678-ijkl-9876543210mn";

fetch(`https://api.mobilemessage.com.au/v1/messages?message_id=${messageId}`, {
    headers: {
        'Authorization': 'Basic ' + btoa('user123:mypassword')
    }
})
.then(response => response.json())
.then(data => console.log(data));

<?php
$message_id = "abcd1234-efgh-5678-ijkl-9876543210mn";
$url = "https://api.mobilemessage.com.au/v1/messages?message_id=" . $message_id;
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, "user123:mypassword");
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;

public class LookupMessage {
    public static void main(String[] args) throws Exception {
        String message_id = "abcd1234-efgh-5678-ijkl-9876543210mn";
        URL url = new URL("https://api.mobilemessage.com.au/v1/messages?message_id=" + message_id);
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        String credentials = Base64.getEncoder().encodeToString("user123:mypassword".getBytes());
        connection.setRequestProperty("Authorization", "Basic " + credentials);
        connection.setRequestMethod("GET");
        // Process the response...
    }
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Threading.Tasks;

class Program {
    static async Task Main() {
        string message_id = "abcd1234-efgh-5678-ijkl-9876543210mn";
        string url = $"https://api.mobilemessage.com.au/v1/messages?message_id={message_id}";
        var client = new HttpClient();
        var byteArray = System.Text.Encoding.ASCII.GetBytes("user123:mypassword");
        client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));
        var response = await client.GetAsync(url);
        Console.WriteLine(await response.Content.ReadAsStringAsync());
    }
}

import requests
from requests.auth import HTTPBasicAuth

url = "https://api.mobilemessage.com.au/v1/account"
response = requests.get(url, auth=HTTPBasicAuth('user123', 'mypassword'))

# Parse the JSON response
data = response.json()
credit_balance = data.get('credit_balance', 'N/A')

print(f"Credit Balance: {credit_balance}")
# Output might be: Credit Balance: 1000

// Using Fetch API to get and process account balance
fetch('https://api.mobilemessage.com.au/v1/account', {
    method: 'GET',
    headers: {
        'Authorization': 'Basic ' + btoa('user123:mypassword'),
        'Content-Type': 'application/json'
    }
})
.then(response => response.json())
.then(data => {
    const creditBalance = data.credit_balance || 'N/A';
    console.log("Credit Balance:", creditBalance);
})
.catch(error => console.error(error));

<?php
$url = "https://api.mobilemessage.com.au/v1/account";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERPWD, "user123:mypassword");
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
$creditBalance = isset($data['credit_balance']) ? $data['credit_balance'] : 'N/A';
echo "Credit Balance: " . $creditBalance;
// Output might be: Credit Balance: 1000
?>

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Base64;
import org.json.JSONObject;  // Requires org.json library

public class GetBalance {
    public static void main(String[] args) throws Exception {
        URL url = new URL("https://api.mobilemessage.com.au/v1/account");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        String credentials = Base64.getEncoder().encodeToString("user123:mypassword".getBytes());
        connection.setRequestProperty("Authorization", "Basic " + credentials);
        connection.setRequestMethod("GET");

        BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
        String inputLine;
        StringBuilder responseStr = new StringBuilder();
        while ((inputLine = in.readLine()) != null) {
            responseStr.append(inputLine);
        }
        in.close();

        JSONObject json = new JSONObject(responseStr.toString());
        int creditBalance = json.getInt("credit_balance");
        System.out.println("Credit Balance: " + creditBalance);
    }
}

using System;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json.Linq;  // Requires Newtonsoft.Json package

class Program {
    static async Task Main() {
        var client = new HttpClient();
        var byteArray = Encoding.ASCII.GetBytes("user123:mypassword");
        client.DefaultRequestHeaders.Authorization =
            new AuthenticationHeaderValue("Basic", Convert.ToBase64String(byteArray));

        var response = await client.GetAsync("https://api.mobilemessage.com.au/v1/account");
        var responseString = await response.Content.ReadAsStringAsync();
        var json = JObject.Parse(responseString);
        var creditBalance = json["credit_balance"];
        Console.WriteLine("Credit Balance: " + creditBalance);
    }
}

const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook-inbound', (req, res) => {
  const {
    to,
    message,
    sender,
    received_at,
    type,
    original_message_id,
    original_custom_ref
  } = req.body;

  console.log("Inbound Webhook Received:");
  console.log("  To:", to);
  console.log("  From:", sender);
  console.log("  Received At:", received_at);
  console.log("  Message:", message);
  console.log("  Type:", type);
  console.log("  Original Message ID:", original_message_id);
  console.log("  Original Custom Ref:", original_custom_ref);

  res.status(200).send("OK");
});

app.listen(3000, () => {
  console.log('Inbound webhook server listening on port 3000');
});

<?php
// Simple inbound webhook example in PHP
$rawData = file_get_contents('php://input');
$data = json_decode($rawData, true);

$to = $data['to'] ?? '';
$message = $data['message'] ?? '';
$sender = $data['sender'] ?? '';
$receivedAt = $data['received_at'] ?? '';
$type = $data['type'] ?? '';
$originalMessageId = $data['original_message_id'] ?? '';
$originalCustomRef = $data['original_custom_ref'] ?? '';

error_log("Inbound Webhook Received:");
error_log("  To: $to");
error_log("  From: $sender");
error_log("  Received At: $receivedAt");
error_log("  Message: $message");
error_log("  Type: $type");
error_log("  Original Message ID: $originalMessageId");
error_log("  Original Custom Ref: $originalCustomRef");

// Send a simple OK response
http_response_code(200);
echo "OK";

import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;

@RestController
public class InboundWebhookController {

    @PostMapping("/webhook-inbound")
    public ResponseEntity<String> handleInbound(@RequestBody InboundPayload payload) {
        System.out.println("Inbound Webhook Received:");
        System.out.println("  To: " + payload.getTo());
        System.out.println("  From: " + payload.getSender());
        System.out.println("  Received At: " + payload.getReceivedAt());
        System.out.println("  Message: " + payload.getMessage());
        System.out.println("  Type: " + payload.getType());
        System.out.println("  Original Message ID: " + payload.getOriginalMessageId());
        System.out.println("  Original Custom Ref: " + payload.getOriginalCustomRef());

        return ResponseEntity.ok("OK");
    }
}

// Example inbound payload model
class InboundPayload {
    private String to;
    private String message;
    private String sender;
    private String receivedAt;
    private String type;
    private String originalMessageId;
    private String originalCustomRef;

    // Getters and setters...
}

using Microsoft.AspNetCore.Mvc;
using System;

[ApiController]
[Route("webhook-inbound")]
public class InboundWebhookController : ControllerBase {
    [HttpPost]
    public IActionResult HandleInbound([FromBody] InboundPayload payload) {
        Console.WriteLine("Inbound Webhook Received:");
        Console.WriteLine($"  To: {payload.To}");
        Console.WriteLine($"  From: {payload.Sender}");
        Console.WriteLine($"  Received At: {payload.ReceivedAt}");
        Console.WriteLine($"  Message: {payload.Message}");
        Console.WriteLine($"  Type: {payload.Type}");
        Console.WriteLine($"  Original Message ID: {payload.OriginalMessageId}");
        Console.WriteLine($"  Original Custom Ref: {payload.OriginalCustomRef}");

        return Ok("OK");
    }
}

public class InboundPayload {
    public string To { get; set; }
    public string Message { get; set; }
    public string Sender { get; set; }
    public string ReceivedAt { get; set; }
    public string Type { get; set; }
    public string OriginalMessageId { get; set; }
    public string OriginalCustomRef { get; set; }
}

const express = require('express');
const app = express();
app.use(express.json());

app.post('/webhook-status', (req, res) => {
  const {
    to,
    message,
    sender,
    custom_ref,
    status,
    message_id,
    received_at,
    part_number,
    total_parts
  } = req.body;

  console.log("Status Webhook Received:");
  console.log("  To:", to);
  console.log("  From:", sender);
  console.log("  Received At:", received_at);
  console.log("  Message:", message);
  console.log("  Custom Ref:", custom_ref);
  console.log("  Status:", status);
  console.log("  Message ID:", message_id);
  console.log("  Part:", `${part_number}/${total_parts}`);

  res.status(200).send("OK");
});

app.listen(3000, () => {
  console.log('Status webhook server listening on port 3000');
});

<?php
$rawData = file_get_contents('php://input');
$data = json_decode($rawData, true);

$to = $data['to'] ?? '';
$message = $data['message'] ?? '';
$sender = $data['sender'] ?? '';
$customRef = $data['custom_ref'] ?? '';
$status = $data['status'] ?? '';
$messageId = $data['message_id'] ?? '';
$receivedAt = $data['received_at'] ?? '';
$partNumber = $data['part_number'] ?? 1;
$totalParts = $data['total_parts'] ?? 1;

error_log("Status Webhook Received:");
error_log("  To: $to");
error_log("  From: $sender");
error_log("  Received At: $receivedAt");
error_log("  Message: $message");
error_log("  Custom Ref: $customRef");
error_log("  Status: $status");
error_log("  Message ID: $messageId");
error_log("  Part: {$partNumber}/{$totalParts}");

http_response_code(200);
echo "OK";

import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;

@RestController
public class StatusWebhookController {

    @PostMapping("/webhook-status")
    public ResponseEntity<String> handleStatus(@RequestBody StatusPayload payload) {
        System.out.println("Status Webhook Received:");
        System.out.println("  To: " + payload.getTo());
        System.out.println("  From: " + payload.getSender());
        System.out.println("  Received At: " + payload.getReceivedAt());
        System.out.println("  Message: " + payload.getMessage());
        System.out.println("  Custom Ref: " + payload.getCustomRef());
        System.out.println("  Status: " + payload.getStatus());
        System.out.println("  Message ID: " + payload.getMessageId());
        System.out.println("  Part: " + payload.getPartNumber() + "/" + payload.getTotalParts());

        return ResponseEntity.ok("OK");
    }
}

// Example status payload model
class StatusPayload {
    private String to;
    private String message;
    private String sender;
    private String customRef;
    private String status;
    private String messageId;
    private String receivedAt;
    private Integer partNumber;
    private Integer totalParts;

    // Getters and setters...
}

using Microsoft.AspNetCore.Mvc;
using System;

[ApiController]
[Route("webhook-status")]
public class StatusWebhookController : ControllerBase {
    [HttpPost]
    public IActionResult HandleStatus([FromBody] StatusPayload payload) {
        Console.WriteLine("Status Webhook Received:");
        Console.WriteLine($"  To: {payload.To}");
        Console.WriteLine($"  From: {payload.Sender}");
        Console.WriteLine($"  Received At: {payload.ReceivedAt}");
        Console.WriteLine($"  Message: {payload.Message}");
        Console.WriteLine($"  Custom Ref: {payload.CustomRef}");
        Console.WriteLine($"  Status: {payload.Status}");
        Console.WriteLine($"  Message ID: {payload.MessageId}");
        Console.WriteLine($"  Part: {payload.PartNumber}/{payload.TotalParts}");

        return Ok("OK");
    }
}

public class StatusPayload {
    public string To { get; set; }
    public string Message { get; set; }
    public string Sender { get; set; }
    public string CustomRef { get; set; }
    public string Status { get; set; }
    public string MessageId { get; set; }
    public string ReceivedAt { get; set; }
    public int PartNumber { get; set; }
    public int TotalParts { get; set; }
}