டெவலப்பர்களுக்கான SMSlenz API ஒருங்கிணைப்பு வழிகாட்டி

பல தொடர்பு எண்களுக்கு SMS அனுப்ப இந்த எண்ட்பாயிண்டை நேரடியாகப் பயன்படுத்தவும்.

கோரிக்கை

URL: https://mail.smslenz.lk/api/send-bulk-sms

அளவுருக்கள்

மாதிரிக் கோரிக்கை உள்ளடக்கம் (POST · JSON)

{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "sender_id": "SMSlenzDEMO",
    "contacts": ["+9476XXXXXXX", "+9475XXXXXXX"],
    "message": "Welcome to bulk sms API!"
}

இந்த எண்ட்பாயிண்ட் POST மட்டுமே ஏற்கும் — உள்ளடக்கத்தை JSON ஆக (Content-Type: application/json) அல்லது சாதாரண form fields ஆக அனுப்பவும்.

குறியீட்டு எடுத்துக்காட்டுகள்

• cURL
• PHP
• JavaScript
• Python

curl -X POST "https://mail.smslenz.lk/api/send-bulk-sms" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "sender_id": "SMSlenzDEMO",
    "contacts": ["+9476XXXXXXX", "+9475XXXXXXX"],
    "message": "Welcome to bulk sms API!"
  }'

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://mail.smslenz.lk/api/send-bulk-sms");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'user_id'   => '12',
    'api_key'   => 'YOUR_API_KEY',
    'sender_id' => 'SMSlenzDEMO',
    'contacts'  => ['+9476XXXXXXX', '+9475XXXXXXX'],
    'message'   => 'Welcome to bulk sms API!',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

echo $response;

fetch("https://mail.smslenz.lk/api/send-bulk-sms", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        user_id: "12",
        api_key: "YOUR_API_KEY",
        sender_id: "SMSlenzDEMO",
        contacts: ["+9476XXXXXXX", "+9475XXXXXXX"],
        message: "Welcome to bulk sms API!"
    })
})
    .then(res => res.json())
    .then(data => console.log(data))
    .catch(err => console.error(err));

import requests

url = "https://mail.smslenz.lk/api/send-bulk-sms"
payload = {
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "sender_id": "SMSlenzDEMO",
    "contacts": ["+9476XXXXXXX", "+9475XXXXXXX"],
    "message": "Welcome to bulk sms API!"
}

response = requests.post(url, json=payload)
print(response.json())

பதில்

வெற்றிகரமான முயற்சியில் JSON பதிலைப் பெறுவீர்கள்.

Content-Type: application/json

உள்ளடக்கம்:

{
    "success": true,
    "message": "SMS sent successfully",
    "data": {
        "status": "success",
        "campaign_id": 43,
        "message": "Welcome to bulk sms API!",
        "sender_id": "SMSlenzDEMO",
        "pages": 1,
        "no_of_recipients": 2,
        "sms_credit_balance": "2,512.77",
        "charged_from": "main"
    }
}

sms_credit_balance என்பது sender ID கிரெடிட் பெறும் தொகுப்பின் மீதமுள்ள இருப்பு: sender ID-க்குச் செயலில் உள்ள கிரெடிட் ஒதுக்கீடு இருந்தால் அதன் ஒதுக்கப்பட்ட கிரெடிட், இல்லையெனில் உங்கள் முதன்மை இருப்பு. எது என்பதை charged_from காட்டும் (allocation அல்லது main).

உங்கள் கணக்கின் நிலையைச் சரிபார்க்க இந்த எண்ட்பாயிண்டைப் பயன்படுத்தவும்.

கோரிக்கை

URL: https://mail.smslenz.lk/api/account-status

அளவுருக்கள்

மாதிரிக் கோரிக்கை உள்ளடக்கம் (POST · JSON)

{
    "user_id": "12",
    "api_key": "YOUR_API_KEY"
}

மாதிரி GET கோரிக்கை URL

https://mail.smslenz.lk/api/account-status?user_id=12&api_key=YOUR_API_KEY

குறியீட்டு எடுத்துக்காட்டுகள்

• cURL
• PHP
• JavaScript
• Python

curl -X POST "https://mail.smslenz.lk/api/account-status" \
  -d "user_id=12" \
  -d "api_key=YOUR_API_KEY"

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://mail.smslenz.lk/api/account-status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'user_id' => '12',
    'api_key' => 'YOUR_API_KEY',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

echo $response;

fetch("https://mail.smslenz.lk/api/account-status", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        user_id: "12",
        api_key: "YOUR_API_KEY"
    })
})
    .then(res => res.json())
    .then(data => console.log(data))
    .catch(err => console.error(err));

import requests

url = "https://mail.smslenz.lk/api/account-status"
payload = {
    "user_id": "12",
    "api_key": "YOUR_API_KEY"
}

response = requests.post(url, data=payload)
print(response.json())

பதில்

வெற்றிகரமான முயற்சியில் JSON பதிலைப் பெறுவீர்கள்.

Content-Type: application/json

உள்ளடக்கம்:

{
    "success": true,
    "message": "Account status retrieved successfully",
    "data": {
        "status": "active",
        "sms_credit_balance": "2,515.72",
        "allocated_credit_total": "1,500.00",
        "sender_id_balances": [
            {
                "sender_id": "YOURBRAND",
                "allocated_balance": "1,500.00",
                "active": true
            }
        ],
        "active_plan": "Pay As You Go",
        "total_contacts": 3,115,
        "total_sender_ids": 6
    }
}

sms_credit_balance என்பது உங்கள் முதன்மை இருப்பு. sender_id_balances கிரெடிட் ஒதுக்கீடு உள்ள sender ID-களைப் பட்டியலிடுகிறது; active ஒதுக்கீடு உள்ள sender ID-க்கு அதன் ஒதுக்கப்பட்ட இருப்பிலிருந்து மட்டுமே கட்டணம் வசூலிக்கப்படும்.

SMS அனுப்பாமல் உங்கள் கணக்கில் ஒரு தொடர்பைச் சேர்க்க இந்த endpoint-ஐப் பயன்படுத்துங்கள். ஏற்கனவே உள்ள எண்ணைச் சேமிப்பது பாதுகாப்பானது: ஏற்கனவே உள்ள தொடர்பே உங்களுக்குத் திரும்பக் கிடைக்கும்.

கோரிக்கை

URL: https://mail.smslenz.lk/api/save-contact

அளவுருக்கள்

மாதிரிக் கோரிக்கை உள்ளடக்கம் (POST · JSON)

{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "contact": "+9476XXXXXXX",
    "name": "Kamal Perera",
    "group": "VIP Customers"
}

குறியீட்டு எடுத்துக்காட்டுகள்

• cURL
• PHP
• JavaScript
• Python

curl -X POST "https://mail.smslenz.lk/api/save-contact" \
  -d "user_id=12" \
  -d "api_key=YOUR_API_KEY" \
  --data-urlencode "contact=+9476XXXXXXX" \
  --data-urlencode "name=Kamal Perera" \
  --data-urlencode "group=VIP Customers"

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://mail.smslenz.lk/api/save-contact");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'user_id' => '12',
    'api_key' => 'YOUR_API_KEY',
    'contact' => '+9476XXXXXXX',
    'name'    => 'Kamal Perera',
    'group'   => 'VIP Customers',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

echo $response;

fetch("https://mail.smslenz.lk/api/save-contact", {
    method: "POST",
    headers: { "Content-Type": "application/json", "Accept": "application/json" },
    body: JSON.stringify({
        user_id: "12",
        api_key: "YOUR_API_KEY",
        contact: "+9476XXXXXXX",
        name: "Kamal Perera",
        group: "VIP Customers"
    })
})
    .then(res => res.json())
    .then(data => console.log(data))
    .catch(err => console.error(err));

import requests

url = "https://mail.smslenz.lk/api/save-contact"
payload = {
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "contact": "+9476XXXXXXX",
    "name": "Kamal Perera",
    "group": "VIP Customers"
}

response = requests.post(url, data=payload)
print(response.json())

பதில்

புதிய தொடர்பு உருவாக்கப்பட்டால் HTTP 201, எண் ஏற்கனவே உங்கள் தொடர்புகளில் இருந்தால் 200.

Content-Type: application/json

உள்ளடக்கம்:

{
    "success": true,
    "message": "Contact saved successfully",
    "data": {
        "contact_id": 1024,
        "name": "Kamal Perera",
        "phone": "+9476XXXXXXX",
        "created": true,
        "groups": ["All Contacts", "VIP Customers"]
    }
}

groups தொடர்பு சேர்ந்துள்ள அனைத்துக் குழுக்களையும் பட்டியலிடுகிறது.

பிழைகள்

உங்கள் சொந்த அமைப்பிலிருந்து SMS கிரெடிட்டை ரீலோட் செய்ய இந்த எண்ட்பாயிண்டைப் பயன்படுத்தவும். இது ஒரு கட்டண இணைப்பை உருவாக்குகிறது; பணம் செலுத்துபவர் (நீங்கள், உங்கள் ஊழியர்கள் அல்லது உங்கள் வாடிக்கையாளர்) அதைத் திறந்து PayHere-இன் பாதுகாப்பான checkout-இல் அட்டை மூலம் செலுத்துவார். அட்டை விவரங்கள் உங்கள் அல்லது எங்கள் அமைப்பின் வழியாகச் செல்வதில்லை.

இது எவ்வாறு செயல்படுகிறது

1. இந்த எண்ட்பாயிண்டை அழையுங்கள். உங்களுக்கு ஒரு order_id மற்றும் ஒரு payment_url கிடைக்கும்.
2. payment_url-ஐ உலாவியில் திறக்கவும், அல்லது உங்கள் பயனரை அதற்குத் திருப்பிவிடவும். அது அவர்களை அட்டை checkout-க்கு அழைத்துச் செல்லும். SMSlenz உள்நுழைவு தேவையில்லை.
3. முடிவைப் பெறுங்கள்: callback_url ஒன்றை வழங்கினால் அதை உங்கள் சேவையகத்திற்கு POST செய்வோம் (கட்டண கால்பேக்குகள் பார்க்கவும்), அல்லது கட்டண நிலையைச் சரிபார்க்கவும். பணம் செலுத்தப்பட்டவுடன் கிரெடிட் உங்கள் கணக்கில் சேர்க்கப்படும்.

கோரிக்கை

URL: https://mail.smslenz.lk/api/reload-credit

அளவுருக்கள்

மாதிரிக் கோரிக்கை உள்ளடக்கம் (POST · JSON)

{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "amount": 5000,
    "sender_id": "YOURBRAND",
    "client_reference": "INV-1001",
    "return_url": "https://example.com/payment-complete",
    "callback_url": "https://example.com/smslenz-callback"
}

இந்த எண்ட்பாயிண்ட் POST மட்டுமே ஏற்கும் — உள்ளடக்கத்தை JSON ஆக (Content-Type: application/json) அல்லது சாதாரண form fields ஆக அனுப்பவும்.

குறியீட்டு எடுத்துக்காட்டுகள்

• cURL
• PHP
• JavaScript
• Python

curl -X POST "https://mail.smslenz.lk/api/reload-credit" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "amount": 5000,
    "client_reference": "INV-1001",
    "callback_url": "https://example.com/smslenz-callback"
  }'

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://mail.smslenz.lk/api/reload-credit");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'user_id'          => '12',
    'api_key'          => 'YOUR_API_KEY',
    'amount'           => 5000,
    'client_reference' => 'INV-1001',
    'callback_url'     => 'https://example.com/smslenz-callback',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

// Save $response['data']['order_id'], then send the payer to checkout:
header('Location: ' . $response['data']['payment_url']);

fetch("https://mail.smslenz.lk/api/reload-credit", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        user_id: "12",
        api_key: "YOUR_API_KEY",
        amount: 5000,
        client_reference: "INV-1001",
        callback_url: "https://example.com/smslenz-callback"
    })
})
    .then(res => res.json())
    .then(data => {
        // Save data.data.order_id, then open checkout
        window.location.href = data.data.payment_url;
    })
    .catch(err => console.error(err));

import requests

url = "https://mail.smslenz.lk/api/reload-credit"
payload = {
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "amount": 5000,
    "client_reference": "INV-1001",
    "callback_url": "https://example.com/smslenz-callback"
}

data = requests.post(url, json=payload).json()
print(data["data"]["order_id"], data["data"]["payment_url"])

பதில்

புதிய இணைப்பு உருவாக்கப்படும்போது 201 நிலையுடனும், client_reference ஏற்கனவே உள்ள ஒன்றுடன் பொருந்தும்போது 200 நிலையுடனும் JSON பதிலைப் பெறுவீர்கள்.

Content-Type: application/json

உள்ளடக்கம்:

{
    "success": true,
    "message": "Payment link created",
    "data": {
        "order_id": "PRU3FTX7HUJP8RAHY4",
        "amount": "5,000.00",
        "status": "pending",
        "last_attempt": null,
        "client_reference": "INV-1001",
        "sender_id": "YOURBRAND",
        "allocation_status": null,
        "callback_url": "https://example.com/smslenz-callback",
        "expires_at": "2026-10-08T15:30:00+05:30",
        "paid_at": null,
        "payment_url": "https://mail.smslenz.lk/pay/PRU3FTX7HUJP8RAHY4?signature=3f9c…"
    }
}

• payment_url 60 நிமிடங்களுக்கு (expires_at வரை) செயல்படும். கட்டணம் ரத்து செய்யப்பட்டால் அல்லது நிராகரிக்கப்பட்டால், மீண்டும் முயற்சிக்க அதே இணைப்பைத் திறக்கலாம்.
• return_url இருந்தால், பணம் செலுத்துபவர் ?order_id=…&status=… சேர்க்கப்பட்டு அதற்குத் திருப்பி அனுப்பப்படுவார். அதை ஒரு குறிப்பாக மட்டுமே கருதுங்கள்: அதன் அடிப்படையில் செயல்படுவதற்கு முன் உங்கள் கால்பேக் அல்லது கட்டண நிலையை நம்புங்கள்.

பிழைகள்

கிரெடிட் ரீலோட் கட்டணம் முடிந்ததா என்பதைச் சரிபார்க்க இந்த எண்ட்பாயிண்டைப் பயன்படுத்தவும். நீங்கள் callback_url பயன்படுத்தவில்லை என்றால், பணம் செலுத்துபவர் checkout-இலிருந்து திரும்பிய பின் சரிபார்த்து, நிலை paid அல்லது expired ஆகும் வரை சில விநாடிகளுக்கு ஒருமுறை சரிபார்க்கவும்.

கோரிக்கை

URL: https://mail.smslenz.lk/api/payment-status

அளவுருக்கள்

மாதிரிக் கோரிக்கை உள்ளடக்கம் (POST · JSON)

{
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "order_id": "PRU3FTX7HUJP8RAHY4"
}

குறியீட்டு எடுத்துக்காட்டுகள்

• cURL
• PHP
• JavaScript
• Python

curl -X POST "https://mail.smslenz.lk/api/payment-status" \
  -d "user_id=12" \
  -d "api_key=YOUR_API_KEY" \
  -d "order_id=PRU3FTX7HUJP8RAHY4"

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://mail.smslenz.lk/api/payment-status");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'user_id'  => '12',
    'api_key'  => 'YOUR_API_KEY',
    'order_id' => 'PRU3FTX7HUJP8RAHY4',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = json_decode(curl_exec($ch), true);
curl_close($ch);

if ($response['data']['status'] === 'paid') {
    // Credit has been added to your account
}

fetch("https://mail.smslenz.lk/api/payment-status", {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
        user_id: "12",
        api_key: "YOUR_API_KEY",
        order_id: "PRU3FTX7HUJP8RAHY4"
    })
})
    .then(res => res.json())
    .then(data => console.log(data.data.status))
    .catch(err => console.error(err));

import requests

url = "https://mail.smslenz.lk/api/payment-status"
payload = {
    "user_id": "12",
    "api_key": "YOUR_API_KEY",
    "order_id": "PRU3FTX7HUJP8RAHY4"
}

response = requests.post(url, data=payload)
print(response.json()["data"]["status"])

பதில்

வெற்றிகரமான முயற்சியில் JSON பதிலைப் பெறுவீர்கள்.

Content-Type: application/json

உள்ளடக்கம்:

{
    "success": true,
    "message": "Payment status retrieved successfully",
    "data": {
        "order_id": "PRU3FTX7HUJP8RAHY4",
        "amount": "5,000.00",
        "status": "paid",
        "last_attempt": null,
        "client_reference": "INV-1001",
        "sender_id": "YOURBRAND",
        "allocation_status": "allocated",
        "callback_url": "https://example.com/smslenz-callback",
        "expires_at": "2026-10-08T15:30:00+05:30",
        "paid_at": "2026-10-08T14:42:10+05:30",
        "callback_status": "delivered",
        "sms_credit_balance": "2,515.72",
        "sender_id_balance": "6,500.00"
    }
}

தெரியாத order ID-கள் மற்றும் வேறொரு கணக்கிற்குச் சொந்தமான ஆர்டர்கள் 404-ஐத் தரும்.

கிரெடிட் ரீலோட்-க்கு callback_url ஒன்றை வழங்குங்கள், அந்தக் கட்டணம் செலுத்தப்படும்போது அல்லது அதன் இணைப்பு காலாவதியாகும்போது முடிவை உங்கள் சேவையகத்திற்கு POST செய்வோம், எனவே கட்டண நிலையை மீண்டும் மீண்டும் சரிபார்க்க வேண்டியதில்லை. ஒவ்வொரு கட்டணத்திற்கும் வெவ்வேறு callback_url பயன்படுத்தலாம்.

நிகழ்வுகள்

நாங்கள் அனுப்புவது

JSON உள்ளடக்கத்துடன் (Content-Type: application/json) இந்த headers கொண்ட ஒரு POST:

{
    "event": "payment.paid",
    "event_id": "evt_01k6ztg3m8q2v7r4c1x9n5b0wd",
    "created_at": "2026-10-08T14:42:11+05:30",
    "data": {
        "order_id": "PRU3FTX7HUJP8RAHY4",
        "amount": "5,000.00",
        "status": "paid",
        "last_attempt": null,
        "client_reference": "INV-1001",
        "sender_id": "YOURBRAND",
        "allocation_status": "allocated",
        "callback_url": "https://example.com/smslenz-callback",
        "expires_at": "2026-10-08T15:30:00+05:30",
        "paid_at": "2026-10-08T14:42:10+05:30",
        "sms_credit_balance": "2,515.72",
        "sender_id_balance": "6,500.00"
    }
}

data-வில் கட்டண நிலை பதிலில் உள்ள அதே புலங்கள் இருக்கும்.

பதிலளித்தல்

• 10 விநாடிகளுக்குள் ஏதேனும் 2xx நிலையுடன் பதிலளியுங்கள். நேரம் எடுக்கும் வேலைகளைப் பதிலளித்த பின் செய்யுங்கள்.
• வேறு எந்தப் பதிலும் 1 நிமிடம், 5 நிமிடங்கள், 30 நிமிடங்கள், 2 மணிநேரம் மற்றும் 6 மணிநேரத்திற்குப் பின் மீண்டும் முயற்சிக்கப்படும், பின்னர் நிறுத்துவோம். Redirects பின்பற்றப்படாது.
• ஒரே நிகழ்வு ஒன்றுக்கு மேற்பட்ட முறை வரலாம். ஒவ்வொரு event_id-ஐயும் ஒருமுறை மட்டுமே செயல்படுத்துங்கள்.
• கட்டண நிலையே எப்போதும் நம்பகமான தகவல் மூலம், எனவே கால்பேக் வரவில்லை என்றாலும் அதைச் சரிபார்க்கலாம்.

கால்பேக்கைச் சரிபார்த்தல்

v1 கையொப்பம் என்பது உங்கள் API key-ஐ விசையாகக் கொண்டு {t}.{raw request body}-இன் HMAC-SHA256 ஆகும். அதை நீங்களே கணக்கிட்டு ஒப்பிடுங்கள்; t 5 நிமிடங்களுக்கு மேல் பழையதாக உள்ள கால்பேக்குகளையும் நிராகரியுங்கள். உங்கள் API key-ஐப் புதுப்பித்தால், அதன் பின் அனுப்பப்படும் கால்பேக்குகள் புதிய key மூலம் கையொப்பமிடப்படும்.

• PHP
• Node.js
• Python

<?php
$body = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_SMSLENZ_SIGNATURE'] ?? ''), $sig);

$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $body, 'YOUR_API_KEY');

if (! hash_equals($expected, $sig['v1'] ?? '') || abs(time() - (int) ($sig['t'] ?? 0)) > 300) {
    http_response_code(400);
    exit;
}

$event = json_decode($body, true);
// Skip $event['event_id'] if you've already processed it, then:
if ($event['event'] === 'payment.paid') {
    // $event['data']['order_id'] is paid
}

http_response_code(200);

const crypto = require("crypto");
const express = require("express");
const app = express();

// Use the raw body: the signature covers the exact bytes we sent.
app.post("/smslenz-callback", express.raw({ type: "application/json" }), (req, res) => {
    const sig = Object.fromEntries(
        (req.get("X-SMSlenz-Signature") || "").split(",").map(part => part.split("="))
    );
    const expected = crypto.createHmac("sha256", "YOUR_API_KEY")
        .update(`${sig.t}.${req.body}`)
        .digest("hex");

    const valid = sig.v1 && sig.v1.length === expected.length
        && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1))
        && Math.abs(Date.now() / 1000 - Number(sig.t)) <= 300;
    if (!valid) return res.sendStatus(400);

    const event = JSON.parse(req.body);
    // Skip event.event_id if you've already processed it, then handle event.event
    res.sendStatus(200);
});

import hashlib, hmac, json, time
from flask import Flask, abort, request

app = Flask(__name__)

@app.post("/smslenz-callback")
def smslenz_callback():
    body = request.get_data()  # raw bytes, exactly as sent
    sig = dict(part.split("=", 1) for part in request.headers.get("X-SMSlenz-Signature", "").split(",") if "=" in part)

    expected = hmac.new(b"YOUR_API_KEY", f"{sig.get('t')}.".encode() + body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, sig.get("v1", "")) or abs(time.time() - int(sig.get("t", 0))) > 300:
        abort(400)

    event = json.loads(body)
    # Skip event["event_id"] if you've already processed it, then handle event["event"]
    return "", 200