HTTP Client

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy

Fetches data from an HTTP endpoint. Supports one-shot or periodic polling.

Configuration

source:
  kind: http_client
  url: "https://api.example.com/data"
  method: GET
  headers:
    Authorization: ${HTTP_CLIENT_AUTH_HEADER}
  auth_strategy: bearer
  auth_token: ${HTTP_CLIENT_AUTH_TOKEN}
  scrape_interval_seconds: 60

Field	Default	Description
url	(required)	HTTP endpoint URL
method	GET	HTTP method (GET, POST, PUT)
headers		Map of additional request headers
body		Request body string
auth_strategy		basic or bearer
auth_user / auth_password		Credentials for basic auth
auth_token		Token for bearer auth
scrape_interval_seconds		Polling interval; omit for one-shot

Namespace: http.{url_host}

CLI

skippr connect source http-client \
  --url https://api.example.com/data \
  --method GET \
  --headers Authorization='Bearer your-token' \
  --body '{"include":"latest"}' \
  --auth-strategy bearer \
  --auth-token ${HTTP_CLIENT_AUTH_TOKEN} \
  --scrape-interval-seconds 60

Flag	Description
--url	HTTP endpoint URL
--method	HTTP method (default: GET)
--headers KEY=VALUE	Additional request header; repeat for multiple values
--body	Request body string
--auth-strategy	Authentication strategy such as basic or bearer
--auth-user	Username for basic auth
--auth-password	Password for basic auth
--auth-token	Token for bearer auth
--scrape-interval-seconds	Polling interval in seconds (omit for one-shot)

Authentication

Authentication is optional and depends on the upstream endpoint. For security best practices, we strongly advise against storing authentication values in skippr.yaml. Use environment variable interpolation instead: replace the relevant auth field with your own ${ENV_VAR} reference.

The relevant part of skippr.yaml looks like this:

source:
  kind: http_client
  auth_strategy: bearer
  auth_token: ${HTTP_CLIENT_AUTH_TOKEN}

Set the env var before running skippr:

macOS / Linux

export HTTP_CLIENT_AUTH_TOKEN="your-token"

Windows PowerShell

$env:HTTP_CLIENT_AUTH_TOKEN = "your-token"

Windows Command Prompt

set HTTP_CLIENT_AUTH_TOKEN=your-token

Permissions or Network Requirements

The runner must be able to reach the configured URL, and the upstream service must allow the HTTP method, headers, and polling cadence you configure.

Troubleshooting

Symptom	Fix
401 or 403 responses	Verify credentials, bearer tokens, and any required request headers.
timeouts or empty responses	Check the endpoint URL, method, timeout settings, and whether the service is rate limiting requests.

Next steps

• Pair this source with a destination from Destination Connectors.
• See How It Works for the end-to-end pipeline flow.

Install

See the Install guide for the full setup, including Windows PowerShell.

curl -fsSL https://install.skippr.io/install.sh | shClick to copy