SDK do API SMS: Node.js, Python, PHP, curl

Cztery drogi do pierwszego SMS-a

Ustaw klucz API w zmiennej środowiskowej PRZYPOMINAMY_API_KEY (klucz testowy pk_test_… dostajesz od razu po rejestracji, produkcyjny pk_live_… po pierwszym doładowaniu) i wybierz język.

npm install przypominamy

import { Przypominamy } from 'przypominamy';

const sms = new Przypominamy(process.env.PRZYPOMINAMY_API_KEY);
const msg = await sms.send({
  to: '+48600123456',
  text: 'Przypominamy o wizycie jutro o 14:00.',
  reference: 'wizyta-4521',
});
console.log(msg.id, msg.status, msg.parts); // msg_… queued 1

pip install przypominamy

import os
from przypominamy import Przypominamy

sms = Przypominamy(os.environ["PRZYPOMINAMY_API_KEY"])
msg = sms.send(
    "+48600123456",
    "Przypominamy o wizycie jutro o 14:00.",
    reference="wizyta-4521",
)
print(msg["id"], msg["status"], msg["parts"])

Skopiuj klasę Przypominamy z artykułu /blog/api-sms-php do pliku Przypominamy.php

<?php
require __DIR__ . '/Przypominamy.php'; // klasa z /blog/api-sms-php

$sms = new Przypominamy(getenv('PRZYPOMINAMY_API_KEY'));
$msg = $sms->send('+48600123456', 'Przypominamy o wizycie jutro o 14:00.', [
    'reference'       => 'wizyta-4521',
    'idempotency_key' => 'wizyta-4521-przypomnienie',
]);
echo $msg['id'], ' ', $msg['status'], ' ', $msg['parts'], PHP_EOL;

curl https://api.przypominamy.com/v1/messages \
  -H "Authorization: Bearer $PRZYPOMINAMY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wizyta-4521-przypomnienie" \
  -d '{
    "to": "+48600123456",
    "text": "Przypominamy o wizycie jutro o 14:00.",
    "reference": "wizyta-4521"
  }'

Co dostajesz w odpowiedzi

Konektory no-code

Nie każdy SMS wymaga kodu. Jeśli Twoje dane żyją w Google Sheets, sklepie, kalendarzu albo CRM, jeden moduł HTTP w narzędziu do automatyzacji wystarczy. Na każdej stronie integracji znajdziesz gotowy workflow do importu.

Konektory używają tego samego klucza API i tych samych stawek co SDK. Limit 120 żądań na minutę dotyczy konta, nie narzędzia.

Inne języki: Go, Java, C#, Ruby, Rust, Kotlin

Nie publikujemy dla nich paczek, ale dla każdego mamy kompletny przewodnik z klientem na bibliotece standardowej lub popularnym kliencie HTTP, obsługą błędów po error.code, retry z Idempotency-Key i weryfikacją podpisu webhooka w stałym czasie.

Webhooki: weryfikacja podpisu

Adres ustawiasz przez PUT /v1/account/webhook; w odpowiedzi dostajesz webhook_secret. Przy każdej zmianie statusu wysyłamy POST z JSON-em o zdarzeniu message.sent, message.delivered, message.undelivered, message.failed lub message.expired. Nagłówek X-Przypominamy-Signature: t=<unix>,v1=<hex>, gdzie v1 = HMAC-SHA256(webhook_secret, "<t>.<surowe body>"). Odrzucaj, gdy podpis się nie zgadza lub t jest starsze niż 5 minut. Zawsze licz HMAC na surowym body, nie na sparsowanym JSON-ie.

import { createHmac, timingSafeEqual } from 'node:crypto';

export function verify(rawBody, header, secret) {
  const m = /t=(\d+),v1=([0-9a-f]{64})/.exec(header ?? '');
  if (!m) return false;
  const [, t, sig] = m;
  if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
  const expected = createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
  return timingSafeEqual(Buffer.from(sig, 'hex'), Buffer.from(expected, 'hex'));
}
// lub: import { verifyWebhook } from 'przypominamy';

import hmac, hashlib, re, time

def verify(raw_body: bytes, header: str, secret: str) -> bool:
    m = re.match(r"t=(\d+),v1=([0-9a-f]{64})", header or "")
    if not m:
        return False
    t, sig = m.groups()
    if abs(time.time() - int(t)) > 300:
        return False
    expected = hmac.new(secret.encode(), f"{t}.".encode() + raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(sig, expected)
# lub: from przypominamy import verify_webhook

<?php
function verify(string $rawBody, ?string $header, string $secret): bool {
    if (!preg_match('/t=(\d+),v1=([0-9a-f]{64})/', $header ?? '', $m)) return false;
    [, $t, $sig] = $m;
    if (abs(time() - (int)$t) > 300) return false;
    $expected = hash_hmac('sha256', "$t.$rawBody", $secret);
    return hash_equals($expected, $sig);
}
$ok = verify(file_get_contents('php://input'), $_SERVER['HTTP_X_PRZYPOMINAMY_SIGNATURE'] ?? null, getenv('PRZYPOMINAMY_WEBHOOK_SECRET'));

Odpowiadaj 200 od razu i przetwarzaj zdarzenie w tle. Jeśli endpoint nie odpowie w kilka sekund lub zwróci błąd, ponawiamy dostarczenie z rosnącym odstępem; obsłuż więc duplikaty po id wiadomości i wartości statusu.

Częste pytania o SDK