From 32b6ff636932692b46a940ac7d67b5b6ae20f0ad Mon Sep 17 00:00:00 2001 From: Mark West Date: Mon, 27 Nov 2023 14:40:47 +0100 Subject: [PATCH 1/3] Spellcheck --- docs/Integratie.md | 43 ++++++++++++++++++++++++++----------------- 1 file changed, 26 insertions(+), 17 deletions(-) diff --git a/docs/Integratie.md b/docs/Integratie.md index d35d86f2..b543c046 100644 --- a/docs/Integratie.md +++ b/docs/Integratie.md @@ -1,24 +1,30 @@ # Integratie -OpenWoo.app is essentie een koppelvlak waar aan de bovenkant meerdere weergaven of user interfaces op kunnen worden gekoppeld en aan de onderkant meerdere bronnen ontsloten. +OpenWoo.app is essentie een koppelvlak waar aan de bovenkant meerdere weergaven of user interfaces op kunnen worden gekoppeld en aan de onderkant meerdere bronnen ontsloten. ## Het koppelen van een user interface -Als u als organisatie of leverancier OpenWoo.app wilt koppelen aan een huidige interface (bijvoorbeeld door de resulaten uit uw gemeente in uw website te integegreren) and kunt u daarvoor gebruik maken van de OpenWoo.app api. + +Als u als organisatie of leverancier OpenWoo.app wilt koppelen aan een huidige interface (bijvoorbeeld door de resultaten uit uw gemeente in uw website te integereren) and kunt u daarvoor gebruikmaken van de OpenWoo.app API. ### Locatie en Authenticatie -U vind de API op [https://api.OpenWoo.app](https://api.OpenWoo.app). Voor het stellen van zoekvragen is géén authenticatie vereist (het doel van OpenWOO.app is immers het verspreiden van openbare informatie). Er is echter wel sprake van trotheling op responce tijden (de api reageert langsamer) en ratelimiting (het aantal bevragingen per minuut en uur zijn beperkt) zonder authenticatie. Ook zijn alleen de GET (ophalen) acties toegestaan zonder authenticatie. -Als u vanuit uw casus een API nodig heeft zonder throtheling, ratelimit of namens een organisatie wijzigingen wilt doen (POST,PUT,DELETE) dan zijn er twee mogenlijkheden. -- Beschikt uw organisatie reeds over FSC? Dan kunt u ons via FSC toegangs verzoek doen -- Beschikt uw organisatie nog niet over FSC? Dan kunt u een mail sturen naar info@conduction.nl +U vindt de API op [https://api.OpenWoo.app](https://api.OpenWoo.app). Voor het stellen van zoekvragen is géén authenticatie vereist (het doel van OpenWOO.app is immers het verspreiden van openbare informatie). Er is echter wel sprake van throttling op response tijden (de API reageert langzamer) en rate-limiting (het aantal bevragingen per minuut en uur zijn beperkt) zonder authenticatie. Ook zijn alleen de GET (ophalen) acties toegestaan zonder authenticatie. + +Als u vanuit uw casus een API nodig heeft zonder throttling, ratelimit of namens een organisatie wijzigingen wilt doen (POST,PUT,DELETE) dan zijn er twee mogelijkheden. + +- Beschikt uw organisatie reeds over FSC? Dan kunt u ons via FSC toegangsverzoek doen +- Beschikt uw organisatie nog niet over FSC? Dan kunt u een mail sturen naar ### Documentatie -Voor de API is een [redoc documentatie]() beschickbaar met voorbeelden van de verschillende API endpoints, calls en resultaten. Omdat de API daarnaast kan worden gebruikt zonder authenticatie is deze ook goed te beproeven via onze [postman collectie](). We raden developers van ook van harte aan om aan de hand van deze collectie te spelen en ontwikkelen. + +Voor de API is een [redoc documentatie]() beschikbaar met voorbeelden van de verschillende API endpoints, calls en resultaten. Omdat de API daarnaast kan worden gebruikt zonder authenticatie is deze ook goed te beproeven via onze [Postman collectie](). We raden developers van ook van harte aan om aan de hand van deze collectie te spelen en ontwikkelen. ### Voorbeelden -In het merendeel van de gevallen zult u een zoekvraag willen uitvoeren binnen de Woo publicaties van OpenWoo.app, het enpoint daarvoor is: https://api.OpenWoo.app/publicaties. Er zijn 4 voor de hand liggende zoek parameters waarmee gezocht word (overige opties vind ut terug in de [redoc documentatie](). -1. Op een of meerdere zoek woorden, b.v. _search=test -2. Op organisatie, dit gaat aan de hand van OIN (de volledige OIN lijst vind u [hier](https://oinregister.logius.nl/oin-register). + +In het merendeel van de gevallen zult u een zoekvraag willen uitvoeren binnen de Woo publicaties van OpenWoo.app, het endpoint daarvoor is: . Er zijn 4 voor de hand liggende zoekparameters waarmee gezocht wordt (overige opties vind u terug in de [Redoc documentatie]()). + +1. Op een of meerdere zoek woorden, b.v. `_search=test` +2. Op organisatie, dit gaat aan de hand van OIN (de volledige OIN lijst vind u [hier](https://oinregister.logius.nl/oin-register)). 3. Op categorie, categorie=Convenant 4. Op datum, Hierbij kunt u een begin en eindatum opgeven om een periode (bijvoorbeeld jaar) te doorzoeken publicatiedatum[after]=2022-12-31T23:59:59Z&publicatiedatum[before]=2024-01-01T00:00:00Z& @@ -280,7 +286,7 @@ Response } ```` -Vanuit een het weergeven van een zoek formulier is het goed mogenlijk dat u alleen bestaande waardes wilt weergeven (bijvoorbeeld bij jaartal of categorie). U kunt daarvoor de queries parameter gebruiken, deze verteld uw welke zoekwaarde welke resultaten opleveren. +Vanuit een het weergeven van een zoekformulier is het goed mogelijk dat u alleen bestaande waardes wilt weergeven (bijvoorbeeld bij jaartal of categorie). U kunt daarvoor de queries parameter gebruiken, deze verteld u welke zoekwaarde welke resultaten opleveren. ````cli GET 'https://api.OpenWoo.app/publicaties?_queries[]=categorie' @@ -302,14 +308,17 @@ Response ```` ### Spelregels -- Er mogen géén kopien worden gemaakt van data uit de API, dit zodat overheden de mogenlijkheid hebben data te depubliceren (bijvoorbeeld bij het per abuis publiceren van persoons gegevens) -- Er mag wel gebruik worden gemaakt van cashing voor het verbeteren van performance, maar er mag niet langer worden gecashed dan aangegeven in de cashing header van het responce object. Ofwel de bron bepaald hoe lang er gecashed mag worden. + +- Er mogen géén kopiën worden gemaakt van data uit de API, dit zodat overheden de mogelijkheid hebben data te depubliceren (bijvoorbeeld bij het per abuis publiceren van persoonsgegevens) +- Er mag wel gebruik worden gemaakt van caching voor het verbeteren van performance, maar er mag niet langer worden gecachet dan aangegeven in de caching header van het responseobject. Ofwel de bron bepaald hoe lang er gecachet mag worden. ## Het koppelen van een bron -Er zijn twéé manieren waarop een bron kan worden gekoppeld, bijde vereisen dat de bron beschikt over een koppelvlak dat benaderbaar is door de OpenWoo.app. -1. **De bron bied een reeds door OpenWoo.app ondersteund koppelvlak aan of ontwikkelt deze.** Dit is vanuit de OpenWoo.app natuurlijk de snelste route -2. **OpenWoo.app ontwikkeld ondersteuning voor een bron specifiek koppelvlak.** Deze route vergt minder van de aan te sluiten bron (die zal doorgaans al over een koppelvlak zo als API beschikken). Maar vergt inspanning aan de kant van de OpenWoo.app leveranciers. Daarnaast zal de OpenWoo.app community acoord moeten gaan met de ontwikkeling en bekostiging (in de praktijk zal de aanvragen worden gevraagd de kosten te dekken). +Er zijn twéé manieren waarop een bron kan worden gekoppeld, beide vereisen dat de bron beschikt over een koppelvlak dat benaderbaar is door de OpenWoo.app. + +1. **De bron biedt een reeds door OpenWoo.app ondersteund koppelvlak aan of ontwikkelt deze.** Dit is vanuit de OpenWoo.app natuurlijk de snelste route +2. **OpenWoo.app ontwikkeld ondersteuning voor een bron specifiek koppelvlak.** Deze route vergt minder van de aan te sluiten bron (die zal doorgaans al over een koppelvlak zo als API beschikken). Maar vergt inspanning aan de kant van de OpenWoo.app leveranciers. Daarnaast zal de OpenWoo.app community akkoord moeten gaan met de ontwikkeling en bekostiging (in de praktijk zal de aanvragen worden gevraagd de kosten te dekken). ## Het koppelen van een organisatie -Zie voor het koppelen van een organisatie de [naar productie pagina](). \ No newline at end of file + +Zie voor het koppelen van een organisatie de [naar productie pagina](). From db872d86585ec00e3a0490b7045f767cdc1e83c0 Mon Sep 17 00:00:00 2001 From: Barry Brands <57346398+bbrands02@users.noreply.github.com> Date: Wed, 29 Nov 2023 20:54:48 +0100 Subject: [PATCH 2/3] Update Integratie.md --- docs/Integratie.md | 443 +++++++++++++++++++++++++++++++-------------- 1 file changed, 311 insertions(+), 132 deletions(-) diff --git a/docs/Integratie.md b/docs/Integratie.md index b543c046..5418b040 100644 --- a/docs/Integratie.md +++ b/docs/Integratie.md @@ -84,50 +84,220 @@ Response } ] }, + "id": "3082", "titel": "Afvalwaterakkoord", "beschrijving": null, "samenvatting": "In dit bestuursakkoord is afgesproken door de koepelorganisaties, dat het waterschap en de gemeenten moeten samenwerken in de afvalwaterketen "als ware het één bedrijf’.", "categorie": "Convenant", - "ontvangstdatum": null, "publicatiedatum": "2023-11-24 11:31:47", - "behandelstatus": null, - "termijnoverschrijding": null, - "urlInformatieverzoek": null, - "id": "3082", - "portalUrl": null, - "ontvangerInformatieverzoek": null, - "urlInventarisatielijst": null, - "urlBesluit": null, + "portalUrl": "https://conductionnl.github.io/woo-website-epe/19cdec3f-896f-4765-8d62-c6c8570926b7", "bijlagen": [ - "/api/bijlagen/2653c850-a57f-49ef-80e4-89b8d445a98a" + { + "_self": { + "id": "2653c850-a57f-49ef-80e4-89b8d445a98a", + "name": "Naam_Bijlage", + "self": "/api/bijlagen/2653c850-a57f-49ef-80e4-89b8d445a98a", + "schema": { + "id": "bbfc722b-55bb-455e-8029-4b5bee6172e4", + "name": "Bijlage", + "ref": "https://commongateway.nl/pdd.bijlage.schema.json" + }, + "level": 2, + "dateCreated": "2023-11-24T11:31:47+00:00", + "dateModified": "2023-11-24T11:31:48+00:00", + "owner": { + "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", + "name": "Conduction Admin", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": [ + { + "id": "f8cbb0d0-aa58-4163-97f2-2da2a220bb31", + "source": { + "id": "75b9d330-a87b-477e-a6e0-8258ecc75c97", + "ref": "https://commongateway.woo.nl/source/ridderkerk.openwoo.source.json", + "name": "Ridderkerk OpenWoo", + "description": "Ridderkerk OpenWoo API", + "location": "https://openpub.ridderkerk.nl/wp-json" + }, + "endpoint": null, + "sourceId": "https://openpub.ridderkerk.nl/wp-content/uploads/sites/3/2023/02/ondertekend-afvalwaterakkoord-Ridderkerk-2022.pdf", + "dateCreated": "2023-11-24T11:31:47+00:00", + "dateModified": "2023-11-24T11:31:47+00:00", + "lastChecked": null, + "lastSynced": null, + "sourceLastChanged": null + } + ] + }, + "id": null, + "titel": "Naam_Bijlage", + "categorie": null, + "type": null, + "status": null, + "url": "https://openpub.ridderkerk.nl/wp-content/uploads/sites/3/2023/02/ondertekend-afvalwaterakkoord-Ridderkerk-2022.pdf" + } ], "themas": [ - "/api/themas/622721fc-6866-4a88-a1da-91a28edbcb39" + { + "_self": { + "id": "622721fc-6866-4a88-a1da-91a28edbcb39", + "name": "No name could be established for this entity", + "self": "/api/themas/622721fc-6866-4a88-a1da-91a28edbcb39", + "schema": { + "id": "df8dec18-b872-4052-a9c4-d25d0654299e", + "name": "Thema", + "ref": "https://commongateway.nl/pdd.thema.schema.json" + }, + "level": 2, + "dateCreated": "2023-11-24T11:31:47+00:00", + "dateModified": "2023-11-24T11:31:48+00:00", + "owner": { + "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", + "name": "Conduction Admin", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": null + }, + "hoofdthema": "Milieu", + "subthema": null, + "aanvullendThema": null + } ], - "Besluit": null, - "informatieverzoek": null, - "inventarisatielijst": null, - "besluit": null, - "behandelendBestuursorgaan": "/api/behandelend_bestuursorganen/37165afb-0e33-4813-8f66-d504501e6128", - "metadata": "/api/metadata/8e1084b5-ba4d-4d33-a5c2-f98e7f893f07", - "embedded": { - "bijlagen": [ - { + "organisatie": { + "_self": { + "id": "37165afb-0e33-4813-8f66-d504501e6128", + "name": "Gemeente Ridderkerk", + "self": "/api/organisatie/37165afb-0e33-4813-8f66-d504501e6128", + "schema": { + "id": "c58c5089-924a-45de-90d2-5a04707dd3aa", + "name": "Organisatie", + "ref": "https://commongateway.nl/woo.organisatie.schema.json" + }, + "level": 2, + "dateCreated": "2023-11-24T11:31:47+00:00", + "dateModified": "2023-11-24T11:31:48+00:00", + "owner": { + "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", + "name": "Conduction Admin", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": null + }, + "naam": "Gemeente Ridderkerk", + "rsin": null, + "tooi": null, + "oidn": "ridderkerk", + "id": "37165afb-0e33-4813-8f66-d504501e6128" + }, + "metadata": { + "_self": { + "id": "8e1084b5-ba4d-4d33-a5c2-f98e7f893f07", + "name": "No name could be established for this entity", + "self": "/api/metadata/8e1084b5-ba4d-4d33-a5c2-f98e7f893f07", + "schema": { + "id": "dc551296-2715-4316-bb43-8a814f50197a", + "name": "Metadata", + "ref": "https://commongateway.nl/woo.metadata.schema.json" + }, + "level": 2, + "dateCreated": "2023-11-24T11:31:47+00:00", + "dateModified": "2023-11-24T11:31:48+00:00", + "owner": { + "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", + "name": "Conduction Admin", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": null + }, + "volgnummer": null, + "besluitdatum": "2022-12-21", + "verzoek": { + "_self": { + "id": "865e9591-109c-40f0-abb6-617f24893e10", + "name": "No name could be established for this entity", + "self": "/api/objects/865e9591-109c-40f0-abb6-617f24893e10", + "schema": { + "id": "8eafc709-09a5-4e71-9f4a-2831db244f5f", + "name": "Verzoek", + "ref": "https://commongateway.nl/woo.verzoek.schema.json" + }, + "level": 3, + "dateCreated": "2023-11-29T18:56:18+00:00", + "dateModified": "2023-11-29T19:10:18+00:00", + "owner": { + "id": "b5d1f8b2-100a-4925-9faa-f0a435228ee6", + "name": "Default User", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": null + }, + "inventarisatielijst": { "_self": { - "id": "2653c850-a57f-49ef-80e4-89b8d445a98a", - "name": "Naam_Bijlage", - "self": "/api/bijlagen/2653c850-a57f-49ef-80e4-89b8d445a98a", + "id": "c9517757-a726-4aec-b666-6ae5d21281ee", + "name": "Temporarily title so a object gets created for file fetching and url genering.", + "self": "/api/bijlagen/c9517757-a726-4aec-b666-6ae5d21281ee", "schema": { - "id": "bbfc722b-55bb-455e-8029-4b5bee6172e4", + "id": "fb4325dc-5f4e-4336-b2b5-f4c5f0872596", "name": "Bijlage", - "ref": "https://commongateway.nl/pdd.bijlage.schema.json" + "ref": "https://commongateway.nl/woo.bijlage.schema.json" }, - "level": 2, - "dateCreated": "2023-11-24T11:31:47+00:00", - "dateModified": "2023-11-24T11:31:48+00:00", + "level": 3, + "dateCreated": "2023-11-29T18:56:16+00:00", + "dateModified": "2023-11-29T19:10:18+00:00", "owner": { - "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", - "name": "Conduction Admin", + "id": "b5d1f8b2-100a-4925-9faa-f0a435228ee6", + "name": "Default User", "ref": "https://docs.commongateway.nl/user/default.user.json" }, "organization": { @@ -142,50 +312,47 @@ Response }, "synchronizations": [ { - "id": "f8cbb0d0-aa58-4163-97f2-2da2a220bb31", + "id": "3d532126-45b6-461f-b713-36b2b94843dc", "source": { - "id": "75b9d330-a87b-477e-a6e0-8258ecc75c97", - "ref": "https://commongateway.woo.nl/source/ridderkerk.openwoo.source.json", - "name": "Ridderkerk OpenWoo", - "description": "Ridderkerk OpenWoo API", - "location": "https://openpub.ridderkerk.nl/wp-json" + "id": "b4857337-cd1b-4834-9aeb-193c7170c488", + "ref": "https://commongateway.woo.nl/source/epe.zaaksysteem.source.json", + "name": "Epe zaaksysteem", + "description": "Epe zaaksysteem api", + "location": "https://zaaksysteem-accept.epe.nl/api" }, "endpoint": null, - "sourceId": "https://openpub.ridderkerk.nl/wp-content/uploads/sites/3/2023/02/ondertekend-afvalwaterakkoord-Ridderkerk-2022.pdf", - "dateCreated": "2023-11-24T11:31:47+00:00", - "dateModified": "2023-11-24T11:31:47+00:00", + "sourceId": "5d68832e-b847-4671-8a8e-5030f61d9a0a", + "dateCreated": "2023-11-29T18:56:16+00:00", + "dateModified": "2023-11-29T18:56:16+00:00", "lastChecked": null, "lastSynced": null, "sourceLastChanged": null } ] }, - "id": null, + "categorie": null, "type": null, - "status": null, - "tijdstipLaatsteWijziging": null, - "titel": "Naam_Bijlage", - "label": "Naam_Bijlage", - "url": "https://openpub.ridderkerk.nl/wp-content/uploads/sites/3/2023/02/ondertekend-afvalwaterakkoord-Ridderkerk-2022.pdf" - } - ], - "themas": [ - { + "status": "accepted", + "url": "http://localhost/api/view-file/f9358a25-ee51-4079-a1d1-e98d53c4ca80", + "titel": "Temporarily title so a object gets created for file fetching and url genering.", + "id": null + }, + "informatieverzoek": { "_self": { - "id": "622721fc-6866-4a88-a1da-91a28edbcb39", - "name": "No name could be established for this entity", - "self": "/api/themas/622721fc-6866-4a88-a1da-91a28edbcb39", + "id": "f6395c55-56d6-4837-bbd2-4e3f57f66f2a", + "name": "Temporarily title so a object gets created for file fetching and url genering.", + "self": "/api/bijlagen/f6395c55-56d6-4837-bbd2-4e3f57f66f2a", "schema": { - "id": "df8dec18-b872-4052-a9c4-d25d0654299e", - "name": "Thema", - "ref": "https://commongateway.nl/pdd.thema.schema.json" + "id": "fb4325dc-5f4e-4336-b2b5-f4c5f0872596", + "name": "Bijlage", + "ref": "https://commongateway.nl/woo.bijlage.schema.json" }, - "level": 2, - "dateCreated": "2023-11-24T11:31:47+00:00", - "dateModified": "2023-11-24T11:31:48+00:00", + "level": 3, + "dateCreated": "2023-11-29T18:56:16+00:00", + "dateModified": "2023-11-29T19:10:18+00:00", "owner": { - "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", - "name": "Conduction Admin", + "id": "b5d1f8b2-100a-4925-9faa-f0a435228ee6", + "name": "Default User", "ref": "https://docs.commongateway.nl/user/default.user.json" }, "organization": { @@ -198,82 +365,94 @@ Response "name": null, "ref": null }, - "synchronizations": null - }, - "hoofdthema": "Milieu", - "subthema": null, - "aanvullendThema": null - } - ], - "behandelendBestuursorgaan": { - "_self": { - "id": "37165afb-0e33-4813-8f66-d504501e6128", - "name": "Gemeente Ridderkerk", - "self": "/api/behandelend_bestuursorganen/37165afb-0e33-4813-8f66-d504501e6128", - "schema": { - "id": "c58c5089-924a-45de-90d2-5a04707dd3aa", - "name": "Behandelend bestuursorgaan", - "ref": "https://commongateway.nl/woo.behandelendBestuursorgaan.schema.json" - }, - "level": 2, - "dateCreated": "2023-11-24T11:31:47+00:00", - "dateModified": "2023-11-24T11:31:48+00:00", - "owner": { - "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", - "name": "Conduction Admin", - "ref": "https://docs.commongateway.nl/user/default.user.json" - }, - "organization": { - "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", - "name": "Default Organization", - "ref": "https://docs.commongateway.nl/organization/default.organization.json" - }, - "application": { - "id": null, - "name": null, - "ref": null + "synchronizations": [ + { + "id": "83fbd5dc-50f0-4c83-a0b3-1c9d097bc27c", + "source": { + "id": "b4857337-cd1b-4834-9aeb-193c7170c488", + "ref": "https://commongateway.woo.nl/source/epe.zaaksysteem.source.json", + "name": "Epe zaaksysteem", + "description": "Epe zaaksysteem api", + "location": "https://zaaksysteem-accept.epe.nl/api" + }, + "endpoint": null, + "sourceId": "348048f9-b29f-4986-8709-687d70d52333", + "dateCreated": "2023-11-29T18:56:16+00:00", + "dateModified": "2023-11-29T18:56:16+00:00", + "lastChecked": null, + "lastSynced": null, + "sourceLastChanged": null + } + ] }, - "synchronizations": null + "categorie": null, + "type": null, + "status": "accepted", + "url": "http://localhost/api/view-file/f723f34c-ef3d-453b-b395-fe60b5127cde", + "titel": "Temporarily title so a object gets created for file fetching and url genering.", + "id": null }, - "naam": "Gemeente Ridderkerk", - "oidn": "ridderkerk", - "id": "37165afb-0e33-4813-8f66-d504501e6128" - }, - "metadata": { - "_self": { - "id": "8e1084b5-ba4d-4d33-a5c2-f98e7f893f07", - "name": "No name could be established for this entity", - "self": "/api/metadata/8e1084b5-ba4d-4d33-a5c2-f98e7f893f07", - "schema": { - "id": "dc551296-2715-4316-bb43-8a814f50197a", - "name": "Metadata", - "ref": "https://commongateway.nl/woo.metadata.schema.json" - }, - "level": 2, - "dateCreated": "2023-11-24T11:31:47+00:00", - "dateModified": "2023-11-24T11:31:48+00:00", - "owner": { - "id": "f5d48e83-7a82-4d42-9120-9ff7b1ba0129", - "name": "Conduction Admin", - "ref": "https://docs.commongateway.nl/user/default.user.json" - }, - "organization": { - "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", - "name": "Default Organization", - "ref": "https://docs.commongateway.nl/organization/default.organization.json" - }, - "application": { - "id": null, - "name": null, - "ref": null + "besluit": { + "_self": { + "id": "c070e255-bb45-424c-aafd-53b885c4c144", + "name": "Temporarily title so a object gets created for file fetching and url genering.", + "self": "/api/bijlagen/c070e255-bb45-424c-aafd-53b885c4c144", + "schema": { + "id": "fb4325dc-5f4e-4336-b2b5-f4c5f0872596", + "name": "Bijlage", + "ref": "https://commongateway.nl/woo.bijlage.schema.json" + }, + "level": 3, + "dateCreated": "2023-11-29T18:56:17+00:00", + "dateModified": "2023-11-29T19:10:18+00:00", + "owner": { + "id": "b5d1f8b2-100a-4925-9faa-f0a435228ee6", + "name": "Default User", + "ref": "https://docs.commongateway.nl/user/default.user.json" + }, + "organization": { + "id": "a1c8e0b6-2f78-480d-a9fb-9792142f4761", + "name": "Default Organization", + "ref": "https://docs.commongateway.nl/organization/default.organization.json" + }, + "application": { + "id": null, + "name": null, + "ref": null + }, + "synchronizations": [ + { + "id": "14be2af7-bb74-4f38-8b7a-dcc1844bff60", + "source": { + "id": "b4857337-cd1b-4834-9aeb-193c7170c488", + "ref": "https://commongateway.woo.nl/source/epe.zaaksysteem.source.json", + "name": "Epe zaaksysteem", + "description": "Epe zaaksysteem api", + "location": "https://zaaksysteem-accept.epe.nl/api" + }, + "endpoint": null, + "sourceId": "160ce4f7-612d-4ffa-a504-51b78367c61f", + "dateCreated": "2023-11-29T18:56:17+00:00", + "dateModified": "2023-11-29T18:56:17+00:00", + "lastChecked": null, + "lastSynced": null, + "sourceLastChanged": null + } + ] }, - "synchronizations": null + "categorie": null, + "type": null, + "status": "accepted", + "url": "http://localhost/api/view-file/4b7978e8-6cf9-469e-b27c-08f895e5f653", + "titel": "Temporarily title so a object gets created for file fetching and url genering.", + "id": null }, - "volgnummer": null, - "besluitdatum": "2022-12-21", - "verzoeker": null, - "id": "8e1084b5-ba4d-4d33-a5c2-f98e7f893f07" - } + "termijnoverschrijding": null, + "ontvangstdatum": "2023-10-02T10:31:12Z", + "ontvangerInformatieverzoek": null, + "status": null + }, + "id": "8e1084b5-ba4d-4d33-a5c2-f98e7f893f07" } } ], From bf60024ed78d91cf2700a1bb053b23d1f426c1e0 Mon Sep 17 00:00:00 2001 From: Barry Brands Date: Wed, 29 Nov 2023 21:46:39 +0100 Subject: [PATCH 3/3] urls changed to dev --- docs/Integratie.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/Integratie.md b/docs/Integratie.md index 5418b040..b59e6d9d 100644 --- a/docs/Integratie.md +++ b/docs/Integratie.md @@ -8,7 +8,7 @@ Als u als organisatie of leverancier OpenWoo.app wilt koppelen aan een huidige i ### Locatie en Authenticatie -U vindt de API op [https://api.OpenWoo.app](https://api.OpenWoo.app). Voor het stellen van zoekvragen is géén authenticatie vereist (het doel van OpenWOO.app is immers het verspreiden van openbare informatie). Er is echter wel sprake van throttling op response tijden (de API reageert langzamer) en rate-limiting (het aantal bevragingen per minuut en uur zijn beperkt) zonder authenticatie. Ook zijn alleen de GET (ophalen) acties toegestaan zonder authenticatie. +U vindt de API op [https://api.gateway.commonground.nu/api/publicaties](https://api.gateway.commonground.nu/api/publicaties). Voor het stellen van zoekvragen is géén authenticatie vereist (het doel van OpenWOO.app is immers het verspreiden van openbare informatie). Er is echter wel sprake van throttling op response tijden (de API reageert langzamer) en rate-limiting (het aantal bevragingen per minuut en uur zijn beperkt) zonder authenticatie. Ook zijn alleen de GET (ophalen) acties toegestaan zonder authenticatie. Als u vanuit uw casus een API nodig heeft zonder throttling, ratelimit of namens een organisatie wijzigingen wilt doen (POST,PUT,DELETE) dan zijn er twee mogelijkheden. @@ -21,15 +21,15 @@ Voor de API is een [redoc documentatie]() beschikbaar met voorbeelden van de ver ### Voorbeelden -In het merendeel van de gevallen zult u een zoekvraag willen uitvoeren binnen de Woo publicaties van OpenWoo.app, het endpoint daarvoor is: . Er zijn 4 voor de hand liggende zoekparameters waarmee gezocht wordt (overige opties vind u terug in de [Redoc documentatie]()). +In het merendeel van de gevallen zult u een zoekvraag willen uitvoeren binnen de Woo publicaties van OpenWoo.app, het endpoint daarvoor is: . Er zijn 4 voor de hand liggende zoekparameters waarmee gezocht wordt (overige opties vind u terug in de [Redoc documentatie]()). 1. Op een of meerdere zoek woorden, b.v. `_search=test` -2. Op organisatie, dit gaat aan de hand van OIN (de volledige OIN lijst vind u [hier](https://oinregister.logius.nl/oin-register)). -3. Op categorie, categorie=Convenant +2. Op organisatie, dit gaat aan de hand van OIN (de volledige OIN lijst vind u [hier](https://oinregister.logius.nl/oin-register)) b.v. `oin=00000001001299992000` +3. Op categorie, `categorie=Convenant` 4. Op datum, Hierbij kunt u een begin en eindatum opgeven om een periode (bijvoorbeeld jaar) te doorzoeken publicatiedatum[after]=2022-12-31T23:59:59Z&publicatiedatum[before]=2024-01-01T00:00:00Z& ````cli -GET 'https://api.OpenWoo.app/publicaties?extend[]=all&_search=Afvalwaterakkoord&_order[publicatiedatum]=desc&_limit=12&_page=1' +GET 'https://api.gateway.commonground.nu/api/publicaties?extend[]=all&_search=Afvalwaterakkoord&_order[publicatiedatum]=desc&_limit=12&_page=1' Response @@ -468,7 +468,7 @@ Response Vanuit een het weergeven van een zoekformulier is het goed mogelijk dat u alleen bestaande waardes wilt weergeven (bijvoorbeeld bij jaartal of categorie). U kunt daarvoor de queries parameter gebruiken, deze verteld u welke zoekwaarde welke resultaten opleveren. ````cli -GET 'https://api.OpenWoo.app/publicaties?_queries[]=categorie' +GET 'https://api.gateway.commonground.nu/api/publicaties?_queries[]=categorie' Response