HysioConnect v4.2.0

Connect Docsv4.2.0

Versies en wijzigingen

Welke contractversie geldt, hoe we wijzigingen melden en wat er veranderde.

Welke versie geldt

Het API-contract heeft een eigen versie, los van deze gids.

NummerWaarvanNu
ContractversieHet OpenAPI-contract en het gedrag van de APIOpenAPI 3.1, versie 1.0.0
API-padDe basis-URL van elke aanroep/api/v1
Versie van deze gidsDe tekst van Hysio Connect Docsv4.2.0

Hoe we wijzigingen melden

We melden wijzigingen die je koppeling kunnen raken op deze pagina, met datum.

Wat je van ons kunt verwachten

  • Het contract is leidend. Alleen wat in het OpenAPI-contract staat, is afgesproken. Wat erbuiten valt, hoort bij de Hysio-app en kan zonder aankondiging veranderen; bouw daar niet op.
  • De changelog. Hieronder staan de wijzigingen met datum, wat er verandert en wat jij doet.
  • Het nummer zegt niet alles. De contractversie is tot nu toe 1.0.0 gebleven, ook bij kleine toevoegingen. Leg daarom bij elke controle de ophaaldatum en een hash van het contract vast.
  • Vaste termijnen in voorbereiding. Hoe lang een oude versie blijft werken en hoe ver vooraf we een breuk aankondigen, leggen we nog vast. Tot dan maken we die afspraak per koppeling.

Changelog van de API

Wijzigingen in de API die je koppeling kunnen raken, de nieuwste bovenaan.

DatumSoortWat er verandertWat jij doet
6 november 2026ToegevoegdElke export (txt, pdf, docx) draagt een label dat de tekst met AI is gemaakt. Een txt-export begint met één vaste regel; bij pdf en docx staat het label in de voettekst en de metadata.Lees je de tekstexport in, sla dan de eerste regel over.
6 november 2026GewijzigdDe toegangscontrole bij het starten van een sessie en bij /input kijkt naar actieve toegang tot Hysio. Leden van een team tellen mee.Niets.
29 oktober 2026OpgelostKomt er voor dezelfde stap tegelijk een tweede inzending op /input, dan geeft de API 409 met de melding dat de stap al wordt verwerkt.Stuur niet opnieuw; lees de status van de sessie.
30 augustus 2026Veiligheidpostback_url moet een publiek HTTPS-adres zijn. Hysio controleert dat bij de start en opnieuw vóór elke bezorging, en volgt geen redirect.Gebruik het definitieve, publieke adres van je endpoint.
19 augustus 2026ToegevoegdDe API voor werkstromen: drie rechten per key, een key van 365 dagen, een gehoste link van 72 uur en een ondertekende postback. De drie startroutes accepteren een Idempotency-Key; die komt terug in de postback.Begin bij de Quickstart.

Gecontroleerd tegen de API-code van 6 november 2026. Een datum is de dag waarop de wijziging in de hoofdversie van de API-code kwam. Test een wijziging altijd eerst op staging.

Changelog van deze gids

Wat er in Hysio Connect Docs veranderde, de nieuwste bovenaan.

DatumWat er veranderde
november 2026Nieuwe pagina's: Browser Connect, Powered Connect, Versies & changelog, Productie-acceptatie en Vertrouwen. Het postbackvoorbeeld toont ook tokens_used. Een link naar een PDF die niet meer bestaat, is weg.
november 2026Veilig herhalen: maak per nieuwe sessie een nieuwe, willekeurige Idempotency-Key, nooit een patiënt-, dossier- of recordnummer.
13 november 2026Kortere introducties, een rustiger leesvolgorde en een zijbalk met de onderdelen van het actieve hoofdstuk. De inhoud over de API bleef gelijk.
10 november 2026Live op connect.hysio.nl als Hysio Connect. De gehoste sessie en /run staan als live in API v1, Route 2B als route op aanvraag. Nieuwe pagina Beveiliging & Privacy.
3 oktober 2026Tekst uit Markdown, een Quickstart in zeven stappen, regels voor de Idempotency-Key, een foutentabel en een Node.js-voorbeeld.