Uma função para enviar SMS em PHP, Python ou Node.js, com tempo limite e tratamento de erros

A resposta curta: escreva uma só função que envia o SMS e use-a em todo o sistema. Ela recebe o número, o texto e uma chave do evento, lê a chave da API de uma variável de ambiente, tem tempo limite, envia sempre Idempotency-Key e devolve o código HTTP e a resposta. A decisão de repetir fica num só sítio: repete-se com espera num 429 ou 5xx, nunca num 422.

Em PHP

function enviar_sms($numero, $texto, $chave_evento) {
$ch = curl_init('https://api.mozout.co.mz/v1/sms/messages');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('SMS_API_KEY'),
'Content-Type: application/json',
'Idempotency-Key: ' . $chave_evento,
],
CURLOPT_POSTFIELDS => json_encode(['number' => $numero, 'text' => $texto]),
]);
$corpo = curl_exec($ch);
$http = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return [$http, json_decode((string) $corpo, true)];
}

Em Python

import os, requests

def enviar_sms(numero, texto, chave_evento):
r = requests.post(
"https://api.mozout.co.mz/v1/sms/messages",
headers={"Authorization": "Bearer " + os.environ["SMS_API_KEY"],
"Idempotency-Key": chave_evento},
json={"number": numero, "text": texto},
timeout=30,
)
return r.status_code, r.json()

Em Node.js

async function enviarSms(numero, texto, chaveEvento) {
const r = await fetch("https://api.mozout.co.mz/v1/sms/messages", {
method: "POST",
headers: { "Authorization": "Bearer " + process.env.SMS_API_KEY,
"Content-Type": "application/json",
"Idempotency-Key": chaveEvento },
body: JSON.stringify({ number: numero, text: texto }),
signal: AbortSignal.timeout(30000),
});
return [r.status, await r.json()];
}

A chave_evento é o que torna a repetição segura: algo como pagamento-3381 ou encomenda-8812-saiu. Com o mesmo valor e o mesmo corpo, a API devolve a resposta guardada em vez de enviar outra vez.

O que fazer com a resposta