Erste Schritte

Dieser Leitfaden führt Sie von null bis zur ersten authentifizierten Anfrage: Token erstellen, Basis-URL setzen und die API aufrufen.

Voraussetzungen

• Zugriff auf einen Workspace, der für die Public API freigeschaltet ist.
• Berechtigung, in diesem Workspace Tokens zu erstellen.
• Grundkenntnisse der Copera-Ressourcen — Boards, Tabellen, Zeilen, Channels, Dokumente.

Schritt 1 — Personal Access Token erstellen

Ein Personal Access Token (PAT, Präfix cp_pat_) authentifiziert die API als Sie und schaltet die gesamte API-Oberfläche frei. Das ist der einfachste Einstieg.

Workspace-Einstellungen öffnen

Gehen Sie zu Workspace-Einstellungen → Integrationen.

Tab Personal Tokens öffnen

Wählen Sie Personal Tokens, dann Create new token.

Benennen, Scopes setzen, Ablaufdatum wählen

Geben Sie dem Token einen Namen, wählen Sie die benötigten Scopes und setzen Sie ein Ablaufdatum (bis zu 1 Jahr).

Token jetzt kopieren

Das Token wird nur einmal angezeigt. Kopieren Sie es sofort und speichern Sie es in einem Secret Manager oder einer Umgebungsvariable.

warnung

Behandeln Sie Tokens wie Passwörter. Committen Sie sie niemals in die Versionskontrolle. Bei einem Leak löschen Sie das Token und erstellen Sie ein neues.

Die vollständige Aufschlüsselung der Token-Typen und Scopes finden Sie unter Authentifizierung.

Schritt 2 — Basis-URL setzen

Alle Endpunkte liegen unter:

https://api.copera.ai/public/v1

Jede Anfrage muss Ihr Token im Header Authorization mit dem Schema Bearer enthalten:

Authorization: Bearer cp_pat_your_token_here

Schritt 3 — Erste Anfrage senden

Diese listet die Boards auf, auf die Ihr Token zugreifen kann.

curl

curl https://api.copera.ai/public/v1/board/list-boards \
  -H "Authorization: Bearer cp_pat_your_token_here"

JavaScript

const res = await fetch(
  "https://api.copera.ai/public/v1/board/list-boards",
  {
    headers: {
      Authorization: "Bearer cp_pat_your_token_here",
    },
  },
);

if (!res.ok) {
  const error = await res.json();
  throw new Error(`${res.status}: ${error.message}`);
}

const boards = await res.json();
console.log(boards);

Eine 200-Antwort liefert JSON. Ein 401 bedeutet, dass das Token fehlt, fehlerhaft oder abgelaufen ist — siehe Authentifizierung. Andere Fehler folgen dem gemeinsamen Fehler-Schema.

Schritt 4 — Nachricht senden (optional)

Wenn Ihr Token den Scope access_channels hat, können Sie in einen Channel posten:

curl -X POST \
  https://api.copera.ai/public/v1/chat/channel/{channelId}/send-message \
  -H "Authorization: Bearer cp_pat_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Hello from my integration!" }'

tipp

Aktivieren Sie den Developer Mode, um Ressourcen-IDs (Channel, Board, Tabelle, Spalte) direkt aus der Copera-Oberfläche zu kopieren — ohne Netzwerk-Inspektion.

Nächste Schritte

• Authentifizierung — Token-Typen, Scopes und Sicherheit.
• Paginierung — wie List-Endpunkte Ergebnisse seitenweise liefern.
• Fehlerbehandlung — Statuscodes und Wiederherstellung.
• Rate Limits — Limits pro Endpunkt und Backoff.
• API-Referenz — alle Endpunkte und Schemas.