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

Uit Kennisnet Developers Documentatie
< OSR:API‎ | V2
Naar navigatie springen Naar zoeken springen
(De pagina is leeggehaald)
Label: Leeghalen
 
(10 tussenliggende versies door dezelfde gebruiker niet weergegeven)
Regel 1: Regel 1:


==Inleiding==
Men kan informatie over diensten en dienstversies opvragen met behulp van deze functionaliteit.
==Opvragen informatie over een dienst==
===Aanroep===
====API endpoint====
<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";> /services</syntaxhighlight></td>
</tr></table>
====Voorbeeld====
Het is mogelijk om te zoeken naar een (deel van de) dienstnaam, onderstaande geeft een voorbeeld weer van het gebruik van deze parameter.<br>
<syntaxhighlight lang="json">
/api/v2/services?name=bron
</syntaxhighlight>
{|class="wikitable"
! style="text-align:left;"| Parameters
! style="text-align:left;"| Omschrijving
! style="text-align:left;"| Verplicht/Optioneel
|-
| | Name
| (Deel van de) Naam van de dienst.
| | Optioneel
|}
===Response===
De response kan uit 0, 1 of meerdere diensten bestaan. Hieronder is een voorbeeld weergegeven van de response:<br>
<syntaxhighlight lang="json">
[
  {
    "code": "DIENST01",
    "name": "Eerste voorbeeldienst",
    "description": "Deze dienst dient ter illustratie",
    "_links": {
      "self": {
        "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"
      },
    }
  }
]
</syntaxhighlight>
==Voor wie?==
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>
Zie meer informatie over de API op https://osr.kennisnet.nl/api/v2/documentation<br>
==Over het gebruik van certificaten==
{{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]]

Huidige versie van 20 jun 2025 14:11

Overgenomen van "https://developers.wiki.kennisnet.nl/index.php?title=OSR:API/V2/Opvragen_informatie_over_dienst&oldid=13161"