Sender ID

• Getting Started
• Get Sender IDs
• Headers
• Success Responses
• Error Responses
• Sample Code
  • PHP
  • Node JS
  • Curl
  • Javascript
  • Python
  • Go Native

Introduction

Techspace Softwares SMS offers you an API endpoint that you can quickly plug into your existing system with our bulk SMS platform. Seamlessly send bulk SMS to your clients with less hassle.

Get Sender IDs

This endpoint retrieves the sender IDs associated with the authenticated user.

Headers

Note: These are example values. Please obtain your actual API key and client ID from the portal. Visit the portal, go to Settings, then API Keys, and generate your keys.

Sample Responses

Success (200 OK)

Returns a JSON object containing an array of sender IDs.

{
    "sender_ids": [
        "cdlkes",
        "GIShu",
        "GIScsdfsfs",
        "Techspacess",
        "dbjfbjhbf",
        "GISKE"
    ]
}

Error (404 Not Found)

If no sender IDs are found for the user, returns an error message.

{
    "error": "No active sender IDs found for the user"
}

Error (401 Unauthorized)

If the provided API credentials are invalid, returns an error message.

{
    "error": "Invalid API credentials"
}

Examples

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://app.techspace.co.ke/api/v1/sender-id',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'api-key: szrgh88Z62Ne828RcXM1sCRbFEfm42St',
    'client-id: F2ikqLLEA9EsmWyTzeEAsjln0avMxTix'
  ),
));

$response = curl_exec($curl);

curl_close($curl);

echo $response;
?>

Node JS

var axios = require('axios');

var config = {
  method: 'get',
maxBodyLength: Infinity,
  url: 'https://app.techspace.co.ke/api/v1/sender-id',
  headers: { 
    'api-key': 'szrgh88Z62Ne828RcXM1sCRbFEfm42St', 
    'client-id': 'F2ikqLLEA9EsmWyTzeEAsjln0avMxTix'
  }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Curl

curl --location 'https://app.techspace.co.ke/api/v1/sender-id' \
--header 'api-key: szrgh88Z62Ne828RcXM1sCRbFEfm42St' \
--header 'client-id: F2ikqLLEA9EsmWyTzeEAsjln0avMxTix'

Javascript

var myHeaders = new Headers();
myHeaders.append("api-key", "szrgh88Z62Ne828RcXM1sCRbFEfm42St");
myHeaders.append("client-id", "F2ikqLLEA9EsmWyTzeEAsjln0avMxTix");

var requestOptions = {
  method: 'GET',
  headers: myHeaders,
  redirect: 'follow'
};

fetch("https://app.techspace.co.ke/api/v1/sender-id", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Python

import http.client

conn = http.client.HTTPSConnection("app.techspace.co.ke")
payload = ''
headers = {
  'api-key': 'szrgh88Z62Ne828RcXM1sCRbFEfm42St',
  'client-id': 'F2ikqLLEA9EsmWyTzeEAsjln0avMxTix'
}
conn.request("GET", "/api/v1/sender-id", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Go Native

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://app.techspace.co.ke/api/v1/sender-id"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("api-key", "szrgh88Z62Ne828RcXM1sCRbFEfm42St")
  req.Header.Add("client-id", "F2ikqLLEA9EsmWyTzeEAsjln0avMxTix")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}