Koppelprofiel Zaaksysteem API: verschil tussen versies
(→Instructie voor Windows omgeving) |
(→Instructie voor Windows omgeving) |
||
Regel 86: | Regel 86: | ||
<pre> | <pre> | ||
powershell -ExecutionPolicy unrestricted -Command "$cmd = (New-Object Net.WebClient); $cmd.Headers.Add(\"API-Interface-Id\",\"71\"); $cmd.Headers.Add(\"API-Key\",\"1234\"); $cmd.DownloadString(\"https://quarterly.zaaksysteem.nl/app/api2csv\"); | powershell -ExecutionPolicy unrestricted -Command "$cmd = (New-Object Net.WebClient); $cmd.Headers.Add(\"API-Interface-Id\",\"71\"); $cmd.Headers.Add(\"API-Key\",\"1234\"); $cmd.DownloadString(\"https://quarterly.zaaksysteem.nl/app/api2csv\"); | ||
+ | </pre> | ||
+ | Het resultaat is de output van de opgeslagen zoekopdracht in CSV formaat. Deze kan gekopiëerd worden voor gebruik in een andere applicatie. De response kan ook direct opgeslagen worden door aan het Powershell commando ' | Out-File –FilePath c:\folder\structuur\bestandsnaam.csv toe te voegen. | ||
+ | |||
+ | <pre> | ||
+ | powershell -ExecutionPolicy unrestricted -Command "$cmd = (New-Object Net.WebClient); $cmd.Headers.Add(\"API-Interface-Id\",\"71\"); $cmd.Headers.Add(\"API-Key\",\"1234\"); $cmd.DownloadString(\"https://quarterly.zaaksysteem.nl/app/api2csv\"); | Out-File –FilePath c:\path\bestandsnaam.csv | ||
</pre> | </pre> | ||
Versie van 2 nov 2016 om 12:41
Inhoud
Met deze koppeling kan een externe partij gegevens uit het zaaksysteem uitlezen en/of het zaaksysteem berichten aan een externe partij sturen.
Instellingen
Zie ook de Zaaksysteem API Manual: https://<domeinnaam>/man/Zaaksysteem::Manual::API::V1.
Titel | Omschrijving | ||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Versie | De versie van dit koppelprofiel | ||||||||||||||
API sleutel | De unieke API sleutel waarmee de externe partij kan authenticeren | ||||||||||||||
Medewerker | De externe partij heeft hetzelfde toegangsniveau als de geselecteerde gebruiker: Zaken raadplegen en wijzigingen aan zaken aanbrengen. Eventuele wijzigingen die de externe partij binnen zaaksysteem uitvoert zullen namens deze gebruiker gedaan worden. | ||||||||||||||
Toegangsniveau | Het toegangsniveau dat deze API verschaft:
Let op: Deze instelling is onderhevig aan de rechten van de medewerker. Als de medewerker enkel raadpleegrechten heeft zal de instelling 'Behandelen' deze rechten op 'Raadplegen' houden. Als de medewerker behandelrechten heeft zal de instelling 'Raadplegen' de rechten juist beperkt houden tot 'Raadplegen'. | ||||||||||||||
Zoekopdracht | Standaard verschaft de API toegang tot de volgende metainformatie van een zaak:
Deze informatieset wordt uitgebreid met alle informatie die zichtbaar is binnen de geselecteerde zoekopdracht (dus op basis van de geselecteerde filters en kolommen). | ||||||||||||||
Trigger URL | De URL waar de externe partij berichtgeving van zaaksysteem op moet ontvangen. Zie ook: Regel - Extern systeembericht
Let op: Dit moet een https:// zijn. | ||||||||||||||
Trigger CA Certificaat | Eventueel het certificaat voor de trigger URL | ||||||||||||||
API URI | |||||||||||||||
Example: CSV via powershell | Met dit windows commando (powershell) kan de output van de ingestelde zoekopdracht geëxporteerd worden als CSV. | ||||||||||||||
Examlple: CSV via Curl | Met dit unix commando (curl) kan de output van de ingestelde zoekopdracht geëxporteerd worden als CSV. |
API v1
Zaaksysteem biedt de mogelijkheid om een opgeslagen zoekopdracht te selecteren die vervolgens op te vragen is door <omgeving>/api/v1/case te bezoeken. De uitvoer van <omgeving>/api/v1/case is in JSON formaat.
API2CSV
Om de integratie met andere systemen makkelijker te maken biedt Zaaksysteem ook de mogelijkheid om de API v1 uitvoer in een comma separated value (CSV) formaat uit te voeren. Op deze pagina staat beschreven hoe beheerders deze functionaliteit op hun omgeving kunnen installeren, en hoe gebruikers de uitvoer in CSV kunnen opvragen.
Let op: Integratie met andere applicaties is mogelijk. Deze applicaties moeten een http get commando uit kunnen voeren waarbij enkele headers meegegeven dienen te worden (zie het Curl commando voor meer info voor welke headers).
Instructie voor Windows omgeving
Voer het volgende Powershell commando uit in een terminal (anders dan de Powershell terminal):
powershell -ExecutionPolicy unrestricted -Command "$cmd = (New-Object Net.WebClient); $cmd.Headers.Add(\"API-Interface-Id\",\"71\"); $cmd.Headers.Add(\"API-Key\",\"1234\"); $cmd.DownloadString(\"https://quarterly.zaaksysteem.nl/app/api2csv\");
Het resultaat is de output van de opgeslagen zoekopdracht in CSV formaat. Deze kan gekopiëerd worden voor gebruik in een andere applicatie. De response kan ook direct opgeslagen worden door aan het Powershell commando ' | Out-File –FilePath c:\folder\structuur\bestandsnaam.csv toe te voegen.
powershell -ExecutionPolicy unrestricted -Command "$cmd = (New-Object Net.WebClient); $cmd.Headers.Add(\"API-Interface-Id\",\"71\"); $cmd.Headers.Add(\"API-Key\",\"1234\"); $cmd.DownloadString(\"https://quarterly.zaaksysteem.nl/app/api2csv\"); | Out-File –FilePath c:\path\bestandsnaam.csv
Instructie voor UNIX / Mac omgeving
Voer het volgende Powershell commando uit in een terminal:
curl --header "API-Interface-Id: 71" --header "API-Key: 1234" "https://quarterly.zaaksysteem.nl/app/api2csv"
Het resultaat is de output van de opgeslagen zoekopdracht in CSV formaat. Deze kan gekopiëerd worden voor gebruik in een andere applicatie. De response kan ook direct opgeslagen worden door aan het Curl commando ' bestandsnaam.txt' toe te voegen.
curl --header "API-Interface-Id: 71" --header "API-Key: 1234" "https://quarterly.zaaksysteem.nl/app/api2csv" > file.txt
Troubleshooting
Wanneer er geen resultaten zijn moet eerst gecontroleerd worden of de gebruiker die ingesteld staat bij 'Medewerker' in het Zaaksysteem API koppelprofiel überhaupt resultaten krijgt in Uitgebreid Zoeken. Daarna kan gecontroleerd worden of de medewerker wel raadpleegrechten heeft tot de zaaktype(n).