api-tester
API Tester validates endpoints and their responses against expected schemas. Extract API specs from documentation, test GET and POST requests, and document any discrepancies between live behavior and published contracts.
API Tester lets you test and validate API endpoints while verifying response schemas match documentation.
AI-generated summary based on this skill's SKILL.md
Install
gooseworks-ai/goose-skills/api-tester · repository language: Python
git clone https://github.com/gooseworks-ai/goose-skills
cp -r goose-skills/skills/research-tools/capabilities/api-tester ~/.claude/skills/api-testerFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does api-tester validate API response schema?
API Tester validates endpoints and their responses against expected schemas by extracting API specs from documentation and comparing live behavior against published contracts. It checks response structure, data types, and required fields to ensure responses match their documented definitions.
Can api-tester test REST API endpoints?
Yes, API Tester is designed to test REST API endpoints comprehensively. It supports testing GET and POST requests, verifies response schemas, checks status codes, and validates error handling across your API workflows to ensure endpoints behave as documented.
What does api-tester do to check API status codes?
API Tester checks API status codes and error handling by validating HTTP response codes against expected values. It verifies that endpoints return appropriate status codes for success, client errors, and server errors, helping identify unexpected API behavior.
Does api-tester generate API documentation examples?
API Tester generates API documentation and example requests to help document your endpoints. It can produce curl examples and request samples based on your API specifications, making it easier to create and maintain accurate API documentation.
How can api-tester automate REST API testing workflows?
API Tester automates REST API testing workflows by allowing you to define test cases that validate endpoints, verify responses, check status codes, and document discrepancies. This enables continuous validation of your API contracts without manual testing.
What license does api-tester use?
API Tester is released under the MIT license, allowing free use, modification, and distribution with minimal restrictions.
SKILL.md
rendered from the published skill — quoted content, verbatim
API Tester - Test Any API Endpoint
Setup
Read your credentials from ~/.gooseworks/credentials.json:
export GOOSEWORKS_API_KEY=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json'))['api_key'])")
export GOOSEWORKS_API_BASE=$(python3 -c "import json;print(json.load(open('$HOME/.gooseworks/credentials.json')).get('api_base','https://api.gooseworks.ai'))")
If ~/.gooseworks/credentials.json does not exist, tell the user to run: npx gooseworks login
All endpoints use Bearer auth: -H "Authorization: Bearer $GOOSEWORKS_API_KEY"
Test API endpoints, validate responses, and generate documentation examples.
Workflow
Step 1: Test GET Endpoints
Make GET requests to test endpoints:
curl -s -X POST $GOOSEWORKS_API_BASE/v1/proxy/orthogonal/run \
-H "Authorization: Bearer $GOOSEWORKS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api":"linkup","path":"/fetch","body":{"url":"https://api.example.com/health"}}'
Step 2: Test POST Endpoints
Test POST requests by
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
skills/research-tools/capabilities/api-tester/SKILL.md
skills/research-tools/capabilities/api-tester/skill.meta.json