API-Client
Free & PremiumDer API-Client schickt HTTP-Anfragen an eine API und zeigt dir die Antwort: Status, Dauer, Größe, Inhalt und Header. Er läuft in der App, nicht im Browser, und kennt deshalb keine CORS-Hürden. Deine lokalen Sites erreicht er direkt, auch über HTTPS mit den Zertifikaten von WebDonkey. Mit Tests prüft er jede Antwort von selbst.
Was du hier machst
- Eine Anfrage bauen: Parameter, Header, Inhalt (Body) und Anmeldung (Auth)
- Die Antwort lesen und Fehler verstehen: Die Antwort lesen
- Jede Antwort automatisch prüfen lassen: Tests
- Werte wie
{{base_url}}je Umgebung wechseln: Umgebungen - In mehreren Tabs arbeiten und Anfragen in Sammlungen ablegen: Gespeicherte Anfragen und Tabs
Aufbau der Seite
| Bereich | Inhalt |
|---|---|
| Kopf | Titel, rechts die Marke der aktiven Umgebung, falls eine aktiv ist |
| Links | die Liste Gespeicherte Anfragen mit Sammlung anlegen, darunter Umgebung. Die Liste lässt sich einklappen. Mit Premium zeigt die schmale Leiste dann deine Sammlungen mit der Zahl ihrer Anfragen |
| Oben in der Mitte | die Leiste Anfrage-Tabs: ein Tab je Anfrage, mit Methode und Titel, + (Neuer Tab) öffnet einen weiteren |
| Adresszeile | Methode, Adresse, das Zeitlimit in Sekunden, Senden und Speichern |
| Anfrage | die Reiter Parameter, Header, Inhalt (Body), Anmeldung (Auth) und Tests. Die Zahl in Klammern nennt die Einträge. Rechts der Knopf Anfragebereich vergrößern |
| Antwort | Status, Dauer und Größe, dazu die Ansichten Inhalt (Body), Header und Tests |
Die Trennlinie zwischen Anfrage und Antwort ziehst du mit der Maus. Solange du keine Höhe gewählt hast, passt sich der Anfragebereich selbst an und macht nach dem Senden der Antwort Platz. Höhe wieder automatisch stellt das wieder her.
Eine erste Anfrage
- Trag bei Adresse eine URL ein, zum Beispiel
https://api.example.com/v1/users. Ist das Feld leer, schlägt der Antwortbereich unter Zum Ausprobieren eine deiner lokalen Sites: bis zu zwei deiner Sites vor. Ein Klick trägt die Adresse ein. - Wähle die Methode: GET ruft etwas ab, POST schickt etwas Neues hin, PUT und PATCH ändern es, DELETE löscht es. Dazu gibt es HEAD und OPTIONS.
- Klicke auf Senden oder drück Enter im Adressfeld. Während die Anfrage läuft, wird aus Senden der Knopf Abbrechen.
- Lies unten die Antwort.
Was im Hintergrund passiert
- Die App sendet die Anfrage selbst, mit dem User-Agent
WebDonkey-API-Client. Sie vertraut der lokalen Zertifizierungsstelle von WebDonkey, deshalb prüft sie lokale HTTPS-Sites wie jede andere Site. - Antworten liest sie bis zu 64 MB. Binäre Antworten wie Bilder oder PDFs fasst sie zusammen, statt sie als Zeichensalat zu zeigen.
- Deine Tabs mit allen Eingaben bleiben über einen Neustart der App erhalten. Antworten gelten nur bis zum Beenden.
- Gespeicherte Anfragen, Sammlungen und Umgebungen liegen in der Datenbank der App auf deinem Mac.
Free und Premium
| Free | Premium | |
|---|---|---|
| Anfragen bauen und senden, Antwort lesen | ja | ja |
| Tests | ja | ja |
| Bis zu 20 Tabs, auch nach einem Neustart | ja | ja |
| Anfragen speichern, Sammlungen | nein | ja |
| Umgebungen mit Variablen | nein | ja |
Im Free-Tarif fehlt der Knopf Speichern. Links steht stattdessen der Hinweis Das Speichern von Anfragen, Sammlungen und Umgebungen ist Premium. Senden und Tests sind kostenlos.
Parameter Free
Parameter hängen Angaben an die Adresse an, den Query-String. Aus limit = 10 wird ?limit=10, das heißt bei vielen APIs „nur zehn Ergebnisse“. Im Reiter Parameter pflegst du sie als Liste und schaltest einzelne an und aus, ohne die Adresse umzuschreiben.
So findest du es
Seitenleiste Werkzeuge › API-Client, im Anfragebereich der Reiter Parameter. Die Zahl in Klammern nennt die Zeilen.
So gehst du vor
- Klicke im Reiter Parameter auf Hinzufügen. Eine neue Zeile erscheint.
- Trag links bei Param den Namen ein, zum Beispiel
limit. - Trag rechts bei Wert den Wert ein, zum Beispiel
10. - Klicke auf Senden.
Felder und Optionen
| Element | Bedeutung |
|---|---|
| Kästchen Aktiv | an: Die Zeile geht mit. aus: Sie bleibt in der Liste, geht aber nicht mit. So parkst du einen Parameter, den du nur manchmal brauchst |
| Param | Name des Parameters |
| Wert | Wert des Parameters |
| X am Ende | entfernt die Zeile |
| Hinzufügen | neue, eingeschaltete Zeile |
Solange keine Zeile da ist, erklärt ein kurzer Hinweis den Reiter.
Was im Hintergrund passiert
- Beim Senden hängt die App alle eingeschalteten Zeilen an die Adresse und kodiert Sonderzeichen wie Leerzeichen oder
&selbst. - Namen und Werte dürfen Variablen der aktiven Umgebung enthalten, etwa
{{page_size}}. Die App setzt den Wert beim Senden ein. Kennt die Umgebung einen Namen nicht, geht der Text so hinaus, wie er dasteht. - Parameter, die du direkt in die Adresse schreibst, bleiben dort und erscheinen nicht in der Liste. Beides zusammen geht.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Der Server ignoriert den Parameter | Das Kästchen Aktiv ist aus, oder der Name ist falsch geschrieben | Kästchen prüfen, Namen mit der API-Dokumentation vergleichen |
| Ein Parameter kommt doppelt an | Er steht in der Adresse und in der Liste | An einer Stelle entfernen |
{{name}} kommt wörtlich beim Server an |
Keine Umgebung aktiv oder der Name fehlt in ihr | Die Umgebung wählen oder die Variable dort anlegen |
Siehe auch
Header Free
Header sind Zusatzangaben, die mit der Anfrage mitgehen. Accept = application/json bittet den Server zum Beispiel um eine Antwort als JSON, X-Shop-Id = 42 sagt einer API, welcher Shop gemeint ist. Im Reiter Header pflegst du sie als Liste.
So findest du es
Seitenleiste Werkzeuge › API-Client, im Anfragebereich der Reiter Header. Die Zahl in Klammern nennt die Zeilen.
So gehst du vor
- Klicke im Reiter Header auf Hinzufügen.
- Trag links bei Header den Namen ein, zum Beispiel
Accept. - Trag rechts bei Wert den Wert ein, zum Beispiel
application/json. - Klicke auf Senden.
Felder und Optionen
| Element | Bedeutung |
|---|---|
| Kästchen Aktiv | an: Der Header geht mit. aus: Er bleibt in der Liste, geht aber nicht mit |
| Header | Name des Headers |
| Wert | Wert des Headers |
| X am Ende | entfernt die Zeile |
| Hinzufügen | neue, eingeschaltete Zeile |
Was im Hintergrund passiert
- Namen und Werte dürfen Variablen der aktiven Umgebung enthalten, zum Beispiel ein Schlüssel als
{{access_key}}. Fehlt eine Variable, warnt eine Zeile unter der Adresse: Nicht in der Umgebung „…“: … Das wird so gesendet, wie es dasteht. - Zwei Header setzt die App aus anderen Reitern: den Inhaltstyp (
Content-Type) aus dem Reiter Inhalt (Body) und die Anmeldung (Authorizationoder einen API-Key-Header) aus dem Reiter Anmeldung (Auth). Trag sie nicht zusätzlich hier ein. - Die Header der Antwort liest du unten in der Ansicht Header der Antwort.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
Antwort 401 oder 403 |
Die Anmeldung fehlt oder ist falsch | Den Reiter Anmeldung (Auth) prüfen |
Antwort 415 |
Der Server erwartet einen anderen Inhaltstyp | Den Content-Type im Reiter Inhalt (Body) anpassen |
| Ein Header kommt doppelt an | Er steht hier und wird von einem anderen Reiter gesetzt | Die Zeile hier entfernen |
Siehe auch
Inhalt (Body) Free
Der Inhalt sind die Daten, die du mit der Anfrage mitschickst, zum Beispiel ein neues Produkt als JSON. Eine Anfrage, die nur etwas abruft (GET), braucht keinen. Im Reiter Inhalt (Body) wählst du, was mitgeht: nichts, freier Text oder Formularfelder.
So findest du es
Seitenleiste Werkzeuge › API-Client, im Anfragebereich der Reiter Inhalt (Body).
So gehst du vor
Ein JSON-Objekt senden:
- Wähle die Methode POST und trag die Adresse ein.
- Wähle im Reiter Inhalt (Body) in der Liste Text oder JSON (Raw). Daneben steht der Inhaltstyp
application/json. - Schreib das JSON in den Editor, zum Beispiel
{ "name": "Test" }. - Klicke auf Senden.
Formularfelder senden
- Wähle Formularfelder (urlencoded).
- Klicke auf Hinzufügen und trag Feld und Wert ein, je Feld eine Zeile.
- Klicke auf Senden. Die Felder gehen wie ein HTML-Formular hinaus.
Felder und Optionen
| Art | Was mitgeht |
|---|---|
| Kein Inhalt | nichts. Vorgabe für jede neue Anfrage |
| Text oder JSON (Raw) | der Text im Editor, genau so, wie er dasteht. Daneben trägst du den Inhaltstyp ein, Vorgabe application/json. Enthält er json, färbt der Editor den Text als JSON |
| Formularfelder (urlencoded) | eine Liste aus Feld und Wert, gesendet als application/x-www-form-urlencoded. Mit dem Kästchen Aktiv schaltest du einzelne Felder ab, X entfernt eine Zeile |
Wechselst du die Art, beginnt der neue Inhalt leer. Jeder Tab hat seinen eigenen Editor mit eigenem Rückgängig.
Was im Hintergrund passiert
- Bei Text oder JSON (Raw) setzt die App den Header
Content-Typeauf den Wert neben der Liste. Bei Formularfeldern setzt sie ihn selbst. - Variablen der aktiven Umgebung wie
{{base_url}}oder ein Token ersetzt die App auch im Inhalt, im Text wie in den Formularfeldern. - Die App prüft nicht, ob dein JSON gültig ist. Was im Editor steht, geht hinaus.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Der Server meldet ungültiges JSON | Ein Komma oder Anführungszeichen fehlt | Den Text im Editor prüfen, die Färbung hilft |
Antwort 415 |
Der Inhaltstyp passt nicht zu dem, was der Server erwartet | Den Inhaltstyp neben der Liste anpassen |
| Der Inhalt kommt nicht an | Art Kein Inhalt gewählt, oder die Methode ist GET und der Server liest bei GET keinen Inhalt | Art wählen, Methode prüfen |
Siehe auch
Anmeldung (Auth) Free
Viele APIs wollen wissen, wer anfragt. Im Reiter Anmeldung (Auth) weist du dich beim Server aus, zum Beispiel mit einem Token, den dir die API gegeben hat. Welche Art der Dienst verlangt, steht in seiner API-Dokumentation.
So findest du es
Seitenleiste Werkzeuge › API-Client, im Anfragebereich der Reiter Anmeldung (Auth).
So gehst du vor
- Wähle im Reiter Anmeldung (Auth) die Art, zum Beispiel Bearer-Token.
- Füll die Felder aus, die dazu erscheinen.
- Klicke auf Senden.
Felder und Optionen
| Art | Was du einträgst | Was gesendet wird |
|---|---|---|
| Keine Anmeldung | nichts | keine Anmeldedaten. Vorgabe |
| Bearer-Token | Token | der Header Authorization: Bearer <token> |
| Basic Auth | Benutzername und Passwort | der Header Authorization: Basic … mit beidem, Base64-kodiert |
| API key (Header) | den Namen des Headers (Vorgabe X-API-Key) und den Wert |
genau dieser Header |
Das Passwort bei Basic Auth ist verdeckt.
Was im Hintergrund passiert
- Alle Felder dürfen Variablen der aktiven Umgebung enthalten, etwa
{{access_token}}. So wechselst du zwischen lokal und live, ohne die Anfrage zu ändern. - Speicherst du die Anfrage (Premium), speichert die App auch, was hier steht. Steht ein Token als Variable hier, liegt es nur in der Umgebung.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
Antwort 401 |
Token oder Passwort fehlt, ist abgelaufen oder falsch | Wert prüfen, bei Variablen die aktive Umgebung |
Antwort 403 |
Die Anmeldung stimmt, aber das Konto darf das nicht | Rechte beim Anbieter der API prüfen |
| Der Server erwartet den Schlüssel als Parameter statt als Header | Manche APIs lesen ihn aus der Adresse | Keine Anmeldung wählen und den Schlüssel im Reiter Parameter eintragen |
Siehe auch
Die Antwort lesen Free
Nach dem Senden erscheint die Antwort unter der Anfrage: oben Status, Dauer und Größe, darunter der Inhalt, die Header und das Ergebnis deiner Tests. Bis dahin steht dort, was als Nächstes zu tun ist.
So findest du es
Seitenleiste Werkzeuge › API-Client, der untere Bereich unter der Anfrage. Jeder Tab hat seine eigene Antwort.
So gehst du vor
- Sende eine Anfrage mit Senden oder Enter im Adressfeld.
- Lies den Status oben links: grün für 200 bis 399, rot für alles andere.
- Schau dir in Inhalt (Body) an, was der Server geschickt hat.
- Wechsle bei Bedarf zu Header oder Tests.
Felder und Optionen
Kopfzeile
| Angabe | Bedeutung |
|---|---|
| Status | Code und Grund, zum Beispiel 200 OK oder 404 Not Found |
| Dauer | Millisekunden vom Senden bis zur Antwort |
| Größe | Größe des Inhalts in B, KB oder MB |
Ansichten
| Ansicht | Zeigt |
|---|---|
| Inhalt (Body) | den Inhalt in einem schreibgeschützten Editor. JSON rückt die App automatisch ein. Bei binären Antworten wie Bildern, PDFs oder ZIP-Dateien steht dort nur, wie viele Bytes es sind |
| Header | alle Header der Antwort, die Zahl in Klammern nennt sie |
| Tests | je Test ein grüner Haken oder ein rotes Kreuz mit Begründung, die Zahl daneben nennt bestanden von gesamt, etwa 3/4. Ohne Tests: Keine Tests definiert. |
Bevor du sendest
Solange der Tab noch nichts gesendet hat, steht im Antwortbereich Hier erscheint die Antwort. Ist die Adresse leer, schlägt er unter Zum Ausprobieren eine deiner lokalen Sites: bis zu zwei deiner eingeschalteten Sites vor. Ein Klick trägt die Adresse ein.
Was im Hintergrund passiert
- Die Antwort gehört dem Tab, aus dem du gesendet hast. Wechselst du währenddessen den Tab oder die Seite, landet sie trotzdem dort. Mehrere Tabs dürfen gleichzeitig senden.
- Die App liest den Zeichensatz aus dem Header
Content-Type, viele ältere Sites senden ISO-8859-1 statt UTF-8. - Die App liest höchstens 64 MB einer Antwort.
- Das Zeitlimit neben der Adresse bricht die Anfrage nach so vielen Sekunden ab. Vorgabe sind 30 Sekunden,
0heißt kein Limit.
Lokales HTTPS
Lokale Sites mit HTTPS von WebDonkey funktionieren ohne Zusatzschritt, die App vertraut der lokalen Zertifizierungsstelle von WebDonkey. Für eine Site mit einem Zertifikat, das dein Mac nicht kennt, schaltest du im Reiter Tests die Option Ungültige/selbstsignierte TLS-Zertifikate zulassen (lokale Entwicklung) ein. Die Anfrage zeigt dann rechts über den Reitern Zertifikat wird nicht geprüft. Ein Klick darauf schaltet die Prüfung wieder ein. Nutze das nur für lokale Sites.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
request timed out |
Das Zeitlimit war kürzer als die Antwortzeit | Das Zeitlimit erhöhen oder auf 0 setzen |
request failed: … mit einem Hinweis auf Zertifikate |
Das Zertifikat des Servers ist ungültig oder unbekannt | Für lokale Sites die TLS-Option im Reiter Tests einschalten |
request failed: … mit „connection refused“ |
Unter der Adresse lauscht nichts | Prüfen, ob die Site oder der Dienst läuft, etwa mit wd sites |
Ein {{name}} steht in der Adresse beim Server |
Die Variable fehlt in der aktiven Umgebung | Siehe Umgebungen |
| Nach Abbrechen kommt keine Antwort | So gewollt, abgebrochene Anfragen zeigen keinen Fehler | Erneut senden |
Siehe auch
Tests Free
Tests prüfen jede Antwort von selbst. „Status ist 200“ heißt zum Beispiel: Die Anfrage hat geklappt. Du legst die Prüfungen einmal an, und nach jedem Senden zeigt die Antwort, welche bestanden sind. So merkst du sofort, wenn eine API ihre Antwort ändert. Tests sind kostenlos.
So findest du es
Seitenleiste Werkzeuge › API-Client, im Anfragebereich der Reiter Tests. Das Ergebnis steht nach dem Senden in der Antwort in der Ansicht Tests.
So gehst du vor
- Klicke im Reiter Tests auf Test hinzufügen. Eine Zeile Status ist mit
200erscheint. - Wähle bei Bedarf eine andere Art und trag den Wert ein.
- Klicke auf Senden.
- Wechsle in der Antwort zu Tests. Je Prüfung steht ein grüner Haken oder ein rotes Kreuz mit Begründung, daneben die Zahl der bestandenen, etwa
3/4.
Ein guter Anfang: Status ist 200 und JSON-Pfad existiert für das wichtigste Feld.
Felder und Optionen
| Art | Prüft | Eingabe |
|---|---|---|
| Status ist | der Statuscode ist genau dieser | eine Zahl, Vorgabe 200 |
| Zeit unter (ms) | die Antwort kam in höchstens so vielen Millisekunden | eine Zahl, Vorgabe 1000 |
| Inhalt enthält | der Inhalt der Antwort enthält diesen Text, Groß- und Kleinschreibung zählt | ein Text |
| JSON-Pfad gleich | der Wert an einem Pfad wie data.items.0.id ist genau der erwartete |
Pfad und erwartet |
| JSON-Pfad existiert | an diesem Pfad gibt es einen Wert | ein Pfad |
X am Ende einer Zeile entfernt den Test.
JSON-Pfade
Ebenen trennst du mit Punkten, eine Zahl greift in eine Liste. Aus {"data": {"items": [{"id": 7}]}} liefert data.items.0.id den Wert 7. Bei JSON-Pfad gleich vergleicht die App als Text: Eine Zahl 7 ist gleich dem erwarteten 7, ein Text wird ohne Anführungszeichen verglichen.
Die TLS-Option
Unter den Tests steht Ungültige/selbstsignierte TLS-Zertifikate zulassen (lokale Entwicklung). Ist sie an, prüft die Anfrage das Zertifikat des Servers nicht. Das ist für lokale Sites mit fremdem Zertifikat gedacht, siehe Die Antwort lesen.
Was im Hintergrund passiert
- Die App wertet die Tests direkt nach dem Eintreffen der Antwort aus, noch bevor sie angezeigt wird.
- Die JSON-Tests brauchen eine Antwort, die sich als JSON lesen lässt. Sonst scheitern sie mit path not found.
- Beschriftung und Begründung eines Ergebnisses stehen auf Englisch, zum Beispiel
Status is 200mitgot 404oderResponse under 1000 msmittook 1530 ms.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
path not found |
Der Pfad stimmt nicht oder die Antwort ist kein JSON | In Inhalt (Body) der Antwort nachsehen, wie die Felder heißen |
JSON-Pfad gleich scheitert mit got … |
Der Wert in der Antwort ist anders geschrieben als der erwartete, etwa true statt 1 |
Den Wert genau so eintragen, wie er in der Antwort steht |
| Zeit unter (ms) scheitert manchmal | Die Antwortzeit schwankt | Den Wert großzügiger setzen |
Siehe auch
Umgebungen Premium
Eine Umgebung hält Variablen bereit, Werte wie {{base_url}} oder {{access_token}}, die du in Anfragen wiederverwendest. Mit einer Umgebung Lokal und einer Live schickst du dieselbe Anfrage mal an https://shop.test, mal an https://shop.example.com, ohne sie umzuschreiben. Umgebungen sind Premium.
So findest du es
Seitenleiste Werkzeuge › API-Client, links unter den gespeicherten Anfragen der Bereich Umgebung mit der Auswahl und dem Knopf Umgebungen verwalten.
So gehst du vor
Eine Umgebung anlegen
- Klicke auf Umgebungen verwalten. Der Dialog öffnet sich.
- Klicke links auf Neue Umgebung.
- Trag bei Name einen Namen ein, zum Beispiel
Lokal. - Klicke unter Variablen auf Variable hinzufügen und trag Name und Wert ein, zum Beispiel
base_urlundhttps://shop.test. - Klicke auf Speichern.
Eine Umgebung benutzen
- Wähle die Umgebung in der Auswahl im Bereich Umgebung. Keine Umgebung schaltet sie ab.
- Schreib
{{base_url}}in die Adresse, etwa{{base_url}}/api/products. - Klicke auf Senden. Die App setzt den Wert ein.
Oben rechts auf der Seite steht jetzt eine Marke mit dem Namen der aktiven Umgebung.
Felder und Optionen
Im Bereich Umgebung
| Element | Bedeutung |
|---|---|
| Auswahl | die aktive Umgebung oder Keine Umgebung |
| Stift | „…“ bearbeiten: öffnet den Dialog bei der aktiven Umgebung |
| Variablen ansehen | klappt die Variablen der aktiven Umgebung mit ihren Werten auf, die Zahl in Klammern nennt sie |
| Umgebungen verwalten | öffnet den Dialog |
Im Dialog Umgebungen verwalten
| Element | Bedeutung |
|---|---|
| Liste links | alle Umgebungen, die aktive trägt aktiv. Neue Umgebung legt eine an |
| Name | Pflicht. Ohne Namen meldet der Dialog Die Umgebung braucht einen Namen. |
| Variablen | die Variablen als Zeilen (Name und Wert je Zeile) oder als JSON, etwa {"base_url": "https://example.test"}. Du kannst jederzeit zwischen beiden Ansichten wechseln |
| Variable hinzufügen | neue Zeile, das Kreuz am Ende entfernt sie |
| Duplizieren | öffnet eine Kopie der Umgebung unter neuem Namen. Sie entsteht, sobald du sie speicherst |
| Löschen | fragt „…“ mit ihren Variablen löschen? Das lässt sich nicht rückgängig machen. |
| Verwerfen, Speichern | Änderungen zurücknehmen oder speichern |
Schließt du den Dialog oder wechselst die Umgebung mit ungespeicherten Änderungen, fragt er: Du hast Änderungen, die noch nicht gespeichert sind. mit Weiter bearbeiten, Verwerfen und Speichern.
Was im Hintergrund passiert
- Beim Senden ersetzt die App jedes
{{name}}durch den Wert der aktiven Umgebung: in der Adresse, in Parametern, Headern, Inhalt und Anmeldung. - Kennt die aktive Umgebung einen Namen nicht, bleibt
{{name}}stehen und geht so hinaus. Steht er in der Adresse oder einem Header, warnt eine Zeile unter der Adresse schon vor dem Senden: Nicht in der Umgebung „…“: … Das wird so gesendet, wie es dasteht. Ist keine Umgebung aktiv, sagt die Zeile das. - Die Umgebungen liegen in der Datenbank der App auf deinem Mac, auch ihre Werte.
Free und Premium
Umgebungen sind Premium. Im Free-Tarif erscheint der Bereich Umgebung nur, wenn du aus einer früheren Premium-Zeit Umgebungen hast. Sie bleiben erhalten und lassen sich im Dialog ansehen und löschen, aber nicht auswählen. Eine gesperrte Umgebung wird beim Senden nicht angewendet.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Die Variable braucht einen Namen. | Eine Zeile hat einen Wert, aber keinen Namen | Namen eintragen oder die Zeile entfernen |
| Diesen Namen gibt es doppelt. Nur eine der beiden bliebe erhalten. | Zwei Zeilen haben denselben Namen | Eine umbenennen oder entfernen |
| Das ist noch kein gültiges JSON: … | In der Ansicht JSON fehlt ein Zeichen | Klammern, Kommas und Anführungszeichen prüfen |
| Meldung, es müsse ein Objekt aus Namen und Werten sein | Das JSON ist eine Liste oder ein einzelner Wert | Die Form {"name": "wert"} verwenden |
Siehe auch
Gespeicherte Anfragen und Tabs Free & Premium
Im API-Client arbeitest du in bis zu 20 Anfrage-Tabs nebeneinander, jeder mit seiner eigenen Anfrage und Antwort. Mit Premium legst du Anfragen dauerhaft in der Liste Gespeicherte Anfragen ab und ordnest sie in Sammlungen, zum Beispiel alle Anfragen für einen Shop.
So findest du es
Seitenleiste Werkzeuge › API-Client. Die Tabs stehen über der Adresszeile, die gespeicherten Anfragen links.
So gehst du vor
Eine Anfrage speichern (Premium)
- Bau die Anfrage, mindestens mit einer Adresse.
- Klicke auf Speichern rechts neben Senden.
- Gib bei Name der Anfrage einen Namen ein, zum Beispiel „Produkte auflisten“.
- Wähle bei Bedarf eine Sammlung. Die Auswahl erscheint, sobald es eine gibt.
- Klicke auf Speichern. Die Anfrage steht links, der Tab trägt ihren Namen.
Änderst du danach etwas, zeigt der Tab einen Punkt für Ungespeicherte Änderungen, und Speichern übernimmt die Änderung in die gespeicherte Anfrage. Ist nichts geändert, steht dort Gespeichert mit Haken.
Direkt in eine Sammlung speichern
Ist der offene Tab noch nicht gespeichert, steht in jeder aufgeklappten Sammlung Aktuelle Anfrage hier speichern. Ein Klick fragt nur noch nach dem Namen.
Eine gespeicherte Anfrage öffnen
Klicke links auf die Anfrage. Sie öffnet sich im Tab, der sie schon hält, sonst im offenen Tab, wenn der leer ist, sonst in einem neuen. Ist sie schon offen, springt die App zu diesem Tab und lässt ihn kurz aufleuchten.
Felder und Optionen
Anfrage-Tabs
| Aktion | So geht es |
|---|---|
| Neuer Tab | + am Ende der Leiste (Neuer Tab) |
| Tab wechseln | Tab anklicken |
| Tab umbenennen | Doppelklick, F2 oder Tab umbenennen im Kontextmenü. Enter übernimmt, Escape bricht ab. Ohne eigenen Namen folgt der Titel der Anfrage, etwa ihrem Namen oder Methode und Pfad |
| Tab duplizieren | Tab duplizieren im Kontextmenü |
| Tab schließen | das Kreuz im Tab, ein Klick mit der mittleren Maustaste oder Tab schließen |
| Andere schließen | Andere Tabs schließen im Kontextmenü |
Das Kontextmenü öffnest du mit einem Rechtsklick auf den Tab. Ein Punkt im Tab heißt Ungespeicherte Änderungen, ein eigenes Symbol zeigt Anfrage läuft. Bei 20 Tabs meldet die App Höchstens 20 Tabs. Schließe einen, um einen weiteren zu öffnen.
Die Liste Gespeicherte Anfragen
| Element | Bedeutung |
|---|---|
| Sammlung anlegen | neue Sammlung, nur mit einem Namen (Name der Sammlung) |
| Sammlung | aufklappbar, mit der Zahl ihrer Anfragen. Das Menü … (oder ein Rechtsklick) hat Umbenennen und Nur Sammlung löschen |
| Ohne Sammlung | Anfragen, die in keiner Sammlung liegen |
| Anfrage | Methode und Name. Das Menü … hat Öffnen, Als Kopie in neuem Tab öffnen, Umbenennen oder verschieben und Löschen |
- Als Kopie in neuem Tab öffnen lässt das Original unberührt, der Tab heißt „… (Kopie)“.
- Umbenennen oder verschieben ändert Name und Sammlung.
- Nur Sammlung löschen entfernt den Ordner, die Anfragen darin landen bei Ohne Sammlung.
- Löschen entfernt die Anfrage ohne Rückfrage. Ein Tab, der sie offen hat, behält den Text als ungespeicherte Arbeit.
Mit dem Symbol rechts neben Gespeicherte Anfragen klappst du die Liste zu einer schmalen Leiste ein, Gespeicherte Anfragen aufklappen holt sie zurück. Die Wahl bleibt über einen Neustart erhalten.
Was im Hintergrund passiert
- Die Tabs mit allen Eingaben speichert die App laufend auf deinem Mac. Sie sind nach einem Neustart wieder da, auch im Free-Tarif. Antworten gelten nur bis zum Beenden.
- Gespeicherte Anfragen und Sammlungen liegen in der Datenbank der App.
Free und Premium
Tabs, Senden und Tests sind kostenlos. Speichern, Sammlungen und Umgebungen sind Premium. Im Free-Tarif fehlt der Knopf Speichern, und links steht Das Speichern von Anfragen, Sammlungen und Umgebungen ist Premium. Senden und Tests sind kostenlos.
Nach einem Wechsel von Premium zu Free bleiben gespeicherte Anfragen sichtbar, aber gesperrt: Du kannst sie umbenennen und löschen, aber nicht öffnen. Tabs, die an eine gesperrte Anfrage gebunden waren, behalten ihren Text als ungespeicherte Arbeit.
Wenn es nicht klappt
| Was du siehst | Warum | Was du tust |
|---|---|---|
| Höchstens 20 Tabs. … | Die Grenze der Tabs ist erreicht | Einen Tab schließen |
| Kein Knopf Speichern | Free-Tarif | Premium aktivieren oder die Anfrage im Tab lassen |
| Eine Anfrage lässt sich nicht öffnen | Sie ist nach einem Downgrade gesperrt | Premium aktivieren, oder sie umbenennen und löschen |