Child pages
  • Telefoongids
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

Opvragen van de telefoongids van een instelling. 

Authenticatie nodig: afhankelijk van policy instelling (?) ?(zijn er instellingen die deze informatie publiek willen hebben?)

Voorstel: https://api.example.edu/v0/directory/people/search

De response is een json-object met daarin record van personen.  Attributen (naam, telefoon, etc) van de persoon worden uitgedrukt met hun LDAP-namen (RFC4519)

Voorbeeld:

GET https://api.example.edu/v0/directory/people/search?q=piet
200 OK
{
  "status": "ok",
  "numresults": 2,
  "results": [
    {
      "givenName": "Jan",
      "sn": "Pietersen",
      "telephoneNumber": "010-1234567"
    },
    {
      "givenName": "Kees",
      "sn": "Pietersen",
      "telephoneNumber": "010-7654321"
    }
  ]
}

Voorbeelden

Avans:

https://<endpoint>/<version>/phonedirectory/<search>/

Zoekt naar de (telefoongids-)gegevens van de persoon waarvan <search> voorkomt in:

  • inlognaam
  • voornaam
  • achternaam
  • afdeling
  • emailadres
  • telefoonnummer

De zoekopdracht is minimaal 4 karakters lang

Hogeschool Leiden:

Er is geen echte telefoongids, maar wel informatie die in een telefoonboek kan worden gebruikt.

Zoeken en opvragen detailgegevens voor studenten of medewerkers.

https://<endpoint>/apis/<version>/student/...

https://<endpoint>/apis/<version>/student/id/...

https://<endpoint>/apis/<version>/employee/...

https://<endpoint>/apis/<version>/employee/id/...

De zoekopdracht is minimaal 2 karakters lang.

Resultaatset geeft:

  • inlognaam
  • voornaam
  • achternaam
  • displayname
  • emailadres
  • opleiding (student)
  • afdeling of cluster (medewerker)
  • telefoonnummer (medewerker)
  • (verdere details van de betreffende persoon worden getoond indien de gegevens zijn vrijgegeven door de persoon zelf.)
  • No labels