Zoekresultaten

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.
| Nummer | Waarvan | Nu |
|---|---|---|
| Contractversie | Het OpenAPI-contract en het gedrag van de API | OpenAPI 3.1, versie 1.0.0 |
| API-pad | De basis-URL van elke aanroep | /api/v1 |
| Versie van deze gids | De tekst van Hysio Connect Docs | v4.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.
| Datum | Soort | Wat er verandert | Wat jij doet |
|---|---|---|---|
| 6 november 2026 | Toegevoegd | Elke 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 2026 | Gewijzigd | De 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 2026 | Opgelost | Komt 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 2026 | Veiligheid | postback_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 2026 | Toegevoegd | De 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.
| Datum | Wat er veranderde |
|---|---|
| november 2026 | Nieuwe 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 2026 | Veilig herhalen: maak per nieuwe sessie een nieuwe, willekeurige Idempotency-Key, nooit een patiënt-, dossier- of recordnummer. |
| 13 november 2026 | Kortere introducties, een rustiger leesvolgorde en een zijbalk met de onderdelen van het actieve hoofdstuk. De inhoud over de API bleef gelijk. |
| 10 november 2026 | Live 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 2026 | Tekst uit Markdown, een Quickstart in zeven stappen, regels voor de Idempotency-Key, een foutentabel en een Node.js-voorbeeld. |
