Openbare API voor docenten, studio's en lessen

Lees dezelfde gids die mensen op MoveMentors zien: zelfstandige docenten, kleine studio's en hun komende lessen. Geen aanmelding, geen sleutel, gewoon JSON. Gemaakt zodat AI-agents en kleine tools mensen naar lessen in de buurt kunnen wijzen zonder te scrapen.

Basis-URL

https://movementors.com/api/v1

Alle endpoints hieronder beginnen hier. Een gewone GET erop geeft een JSON-lijst van allemaal.

Probeer het

Zoek vijf pilatesdocenten. Plak dit in een terminal:

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

Endpoints

Allemaal alleen-lezen en gratis. Lijsten nemen page en limit (tot 50).

EndpointWat het teruggeeft
GET/api/v1/mentorsZoek zelfstandige docenten op tekst, stad of discipline.
GET/api/v1/mentors/{slug}Het openbare profiel van een docent: disciplines, plekken en certificaten.
GET/api/v1/studiosZoek kleine studio's. Voeg rentable=1 toe voor zalen die andere docenten kunnen huren.
GET/api/v1/studios/{slug}Het openbare profiel van een studio en de locaties.
GET/api/v1/classesKomende sessies, online of op locatie, met data, prijzen en gastheren.
GET/api/v1/classes/{id}Eén les met het rooster en de gastheer.
GET/api/v1/healthOf de dienst draait.
GET/api/v1/openapi.jsonHet volledige OpenAPI 3.1 contract, voor codegeneratoren en agents.

Authenticatie

Geen voor de endpoints op deze pagina. Om voor iemand een les te boeken of een rooster te beheren, gebruikt een agent onze MCP-server met OAuth, zodat die persoon eerst toestemming geeft.

Verbind een AI-assistent

Fouten

Elke fout komt terug als JSON in het RFC 9457 probleemformaat (application/problem+json), nooit als HTML-pagina. Lees code om te bepalen wat je doet en hint om te zien hoe je het oplost.

  • 400invalid_parameter

    Een queryparameter klopt niet. Het veld param noemt hem.

  • 404not_found

    Dit endpoint, deze docent, studio of les bestaat niet.

  • 405method_not_allowed

    Deze endpoints lezen alleen. Gebruik GET.

  • 429rate_limited

    Te veel verzoeken. Wacht het aantal seconden uit Retry-After.

  • 500internal_error

    Er ging bij ons iets mis. Probeer opnieuw en wacht elke keer iets langer.

  • 503service_unavailable

    De dienst is even onbereikbaar. Probeer het later opnieuw.

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"
}

Limieten

Limieten gelden per IP-adres: 100 verzoeken per minuut, plus 5.000 per dag op lijst-endpoints. Elk antwoord laat zien waar je staat, zodat je op tijd kunt afremmen.

  • RateLimit-Policy

    Je quota, bijvoorbeeld "burst";q=100;w=60.

  • RateLimit

    Resterende verzoeken en seconden tot elk quotum opnieuw begint.

  • RateLimit-Limit / -Remaining / -Reset

    Hetzelfde voor het quotum dat het eerst op is, in de oudere vorm met één waarde.

  • Retry-After

    Bij een 429: hoeveel seconden je moet wachten.

Versies

De versie staat in het pad, dus er verandert niets zonder waarschuwing.

  • Nieuwe endpoints, parameters en velden komen er in v1 gewoon bij. Je code blijft werken.
  • Alles wat bestaande code zou breken, zoals een veld weghalen of hernoemen, verschijnt als /api/v2.
  • Voordat een versie wordt uitgezet, dragen de antwoorden een Deprecation-header (RFC 9745) en een Sunset-header (RFC 8594) met de datum, minstens 6 maanden van tevoren.

Voor agents en tools

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

Vragen, of een hogere limiet nodig? Mail naar support@movementors.com