ColorbySultan Entwickler Ressourcen & Agent APIs

Maschinenlesbare Schnittstellen, OpenAPI 3.1 Dokumentation und Protokolle für autonome KI-Agenten.

Öffentliche APIs & Endpunkte

GET /api/salon/info Stammdaten, Anschrift, Koordinaten, Telefon & Buchungslink JSON ansehen

GET /api/salon/services Dienstleistungskatalog (Balayage, Schnitte, Olaplex) mit Dauer und Preisen JSON ansehen

GET /api/salon/hours Reguläre Öffnungszeiten je Wochentag im Salon Wiehl JSON ansehen

GET /api/openapi.json Offizielle OpenAPI 3.1 Spezifikation (JSON) OpenAPI JSON

GET /api/openapi.yaml Offizielle OpenAPI 3.1 Spezifikation (YAML) OpenAPI YAML

GET /llms.txt Standardisiertes LLM Kontext-Dokument (llmstxt.org) llms.txt

GET /sitemap.xml XML Sitemap aller indexierbaren URLs mit lastmod Sitemap

Markdown Content Negotiation (RFC 7231 / RFC 9110)

ColorbySultan unterstützt das automatische Aushandeln von Markdown-Inhalten für Sprachmodelle und Web-Agenten:

# Abruf der Startseite im Markdown-Format:
curl -sS -L -H 'Accept: text/markdown' https://colorbysultan.de/

# Abruf von 404 Fehlermeldungen im Markdown-Format:
curl -sS -L -H 'Accept: text/markdown' https://colorbysultan.de/__ora-404-probe

Model Context Protocol (MCP) Server Konfiguration

Agenten können ColorbySultan direkt über das Model Context Protocol einbinden:

{
  "mcpServers": {
    "colorbysultan": {
      "type": "http",
      "url": "https://colorbysultan.de/api/openapi.json",
      "description": "ColorbySultan Salon & Booking Assistant API"
    }
  }
}

Rate Limiting & Bot Self-Throttling

Zur Gewährleistung optimaler Verfügbarkeit senden alle API-Endpunkte standardmäßige Rate-Limit-Header (IETF & X-RateLimit). AI-Agenten und Bots können ihre Anfragen anhand dieser Werte automatisch drosseln:

RateLimit-Limit & X-RateLimit-Limit: Maximale Anfragen im aktuellen Zeitfenster (Standard: 60/min).
RateLimit-Remaining & X-RateLimit-Remaining: Verbleibende Anfragen vor Drosselung.
RateLimit-Reset & X-RateLimit-Reset: Sekunden bzw. Zeitstempel bis zum Zurücksetzen.
Status 429 Too Many Requests: Standardisiertes Fehlerschema (error, message, status, details) mit Retry-After Header.