DIDHub Docs

Appearance

API clients & tools ​

The DIDHub API is described by a single OpenAPI 3.1 document. Any tool that imports OpenAPI can generate a fully-typed client, a request collection, or mock servers — no hand-wiring required.

The spec ​

text
https://docs.didhub.io/openapi.json

This is the same spec that powers the interactive explorer. It's always current with the live API.

Import into a REST client ​

One-step import

All of these import directly from the spec URL above — no manual endpoint entry.

Postman ​

  1. Import → Link → paste https://docs.didhub.io/openapi.json
  2. Postman generates a collection with every endpoint, grouped by tag.
  3. Set a collection variable baseUrl = https://api.didhub.io/v1 and an Authorization header (Bearer didhub_live_…).

Insomnia ​

  1. Create → Import From → URL → paste the spec URL.
  2. Insomnia builds a request collection + a base environment.

Bruno ​

  1. Import Collection → OpenAPI V3 → paste the URL or the downloaded file.

Hoppscotch ​

  1. Import → OpenAPI → URL.

Generate a typed client ​

Use openapi-typescript for TypeScript types, or openapi-generator for a full client in 50+ languages.

bash
npx openapi-typescript https://docs.didhub.io/openapi.json -o didhub.d.ts
bash
openapi-generator-cli generate \
  -i https://docs.didhub.io/openapi.json \
  -g python \
  -o ./didhub-python
bash
openapi-generator-cli generate \
  -i https://docs.didhub.io/openapi.json \
  -g go \
  -o ./didhub-go

Authentication in your client ​

Set a single header on every request:

text
Authorization: Bearer didhub_live_…

Create a key at Dashboard → Settings → API keys. For per-user access on behalf of your users, use OAuth instead of a static key.

Official SDKs ​

First-party SDKs (npm + PyPI) are on the roadmap. Until then, the generated clients above cover every endpoint. Tell us which language you want first.