Documentation

Welcome to the APIHub Star API. One key, one base URL, every provider. The gateway is fully REST, returns JSON, and is available at https://api.apihubstar.tech.

Authentication

All requests are authenticated with a Bearer token. Create keys in your dashboard and scope them per environment.

Authorization: Bearer ahs_live_xxxxxxxxxxxxxxxx

Keys are prefixed ahs_live_ (production) or ahs_test_ (sandbox). Rotate them any time without redeploying.

Quickstart

curl https://api.apihubstar.tech/v4/geo/ip/1.1.1.1 \
  -H "Authorization: Bearer ahs_test_demo"

Endpoints

Method	Path	Description
GET	/v4/geo/ip/{ip}	Geolocate an IP address
POST	/v4/payments/charge	Create a charge
GET	/v4/fx/rates	Latest FX & crypto rates
POST	/v4/vision/ocr	Extract text from an image
POST	/v4/sms/send	Send an SMS
GET	/v4/weather/now	Current weather

Errors

Code	Meaning
400	Bad request — check parameters
401	Missing or invalid API key
429	Rate limit exceeded — see `Retry-After`
503	Upstream degraded — gateway is failing over

Rate limits

Limits are returned on every response via X-RateLimit-Remaining and X-RateLimit-Reset. The Team plan ships with adaptive burst smoothing enabled by default.

SDKs

Typed clients are generated from our OpenAPI spec:

npm i @apihubstar/sdk
pip install apihubstar
go get github.com/apihubstar/go-sdk

Changelog

v4.2 — Edge regions in 23 countries, p95 latency cut by 18%.
v4.1 — Adaptive rate-limiting GA, new Vision OCR tables model.
v4.0 — Unified auth, multi-provider failover routing.