Kann KI das? Sponsoring Agent Agent API

The Agent API from Kann KI das? Sponsoring Agent — 3 operation(s) for agent.

Operations 3

POST /agent/register Register an OAuth client for an agent #
POST /agent/purchases Create an idempotent Stripe Checkout Session #
GET /agent/purchases/{purchase_id} Read a purchase without exposing buyer PII #

Documentation

Specifications

Schemas & Data

Other Resources

🔗
Pricing
https://kannkidas.de/pricing.md
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/examples/kannkidas-de-list-sponsor-slots-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/examples/kannkidas-de-search-products-example.json
🔗
Examples
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/examples/kannkidas-de-x402-buyer-brief-402-example.json
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/conventions/kannkidas-de-conventions.yml
🔗
Idempotency
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/conventions/kannkidas-de-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/errors/kannkidas-de-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/data-model/kannkidas-de-data-model.yml
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/plans/kannkidas-de-plans-pricing.yml
🔗
Sandbox
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/sandbox/kannkidas-de-sandbox.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/lifecycle/kannkidas-de-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/kannkidas-de/refs/heads/main/conformance/kannkidas-de-conformance.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kannkidas-de:kannkidas-de-agent-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kannkidas-de-agent-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kann KI das? Agent API
  version: 1.1.0
  description: Faceted product search plus machine-readable availability and buyer-confirmed Stripe Checkout for fixed sponsor placements.
servers:
- url: https://kannkidas.de/api
tags:
- name: Agent
paths:
  /agent/register:
    post:
      operationId: registerAgentClient
      summary: Register an OAuth client for an agent
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegistrationRequest'
      responses:
        '201':
          description: Client credentials returned once
        '400':
          description: Invalid registration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Agent
  /agent/purchases:
    post:
      operationId: createSponsorPurchase
      summary: Create an idempotent Stripe Checkout Session
      description: Call only after the buyer explicitly confirms a live slot, price and term. Payment details are collected by Stripe.
      security:
      - oauth2:
        - sponsorship:write
      parameters:
      - name: Idempotency-Key
        in: header
        required: true
        schema:
          type: string
          minLength: 8
          maxLength: 128
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PurchaseRequest'
      x-payment-info:
        intent: session
        method: stripe
        amount: 99000
        currency: EUR
        methods:
        - method: stripe
          type: hosted_checkout
      responses:
        '201':
          description: Checkout created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
        '401':
          description: Bearer token missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Slot unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Agent
  /agent/purchases/{purchase_id}:
    get:
      operationId: getSponsorPurchase
      summary: Read a purchase without exposing buyer PII
      security:
      - oauth2:
        - sponsorship:read
      parameters:
      - name: purchase_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Purchase state
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Purchase'
        '404':
          description: Unknown purchase
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Agent
components:
  schemas:
    Error:
      type: object
      required:
      - message
      properties:
        message:
          type: string
    Purchase:
      type: object
      required:
      - purchase_id
      - slot_id
      - status
      - status_url
      properties:
        purchase_id:
          type: string
        slot_id:
          type: string
        status:
          enum:
          - checkout_created
          - paid
          - expired
        checkout_url:
          type: string
          format: uri
        status_url:
          type: string
          format: uri
        expires_at:
          type: string
          format: date-time
        amount:
          type: integer
          const: 99000
        currency:
          type: string
          const: EUR
    RegistrationRequest:
      type: object
      additionalProperties: false
      required:
      - name
      properties:
        name:
          type: string
          minLength: 3
          maxLength: 80
        scopes:
          type: array
          minItems: 1
          uniqueItems: true
          items:
            enum:
            - sponsorship:read
            - sponsorship:write
          default:
          - sponsorship:read
    PurchaseRequest:
      $ref: https://kannkidas.de/schema/agent-purchase.json
  securitySchemes:
    clientBasic:
      type: http
      scheme: basic
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://kannkidas.de/api/oauth/token
          scopes:
            sponsorship:read: Read own purchase status
            sponsorship:write: Create a confirmed checkout