API-versies en uitfasering

Op deze pagina staat hoe we de MijnJurist-API versioneren en hoe we wijzigingen aankondigen die een koppeling kunnen breken. Zo weet je als developer of beheerder van een AI-app waar je op kunt rekenen.

Waar dit beleid over gaat

• De MCP-server op https://api.mijnjurist.ai/mcp: de tools, hun parameters en de vorm van de antwoorden.
• De OAuth-endpoints (/authorize, /token, /register, /revoke) en de metadata onder /.well-known.
• De OpenAPI-spec die deze onderdelen beschrijft.

Hoe we versioneren

De protocolversie onderhandel je per verzoek met de header MCP-Protocol-Version. We ondersteunen de versies uit de OpenAPI-spec en voegen nieuwe versies toe zodra de MCP-specificatie ze vastlegt.

Wijzigingen die niets breken, voeren we zonder aankondiging door: een nieuwe tool, een nieuwe optionele parameter of een extra veld in een antwoord. Een goede client negeert velden die hij niet kent.

Uitfasering

Een wijziging die een bestaande koppeling kan breken, kondigen we minimaal 90 dagen vooraf aan. Denk aan het verwijderen of hernoemen van een tool of parameter, of het laten vallen van een protocolversie. Tijdens die periode:

• staat de wijziging met datum op deze pagina;
• sturen we op antwoorden van de betreffende onderdelen de headers Deprecation (RFC 9745) en Sunset (RFC 8594) mee, met een link naar deze pagina;
• noemt de beschrijving van een tool die verdwijnt de datum waarop dat gebeurt;
• mailen we gebruikers met een actieve koppeling.

Alleen bij een beveiligingsprobleem kan een wijziging sneller nodig zijn. Dan melden we die zo snel mogelijk, op dezelfde manier.

Actuele uitfaseringen

Er staat op dit moment niets op de lijst.

Vragen

Mail naar support@mijnjurist.ai. Hoe je MijnJurist koppelt, staat op de pagina MCP koppelen.