Verschillen

Dit geeft de verschillen weer tussen de geselecteerde revisie en de huidige revisie van de pagina.

--- stable:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:opvragen_informatievaneenzaak [2026/07/15 10:16] – ↷ Pagina verplaatst van stable:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:opvragen_informatievaneenzaak naar dev:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:opvragen_info Kars Gottschal
+++ stable:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:opvragen_informatievaneenzaak [2026/07/15 11:07] (huidige) – aangemaakt - Externe bewerking 127.0.0.1
@@ Regel 1: / Regel 1: @@
+===== Opvragen informatie van één zaak conform OpenZaak API =====
+{{tag>openwave:1.34:applicatiebeheer:functionaliteiten:zgw}}
+Op het endpoint //base-url//<nowiki>/api/zgw/zaken/api/v1/zaken/{identifier}</nowiki> kan met een GET informatie opgevraagd worden van een specifieke zaak.\\
+De //base_url// is de implementatie van OpenWave waar tegenaan gepraat moet worden, bijvoorbeeld: //<nowiki>https://acc.rommeldam.open-wave.nl</nowiki>//.
+De zaak die opgevraagd wordt is de {identifier} in de pathparameter): dat is de UUID die geretourneerd is aan een eerder gecreëerde zaak [[creeerzgwzaakobject|]](Creëer ZGW zaak conform OpenZaak API).
+Voorbeeld van een aanroep: //base-url//<nowiki>/api/zgw/zaken/api/v1/zaken/548358458459-0-9090-0</nowiki>\\
+Gebaseerd op versie Open Zaak API 1.2
+<adm warning Whitelist>
+De zender die hier een van de zaaktypen opvraagt zal gewhitelist moeten worden. Dit kan in de tabellen tbendpointlist en tbipauthorisationlist onder de tegel [[stable:applicatiebeheer:probleemoplossing:portalen_en_moduleschermen:beheerportaal_nieuw:tegels_kolom_gebruikers:endpoints_whitelist]] op het nieuwe beheerportaal onder de kolom //Gebruikers//.
+In de tabel tbendpointlist zal minimaal het endpoint ///api/zgw// gedefinieerd moeten zijn met daaronder (in de tabel tbipauthorisationlist) het IP-adres van de zender.
+</adm>
+===== Authorisation Token =====
+In de Authorization header van dit GET bericht moet een valide JWT-token worden meegegeven onder Bearer Token.
+Zie voorbeeld bij [[stable:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit:creeer_zgw_zaak]].
+Voor het verkrijgen van een token (met beperkte geldigheidsduur!) zie:  [[stable:applicatiebeheer:probleemoplossing:programmablokken:zgw_open_zaak_api_functionaliteit]].\\
+De token wordt opgezocht in de tabel tbaccesstoken en het tijdstip van aanvraag wordt getoetst aan de geldigheidsduur van de gevonden rij.
+<adm warning (robot) Medewerker moet gelinkt zijn aan endpoint>
+De gevonden token is gelinkt aan een (robot)-medewerker (degene onder wiens credentials het token is gecreëerd). Bij de betreffende medewerkers kaart moet de kolom //Endpoint (robotmedewerker is gedefinieerd voor binnenkomende berichten op endpoint)// (dnkeyendpointlist) in blok login verwijzen naar een kaart in //tbendpointlist// waarvan de inhoud van de kolom //dvendpointurl// een substring is van dit endpoint //api/zgw/catalogus/api/v1/zaakobjecttypen/ // waarop deze zaakobjecttypenlijst wordt gevraagd: bijvoorbeeld: ///api/zgw//
+</adm>
+==== Path Parameter =====
+De pathparameter moet gevuld zijn met de uuid van de op te vragen zaak.
+===== Headers =====
+  * Content-type: application/json
+  * Content-Crs: EPSG:4326
+  * Accept-Crs : EPSG:4326
+===== Query Parameters ======
+Worden niet ondersteund door OpenWave
+===== Body =====
+Geen body.
+====== Responsebericht =====
+Indien de zaakinformatie niet kon worden gegenereerd wordt een responsecode anders dan 200/201 geretourneerd met in de body de oorzaak van het falen.\\
+Indien de zaakinformatie wel succesvol is gegenereerd wordt onder de responsecode 200 in de body de informatie getoond.\\
+<adm example Voorbeeld response body>
+<code json>
+{
+  "identificatie": "2024K0105",
+  "bronorganisatie": null,
+  "zaaktype": "https://acc.rommeldam.open-wave.nl/api/zgw/zaken/api/v1/zaaktypen/365f113f-cb3c-4843-91ce-e7c9467f19c5",
+  "einddatum": null,
+  "betalingsindicatieWeergave": null,
+  "registratiedatum": "2024-01-03",
+  "uuid": "738107f2fd164619a071e0c29586270e",
+  "url": "https://acc.rommeldam.open-wave.nl/api/zgw/zaken/api/v1/zaken/738107f2fd164619a071e0c29586270e",
+  "verantwoordelijkeOrganisatie": null,
+  "omschrijving": "2. Ik hoor..  Pauls test ZGW",
+  "rollen": [
+    "https://acc.rommeldam.open-wave.nl/api/zgw/zaken/api/v1/rollen/b74d0d53f8be44638fbc48f33386037c"
+  ],
+  "deelzaken": [],
+  "startdatum": "2024-01-03",
+  "eigenschappen": [],
+  "zaakobjecten": [
+    "https://acc.rommeldam.open-wave.nl/api/zgw/zaken/api/v1/zaakobjecten/c6a70eae61a247c3b7263b36d42e5c80"
+  ],
+  "resultaat": null,
+  "zaakinformatieobjecten": [],
+  "status": null
+}
+</code>
+</adm>