Öffentliche API für Lehrende, Studios und Kurse

Lies dasselbe Verzeichnis, das Menschen auf MoveMentors sehen: unabhängige Lehrende, kleine Studios und ihre kommenden Kurse. Keine Anmeldung, kein Schlüssel, einfaches JSON. Gebaut, damit KI-Agenten und kleine Tools Menschen zu Kursen in ihrer Nähe führen, ohne zu scrapen.

Basis-URL

https://movementors.com/api/v1

Alle Endpunkte unten beginnen hier. Ein einfaches GET darauf liefert eine JSON-Liste aller Endpunkte.

Ausprobieren

Finde fünf Pilates-Lehrende. Füge das in ein Terminal ein:

curl "https://movementors.com/api/v1/mentors?category=pilates&limit=5"

Endpunkte

Alle nur lesend und kostenlos. Listen nehmen page und limit (bis 50).

EndpunktWas zurückkommt
GET/api/v1/mentorsUnabhängige Lehrende nach Text, Stadt oder Disziplin suchen.
GET/api/v1/mentors/{slug}Das öffentliche Profil einer lehrenden Person: Disziplinen, Orte und Zertifikate.
GET/api/v1/studiosKleine Studios suchen. Mit rentable=1 nur Räume, die andere Lehrende mieten können.
GET/api/v1/studios/{slug}Das öffentliche Profil eines Studios und seine Standorte.
GET/api/v1/classesKommende Termine, online oder vor Ort, mit Datum, Preis und Gastgebenden.
GET/api/v1/classes/{id}Ein Kurs mit Terminplan und Gastgebenden.
GET/api/v1/healthOb der Dienst läuft.
GET/api/v1/openapi.jsonDer vollständige OpenAPI 3.1 Vertrag, für Codegeneratoren und Agenten.

Authentifizierung

Keine für die Endpunkte auf dieser Seite. Um einen Kurs zu buchen oder einen Stundenplan für jemanden zu verwalten, nutzt ein Agent unseren MCP-Server mit OAuth, sodass die Person zuerst zustimmt.

KI-Assistenten verbinden

Fehler

Jeder Fehler kommt als JSON im Problem-Format nach RFC 9457 (application/problem+json), nie als HTML-Seite. Lies code, um zu entscheiden, was zu tun ist, und hint, um es zu beheben.

  • 400invalid_parameter

    Ein Query-Parameter ist falsch. Das Feld param nennt ihn.

  • 404not_found

    Diesen Endpunkt, diese Lehrperson, dieses Studio oder diesen Kurs gibt es nicht.

  • 405method_not_allowed

    Diese Endpunkte lesen nur. Nutze GET.

  • 429rate_limited

    Zu viele Anfragen. Warte die Sekunden aus Retry-After ab.

  • 500internal_error

    Bei uns ist etwas schiefgegangen. Versuche es erneut und warte jedes Mal etwas länger.

  • 503service_unavailable

    Der Dienst ist kurz nicht erreichbar. Versuche es später erneut.

HTTP/1.1 404 Not Found
Content-Type: application/problem+json

{
  "type": "https://movementors.com/developers#error-not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Teacher not found",
  "instance": "/api/v1/mentors/unknown",
  "code": "not_found",
  "hint": "Check the path and identifier. GET /api/v1 lists every public endpoint.",
  "error": "Teacher not found"
}

Rate Limits

Die Limits gelten pro IP-Adresse: 100 Anfragen pro Minute, dazu 5.000 pro Tag bei Listen-Endpunkten. Jede Antwort zeigt deinen Stand, damit du rechtzeitig langsamer wirst.

  • RateLimit-Policy

    Deine Kontingente, zum Beispiel "burst";q=100;w=60.

  • RateLimit

    Verbleibende Anfragen und Sekunden bis zum Zurücksetzen jedes Kontingents.

  • RateLimit-Limit / -Remaining / -Reset

    Dasselbe für das Kontingent, das am ehesten ausgeht, im älteren Einzelwert-Format.

  • Retry-After

    Bei einem 429: wie viele Sekunden du warten sollst.

Versionierung

Die Version steht im Pfad, also ändert sich nichts ohne Vorwarnung.

  • Neue Endpunkte, Parameter und Felder kommen direkt in v1 dazu. Dein Code läuft weiter.
  • Alles, was bestehenden Code brechen würde, etwa ein Feld entfernen oder umbenennen, erscheint als /api/v2.
  • Bevor eine Version abgeschaltet wird, tragen ihre Antworten einen Deprecation-Header (RFC 9745) und einen Sunset-Header (RFC 8594) mit dem Datum, mindestens 6 Monate im Voraus.

Für Agenten und Tools

Maschinenlesbare Einstiegspunkte: GET /api/v1 · OpenAPI 3.1 · API catalog (RFC 9727) · llms.txt · MCP server card

Fragen, oder brauchst du ein höheres Limit? Schreib an support@movementors.com