SDK Python
Le SDK officiel Python wrappe l'API REST avec un type-checking idiomatique. Toutes les actions du dashboard sont disponibles.
Installation
$ pip install di2amp
Authentification
Toutes les requêtes se font avec un token API que vous générez dans le dashboard, onglet « API tokens ».
from di2amp import PaasClient
client = PaasClient( token=os.environ["PAAS_API_TOKEN"] )
client = PaasClient( token=os.environ["PAAS_API_TOKEN"] )
Lister les apps
apps = client.apps.list()
for app in apps:
print(app.name, app.url)
Créer une app
app = client.apps.create(
name="monsite",
region="fr-1"
)
Streaming des logs
Les logs en temps réel arrivent via un stream Server-Sent Events. Le SDK le wrappe pour rester idiomatique.
for line in client.logs.stream(app="monsite"):
print(line)
Gestion des erreurs
Toutes les erreurs renvoyées par l'API sont mappées en exceptions typées. Vous catchez par catégorie : AuthError, RateLimitError, NotFoundError, ValidationError, ServerError.
Code source et référence complète
Le SDK est open source (Apache 2.0). Bug, suggestion, ou contribution : sur le repo GitHub.
- Repo : github.com/di2amp/sdk-python
- Référence générée : Python API reference
- Changelog : Voir les versions