SDK
Intégrez CurNext dans les apps que vous utilisez déjà
Limiter l'expérience à notre client ne suffit pas. Les SDK CurNext donnent à vos équipes la liberté d'étendre l'intelligence de maturité dans les applications, workflows et piles que vous opérez déjà.
Ce que vous pouvez construire
Les SDK encapsulent l'API REST versionnée. Créez une clé API projet, puis appelez maturité, projets, appareils, alertes, mesures et webhooks depuis votre propre pile. api.curnext.app/docs
Récupérer maturité et télémétrie
Récupérez maturité des surfaces, prédictions, appareils et dernières mesures dans des tableaux de bord ou rapports.
Automatiser les workflows chantier
Résolvez les alertes, listez les événements d'audit et pilotez les ops depuis scripts et outils internes.
Intégrer avec votre pile
Utilisez la même surface REST depuis des apps Node, PHP, Go, Python, Java ou Flutter que vous exécutez déjà.
Travailler avec les webhooks
Listez les points de terminaison webhook via le SDK. Créez et gérez les récepteurs dans le tableau de bord pour des événements comme SURFACE_READY, ALERT_CREATED et DEVICE_DISPLACED.
SDK
Official CurNext SDKs
Bibliothèques clientes officielles pour l'API REST CurNext. Choisissez un langage ci-dessous pour les étapes d'installation et les exemples.
JavaScript / TypeScript
DisponibleClient Fetch typé pour apps web, services Node et backends TypeScript qui ont besoin de maturité et de contexte projet.
@curnext/sdk
- Client typé
- Node et navigateurs
- Fetch API
Install
npm install @curnext/sdkQuick start
import { CurNext } from "@curnext/sdk";
const client = new CurNext({
apiKey: process.env.CURNEXT_API_KEY!,
// baseUrl par défaut : https://api.curnext.app
// baseUrl: "http://localhost:4000",
});
const health = await client.health.get();
// { status: "ok", service: "curnext-api", version: "...", api: "/api/v1" }
const { projects } = await client.projects.list();
const readiness = await client.projects.getReadiness("SURFACE_EXTERNAL_ID");
console.log(readiness.status, readiness.readiness_score);Error handling
import { CurNextApiError } from "@curnext/sdk";
try {
const readiness = await client.projects.getReadiness("SURFACE_ID");
console.log(readiness.status);
} catch (error) {
if (error instanceof CurNextApiError) {
// 401 clé invalide | 404 introuvable | 429 limité en débit
console.error(error.statusCode, error.message, error.code, error.body);
return;
}
throw error;
}Get started
API keys live in the product
Create a project API key (cn_live_...) under Integration, then authenticate with Bearer tokens. API access is available with your site subscription.