API Smoke Test

API Smoke Test

Verify API availability and performance. Validates deploy_to_ephemeral and release_to_prod.

Inputs

Workflow

1. Load Persona

• persona_load("developer")

2. Check Known Issues

• check_known_issues("curl", "")
• check_known_issues("api", "")

3. TLS Check

• openssl_s_client(host="{{ base_url }}") — verify TLS
• Parse: "verify return code: 0" → ok, extract TLS version

4. HTTP Endpoint Checks

• curl_get(url="{{ base_url }}/") — root
• curl_get(url="{{ base_url }}/health") — health
• curl_head(url="{{ base_url }}/")
• curl_headers(url="{{ base_url }}/")
• curl_timing(url="{{ base_url }}/") — latency
• curl_post(url="{{ base_url }}/api/v1/ping") — if endpoint exists
• curl_put(url="{{ base_url }}/api/v1/ping") — if endpoint exists
• curl_delete(url="{{ base_url }}/api/v1/ping") — if endpoint exists

5. Parse Results

• HTTP status 200–499 → pass
• Timing: total > 2s → slow
• Count passed/total endpoints

6. Failure Learning

• "could not resolve" → learn_tool_fix("curl_get", "could not resolve", "DNS resolution failed", "Verify hostname and DNS")
• "connection refused" → service not running
• "no route to host" → vpn_connect() for internal APIs

7. Memory

• memory_session_log("API smoke test on {{ base_url }}", "environment={{ environment }}, passed=X/Y")

Error Recovery

Output

Report: endpoint results table (passed/total), TLS version, response timing (total, connect, slow flag), response headers, known issues. If failures: suggest skill_run("debug_prod", ...).

Chains To

• debug_prod, create_jira_issue, investigate_alert