Playground Overview
The built-in playground provides demo endpoints for all supported protocols, perfect for learning and testing Istek features.
What is the Playground?
The playground is a local server that runs inside Istek, providing:
- REST API for HTTP testing
- WebSocket echo server
- SSE (Server-Sent Events) for real-time streaming
- GraphQL endpoint with queries and mutations
- gRPC service with reflection enabled
- MQTT broker for pub/sub testing
- Unix Socket server (macOS/Linux)
Starting the Playground
- Look for the Playground panel at the bottom of the sidebar
- Click Start Playground
- Wait for all services to start (green indicators)
Stopping the Playground
Click Stop Playground to shut down all services.
Architecture
Ports
| Service | Port | URL |
|---|---|---|
| HTTP (REST, WS, GraphQL) | 19510 | http://localhost:19510 |
| MQTT Broker | 19511 | localhost:19511 |
| gRPC Server | 19512 | localhost:19512 |
| Unix Socket | - | /tmp/istek-playground.sock |
Data
The playground comes with sample data:
Products
| ID | Name | Price | Category |
|---|---|---|---|
| 1 | Laptop Pro | $1299.99 | Electronics |
| 2 | Wireless Mouse | $49.99 | Electronics |
| 3 | Coffee Mug | $14.99 | Kitchen |
| 4 | Notebook Set | $24.99 | Office |
| 5 | USB-C Cable | $19.99 | Electronics |
Users (GraphQL)
| ID | Name | |
|---|---|---|
| 1 | Alice Johnson | [email protected] |
| 2 | Bob Smith | [email protected] |
| 3 | Carol White | [email protected] |
| 4 | David Brown | [email protected] |
| 5 | Eve Davis | [email protected] |
Data Reset
Data modifications are stored in memory. To reset:
- Stop the playground
- Start the playground again
Or call:
POST http://localhost:19510/api/reset
Use Cases
Learning
Practice with each protocol before using real APIs.
Documentation Examples
All documentation examples use playground endpoints.
Offline Development
Work without internet using local playground services.
Debugging
Test request configurations before sending to production.
Features by Protocol
| Protocol | Features |
|---|---|
| HTTP | CRUD operations, OpenAPI spec |
| WebSocket | Echo messages, JSON responses |
| SSE | Real-time event streaming, counters, timestamps |
| GraphQL | Queries, mutations, SDL endpoint |
| gRPC | Reflection, unary calls, streaming |
| MQTT | Publish, subscribe, QoS levels |
| Unix Socket | Same as HTTP, via socket |
Next Steps
See Playground Endpoints for detailed API documentation.