# Biblioteca oficială Python pentru Calisero este disponibilă

- Language: Romanian
- URL: https://calisero.ro/developer/knowledge-base/biblioteca-python-disponibila
- English version: https://calisero.ro/en/developers/knowledge-base/biblioteca-python-disponibila
- Published: 2026-10-24; last updated: 2026-10-24
- Summary: Biblioteca oficială Python pentru SMS prin Calisero: tipizată, fără dependențe, verificări OTP, opt-out și webhooks de livrare pentru Flask, Django și FastAPI.

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](https://calisero.ro/developer/knowledge-base/depanare-cu-trace-id).

**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:

```bash
pip install "calisero @ git+https://github.com/calisero/calisero-pyton.git@1.0.0"
```

Apoi trimiți primul mesaj cu cheia ta API:

```python
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](https://calisero.ro/developer/knowledge-base/manual-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](https://github.com/calisero/calisero-pyton), 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](https://calisero.ro/developer/knowledge-base/biblioteca-go-disponibila), [pagina de integrări](https://calisero.ro/developer/integrari) listează acum șase biblioteci oficiale: PHP, Laravel, Symfony, Node.js, Go și Python.