Biblioteca oficială Python pentru Calisero este publicată și gata de folosit în producție. Acoperă tot API-ul — mesaje, verificări OTP, opt-out și detaliile contului — pentru orice aplicație Python, de la un proiect Django la un script care rulează periodic.
Ce include
Complet tipizată. Tipurile sunt incluse în pachet (py.typed) și verificate cu mypy --strict. Editorul îți completează fiecare parametru și fiecare câmp din răspunsul API-ului.
Fără dependențe. Clientul HTTP este urllib, din biblioteca standard: nimic de instalat în plus, nimic de auditat.
Modele imuabile. Răspunsurile sunt dataclass-uri înghețate, cu exact numele câmpurilor din API.
OTP în două apeluri. Pornești o verificare, apoi validezi codul introdus de utilizator. Calisero generează, trimite și verifică codul, așa că aplicația ta nu îl stochează niciodată.
Webhooks de livrare. DeliveryWebhookHandler citește și validează fiecare raport de livrare și îl predă codului tău, cu exemple gata făcute pentru Flask, Django, FastAPI sau orice server WSGI. Un token secret opțional în adresa de callback respinge cererile care nu îl conțin.
Erori clare. Fiecare tip de eșec are propria excepție, cu mesajul API-ului și trace ID-ul cererii — cel cu care depanezi orice cerere.
Ora României, gestionată. Transmiți un datetime cu fus orar ca să programezi un mesaj, iar biblioteca îl convertește în fusul orar pe care îl așteaptă API-ul.
Scurtarea link-urilor. Activezi scurtarea link-urilor pentru un mesaj și urmărești click-urile pe ele.
Cum începi
Instalezi pachetul direct din GitHub:
pip install "calisero @ git+https://github.com/calisero/[email protected]"
Apoi trimiți primul mesaj cu cheia ta API:
import os
from calisero import SmsClient
client = SmsClient.create(os.environ["CALISERO_API_KEY"])
message = client.messages.create(
recipient="+40742123456",
body="Comanda ta a fost expediata si ajunge maine.",
).data
print(message.id, message.status)
Cu o cheie API de sandbox încerci fiecare apel fără să trimiți sau să plătești mesaje reale.
Biblioteca are nevoie de Python 3.10 sau mai nou și este testată pe Python 3.10–3.14, pe Linux, macOS și Windows. Codul sursă este public pe GitHub, cu exemple care rulează pentru fiecare operație.
Păstrează cheia API pe server: biblioteca este făcută pentru cod care rulează pe server, niciodată într-un browser sau într-o aplicație mobilă.
Toate bibliotecile oficiale
Odată cu Python și Go, pagina de integrări listează acum șase biblioteci oficiale: PHP, Laravel, Symfony, Node.js, Go și Python.
