Desenvolvedores

O Nodaro é REST-first: o editor do Nodaro, o SDK para TypeScript e a CLI conversam com a mesma API HTTP, então tudo o que você faz no Nodaro pode ser automatizado com um token Bearer e uma requisição JSON. Esta seção documenta essa API, os clientes dela, as formas de autenticação e as formas de colocar o Nodaro dentro do seu próprio produto. Os assistentes de IA acessam os mesmos workflows e modelos pelo servidor MCP.

Três formas de acesso

O SDK usa fetch e URL, então funciona no Node.js 20 ou mais recente, em navegadores, no React Native, no Cloudflare Workers, no Deno e no Bun. A CLI é uma camada fina sobre o SDK: tudo o que a CLI faz, o SDK também faz.

A mesma chamada em cada um deles, executando um workflow salvo:

curl -s -X POST https://app.nodaro.ai/v1/workflows/8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f/run \
  -H "Authorization: Bearer $NODARO_API_KEY"
# {"executionId":"3f9e2b1a-…","status":"pending"}

import { createClient, StaticTokenAuth } from '@nodaro/sdk'

const client = createClient({
  baseUrl: 'https://app.nodaro.ai',
  auth: new StaticTokenAuth(process.env.NODARO_API_KEY!),
})

const { executionId } = await client.workflows.run('8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f')

nodaro auth login --token "$NODARO_API_KEY"
nodaro workflows run 8c2d7f1e-3a4b-4c5d-9e6f-7a8b9c0d1e2f --watch

Três coisas funcionam da mesma forma em todos eles:

• Execute qualquer coisa. Execute um workflow salvo, um app publicado ou um único nó com POST /v1/<node-type>, sem montar um workflow.
• Consulte os resultados periodicamente. As gerações levam de segundos a minutos, então uma execução devolve um id na hora, e você consulta periodicamente o job ou a execução dela. O SDK e a CLI podem esperar por você.
• Descubra sem token. GET /v1/nodes e GET /v1/models listam todos os nós e modelos, com as configurações e os preços em créditos.

Autenticação

Os tokens de API estão disponíveis no Nodaro Cloud e na Business edition. Uma instalação self-hosted também pode executar as suas gerações no Nodaro Cloud com um token de API pessoal, sem OAuth. Leia Autenticação e Apps OAuth.

Especificação OpenAPI

O servidor publica uma especificação OpenAPI 3.1 do núcleo da API em https://app.nodaro.ai/v1/openapi.json. A partir dela, gere um cliente tipado para Go, Rust, Python ou qualquer outra linguagem. Veja Especificação OpenAPI.

Para agentes de IA

• MCP. Adicione https://mcp.nodaro.ai/mcp como conector personalizado no Claude, no ChatGPT, no Cursor e em outros clientes MCP. O assistente entra com a sua conta do Nodaro e ganha ferramentas para gerar mídia, montar e executar workflows e gerenciar personagens e outras entidades. Veja Nodaro MCP.
• Skills para agentes. Arquivos de skill ensinam assistentes de programação, como o Claude Code e o Cursor, a usar o SDK e a criar um app OAuth. Veja Skills para agentes.

O Nodaro no seu produto

• Incorpore um app. Execute um app publicado do Nodaro a partir da sua própria interface web ou mobile. Veja Incorporações.
• Crie os seletores você mesmo. Os catálogos dos Controles criativos vêm como dados em @nodaro/prompts, então o seu app pode oferecer as mesmas opções e escrever os mesmos prompts. Veja Catálogos de seletores.
• Faça o login dos usuários com o seu provedor de identidade. Veja Login externo (SSO).
• Cobre pela sua própria carteira. Uma implantação pode autorizar os gastos de cada cliente pela própria carteira. Veja Carteiras externas.

Explore a documentação para desenvolvedores