| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
CAPO API
De API van CAPO zorgt ervoor dat vrijwel alle functionaliteit in CAPO ook via een API is te gebruiken vanuit de eigen systemen.
...
De documentatie is ook als .JSON te downloaden: https://services.dsplatform.nl/api/capo/documentation.json
Toegang krijgen tot de CAPO API
De CAPO API is beschikbaar voor netbeheerders en aannemers in de contractgebieden die CAPO ondersteunt. Zie hiervoor de lijst van ondersteunde contractgebieden op de CAPO wiki. Om als organisatie toegang te krijgen tot de API kan een Informatieverzoek service request worden aangemaakt op onze Servicedesk. Er wordt dan een token voor je organisatie aangemaakt en verstuurd naar de primaire contactpersoon van die organisatie. Met deze token kan de API vervolgens gebruikt worden.
...
Deelnemer maakt al gebruik van de DSP API en wil ook gebruik maken van de CAPO API.
Deelnemer legt een ticket in om toegang te krijgen tot de CAPO API.
Wanneer het ticket is afgerond, kan de deelnemer van de CAPO API gebruik maken met dezelfde credentials die hij voor de DSP API gebruikt.
Limiet aantal verzoeken
configuratie | waarde | beschrijving |
|---|---|---|
rate limit | 20 | een gemiddeld aantal verzoeken dat per seconden verwerkt kan worden |
burst | 30 | een tijdelijke uitzondering tov het gemiddelde. Zo kun je dus, bijvoorbeeld de eerste seconde, tot maximaal 30 requests sturen. |
inflight requests | 3 | aantal verzoeken dat tegelijk actief mag zijn |
Rate limiting is per client op het geheel van services, niet per API endpoint.
Uitleg veel voorkomende scenario’s
Hieronder worden een aantal scenario’s wat verder uitgelegd met voorbeelden, naar aanleiding van vragen van gebruikers. Let op dat de documentatie in de APIs zelf leading is, en onderstaande ter aanvulling.
Uploaden toegewezen bijlage
In CAPO werken we met toegewezen bijlagen. De toegewezen bijlage kan gezien worden als een container waar deelnemers bestanden (bijlagen) aan kunnen toevoegen. Het doel van deze container is het begeleiden van de projectvoortgang, door duidelijk te maken welke partij er verantwoordelijk is, wat de inhoud is en wat de planning(/tijdigheid) is van dit deel van het project.
...
{bijlageAssignedId} = ID van toegewezen bijlage{bijlageId} = ID van specifiek bestand
Beoordelen toegewezen bijlage
Sommige bijlagen dienen beoordeeld te worden voordat ze opgeleverd worden. Welke dit zijn is per combi gebied vooraf instelbaar door de beheerder van het project.
...
de volgorde van statussen in de happy flow:
assigned→uploaded→review→doneBij één afkeur in het proces is de volgorde:
assigned→uploaded→review→uploaded→review→done
Ophalen reeds geuploade bijlagen/bestanden van een project
Om reeds geuploade bijlagen (bestanden) van een project te downloaden en te achterhalen bij welke toegewezen bijlage zij horen, zijn er een aantal stappen:
Ophalen lijst Toegewezen bijlagen op een project:
GET /project/{projectId}/bijlageassignedOphalen lijst (al geuploade) bijlagen op een project:
GET /project/{projectId}/bijlageKoppelen van bijlage aan bijlageAssigned dmv parentId uit antwoord van
/bijlage, dit heeft dezelfde waarde als bijlageAssignedId uit het antwoord op/bijlageassigned
Quickscan volgorde
Bij het uitvoeren van de Quickscan via de API door een netbeheerder zijn er een aantal stappen:
...
De volgorde van handelingen tbv quickscan is belangrijk omdat, na de eerste combi melding van een netbeheerder, CAPO de quickscan beschouwt als afgerond. Hierna is het dan dus ook niet meer mogelijk om de andere twee handelingen te doen.
AGD: Aansluit Gereed Datum
In steeds meer gebieden wordt de klant gevraagd of hij/zij al gereed is, of op welke datum dat zal zijn. Deze werkwijze wordt per Contractgebied ‘aan’ gezet. Deze gegevens geven we ook door via de CAPO API.
Wordt AGD gebruikt in dit project?
Dit is zichtbaar op de projectdetails, GET /project/{projectId}, type agdRelevant. Bij waarde true wordt er op dit project AGD toegepast
Waar vind ik de AGD die de klant heeft doorgegeven?
De datum die de klant heeft doorgegeven geven we door op produkt niveau (= de combinatie van een aansluitobject en een discipline). Via GET /project/{projectId}, aansluitObjecten → produkten → agd. Het veldt geeft de datum die de klant heeft ingevuld. Deze kan ook leeg zijn als de klant niet weet wanneer hij aansluitgereed is.
Op dit moment zijn alle agd waarden binnen een project gelijk. Met het oog op de toekomst is het per produkt beschikbaar.
Wensdatum
Het veld wensdatum wordt ook gevuld bij projecten waarbij de AGD wordt gebruikt. Dit geeft, op projectniveau, aan wat de afgeleide aansluitgereeddatum zal zijn. Er zijn hiervoor 3 scenario’s:
...