DiffiCat Feedback API

openapi: 3.2.0
info:
  title: Difficat Com Feedback API
  version: 3.149.0
  description: 'Operations tagged Feedback across 2 of this provider''s published API definitions: difficat-com-agent-api-openapi.json, difficat-com-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://app.difficat.com/api/v1
tags:
- name: Feedback
paths:
  /feedback:
    post:
      operationId: sendFeedback
      summary: Tell the people who run this service why a price, a payment path or a result…
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedbackRequest'
            example:
              topic: price
              message: Too expensive for 150 pages
              relatedTool: start_comparison
              quotedAmount: '3.00'
              pages: 150
      responses:
        '202':
          description: Delivered
          content:
            application/json:
              schema:
                type: object
                required:
                - received
                properties:
                  received:
                    type: boolean
                    enum:
                    - true
              example:
                received: true
        '400':
          description: The body fails validation; error names the field
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many messages from this address this hour (Retry-After)
        '503':
          description: Feedback delivery is not configured or unreachable
      tags:
      - Feedback
    servers:
    - url: https://app.difficat.com/api/v1
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: string
    FeedbackRequest:
      type: object
      required:
      - topic
      - message
      properties:
        topic:
          type: string
          enum:
          - price
          - payment
          - missing_feature
          - error
          - docs
          - other
        message:
          type: string
          minLength: 1
          maxLength: 2000
        relatedTool:
          type: string
          description: An MCP tool name of this server.
        quotedAmount:
          type: string
          description: Two-decimal USD string, e.g. "3.00".
        wouldPayAt:
          type: string
          description: Two-decimal USD string.
        pages:
          type: integer
          minimum: 1
        contact:
          type: string
          maxLength: 200
  securitySchemes:
    payment:
      type: http
      scheme: Payment
      description: 'Machine Payments Protocol (mpp.dev). A first request without a credential is answered with 402 and a WWW-Authenticate: Payment challenge; the paid retry carries Authorization: Payment <credential>. Successful responses carry a Payment-Receipt header. x402 clients are accepted on the same routes for USDC on Base.'
    jobToken:
      type: http
      scheme: bearer
      description: The jobToken returned when the job or screenshot was created. The prepaid key that paid a job is accepted in its place.
    prepaidKey:
      type: http
      scheme: bearer
      description: A prepaid key (dck_…) from the account page at /account, where a signed-in human tops up by card through Stripe Checkout and copies the key. On a paid call the priced amount is debited from its balance instead of a 402 challenge; on job reads it stands in for the jobToken of the jobs it paid.
    shareToken:
      type: http
      scheme: bearer
      description: A share token (dcs_…) a snapshot’s owner issued in the web app. It reads that one snapshot and starts live compares against it; it never lists, manages or pays.
    shareTokenHeader:
      type: apiKey
      in: header
      name: X-DiffiCat-Share
      description: The same share token, sent beside a paying Authorization credential (a prepaid or Pro key, or a payment credential) on the two compare routes.
x-refined-from:
- difficat-com-agent-api-openapi.json
- difficat-com-openapi.yml
x-service-info:
  categories:
  - web
  - testing
  - monitoring
  docs:
    homepage: https://difficat.com
    llms: https://difficat.com/llms.txt
    apiReference: https://app.difficat.com/api/v1/openapi.json
  x-prepaid:
    topUp: https://app.difficat.com/account
    amountsUsd:
    - 5
    - 10
    - 25
  x-sample:
    report: https://difficat.com/agents/sample/report.json
    freePages: 40
    freeDiscoveries: 5
    freeScreenshots: 5