Vai al contenuto principale

Panoramica della Copera Public API: autenticazione e tool

La Copera Public API è una REST API che ti consente di leggere e scrivere i dati del workspace in modo programmatico — board e righe, documenti, file del drive, channels, search, notifiche e metadati del workspace. Usala per costruire bot, automazioni, tool interni e integrazioni. Puoi anche aggiungere il widget web Omni al tuo sito e usare una server API key legata alla source per identificare in modo sicuro i visitatori autenticati.

  • Base URL: https://api.copera.ai/public/v1
  • Auth: Authorization: Bearer <token> (Personal Access Token, Integration API Key, token MCP OAuth, oppure la server API key Omni legata alla source accettata solo dall'endpoint identity-token)
  • Format: body JSON di request e response
suggerimento

Nuovo qui? Parti da Primi passi per creare un token e fare la prima richiesta, poi sfoglia Autenticazione per scegliere il tipo di token giusto.

Cosa puoi fare​

Boards​

Lavora con dati strutturati:

  • Elenca board e table
  • Recupera dettagli di board e table
  • Leggi e crea righe
  • Autentica righe e gestisci commenti
  • Cerca tra righe e dati di board

Documents​

Gestisci documenti rich text:

  • Crea, aggiorna ed elimina documenti
  • Leggi e scrivi contenuti come Markdown
  • Cerca tra i documenti
  • Naviga gli alberi dei documenti

Drive​

Storage e gestione file:

  • Sfoglia file e cartelle
  • Carica e scarica file
  • Crea cartelle
  • Cerca tra gli item del drive

Messaging​

Invia messaggi formattati ai channel del workspace per:

  • Notifiche e alert
  • Risposte di bot
  • Aggiornamenti di workflow
  • Lettura e gestione delle tue notifiche

Tool e SDK​

Node.js SDK
SDK TypeScript completo con copertura API totale
CLI
Gestisci boards, docs, drive e messaging dal terminale
GitHub Action
Invia notifiche dalle pipeline CI/CD

Requisiti​

Per usare l'API:

  1. Crea un'integrazione (o un Personal Access Token) nel workspace.
  2. Genera un token — un'Integration API Key (cp_key_…) o un Personal Access Token (cp_pat_…).
  3. Concedi gli scope di permesso — gli access_* rilevanti per ciò di cui hai bisogno (access_boards, access_channels, access_docs, access_drive, access_notifications, access_bookings).
  4. Aggiungi l'integrazione ai channel e alle board che deve raggiungere. Un token può agire solo sulle risorse a cui ha accesso.

Vedi Autenticazione per il dettaglio completo di tipi di token e scope.

Prossimi passi​

Usa la Copera Public API per:

  • Leggere e creare dati di board, righe e commenti
  • Gestire documenti e file del drive
  • Inviare messaggi e creare notifiche
  • Cercare nel workspace
  • Costruire integrazioni custom con SDK, CLI o GitHub Action