OSR:API/V2/Opvragen informatie over dienst: verschil tussen versies

Uit Kennisnet Developers Documentatie
< OSR:API‎ | V2
Naar navigatie springen Naar zoeken springen
Regel 51: Regel 51:
 
"href": "string"
  
"href": "string"
 
}
  
}
  +
}
  +
}
  +
]
  +
</syntaxhighlight>
  +
  +
  +
==Opvragen informatie over een dienstversie==
  +
Onderstaande request is het basisrequest om alle dienstversies op te vragen.
  +
  +
<table><tr>
  +
<td><span style="color:white;font-weight:bold;background-color:#61affe;padding:6px 15px">GET</span></td>
  +
<td><syntaxhighlight lang="json" style="display:inline";> /service-versions</syntaxhighlight></td>
  +
</tr></table>
  +
  +
Een lijst met dienstversies kan worden opgevraagd aan de hand van de code van de desbetreffende dienst.<br>
  +
  +
  +
  +
Responsecodes
  +
  +
{|class="wikitable"
  +
! style="text-align:left;"| Code
  +
! style="text-align:left;"| Melding
  +
|-
  +
| | 200
  +
| | Dienstversies object (gevuld bij resultaat of leeg bij geen matches)
  +
|}
  +
  +
===Response===
  +
De response kan uit 0, 1 of meerdere dienstversies bestaan. Hieronder is een voorbeeld weergegeven van de response:<br>
  +
  +
<syntaxhighlight lang="json">
  +
[
  +
{
  +
"namespace": "http://example.com/v1",
  +
"status": "active",
  +
"_links": {
  +
"self": {
  +
"href": "string"
  +
},
  +
"service": {
  +
"href": "http://example.com"
  +
},
 
}
  
}
 
}
  
}

Versie van 15 jul 2021 13:03

Inleiding

Men kan informatie over diensten en dienstversies opvragen met behulp van deze functionaliteit.

Opvragen informatie over een dienst

Onderstaande request is het basisrequest om alle diensten op te vragen.

GET 
 /services

Het is mogelijk om te zoeken naar een (deel van de) dienstnaam, onderstaande geeft een voorbeeld weer van het gebruik van deze parameter.

/api/v2/services?name=bron
Parameters Omschrijving Verplicht/Optioneel
Name (Deel van de) Naam van de dienst. Optioneel


Responsecodes

Code Melding
200 Dienst object (gevuld bij resultaat of leeg bij geen matches)

Response

De response kan uit 0, 1 of meerdere diensten bestaan. Hieronder is een voorbeeld weergegeven van de response:

[
  {
    "code": "DIENST01",
    "name": "Eerste voorbeeldienst",
    "description": "Deze dienst dient ter illustratie",
    "_links": {
      "self": {
        "href": "string"
      }
    }
  }
]


Opvragen informatie over een dienstversie

Onderstaande request is het basisrequest om alle dienstversies op te vragen.

GET 
 /service-versions

Een lijst met dienstversies kan worden opgevraagd aan de hand van de code van de desbetreffende dienst.


Responsecodes

Code Melding
200 Dienstversies object (gevuld bij resultaat of leeg bij geen matches)

Response

De response kan uit 0, 1 of meerdere dienstversies bestaan. Hieronder is een voorbeeld weergegeven van de response:

[
  {
    "namespace": "http://example.com/v1",
    "status": "active",
    "_links": {
      "self": {
        "href": "string"
      },
     "service": {
        "href": "http://example.com"
      },
    }
  }
]

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.kennisnet.nl/api/v2/documentation

Over het gebruik van certificaten

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/Opvragen_informatie_over_dienst&oldid=11010"