Ghloria Public API & AI Agent Integration

Ghloria provides machine-readable endpoints and an OpenAPI 3.1 specification enabling AI agents, LLM tool-calling integrations, and travel software systems to programmatically interact with our travel agency operations infrastructure.

OpenAPI 3.1 Specification

The full OpenAPI 3.1 specification is published at:

• Canonical URL: https://www.ghloria.com/openapi.json
• Alternative URL: https://www.ghloria.com/api/openapi.yaml
• Format: OpenAPI 3.1.0 JSON, compatible with OpenAI Functions, Anthropic Tools, and LangChain

Public Endpoints

Public endpoints require no authentication and can be invoked directly by HTTP clients and AI agents.

1. API Status & Capability Discovery

• Endpoint: GET /api/v1/status
• Description: Verifies service health, returns the active API version, and enumerates available capabilities and tool endpoints.
• Response Format: application/json

2. Travel Agent Commission & Profit Calculator

• Endpoint: POST /api/v1/calculator/calculate (and GET /api/v1/calculator/calculate)
• Description: Computes commercial margins, host agency commission splits, net rate markups, TOMS/VAT margin tax, and advisor hourly yield.
• Parameters:
  • bookingValue (number, required): Total package selling price.
  • supplierCommissionRate (number, decimal): Commission percentage paid by suppliers (e.g. 0.12 for 12%).
  • agencyRetentionRate (number, decimal): Percentage retained by the advisor after host agency split (e.g. 0.8 for 80%).
  • serviceFee (number): Direct planning or advisory fee.
  • advisorHours (number): Hours dedicated by the travel designer.
  • internalHourlyRate (number): Internal advisor hourly cost.
  • currency (string): ISO currency code (EUR, USD, GBP, CAD, AUD, CHF).

3. Travel Proposal Quality Audit Checklist

• Endpoint: GET /api/v1/proposals/quality-checklist
• Description: Returns the complete 25-point travel proposal quality review framework across Client Brief, Transport Continuity, Accommodation Pace, Supplier Conditions, and Pricing Clarity.

Structured Error Responses (RFC 7807)

All Ghloria API errors return structured JSON Problem Details with standard Content-Type: application/problem+json:

{
  "type": "https://www.ghloria.com/docs#api-route-not-found",
  "title": "API route not found",
  "status": 404,
  "detail": "The requested Ghloria API endpoint '/api/v1/unknown' does not exist.",
  "code": "api_route_not_found",
  "resolution": "Discover available public API endpoints through /openapi.json or /.well-known/api-catalog.",
  "documentation_url": "https://www.ghloria.com/docs"
}

DNS for AI Discovery (DNS-AID)

Ghloria implements DNS for AI Discovery based on IETF draft draft-mozleywilliams-dnsop-dnsaid and RFC 9460 (SVCB / HTTPS Resource Records), enabling agents and resolvers to discover agent endpoints directly via DNS:

• Organizational Index Entrypoint: _index._agents.ghloria.com
  • Record: SVCB 1 www.ghloria.com. alpn="h2,h3" port=443 mandatory=alpn,port
  • Fallback TXT: v=dnsaid1; a2a=https://www.ghloria.com/.well-known/agent-card.json; openapi=https://www.ghloria.com/openapi.json; skills=https://www.ghloria.com/.well-known/agent-skills/index.json
• Agent-to-Agent (A2A) Entrypoint: _a2a._agents.ghloria.com
  • Record: SVCB 1 www.ghloria.com. alpn="a2a" port=443 mandatory=alpn,port
• Model Context Protocol (MCP) Entrypoint: _mcp._agents.ghloria.com
  • Record: SVCB 1 www.ghloria.com. alpn="mcp" port=443 mandatory=alpn,port

Zone file and structured records are published in the codebase at dns/ghloria.com.zone and dns/dns-aid.json.

Machine-Readable Agent Discovery

• https://www.ghloria.com/llms.txt: Summary site guide for LLMs
• https://www.ghloria.com/llms-full.txt: Full company and data model profile
• https://www.ghloria.com/AGENTS.md: Operational boundaries and agent guidance
• https://www.ghloria.com/404.md: Agent-friendly markdown recovery guide
• https://www.ghloria.com/.well-known/agent-card.json: A2A Agent Card descriptor
• https://www.ghloria.com/.well-known/agent-skills/index.json: Agent skills definitions
• https://www.ghloria.com/.well-known/api-catalog: RFC 9264 API linkset