Pontx HubAPI reference for humans & agents
DOCSPontx Hub
Public docsv1
On this pageUniversal CLI

CLI / @pontx/hub-cli

One CLI for the entire API catalog.

Use pontx-hub to search, inspect, preview, and call curated APIs, with stable JSON output for scripts and agents.

01Discoverpontx-hub search
02Inspectpontx-hub show
03Previewpontx-hub preview
04Integratepontx-hub sdk
01

Install and configure

The universal package is @pontx/hub-cli and its executable is pontx-hub.

Global install
pnpm add --global @pontx/hub-cli
pontx-hub --help
02

Command map

Discovery commands are resource-centered; request commands follow API product → controller → Endpoint name.

listList API products
search <query>Search APIs, Endpoints, and Schemas
show <resource-id>Inspect a stable resource
<api> preview …Build a redacted preview
<api> call …Call through the controlled Hub proxy
sdk <api>Inspect SDK package and status
skill installInstall the universal Agent Skill
03

Search and inspect

Search results use stable IDs, so later commands and agents never need to guess URLs.

Natural language
pontx-hub search "返回 dueDate 的接口" --locale zh --json
pontx-hub show endpoint:dida365/get-task-by-id

Repeat --type with api, endpoint, or schema; use --limit and --offset for stable pagination.

04

Build a request

Pass Endpoint parameters as same-name options; use --body for JSON and -H for an additional declared header.

Command anatomy
pontx-hub <api-product> preview [controller] <endpoint-name> --parameter value

# Controller present
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD

# No meaningful controller
pontx-hub frankfurter-v2 preview getRates --base USD
--projectId 123
Preferred: use the OAS parameter name directly.
--body '<json>'
Pass a JSON request body.
-H 'Header: value'
Add a declared raw header; never expose secrets in arguments.
05

Scripts and automation

Use --json for programs, and preserve the exit code and error.code.

Machine-readable output
pontx-hub search "exchange rate" --type endpoint --json > results.json

# Keep credentials in the environment, never in CLI arguments.
export PROVIDER_ACCESS_TOKEN="<from-your-secret-manager>"
pontx-hub <api-product> preview <endpoint-name>