OSR:API/V2/Opvragen mandaat token

Hieronder is een voorbeeld weergegeven van de 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

Request parameters

Parameters	Omschrijving	Verplicht/Optioneel
school_oin	OIN van de onderwijsinstelling	Verplicht
Service_version_namespace	Namespace van de dienst*	Verplicht
Supplier_oin	BOIN 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.

Response

Voor de leverancier die zijn eigen mandaat opvraagt kan het volgende response worden teruggegeven:

{ 
   "token": "d4fe5e12-bf0a-48b9-8844-edf58da93056", 
   "start_date": "2018-12-18", 
   "end_date": null, 
   "_links":    { 
      "self": {"href": "/api/v1/mandates/1"}, 
      "school": {"href": "/api/v1/schools/1"}, 
      "service": {"href": "/api/v1/services/2"} 
   } 
}

Response parameters

Parameters	Omschrijving
token	Mandaat token, dit is nodig voor de gemandateerde leverancier om een endpoint aan te kunnen maken
start_date	Startdatum van het mandaat. Dit is de dag van aanmaak van het mandaat of een specifieke datum welke gekozen is door de onderwijsinstelling
end_date	Einddatum van het mandaat. Dit wordt specifiek ingevuld door de onderwijsinstelling
_links self	Directe link om het mandaat op te kunnen vragen. Dit kan alleen worden gebruikt door de leverancier die gemandateerd is
_links school	Directe link naar informatie over de desbetreffende gekoppelde onderwijsinstelling
_links service	Directe link naar informatie over de desbetreffende gekoppelde dienst