Kaufen

API-Client

Free & Premium

Der 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

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

  1. 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.
  2. 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.
  3. Klicke auf Senden oder drück Enter im Adressfeld. Während die Anfrage läuft, wird aus Senden der Knopf Abbrechen.
  4. 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

  1. Klicke im Reiter Parameter auf Hinzufügen. Eine neue Zeile erscheint.
  2. Trag links bei Param den Namen ein, zum Beispiel limit.
  3. Trag rechts bei Wert den Wert ein, zum Beispiel 10.
  4. 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

  1. Klicke im Reiter Header auf Hinzufügen.
  2. Trag links bei Header den Namen ein, zum Beispiel Accept.
  3. Trag rechts bei Wert den Wert ein, zum Beispiel application/json.
  4. 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 (Authorization oder 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:

  1. Wähle die Methode POST und trag die Adresse ein.
  2. Wähle im Reiter Inhalt (Body) in der Liste Text oder JSON (Raw). Daneben steht der Inhaltstyp application/json.
  3. Schreib das JSON in den Editor, zum Beispiel { "name": "Test" }.
  4. Klicke auf Senden.

Formularfelder senden

  1. Wähle Formularfelder (urlencoded).
  2. Klicke auf Hinzufügen und trag Feld und Wert ein, je Feld eine Zeile.
  3. 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-Type auf 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

  1. Wähle im Reiter Anmeldung (Auth) die Art, zum Beispiel Bearer-Token.
  2. Füll die Felder aus, die dazu erscheinen.
  3. 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

  1. Sende eine Anfrage mit Senden oder Enter im Adressfeld.
  2. Lies den Status oben links: grün für 200 bis 399, rot für alles andere.
  3. Schau dir in Inhalt (Body) an, was der Server geschickt hat.
  4. 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, 0 heiß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

  1. Klicke im Reiter Tests auf Test hinzufügen. Eine Zeile Status ist mit 200 erscheint.
  2. Wähle bei Bedarf eine andere Art und trag den Wert ein.
  3. Klicke auf Senden.
  4. 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 200 mit got 404 oder Response under 1000 ms mit took 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

  1. Klicke auf Umgebungen verwalten. Der Dialog öffnet sich.
  2. Klicke links auf Neue Umgebung.
  3. Trag bei Name einen Namen ein, zum Beispiel Lokal.
  4. Klicke unter Variablen auf Variable hinzufügen und trag Name und Wert ein, zum Beispiel base_url und https://shop.test.
  5. Klicke auf Speichern.

Eine Umgebung benutzen

  1. Wähle die Umgebung in der Auswahl im Bereich Umgebung. Keine Umgebung schaltet sie ab.
  2. Schreib {{base_url}} in die Adresse, etwa {{base_url}}/api/products.
  3. 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)

  1. Bau die Anfrage, mindestens mit einer Adresse.
  2. Klicke auf Speichern rechts neben Senden.
  3. Gib bei Name der Anfrage einen Namen ein, zum Beispiel „Produkte auflisten“.
  4. Wähle bei Bedarf eine Sammlung. Die Auswahl erscheint, sobald es eine gibt.
  5. 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

Siehe auch

Cookie-Voreinstellungen

Diese Website verwendet Cookies, um eine bestmögliche Erfahrung bieten zu können. Deine Wahl gilt für webdonkey.io und den Shop unter shop.webdonkey.io. Mehr Informationen ...

Technisch erforderlich

Für die Funktion der Website erforderliche Cookies:

Immer an
WebDonkey
WebDonkey
Anbieter: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz
Zweck: Deine Einwilligung, Farbschema und Sprache für Website und Shop, Preisschalter; mit wd_debug in der Adresse die Messereignisse in der Entwicklerkonsole zur Fehlersuche
Cookies und Speicher: Cookie wd_consent auf .webdonkey.io, gemeinsam mit shop.webdonkey.io (12 Monate); Cookies wd_theme und wd_lang auf .webdonkey.io, gemeinsam mit shop.webdonkey.io, nur wenn du Farbschema oder Sprache selbst umschaltest (365 Tage); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (nur mit wd_debug in der Adresse; bis der Tab schließt)

Statistik

Zeigt uns, welche Seiten und Produkte auf webdonkey.io und im Shop angesehen werden, woher Besucher kommen und wie sie bis zum Kauf gelangen (mit Bestellnummer, Betrag und Produkten, ohne Name und E-Mail-Adresse). Anbieter: Google. Übermittlung in die USA möglich (EU-US Data Privacy Framework). Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Google Analytics 4
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Nutzungsstatistik: Seitenaufrufe, Klicks, Scrolltiefe, Quellen, Geräte, Ladezeiten; im Shop auch Warenkorb, Kasse, Käufe, Registrierung und Anmeldung
Cookies und Speicher: _ga, _ga_<ID> (2 Jahre)
Datenschutzerklärung

Marketing

Misst, ob unsere Anzeigen auf Facebook, Instagram und TikTok zu Besuchen und Downloads auf webdonkey.io sowie zu Registrierungen und Käufen im Shop führen, und bildet Zielgruppen für Anzeigen. Anbieter: Meta und TikTok, mit denen wir dafür gemeinsam verantwortlich sind. Mit dieser Zustimmung kann auch Google Werbe-Cookies (_gcl_…) setzen. Übermittlung in die USA und weitere Länder außerhalb der EU möglich. Deine Wahl gilt für webdonkey.io und den Shop gemeinsam.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Anbieter: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Irland
Zweck: Lädt die Dienste, denen du zugestimmt hast, hier und im Shop. Setzt selbst keine Cookies.
Cookies und Speicher: keine
Datenschutzerklärung
Meta Pixel (Facebook, Instagram)
Anbieter: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Irland
Zweck: Anzeigenmessung und Zielgruppen auf Facebook und Instagram, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _fbp (3 Monate), _fbc (3 Monate, nur wenn du über eine Anzeige kommst), fr auf facebook.com (3 Monate)
Datenschutzerklärung
TikTok Pixel
Anbieter: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Irland
Zweck: Anzeigenmessung und Zielgruppen auf TikTok, auch im Shop (Warenkorb, Kasse, Käufe, Registrierung)
Cookies und Speicher: _ttp, _tt_enable_cookie (13 Monate)
Datenschutzerklärung