CurNext

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

JavaScript / TypeScript

Disponible

Client 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/sdk

Quick 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.