Yaak - Desktop API Client Cheatsheet
Yaak ist ein Moderner, Offline-Erst Desktop API Client aufgebaut mit Tauri, Rust und React. Es organisiert und führt REST, GraphQL, gRPC, WebSocket und Server-Sent Events (SSE) Anfragen in einer Schnellen, Leichtgewichtigen App, die Privacy-Erst ist: Keine Telemetrie, kein Account erforderlich, und keine Cloud Lock-In. Workspaces werden als Plain Dateien gespeichert, damit Sie sie mit Git Synchen können, und es unterstützt Umgebungen, Variablen und Import aus Postman/Insomnia.
Installation
| Plattform | Methode |
|---|
| macOS | Download die .dmg von yaak.app oder brew install --cask yaak |
| Windows | Download den Installer von yaak.app |
| Linux | AppImage / .deb / .rpm von yaak.app |
| Überprüfen | Starte die App; Prüfe Help → About für Version |
Request Typen
| Typ | Nutzung |
|---|
| REST / HTTP | Standard API Anfragen |
| GraphQL | Queries/Mutations mit Schema Introspection |
| gRPC | Rufe gRPC Services an (mit Reflection) |
| WebSocket | Bidirektionale Socket Verbindungen |
| SSE | Server-Sent Events Ströme |
Core Concepts
| Begriff | Bedeutung |
|---|
| Workspace | Ein Projekt Grouping Anfragen/Umgebungen |
| Folder | Organisiert Anfragen in einem Workspace |
| Umgebung | Benannte Set Variablen (Dev/Staging/Prod) |
| Variable | ${[ name ]} Template genutzt über Anfragen |
| Plain-File Sync | Workspace Daten gespeichert als Dateien → Git-freundlich |
Baue Anfragen
| Element | Notizen |
|---|
| Methode + URL | Mit Variable Templating |
| Query Params | Schlüssel/Wert Editor |
| Headers | Schlüssel/Wert Editor |
| Body | JSON, Form, GraphQL, Binär, usw. |
| Auth | Bearer, Basic, OAuth 2.0, API Schlüssel |
Umgebungen & Variablen
| Feature | Nutzung |
|---|
| Umgebungen | Wechsel Base URLs/Secrets pro Stage |
| Variablen | Referenz mit ${[ var ]} in jedem Feld |
| Dynamische Werte | Generierte Werte (Timestamps, UUIDs) |
| Secrets | Gehalten out of Synched Plain Dateien wenn konfiguriert |
Produktivität Features
| Feature | Beschreibung |
|---|
| Response Viewer | Pretty JSON, Headers, Timing, Größe |
| Verlauf | Vorherige Responses pro Anfrage |
| Import | Postman, Insomnia, cURL, OpenAPI |
| Plugins | Erweitere via ein Plugin System |
| Git Sync | Committe die Workspace Dateien zur Version Control |
| Templating | Kette Anfragen durch Referenzierung vorheriger Responses |
gRPC & GraphQL Notizen
| Protokoll | Fähigkeit |
|---|
| gRPC | Server Reflection zum Entdecken Services/Methoden; Streaming |
| GraphQL | Schema Introspection, Query Builder, Variablen |
Common Workflows
# Team Workflow mit Git-Basiert Sync
1. Erstelle einen Workspace; Speicher es in deinem Repo
2. Definiere Dev/Staging/Prod Umgebungen mit Variablen
3. Baue REST/GraphQL/gRPC Anfragen nutzen ${[ base_url ]}
4. Committe die Plain Dateien; Teammates ziehen und erhalten die selbe Collection
# Kette Anfragen
- Sende eine Login Anfrage, Erfasse den Token aus der Response
- Referenz es als Variable in nachfolgenden autorisierten Anfragen
Yaak vs Andere API Clients
| Aspekt | Yaak | Postman | ATAC | Bruno |
|---|
| Interface | Desktop GUI | Desktop GUI | Terminal TUI | Desktop GUI |
| Protokolle | REST/GraphQL/gRPC/WS/SSE | Breit | REST | REST/GraphQL |
| Telemetrie | Keine | Ja | Keine | Keine |
| Storage | Plain Dateien (Git) | Cloud/Lokal | Dateien | Dateien (Git) |
| Beste für | Privacy-Erst GUI, Multi-Protokoll | Teams/Cloud | Terminal-Erst | GUI + Git |
Ressourcen
