OSR:API/V2/Valideren mandaat: verschil tussen versies

Uit Kennisnet Developers Documentatie
< OSR:API‎ | V2
Naar navigatie springen Naar zoeken springen
k
(21 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 1: Regel 1:
 
==Inleiding==
  
==Inleiding==
   
−
Het mandaat legt de relatie vast tussen onderwijsinstelling, dienst en een leverancier. Het mandaat zelf wordt aangemaakt door de OSR beheerder van de onderwijsinstelling via het zakelijk portaal. <br>
 +
Het mandaat legt de relatie vast tussen onderwijsinstelling, dienst en leverancier. Het mandaat zelf wordt aangemaakt door de OSR beheerder van de onderwijsinstelling via de grafische beheeromgeving van het OSR. <br>
   
 
Het is mogelijk voor andere partijen om te verifiëren of een leverancier gemandateerd is namens een onderwijsinstelling voor een bepaalde dienst.<br><br>
  
Het is mogelijk voor andere partijen om te verifiëren of een leverancier gemandateerd is namens een onderwijsinstelling voor een bepaalde dienst.<br><br>
−  
   
 
==Valideer mandaat==
  
==Valideer mandaat==
−
Hieronder is een voorbeeld weergegeven van de request:<br>
 +
Hieronder is een voorbeeld weergegeven van het request:<br>
   
 
<syntaxhighlight lang="json">
  
<syntaxhighlight lang="json">
Regel 14: Regel 13:
 
</syntaxhighlight>
  
</syntaxhighlight>
   
−
==Request parameters==
  
 
{|class="wikitable"
  
{|class="wikitable"
 
! style="text-align:left;"| Parameters
  
! style="text-align:left;"| Parameters
Regel 30: Regel 28:
 
|-
  
|-
 
| | Supplier_oin
  
| | Supplier_oin
−
| BOIN van de leverancier
 +
| OIN van de leverancier
 
| | Verplicht
  
| | Verplicht
 
|-
  
|-
Regel 38: Regel 36:
 
|}
  
|}
   
−
''' Om de verschillende versies van een dienst te kunnen onderscheiden wordt de namespace van de dienst gebruikt als unieke dienstkenmerk.''''<br>
+
<nowiki>*</nowiki> Om de verschillende versies van een dienst te kunnen onderscheiden wordt de namespace van de dienst gebruikt als unieke dienstkenmerk.<br>In de WSDL wordt dit meestal aangeduid met de targetnamespace. De namespace is een unieke URI die voor alle services/operaties in de dienst gebruikt worden.
−
''' In de WSDL wordt dit meestal aangeduid met de targetnamespace. De namespace is een unieke URI die voor alle services/operaties in de dienst gebruikt worden. '''
  
   
   
  +
Het volgende response kan terug worden gegeven:
−
Voor de leverancier die het mandaat van een andere leverancier opvraagt kan het volgende worden teruggegeven:
 
−  
   
 
<syntaxhighlight lang="json">
  
<syntaxhighlight lang="json">
Regel 55: Regel 51:
 
of 404 Mandate not found, indien er geen mandaat is aangemaakt voor de combinatie supplier_oin, school_oin en service_version_name_space
  
of 404 Mandate not found, indien er geen mandaat is aangemaakt voor de combinatie supplier_oin, school_oin en service_version_name_space
   
  +
−
==Response parameters==
  
  +
Response codes
  +
 
{|class="wikitable"
  
{|class="wikitable"
−
! style="text-align:left;"| Response
 +
! style="text-align:left;"| Route
−
! style="text-align:left;"| Omschrijving
 +
! style="text-align:left;"| Code
  +
! style="text-align:left;"| Melding
−
!
 
 
|-
  
|-
−
| | 200 OK
 +
| | mandates
  +
| | 200
−
| Confirmatie dat er een mandaat is afgegeven voor de combinatie onderwijsinstelling, dienst versie en leverancier.
  
  ⚫
| | mandate object
 
|-
  
|-
  +
| | mandates
⚫
| | 404 mandate not found
  
  +
| | 400
−
| Een van de parameters matcht niet met een mandaat
  
  +
| | some error in query params
  +
|-
  +
| | mandates
  +
| | 404
  +
| | mandate not found
 
|}
  
|}
   
  +
==Eigen mandaat opvragen==
  +
Het is ook mogelijk om het eigen mandaat op te vragen. Het resultaat bevat een mandaat token wat van belang is bij het aanmaken van een endpoint.
  +
  +
Op de volgende pagina kunt u hier informatie over terugvinden: [[OSR:2019/Opvragen_mandaat_token|Opvragen mandaat token]]
   
 
==Voor wie?==
  
==Voor wie?==
 
Deze service is beschikbaar voor iedereen.<br>
  
Deze service is beschikbaar voor iedereen.<br>
 
Voor TLS verbindingen (minimaal TLS 1.2) moet een aanvragende partij een geldige PKI overheidscertifcaat/ODOC certificaat gebruiken<br>
  
Voor TLS verbindingen (minimaal TLS 1.2) moet een aanvragende partij een geldige PKI overheidscertifcaat/ODOC certificaat gebruiken<br>
−
Zie meer informatie over de API op https://osr-sb.kennisnet.nl/api/v1/doc<br>
 +
Zie meer informatie over de API op https://osr-api-sb.kennisnet.nl/api/v1/doc<br>
  +
  +
{{Info|''' Let op:'''<br>Bij nieuw aan te vragen certificaten wordt sterk aangeraden te kiezen voor een PKI-overheidscertificaat.<br>Dit omdat ODOC-certificaten geen onderdeel meer uitmaken van de aankomende Edukoppeling Transactiestandaard versie 1.3.}}
  +
  +
[[Category:OSR]]

Versie van 5 apr 2019 09:24

Inleiding

Het mandaat legt de relatie vast tussen onderwijsinstelling, dienst en leverancier. Het mandaat zelf wordt aangemaakt door de OSR beheerder van de onderwijsinstelling via de grafische beheeromgeving van het OSR.

Het is mogelijk voor andere partijen om te verifiëren of een leverancier gemandateerd is namens een onderwijsinstelling voor een bepaalde dienst.

Valideer mandaat

Hieronder is een voorbeeld weergegeven van het request:

/api/v1/mandates?supplier_oin=00000003272448340204&school_oin=0000000700000AV00000&service_version_namespace=http://xml.eld.nl/schemas/Overstapservice/20180404&reference_date=2019-01-01
Parameters Omschrijving Verplicht/Optioneel
school_oin OIN van de onderwijsinstelling Verplicht
Service_version_namespace Namespace van de dienst* Verplicht
Supplier_oin OIN van de leverancier Verplicht
Reference_date Datumveld om een mandaat welke bv in de toekomst is ingesteld op te vragen Optioneel

* Om de verschillende versies van een dienst te kunnen onderscheiden wordt de namespace van de dienst gebruikt als unieke dienstkenmerk.
In de WSDL wordt dit meestal aangeduid met de targetnamespace. De namespace is een unieke URI die voor alle services/operaties in de dienst gebruikt worden.


Het volgende response kan terug worden gegeven: 

HTTP/1.1 200 OK 
{ 
   "code": 200, 
   "message": "Mandate found" 
}

of 404 Mandate not found, indien er geen mandaat is aangemaakt voor de combinatie supplier_oin, school_oin en service_version_name_space


Response codes

Route Code Melding
mandates 200 mandate object
mandates 400 some error in query params
mandates 404 mandate not found

Eigen mandaat opvragen

Het is ook mogelijk om het eigen mandaat op te vragen. Het resultaat bevat een mandaat token wat van belang is bij het aanmaken van een endpoint.

Op de volgende pagina kunt u hier informatie over terugvinden: Opvragen mandaat token

Voor wie?

Deze service is beschikbaar voor iedereen.
Voor TLS verbindingen (minimaal TLS 1.2) moet een aanvragende partij een geldige PKI overheidscertifcaat/ODOC certificaat gebruiken
Zie meer informatie over de API op https://osr-api-sb.kennisnet.nl/api/v1/doc

Info.gif Let op:
Bij nieuw aan te vragen certificaten wordt sterk aangeraden te kiezen voor een PKI-overheidscertificaat.
Dit omdat ODOC-certificaten geen onderdeel meer uitmaken van de aankomende Edukoppeling Transactiestandaard versie 1.3.
Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSR:API/V2/Valideren_mandaat&oldid=10102"