ChangeGamer API

openapi: 3.1.0
info:
  title: ChangeGamer API
  version: '2026-11-03'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-03: 24 operation(s) read from 9 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; ChangeGamer has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 22
    pages-with-code: 6
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-03'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://changegamer.ai/api/corpus.json
  - https://changegamer.ai/api/corpus.jsonl
  - https://changegamer.ai/api/openapi.json
  - https://changegamer.ai/api/payment.json
  - https://changegamer.ai/api/articles.json
  - https://changegamer.ai/api/articles.jsonl
  - https://changegamer.ai/api/comparisons.json
  - https://changegamer.ai/api/evals-sample.jsonl
  - https://changegamer.ai/api/finetune-sample.jsonl
paths:
  /:
    get:
      operationId: get
      tags:
      - Api
      summary: GET /
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl -sI -A \"PerplexityBot/1.0\" \"https://example.com$p\" | head -1\ndone\n```\n\nAnything other than `200` (or a deliberate
          `402`/`404`) is a bug in your access policy, not a crawler problem. A `403` here means an edge rule is overriding the policy you published
          — and because `robots.txt` is fetched over the same path, the crawler may never even learn what your policy is.\n\n### The rest of the
  /api/corpus.full.jsonl:
    get:
      operationId: get_api_corpus_full_jsonl
      tags:
      - Api
      summary: Paid full export of the content corpus (NDJSON)
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiCorpusFullJsonlResponse'
      x-evidence:
        kind: documentation
  /api/corpus.jsonl:
    get:
      operationId: get_api_corpus_jsonl
      tags:
      - Api
      summary: Free sample of the content corpus (NDJSON)
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiCorpusJsonlResponse'
      x-evidence:
        kind: documentation
  /api/resources.json:
    get:
      operationId: get_api_resources_json
      tags:
      - Api
      summary: List of all resources in JSON format
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiResourcesJsonResponse'
      x-evidence:
        kind: documentation
  /api/x402/data-formats:
    get:
      operationId: get_api_x402_data_formats
      tags:
      - Api
      summary: GET /api/x402/data-formats
      x-source: https://changegamer.ai/api/corpus.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl call against the live endpoint\n\nThis works right now and returns 503, not a payment prompt (example slug `data-formats`,
          currently premium):\n\n```\n$ curl -sS -i https://changegamer.ai/api/x402/data-formats\n\nHTTP/1.1 503 Service Unavailable\nContent-Type:
          application/json; charset=utf-8\n\n{\n  \"error\": \"x402_not_configured\",\n  \"message\": \"Native x402 on-chain settlement is not
          y'
  /blog/agent-traffic.md:
    get:
      operationId: get_blog_agent_traffic_md
      tags:
      - Blog
      summary: Markdown variant of the Agent Traffic article
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetBlogAgentTrafficMdResponse'
      x-evidence:
        kind: documentation
  /extendedAgentCard:
    get:
      operationId: get_extendedAgentCard
      tags:
      - Extendedagentcard
      summary: When a card sets extendedAgentCard to true, an authenticated A2A client can fetch fuller details through GetExtendedAgentCard (GET
        /extendedAgentCard).
      x-source: https://changegamer.ai/api/articles.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /key:
    get:
      operationId: get_key
      tags:
      - Key
      summary: '`GET https://changegamer.ai/key?session_id=<cs_live_...>` returns a JSON containing the access key.'
      x-source: https://changegamer.ai/api/corpus.json
      parameters:
      - name: session_id
        in: query
        required: true
        schema:
          type: string
        description: Stripe checkout session identifier (format `cs_(live|test)_[A-Za-z0-9]+`).
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetKeyResponse'
      x-evidence:
        kind: documentation
  /llms-full.txt:
    get:
      operationId: get_llms_full_txt
      tags:
      - Llms Full
      summary: '`/llms-full.txt` inlines free resources in full and premium resources as a summary stub only.'
      x-source: https://changegamer.ai/api/corpus.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /llms.txt:
    get:
      operationId: get_llms_txt
      tags:
      - Llms
      summary: Start from `/llms.txt` for a compact index of resources.
      x-source: https://changegamer.ai/api/corpus.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /message{send}:
    post:
      operationId: post_message_send
      tags:
      - Message Send
      summary: 'A2A Protocol (Agent2Agent): Agent Card, Operations, Task States, Bindings'
      x-source: https://changegamer.ai/api/comparisons.json
      parameters:
      - name: send
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /message{stream}:
    post:
      operationId: post_message_stream
      tags:
      - Message Stream
      summary: 'A2A Protocol (Agent2Agent): Agent Card, Operations, Task States, Bindings'
      x-source: https://changegamer.ai/api/comparisons.json
      parameters:
      - name: stream
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /priced-thing:
    get:
      operationId: get_priced_thing
      tags:
      - Priced Thing
      summary: GET /priced-thing (x‑402 payment flow)
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPricedThingResponse'
      x-evidence:
        kind: documentation
  /resource:
    get:
      operationId: get_resource
      tags:
      - Resource
      summary: Generic resource endpoint (illustrative).
      description: Placeholder for a resource fetch; page does not detail specifics.
      x-source: https://changegamer.ai/api/corpus.jsonl
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /resources/premium-thing:
    get:
      operationId: get_resources_premium_thing
      tags:
      - Resources
      summary: GET /resources/premium-thing → 402 + JSON body + Link headers
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetResourcesPremiumThingResponse'
      x-evidence:
        kind: documentation
  /resources/some-premium-slug:
    get:
      operationId: get_resources_some_premium_slug
      tags:
      - Resources
      summary: 'Premium resources return `402 Payment Required` unless a valid `Authorization: Bearer <key>` or `x-api-key` header is provided.'
      x-source: https://changegamer.ai/api/corpus.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /robots.txt:
    get:
      operationId: get_robots_txt
      tags:
      - Robots
      summary: Robots policy file controlling agent access
      x-source: https://changegamer.ai/api/articles.jsonl
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetRobotsTxtResponse'
      x-evidence:
        kind: documentation
  /some-page:
    get:
      operationId: get_some_page
      tags:
      - Some Page
      summary: Example free page (no authentication required).
      description: Serves a regular HTML page.
      x-source: https://changegamer.ai/api/corpus.jsonl
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /tasks:
    get:
      operationId: get_tasks
      tags:
      - Tasks
      summary: 'A2A Protocol (Agent2Agent): Agent Card, Operations, Task States, Bindings'
      x-source: https://changegamer.ai/api/comparisons.json
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /tasks/{id}:
    get:
      operationId: get_tasks_id
      tags:
      - Tasks
      summary: 'A2A Protocol (Agent2Agent): Agent Card, Operations, Task States, Bindings'
      x-source: https://changegamer.ai/api/comparisons.json
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/chat/completions:
    post:
      operationId: post_v1_chat_completions
      tags:
      - Chat
      summary: Unified OpenAI‑compatible chat completions endpoint used by AI gateways.
      x-source: https://changegamer.ai/api/corpus.json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ChatCompletionsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ChatCompletionsResponse'
      x-evidence:
        kind: documentation
  /v1/messages/count_tokens:
    post:
      operationId: post_v1_messages_count_tokens
      tags:
      - Messages
      summary: 'LLM Tokenization and Token Counting: tiktoken, Provider Counting Endpoints, and Why Counts Differ?'
      x-source: https://changegamer.ai/api/evals-sample.jsonl
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1MessagesCountTokensRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1MessagesCountTokensResponse'
      x-evidence:
        kind: documentation
  /v1/responses:
    post:
      operationId: post_v1_responses
      tags:
      - Responses
      summary: OpenAI Responses API shape supported by some gateways.
      x-source: https://changegamer.ai/api/corpus.json
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ResponsesRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ResponsesResponse'
      x-evidence:
        kind: documentation
  /webhooks/stripe:
    post:
      operationId: post_webhooks_stripe
      tags:
      - Webhooks
      summary: Stripe webhook endpoint for payment events.
      x-source: https://changegamer.ai/api/corpus.json
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiCorpusFullJsonlResponse:
      type: object
      properties:
        id:
          type: string
          description: Record identifier
        title:
          type: string
          description: Record title
        text:
          type: string
          description: Full text for all records
    GetApiCorpusJsonlResponse:
      type: object
      properties:
        id:
          type: string
          description: Record identifier
        title:
          type: string
          description: Record title
        text:
          type: string
          description: Full text for free records, null for premium records
        access:
          type: object
          description: Object describing how to unlock premium records, omitted for free records
    GetApiResourcesJsonResponse:
      type: object
      properties:
        resources:
          type: array
          description: Array of resource objects
        slug:
          type: string
          description: Resource slug
        title:
          type: string
          description: Human‑readable title
        premium:
          type: boolean
          description: Whether the resource requires payment
    GetBlogAgentTrafficMdResponse:
      type: object
      properties:
        title:
          type: string
          description: Article title
        content:
          type: string
          description: Markdown body of the article
    GetKeyResponse:
      type: object
      properties:
        key:
          type: string
          description: The `cg_` access key.
        created:
          type: string
          description: ISO‑8601 timestamp of key creation.
        tier:
          type: string
          description: Tier of the key (e.g., `starter`).
    GetPricedThingResponse:
      type: object
      properties:
        error:
          type: string
          description: payment_required
        resource:
          type: string
          description: priced-thing
        price:
          type: number
          description: Price in EUR
        payment_url:
          type: string
          description: URL to purchase
        how_to_pay:
          type: string
          description: Machine‑readable payment instructions
    GetResourcesPremiumThingResponse:
      type: object
      properties:
        error:
          type: string
          description: payment_required
        resource:
          type: string
          description: premium-thing
        title:
          type: string
          description: The Premium Thing
        description:
          type: string
          description: What this resource contains, in one sentence.
        outline:
          type: array
          description: Array of section titles
        words:
          type: integer
          description: Word count
        updated:
          type: string
          description: ISO‑8601 date of last update
        price:
          type: number
          description: Price in EUR
        currency:
          type: string
          description: EUR
        payment_url:
          type: string
          description: URL to buy an access key
        how_to_pay:
          type: string
          description: Prose instructions for a machine
        pricing:
          type: string
          description: Link to pricing catalogue
        terms:
          type: string
          description: Link to terms markdown
        license:
          type: string
          description: Link to licence XML
        free_alternatives:
          type: array
          description: Links to free alternatives
    GetRobotsTxtResponse:
      type: object
      properties:
        User-agent:
          type: string
          description: Crawler identifier
        Disallow:
          type: string
          description: Path restrictions
        Allow:
          type: string
          description: Path allowances
    PostV1ChatCompletionsRequest:
      type: object
      properties:
        model:
          type: string
          description: Identifier of the model to use.
        messages:
          type: array
          description: Chat message objects.
        temperature:
          type: number
          description: Sampling temperature.
      required:
      - model
      - messages
    PostV1ChatCompletionsResponse:
      type: object
      properties:
        choices:
          type: array
          description: Generated completions.
    PostV1MessagesCountTokensRequest:
      type: object
      properties:
        body:
          type: object
          description: Same structure as a message request, including system prompts, tools, images and PDFs.
      required:
      - body
    PostV1MessagesCountTokensResponse:
      type: object
      properties:
        input_tokens:
          type: integer
          description: Estimated number of input tokens.
    PostV1ResponsesRequest:
      type: object
      properties:
        model:
          type: string
          description: Model identifier.
        messages:
          type: array
          description: Chat messages.
      required:
      - model
      - messages
    PostV1ResponsesResponse:
      type: object
      properties:
        response:
          type: object
          description: Structured response payload.
  securitySchemes:
    JWT-SVID:
      type: http
      scheme: bearer
      x-source: https://changegamer.ai/resources/agent-identity-authentication.md
    api_key:
      type: apiKey
      in: query
      name: Authorization
      x-source: https://changegamer.ai/resources/agent-identity-authentication.md
tags:
- name: Api
- name: Blog
- name: Chat
- name: Extendedagentcard
- name: Key
- name: Llms
- name: Llms Full
- name: Message Send
- name: Message Stream
- name: Messages
- name: Priced Thing
- name: Resource
- name: Resources
- name: Responses
- name: Robots
- name: Some Page
- name: Tasks
- name: Webhooks
security:
- JWT-SVID: []
- api_key: []