http-client_skill

Overview

This skill is an HTTP client that sends requests with full support for GET, POST, PUT, DELETE and other methods. It accepts custom headers, authentication, JSON bodies, form data and file uploads, then returns status, headers and response body for inspection. It is implemented in TypeScript and designed for scripting and interactive API testing.

How this skill works

You provide method, URL and optional parameters (headers, auth, JSON, form fields, files). The client constructs the HTTP request, attaches authentication and headers, encodes body (JSON or multipart), sends the request, and captures the response status, headers and body. It also exposes error details and HTTP-level diagnostics for debugging failed calls.

When to use it

• Testing or debugging REST endpoints from scripts or command line
• Automating API calls with custom headers and authentication
• Uploading files to an API endpoint using multipart/form-data
• Sending JSON payloads, form data, or raw bodies to a server
• Inspecting response headers and status codes for integration checks

Best practices

• Specify Content-Type and Authorization headers explicitly to avoid server rejections
• Use JSON flag for structured payloads and multipart for file uploads
• Log request and response headers when debugging authentication or CORS issues
• Validate SSL/TLS settings or skip verification only in trusted environments
• Handle non-2xx responses explicitly and surface response body for error insights

Example use cases

• GET a resource list with custom Authorization header to verify token scopes
• POST a JSON payload to create a user and examine the returned location header
• PUT an updated record with ETag/If-Match headers to enforce optimistic concurrency
• POST multipart/form-data including files and metadata to an upload endpoint
• Run automated smoke tests that assert status codes and key response fields