Fehlerbehebung & FAQ
Antworten auf häufige Probleme und Fragen und wie du ein Problem meldest.
Läuft etwas nicht so, wie du erwartest? Such unten dein Symptom. Steht dein Problem nicht dabei, melde es aus der App (siehe Ein Problem melden); jede Meldung wird gelesen.
Synchronisierung
Braucht die Synchronisierung deine Aufmerksamkeit, erscheint ein Cloud-Symbol in der Titelleiste. Klick darauf, um zu sehen, welcher Teil betroffen ist.
| Du siehst | Bedeutung | Was du tust |
|---|---|---|
| Offline — reconnecting… in der Titelleiste | Apiboo erreicht seine Server nicht. Du bist weiterhin angemeldet. | Nichts. Deine Änderungen warten auf diesem Gerät und gehen raus, sobald die Verbindung zurück ist. |
| Offline bei einem Bereich | Dieser Bereich kann gerade nicht synchronisieren. | Prüf deine Verbindung. Apiboo versucht es von selbst erneut. |
| Needs re-authentication | Deine Sitzung für diesen Bereich ist abgelaufen. | Melde dich erneut an. Nimm dafür Konto wechseln statt Abmelden, denn Abmelden entfernt lokale Daten (siehe Nach dem Abmelden fehlen Boards oder Dokumente). |
| „Your clock looks off by about N minutes“ | Die Uhr deines Computers geht falsch. Dadurch können deine Änderungen gegen Änderungen anderer Geräte verlieren. | Stell die Systemzeit richtig. |
| „Cloud sync is available on paid plans“ | Dieser Bereich synchronisiert in deinem Plan nicht. Alles ist weiterhin auf diesem Gerät gespeichert. | See plans, wenn du ihn synchronisiert haben willst (siehe Konto & Pläne). |
| Deine Cloud-Grenzen | Eine Cloud-Grenze des Free-Plans ist nah oder erreicht. | Verschieb Elemente auf dieses Gerät, lösch welche oder upgrade (siehe Plan und Nutzung ansehen). |
Die Sync-Bereiche heißen Personal sync (notes & boards), Team boards, Vault, dazu deine Arbeitsbereiche mit ihrem Namen.
Nach dem Abmelden fehlen Boards oder Dokumente
Abmelden entfernt die Daten dieses Kontos von diesem Computer, mit Ausnahme des Vaults. Alles aus der Cloud kommt bei der nächsten Anmeldung zurück. Boards und Dokumente, die nur auf diesem Gerät lagen, werden dabei mit entfernt.
Um das zu vermeiden, verschieb sie vor dem Abmelden in die Cloud (siehe Boards und Dokumente: Cloud oder dieses Gerät), oder nimm Konto wechseln, das alles behält.
Ein Request schlägt fehl
- Request failed mit Retry heißt, dass Apiboo den Server nicht erreicht hat: Prüf die URL, ob der Server läuft, und deinen Proxy unter Einstellungen → Proxy.
- Ein lokaler Server mit selbstsigniertem Zertifikat: Füg dein CA-Zertifikat unter Einstellungen → Zertifikate hinzu, oder schalte dort während der Entwicklung Disable SSL Verification globally ein.
- Der Request nutzt eine rot angezeigte Variable: Sie ist nicht definiert. Klick sie an, um sie anzulegen (siehe Das Variablen-Popout).
- Der Status ist 400 oder höher: Klick neben dem Status auf Explain, damit der KI-Assistent draufschaut.
- Senden lassen sich nur GET, POST, PUT, PATCH, DELETE, HEAD und OPTIONS. Ein anderer Methodenname scheitert mit „Unsupported HTTP method“.
- Ein DELETE- (oder GET-)Request mit Raw- oder Form-data-Body wird ohne den Body gesendet (siehe Body).
Mein Skript tut nicht, was ich erwarte
- „pm.sendRequest is not available in this context“:
pm.sendRequestfunktioniert nur in einem Pre Request-Skript, wenn du den Request selbst sendest, nicht in Post-Response-Skripten oder im Collection-Runner (siehe Einen anderen Endpunkt aufrufen: pm.sendRequest). - Der Request wurde nicht gesendet: Ein Fehler im Pre-Request-Skript stoppt das Senden. Die Meldung Request not sent zeigt die erste Zeile des Fehlers.
- Nichts von
console.log: Die Ausgabe erscheint nicht in der App. Leg den Wert stattdessen in einen Testnamen oder eine Variable. - Eine per Skript gesetzte Variable ist nach einem Neustart weg: Mit
environment.setgesetzte Werte gelten nur für die Sitzung (siehe Mit Variablen arbeiten). - Eine geheime Variable lässt sich nicht lesen: Erlaube Skripten den Zugriff (siehe Geheime Variablen).
- „Script execution timed out (5000ms)“: Ein Skript darf 5 Sekunden laufen.
Probleme beim Import
- Unrecognized format: Apiboo liest Apiboo-, Postman-v2-, Insomnia-v4-, OpenAPI-3.x-, Swagger-2.0-, HAR- und Bruno-Dateien (siehe Unterstützte Formate).
- Aus einer Insomnia-Datei wurden mehrere Collections: Jede Insomnia-Request-Gruppe wird eine eigene Collection.
- Keine Auth nach einem OpenAPI-Import: Security-Schemes werden nicht importiert. Stell die Auth an der Collection ein.
- Postman-Geheimnisse kamen als normale Variablen an: Markier sie erneut als geheim.
gRPC: Methoden laden, aber Invoke scheitert
Beim Aufruf einer Methode fragt Apiboo den Server derzeit per Reflection nach der Definition, auch wenn du eine .proto-Datei geladen hast. Ein Server ohne Reflection kann deshalb bei Invoke scheitern (siehe gRPC).
Updates
Steht ein Update bereit, erscheint unten in der Leiste der Button Update verfügbar. Unter Einstellungen → Allgemein kannst du mit Nach Updates suchen auch selbst prüfen und festlegen, wie oft Apiboo von allein nachsieht.
| Meldung | Was du tust |
|---|---|
| „Update-Prüfung fehlgeschlagen.“ | Prüf deine Verbindung und versuch es später noch einmal. |
| „Update konnte nicht heruntergeladen oder geöffnet werden. Bitte erneut versuchen.“ | Versuch es erneut oder lade die neueste Version von apiboo.com/download. |
| „Installer geöffnet — schließen Sie das Update ab und starten Sie Apiboo neu.“ | Schließ den Installer ab und starte Apiboo neu. |
Windows erkennt den Installer nicht
Eine ganz neue Version kann Windows SmartScreen auslösen, solange sie noch selten heruntergeladen wurde. Apiboos Installer sind code-signiert; wähl Weitere Informationen und dann Trotzdem ausführen.
Die App zeigt „Something went wrong“
Apiboo ist auf einen unerwarteten Fehler gestoßen. Klick auf Try again. Passiert es immer wieder, klick auf Copy details und füg die Details in eine Meldung ein (siehe Ein Problem melden).
Ein Problem melden
- Öffne Einstellungen → Über und klick auf Problem melden. In der Hilfe steht es auch in der Fußzeile.
- Wähl ein Thema: Fehler, Funktionswunsch, Performance, Abrechnung, Konto, Sicherheit oder Etwas anderes.
- Gib, wenn du magst, einen Betreff an und beschreib unter Was ist passiert?, was du getan hast, was du erwartet hast und was stattdessen passiert ist.
- Häng mit Dateien hinzufügen Screenshots oder Logs an: bis zu 5 Dateien, je 25 MB.
- Klick auf Meldung senden.
Die Meldung enthält App-Version und Betriebssystem, aber keine Dateien, Requests oder Zugangsdaten. Antworten erscheinen in deinen Benachrichtigungen. Zum Senden musst du angemeldet sein.
FAQ
Brauche ich ein Konto? Nein. Alles außer Chat, Synchronisierung, Teilen und Teams funktioniert auch abgemeldet (siehe Brauchst du ein Konto?).
Funktioniert Apiboo offline? Ja. Deine Daten liegen auf deinem Computer. Die Synchronisierung holt auf, sobald du wieder online bist.
Wo ändere ich Tastenkürzel? Unter Einstellungen → Tastatur. Die vollständige Liste steht unter Tastenkürzel.
Wie steige ich von Postman um? Exportier deine Collections und Environments aus Postman und importier sie (siehe Import & Export). Deine pm.*-Skripte laufen unverändert, mit den Unterschieden, die unter Postman-Skripte (pm.*) stehen.
Ein KI-Client meldet „Connected“, zeigt aber keine Tools. Siehe MCP-Server.
Sieht Apiboo meine Requests? Nur das, was du synchronisierst, teilst oder den KI-Assistenten fragst. Requests in einem lokalen Arbeitsbereich bleiben sonst auf deinem Computer. Anonyme Nutzungsdaten zählen nur, welche Funktionen genutzt werden, und du kannst sie unter Einstellungen → Allgemein abschalten (siehe Nutzungsdaten).
