minia2a-uk Platform API

openapi: 3.2.0
info:
  title: minia2a.uk Platform API
  version: 5.0.0
  description: '1769 live pay-per-call API services (generated from the live catalog). 5 free trial calls per signed wallet (no registration) — no API key. Draw a trial by signing ''minia2a trial:::'' and sending ?wallet= plus X-Wallet-Signature / X-Trial-Timestamp headers. Publish your own API: POST /api/v1/publish-service. Every endpoint answers HTTP 402 with an x402 challenge; add ?probe=1 to see the challenge without spending a trial.'
  contact:
    url: https://minia2a.uk
    email: iris@minia2a.uk
servers:
- url: https://minia2a.uk
tags:
- name: Platform
  description: Registration, publishing, catalog and stats
paths:
  /api/v1/register-simple:
    post:
      summary: Register a wallet for publishing services (does NOT grant trials).
      operationId: register_agent
      tags:
      - Platform
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - wallet
              - signature
              properties:
                name:
                  type: string
                wallet:
                  type: string
                signature:
                  type: string
      responses:
        '200':
          description: Registered for publishing (trials come from any signed wallet, not registration)
        '400':
          description: Missing name, wallet or signature
  /api/v1/publish-service:
    post:
      summary: 'Publish a pay-per-call API service. Sign ''minia2a publish: '''
      operationId: publish_service
      tags:
      - Platform
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - endpoint
              - price_cents
              - wallet
              - signature
              properties:
                name:
                  type: string
                endpoint:
                  type: string
                price_cents:
                  type: integer
                wallet:
                  type: string
                signature:
                  type: string
      responses:
        '200':
          description: Published
        '400':
          description: Validation error
  /api/services/{id}:
    put:
      summary: 'Update your own service. Sign ''minia2a update: '''
      operationId: update_service
      tags:
      - Platform
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Updated
    delete:
      summary: 'Deregister (delist) your own service. Sign ''minia2a deregister: '''
      operationId: deregister_service
      tags:
      - Platform
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Deregistered
  /api/services:
    get:
      summary: The live catalog — every service with price, category, trial count and…
      operationId: list_services
      tags:
      - Platform
      parameters:
      - name: limit
        in: query
        required: false
        description: Page size. A non-positive value returns the entire catalog, not an empty page.
        schema:
          type: integer
      - name: offset
        in: query
        required: false
        description: 'Rows to skip. Past the end: 0 rows, with `count` unchanged.'
        schema:
          type: integer
      - name: q
        in: query
        required: false
        description: Search. Every whitespace-separated word must appear in the service's id, name or description (AND, not OR). Case-insensitive; word order does not matter and a hyphen is equivalent to a space.
        schema:
          type: string
      - name: search
        in: query
        required: false
        description: Alias of `q`.
        schema:
          type: string
      - name: category
        in: query
        required: false
        description: Exact match against one of the keys in /api/stats -> categories. An unknown value returns 0 rows.
        schema:
          type: string
      - name: sort
        in: query
        required: false
        description: Only `newest` has an effect (creation time, descending). Every other value is silently ignored and the catalog's own order is returned.
        schema:
          type: string
          enum:
          - newest
      responses:
        '200':
          description: OK
  /api/stats:
    get:
      summary: Live platform counters (services, wallets, trials, on-chain settlements)
      operationId: get_stats
      tags:
      - Platform
      responses:
        '200':
          description: OK