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

Uit Kennisnet Developers Documentatie
< OSR:API‎ | V2
Naar navigatie springen Naar zoeken springen
(Nieuwe pagina aangemaakt met ' ==Inleiding== Men kan informatie over diensten en dienstversies opvragen met behulp van deze operatie. ==Opvragen informatie over een dienst== Onderstaande reque...')
 
(De pagina is leeggehaald)
Label: Leeghalen
 
(18 tussenliggende versies door 2 gebruikers niet weergegeven)
Regel 1: Regel 1:


==Inleiding==
Men kan informatie over diensten en dienstversies opvragen met behulp van deze operatie.
==Opvragen informatie over een dienst==
Onderstaande request is het basisrequest om alle diensten op te vragen.
GET Request<br>
<syntaxhighlight lang="json">
/api/v2/services
</syntaxhighlight>
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
|}
Responsecodes
{|class="wikitable"
! style="text-align:left;"| Route
! style="text-align:left;"| Code
! style="text-align:left;"| Melding
|-
| | services/
| | 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:<br>
<syntaxhighlight lang="json">
[
  {
    "code": "DIENST01",
    "name": "Eerste voorbeeldienst",
    "description": "Deze dienst dient ter illustratie",
    "_links": {
      "self": {
        "href": "string"
      }
    }
  }
]
</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-sb.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"