# Fehlerbehebung

> Die häufigsten Probleme unter Organisation › Einstellungen › Entwickler, geordnet nach dem, was du beobachtest – jeder Abschnitt nennt die Ursache und den nächsten Schritt.

Wie du API-Tokens anlegst und verwaltest, steht auf den anderen Seiten unter [Entwickler](/organisation/einstellungen/entwickler). Probleme mit Webhooks behandelt die [Fehlerbehebung zu Webhooks](/organisation/einstellungen/entwickler/webhooks/fehlerbehebung).

## Die Gruppe „Entwickler“ fehlt in den Einstellungen {#gruppe-fehlt}

Deine Benutzerrolle hat den Bereich **Entwickler** nicht freigeschaltet. Eine Person mit passenden Rechten öffnet dafür **Organisation › Einstellungen › Team & Rollen › Benutzerrollen** und wählt deine Rolle. Im Block **Organisation** klickt sie die Zeile **Einstellungen** an (Pfeil am rechten Rand). In den Detail-Rechten dieser Zeile schaltet sie im Abschnitt **Entwickler** den Schalter **Bereich aktiv** ein. Ist der Bereich aus, verschwindet die ganze Gruppe samt **Webhooks** und **API** aus der Liste links. Dasselbe passiert, wenn im Abschnitt **Entwickler** die Auswahlfelder **Webhooks** und **API** beide auf **Kein Zugriff** stehen.

## Der Menüpunkt für die API-Tokens fehlt {#api-tokens-fehlt}

Deiner Benutzerrolle fehlt der Zugriff auf die **Einstellungen** oder auf die Seite der API-Tokens. Im zweiten Fall steht in den Detail-Rechten der Zeile **Einstellungen** im Abschnitt **Entwickler** das Auswahlfeld **API** auf **Kein Zugriff**. Eine Person mit Administrator-Rolle gibt das unter **Organisation › Einstellungen › Team & Rollen › Benutzerrollen** frei. Zum Ansehen genügt **Nur lesen**, zum Anlegen und Ändern **Lesen + Bearbeiten**.

## Der Punkt vor einem Token ist rot {#punkt-rot}

Ein roter Punkt vor einem API-Token heißt nur, dass dieser Token noch nie verwendet wurde. Unter seinem Namen steht dann **Noch nicht verwendet**. Sobald der Token benutzt wurde, ist der Punkt grün, und dort steht **Zuletzt verwendet** mit Datum und Uhrzeit.

## Das Fenster mit dem Token ist zu, der Token wird nicht mehr angezeigt {#token-nicht-mehr-sichtbar}

i-Planner zeigt den vollständigen Token genau einmal an. Danach siehst du auf der Bearbeiten-Seite im Bereich **Token** unter **Vorschau** nur noch einen Ausschnitt aus Anfang und Ende. Öffne den Token über **Organisation › Einstellungen › Entwickler › API** und klicke im Bereich **Token** auf **Regenerieren**. Dann zeigt dir das Fenster **Token regeneriert** einen neuen Schlüssel. Der bisherige gilt ab diesem Moment nicht mehr, und du musst ihn im angebundenen Programm ersetzen. Die Schritte stehen unter [Token regenerieren](/organisation/einstellungen/entwickler/api-tokens#token-regenerieren).

## Das Programm erreicht die REST-API nicht {#rest-api-nicht-erreichbar}

Prüfe zuerst die Adresse, die im anderen Programm hinterlegt ist. Die REST-API hat für alle Organisationen dieselbe Adresse, die Base-URL `https://www.api.i-planner.app`. Das ist nicht die Adresse, unter der du i-Planner im Browser öffnest. Übernimm sie unter **Organisation › Einstellungen › Entwickler › API** im Abschnitt **Base-URL** mit **Kopieren** und achte auf `https://` am Anfang, siehe [Ein Programm mit der REST-API verbinden](/organisation/einstellungen/entwickler/api-tokens#base-url). Hinter der Base-URL folgen `/v3/` und der Datenbereich, etwa `https://www.api.i-planner.app/v3/customers`. Antwortet die REST-API mit Fehler 404 und „This API endpoint does not exist.“, stimmt dieser Pfad nicht. Lehnt sie einen Aufruf mit Fehler 401 oder 403 ab, liegt es am Token, siehe [Ein Aufruf wird mit „401“ abgelehnt](/organisation/einstellungen/entwickler/fehlerbehebung#fehler-401) und [Ein Aufruf wird mit „403“ abgelehnt](/organisation/einstellungen/entwickler/fehlerbehebung#fehler-403).

## Ein Aufruf wird mit „403“ abgelehnt {#fehler-403}

Wird ein Aufruf mit Fehler 403 abgelehnt, prüfe beim Token unter **Organisation › Einstellungen › Entwickler › API** zwei Dinge. Das erste sind die **Berechtigungen**. Nur ausdrücklich freigegebene Datenbereiche sind erlaubt. Lege also mit **+** eine Zeile für den passenden **Datenbereich** an, oder schalte in der vorhandenen Zeile **Lesen** oder **Schreiben** ein. Das zweite sind die **IPs**. Stehen dort Adressen, nimmt i-Planner Anfragen mit diesem Token nur von diesen Adressen an.

## Ein Aufruf wird mit „401“ abgelehnt {#fehler-401}

Wird ein Aufruf mit Fehler 401 abgelehnt, erkennt i-Planner den Token selbst nicht (mehr) an. Prüfe die Liste unter **Organisation › Einstellungen › Entwickler › API**. Steht beim Token **Widerrufen**, wurde er deaktiviert. Schalte ihn über **Bearbeiten** mit **Aktiv** wieder ein. Steht dort **Abgelaufen**, ist seine Laufzeit vorbei. Wähle dann unter **Gültigkeit** eine neue, siehe [Gültigkeit](/organisation/einstellungen/entwickler/api-tokens#gueltigkeit). Fehlt der Eintrag ganz, wurde er gelöscht. Andernfalls prüfe, ob der Token zwischenzeitlich über **Regenerieren** ersetzt wurde und im anderen Programm noch der alte Schlüssel liegt.

## Weitere Themen {#weitere-themen}

- [API-Tokens](/organisation/einstellungen/entwickler/api-tokens): Token anlegen, Berechtigungen, Laufzeit, IP-Liste, regenerieren und deaktivieren.
- [Webhooks › Fehlerbehebung](/organisation/einstellungen/entwickler/webhooks/fehlerbehebung): wenn ein Webhook nicht feuert oder sich nicht aktivieren lässt.
- [Benutzerrollen](/organisation/einstellungen/team-und-rollen/benutzerrollen/uebersicht): die Rechte für den Bereich **Entwickler**.
- [Audit-Log](/organisation/audit-log): die eingehenden API-Aufrufe im Protokoll **API**.