Voor developers
Je dossiersysteem blijft de werkplek. Start de verwerking met Hysio, ontvang het resultaat en laat de zorgprofessional het controleren voordat je het in het dossier overneemt.
Direct contact samenwerking@hysio.nl
Je kunt de invoer aan Hysio overlaten of je eigen interface gebruiken. In beide routes bepaal je hoe het resultaat in jouw dossiersysteem wordt verwerkt.
Start een sessie via de API en open de teruggegeven Hysio-link. De zorgprofessional neemt daar het gesprek op of voert tekst in en rondt de sessie af.
Behoud de tekstinvoer in je eigen interface. Stuur de tekst naar Hysio en ontvang het resultaat via de API.
Je dossiersysteem bewaakt de samenhang tussen de zorgprofessional, het zorgcontact en het dossier. Hysio ondersteunt de verslaglegging.
Kies een beschikbare AI-assistent. Bewaar de sessiereferentie bij het juiste zorgcontact in je eigen systeem.
Open de gehoste sessie of stuur tekst via de API. Hysio verwerkt de invoer tot een verslag als concept.
Ontvang een postback op je eigen endpoint of vraag het resultaat op. Koppel de sessiereferentie terug aan het zorgcontact.
Toon het concept aan de zorgprofessional. Laat de inhoud controleren en waar nodig aanpassen.
Plaats de gecontroleerde tekst in de passende dossiervelden. De velden en mapping stem je af op de uitvoer van de gekozen AI-assistent.
Begin met de beschikbare AI-assistenten en start daarna een testsessie. Vervang de placeholders in het voorbeeld door de basis-URL, een beschikbare id en je API-key. Vervang ook het fictieve postbackadres door je eigen endpoint.
https://api.staging.server03.hysio.nl/api/v1De PDF bevat ook productievoorbeelden. Gebruik voor je test het stagingadres hierboven.
POST {base_url}/workflows/{workflow_id}/hosted-session
Authorization: Bearer {api_key}
Accept: application/json
Content-Type: application/json
Idempotency-Key: partner-test-voorbeeld-001
{
"postback_url": "https://dossiersysteem.example/hysio/webhook",
"collect_answers": true
}Een geslaagde aanvraag geeft HTTP 201 terug, met onder meer session_id, redirect_url en postback_secret. Open redirect_url ongewijzigd, inclusief het fragment, om de gehoste sessie te gebruiken.
{
"session_id": 1841,
"idempotency_key": "partner-test-voorbeeld-001",
"status": "completed",
"output": "## Subjectief\nFictieve voorbeeldtekst uit het gesprek.",
"output_json": {
"subjectief": "Fictieve voorbeeldtekst uit het gesprek."
},
"output_json_status": "ready"
}Ingekort, fictief webhookvoorbeeld. De velden binnen output_json hangen af van de gekozen AI-assistent. Een afgeronde sessie betekent niet automatisch dat gestructureerde JSON beschikbaar is.
Vraag GET /workflows op met je API-key. Gebruik de id van de gekozen AI-assistent als workflow_id in het voorbeeld; de toegang hangt samen met je account.
Controleer X-Hysio-Signature: sha256= gevolgd door de HMAC-SHA256 van de ongewijzigde requestbody met het ontvangen postback_secret. Weiger een ongeldige handtekening. Bewaar dat geheim op je server.
Controleer output_json_status voordat je JSON verwerkt. Bij pending is de omzetting nog niet klaar. Bij not_configured is geen JSON-uitvoer ingesteld. Houd ook rekening met verwerkingsfouten.
Gebruik bij het opnieuw sturen van dezelfde startaanvraag dezelfde Idempotency-Key. Voor een nieuwe sessie gebruik je een nieuwe waarde.
Hysio Playground
Bekijk in een fictief medisch dossiersysteem hoe een sessie start en het resultaat terugkomt. Zo onderzoek je de werkwijze voordat je zelf een integratie bouwt.
Je opent de playground met een toegangscode. Nog geen code? Vraag hieronder testtoegang aan. Een toegangscode is geen API-key.
Gebruik uitsluitend fictieve gegevens. De playground is een testomgeving en schrijft niet naar een echt medisch dossiersysteem.
Voor zelfstandig testen gebruik je een Hysio-testaccount en een eigen API-key. We stemmen de toegang met je af.
Vertel voor welk medisch dossiersysteem je ontwikkelt en wat je wilt testen. We helpen je aan de passende toegang en documentatie.
Stem je testtoegang met ons af. We helpen je aan een testaccount en de juiste API-toegang. De API-key heeft de rechten workflows:read, sessions:create en sessions:read nodig.
Gebruik de staging-URL, vraag de beschikbare AI-assistenten op en doorloop een sessie. Controleer ook foutmeldingen en de teruglevering van het resultaat.
Een API-key werkt namens je Hysio-account. Je ziet de volledige key alleen bij het aanmaken. Bewaar de key op je server en neem hem niet op in frontendcode, logs of openbare voorbeelden.
Deel je technische vraag of vraag toegang tot de playground aan. We denken mee over de route die bij jouw medisch dossiersysteem past.
Liever rechtstreeks mailen?
samenwerking@hysio.nl
Wil je weten wat er mogelijk is voor jouw praktijk? Vertel ons welk medisch dossiersysteem je gebruikt. Dan bespreken we de actuele mogelijkheden.
Neem contact op