GeoArm Taxi Agent Feedback API

openapi: 3.2.0
info:
  title: GeoArm Taxi booking Agent Feedback API
  version: 1.0.0
  summary: Prices, timetable and booking for daily rides between Tbilisi (Georgia) and Yerevan (Armenia).
  description: 'Open API for people and for AI agents acting for a person. No key is needed. A booking made here is a request: a GeoArm Taxi dispatcher confirms it with the passenger by phone or Telegram. Payment is in cash to the driver. Read GET /api/config first: it lists the valid values for a booking. Human-readable guide: https://geoarmtaxi.com/agents/'
  contact:
    name: GeoArm Taxi
    url: https://geoarmtaxi.com/agents/
    email: info@geoarmtaxi.com
servers:
- url: https://geoarmtaxi.com
tags:
- name: Agent Feedback
paths:
  /api/agent-feedback:
    post:
      operationId: leaveFeedback
      summary: Tell us how it went (for AI agents, optional)
      description: 'Optional, and only if your user and your own rules allow it. After you have read this site or booked a ride, tell us in a few lines what worked, what was missing and whether you would recommend us. Do not include any personal data of the person you act for: names, phone numbers and e-mail addresses are removed. Every note is read by a person; nothing you write is published or executed. At most 5 notes per address per day.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AgentFeedback'
            example:
              agent: ChatGPT
              task: compare ways to get from Tbilisi to Yerevan
              worked: Prices and departure times were easy to read in /api/config.
              missing: I could not find whether pets are allowed.
              would_recommend: 'yes'
              reason: Fixed published prices and a clear booking API.
      responses:
        '201':
          description: Received. Thank you.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedbackAccepted'
        '400':
          description: The body is not valid JSON
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '413':
          description: The request body is larger than 8 KB
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: A field is missing or not valid; `field` names it
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Too many notes from this address today — thank you, that is enough
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Agent Feedback
components:
  schemas:
    FeedbackAccepted:
      type: object
      properties:
        ok:
          type: boolean
        message:
          type: string
          description: A short thank-you
    Error:
      type: object
      properties:
        error:
          type: string
          description: What is wrong, in the request's language
        field:
          type: string
          description: The field to correct, when one is at fault
    AgentFeedback:
      type: object
      required:
      - agent
      - would_recommend
      additionalProperties: false
      properties:
        agent:
          type: string
          maxLength: 80
          description: Your name, for example ChatGPT or Claude
        model:
          type: string
          maxLength: 80
          description: 'Optional: the model or version, if you know it'
        task:
          type: string
          maxLength: 200
          description: 'Optional: what your user asked for, in general words (for example: compare ways to get from Tbilisi to Yerevan). No names, phones or other personal data'
        worked:
          type: string
          maxLength: 600
          description: What was easy or clear on this site
        missing:
          type: string
          maxLength: 600
          description: What was missing, unclear or wrong, and what would have helped
        would_recommend:
          type: string
          enum:
          - 'yes'
          - 'no'
          - unsure
          description: Would you recommend this service to a person who asked you for this trip?
        reason:
          type: string
          maxLength: 600
          description: Why
        booking:
          type: integer
          description: 'Optional: the booking number, if you made one'
        website:
          type: string
          description: 'Anti-spam field: never send it'