Come chiamare l'API Worknano
Sta nella documentazione, non come tab Config né come voce di menu a parte. Ogni modulo, la stessa forma HTTP: task, deal, contact o un modello che aggiungi dopo.
Il lavoro quotidiano sul prodotto resta nell'app. Usa questo quando un altro sistema deve leggere o scrivere un record. Dentro lo spazio, un passo di workflow chiama un endpoint. Chiavi in Secrets.
Leggere e elencare
- Leggere un record:
GET /api/v1/object/task/123. Cambiataskcon il modello e123con l'id. - Elencare:
GET /api/v1/objects/task?status=ACTIVE&_limit=50. Filtra con campi query che il modello ha già. - Uguale per
deal,contacto qualsiasi altro modello. Non impari un path nuovo per modulo.
Creare, aggiornare, cancellare
- Creare:
POST /api/v1/object/taskcon un body JSON dei campi che vuoi impostare. - Aggiornare:
PATCH /api/v1/object/taskcon l'id e i campi cambiati. - Cancellare:
DELETE /api/v1/object/task/123.
Non inventare un verbo o un path nuovo per ticket, idee o un modello aggiunto in Config. Cambia il nome del modello. Usa campi che esistono. Vedi Modelli.
Come si collega all'app
- Apri Config → Integrations. Imposta URL, metodo e auth. Il mapping del body e della risposta sta sul passo di workflow.
- Sul record, clicca l'azione ⋮ che esegue quel workflow. Niente handler one-off su una pagina.
- Se il passo fallisce, apri il log API sulla stessa schermata Integrations. Vedi request, response, stato e durata.
- Le chiavi API restano in Secrets, non sulla pagina.
Per far lavorare nel workspace app di IA come Claude, Cursor o Codex, vedi MCP.