Solidus Logic

Solidus Logic API Documentation

Integrate with our proxy API to send bulk SMS securely. All requests are forwarded to our main SMS provider using our internal credentials.

1. Authentication

All API requests must include both your API Key and Bearer Token in the headers.

Authorization: Bearer YOUR_BEARER_TOKEN
X-API-Key: YOUR_API_KEY
Content-Type: application/json

2. Endpoint Details

URL: http://localhost:3000/api/v1/sms/send

Method: POST

Deduction: Your balance is deducted only when the message is successfully submitted and validated by our upstream provider (Beem Africa).

3. Sending SMS (Python Example)

Use this Python script to send SMS via our Solidus Logic proxy.

import requests

def send_sms_via_proxy(phone_number, message):
    # Your local credentials from the dashboard
    API_KEY = 'YOUR_API_KEY'
    BEARER_TOKEN = 'YOUR_BEARER_TOKEN'
    
    URL = "http://localhost:3000/api/v1/sms/send"
    
    headers = {
        'Authorization': f'Bearer {BEARER_TOKEN}',
        'X-API-Key': API_KEY,
        'Content-Type': 'application/json'
    }

    data = {
        'recipient': phone_number,
        'message': message
    }
    
    try:
        response = requests.post(URL, json=data, headers=headers)
        return response.json()
    except Exception as e:
        print(f"❌ Connection Error: {e}")
        return None

4. Sending SMS (Node.js Example)

const axios = require('axios');

async function sendSMS(phoneNumber, message) {
    const API_KEY = 'YOUR_API_KEY';
    const BEARER_TOKEN = 'YOUR_BEARER_TOKEN';
    const URL = 'http://localhost:3000/api/v1/sms/send';

    try {
        const response = await axios.post(URL, {
            recipient: phoneNumber,
            message: message
        }, {
            headers: {
                'Authorization': `Bearer ${BEARER_TOKEN}`,
                'X-API-Key': API_KEY,
                'Content-Type': 'application/json'
            }
        });

        return response.data;
    } catch (error) {
        console.error('❌ SMS Error:', error.response ? error.response.data : error.message);
        return null;
    }
}

5. Testing with Postman

To test the API using Postman, follow these steps:

  1. Method: Set to POST
  2. URL: http://localhost:3000/api/v1/sms/send
  3. Headers:
    • Authorization: Bearer sl_token_5588_xyz789
    • X-API-Key: SL_API_KEY_922_ABC123
    • Content-Type: application/json
  4. Body: Select raw and JSON, then enter: 
    {
    "recipient": "07XXXXXXXX",
    "message": "Hello from Solidus Logic Proxy!"
}