Curl Cookbook

Mon, 01 Jan 0001 00:00:00 +0000

Curl Cookbook#

Every example below works against the real stub files shipped in the repository (stubs/) with the server running on its default port:

simuhook

Static Response#

curl http://localhost:8080/health
# → {"status":"ok"}

Source: health.yaml — minimal static response.

Wildcard Method#

curl http://localhost:8080/catch-all
curl -X POST http://localhost:8080/catch-all
curl -X DELETE http://localhost:8080/catch-all
# → {"message":"matched any method"}

Source: method-match.yaml — empty method matches any verb.

Query Parameter Matching#

curl "http://localhost:8080/ping?ping_id=11022022&ping_child=43443"
# → {"message":"pong"}

Source: ping.yaml — both params required with exact values. Missing either → 404.

REST API Guide

Mon, 01 Jan 0001 00:00:00 +0000

RESTful API Simulation — Patterns#

How to simulate RESTful API behavior with Simuhook stub files. Nine patterns, each with a YAML stub, the curl command, and a link to the shipped example.

CRUD ↔ HTTP Mapping#

Operation	HTTP Method	Typical Status	Example Stub
List / Read	`GET`	`200 OK`	`health.yaml`, `ping.yaml`
Create	`POST`	`201 Created`	`user-create.yaml`
Replace	`PUT`	`200 OK`	—
Partial update	`PATCH`	`200 OK`	—
Delete	`DELETE`	`204 No Content`	—
Any method	(empty)	`200 OK`	`method-match.yaml`

1. Static Read Endpoint#

Return a fixed JSON response for a GET request.

Examples on spectralab