CurNext

SDK

Lleve CurNext a las apps que ya ejecuta

Restringir la experiencia a nuestro cliente no basta. Los SDK de CurNext dan a sus equipos la libertad de extender la inteligencia de madurez a las aplicaciones, flujos de trabajo y pilas que ya operan.

Qué puede construir

Los SDK encapsulan la API REST versionada. Cree una clave API de proyecto y luego llame madurez, proyectos, dispositivos, alertas, mediciones y webhooks desde su propia pila. api.curnext.app/docs

  • Obtener madurez y telemetría

    Traiga madurez de superficies, predicciones, dispositivos y últimas mediciones a paneles o informes.

  • Automatizar flujos de obra

    Resuelva alertas, liste eventos de auditoría e impulse ops desde scripts y herramientas internas.

  • Integrar con su pila

    Use la misma superficie REST desde apps Node, PHP, Go, Python, Java o Flutter que ya ejecuta.

  • Trabajar con webhooks

    Liste endpoints webhook vía SDK. Cree y gestione receptores en el panel para eventos como SURFACE_READY, ALERT_CREATED y DEVICE_DISPLACED.

SDK

Official CurNext SDKs

Bibliotecas cliente oficiales para la API REST de CurNext. Elija un lenguaje abajo para pasos de instalación y ejemplos.

JavaScript

JavaScript / TypeScript

Disponible

Cliente Fetch tipado para apps web, servicios Node y backends TypeScript que necesitan madurez y contexto de proyecto.

@curnext/sdk

  • Cliente tipado
  • Node y navegadores
  • 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 por defecto: 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 clave no válida | 404 no encontrado | 429 límite de tasa
    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.