curl-recipes

curl-recipes

Targeted curl patterns for debugging HTTP services, testing API endpoints, inspecting TLS, and measuring request timing. Micro-skill — composable with network, ssl-tls, api, and webhook debugging workflows.

1) Response Inspection

# Headers only
curl -I https://example.com

# Verbose — full request + response headers
curl -v https://example.com

# Silent body, show HTTP status code only
curl -s -o /dev/null -w "%{http_code}" https://example.com/health

# Follow redirects + show final URL
curl -L -s -o /dev/null -w "%{url_effective}\n" https://example.com

# Show response headers + body
curl -D - https://example.com

2) Auth Patterns

# Bearer token
curl -H "Authorization: Bearer $TOKEN" https://api.example.com/me

# Basic auth
curl -u username:password https://api.example.com/endpoint
curl -H "Authorization: Basic $(echo -n user:pass | base64)" https://api.example.com

# API key in header
curl -H "X-Api-Key: $API_KEY" https://api.example.com/data

# Cookie
curl -b "session=abc123" https://app.example.com/dashboard

# Client certificate (mTLS)
curl --cert client.crt --key client.key --cacert ca.crt https://internal.api/

3) POST / JSON Bodies

# JSON POST
curl -s -X POST https://api.example.com/items \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"name": "test", "value": 42}'

# From file
curl -X POST https://api.example.com/ingest \
  -H "Content-Type: application/json" \
  -d @payload.json

# Form data
curl -X POST https://api.example.com/login \
  -F "username=admin" \
  -F "password=secret"

# URL-encoded form
curl -X POST https://api.example.com/token \
  -d "grant_type=client_credentials&client_id=xxx&client_secret=yyy"

4) File Upload

# Multipart file upload
curl -X POST https://api.example.com/upload \
  -H "Authorization: Bearer $TOKEN" \
  -F "file=@/path/to/file.pdf" \
  -F "name=my-document"

# PUT binary
curl -X PUT https://storage.example.com/object-key \
  -H "Content-Type: application/octet-stream" \
  --data-binary @/path/to/file.bin

# S3 presigned URL upload
curl -X PUT "$PRESIGNED_URL" \
  -H "Content-Type: image/jpeg" \
  --upload-file photo.jpg