SDK Node.js
Le SDK officiel Node.js wrappe l'API REST avec un type-checking idiomatique. Toutes les actions du dashboard sont disponibles.
Installation
$ npm install @di2amp/sdk
Authentification
Toutes les requêtes se font avec un token API que vous générez dans le dashboard, onglet « API tokens ».
import { PaasClient } from '@di2amp/sdk';
const client = new PaasClient({ token: process.env.PAAS_API_TOKEN });
const client = new PaasClient({ token: process.env.PAAS_API_TOKEN });
Lister les apps
const apps = await client.apps.list();
console.log(apps);
Créer une app
const app = await 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.
const stream = await client.logs.stream({ app: 'monsite' });
for await (const line of stream) {
console.log(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-node
- Référence générée : Node.js API reference
- Changelog : Voir les versions