ZAPADS
Sign inGet started

Discovery API · v1

API reference

Generated from the checked-in OpenAPI 3 document. Base path: /api/v1.

Title

ZapAds Discovery API (read-only subset)

Version

1

Operations

5 endpoints across 5 paths

Description

**Read-only subset retained for backward compatibility.** The canonical, full v1 spec —
including provider/agent registration, key rotation, balance, invocations, and service
writes — is at `/api/v1/openapi.yaml` (or `/openapi/v1.yaml` as a static asset).

This file only documents the anonymous discovery endpoints. Responses include header
`X-ZapAds-Version: 1`. Rate limits: anonymous 60 req/min per IP; with Bearer
`zap_agent_...` minted via `POST /api/v1/agents/register`, 600 req/min.

Paths

  • /categories
    • getCategories with counts

      Responses: 200 (OK)

  • /providers/{id}
    • getProvider summary

      Responses: 200 (OK)

  • /services
    • getList services

      Responses: 200 (OK) · 429 (Rate limited — Retry-After header present)

  • /services/{id}
    • getGet one service by UUID

      Responses: 200 (Single service)

  • /services/search
    • getSearch services (same filters as /services)

      Responses: 200 (OK — meta may document filters)

For interactive exploration, use your deployment origin (e.g. curl "$ORIGIN/api/v1/services").