# Referentielijsten (CONCEPT)

Binnen allerlei registraties wordt gebruik gemaakt van (semi) gestandaardiseerde waarden. Denk aan talen en landen. Idealiter wil je dat elke applicatie dezelfde lijst van talen en landen hanteert. Gelukkig zijn talen en landen goed gestandaardiseerd via ISO-standaarden, hoewel ook hier verschillende varianten in zijn (2 letter of 3 letters codes bijvoorbeeld).

Binnen referentielijsten willen we de wat minder gestandaardiseerde lijsten vastleggen zodat deze in de keten van applicaties gebruikt kan worden en niet in elke applicatie apart opgevoerd en gewijzigd hoeft te worden. Denk bijvoorbeeld aan communicatiekanalen (e-mail, WhatsApp, telefoon, Facebook) of soorten registraties (BRP, KVK, RNI).

## Overzicht

* **Component**: [Docker image](https://hub.docker.com/r/maykinmedia/open-klant/tags) | [Broncode](https://github.com/maykinmedia/referentielijsten)
* **API-specificatie**: [Open API Specificatie](https://redocly.github.io/redoc/?url=https://raw.githubusercontent.com/maykinmedia/referentielijsten/master/src/referentielijsten/api/openapi.yaml) 
* **Beschikbare lijsten**: Voorlopig, onderaan deze pagina.

## Open vragen

Bij lijsten spelen o.a. de volgende vragen:

* **Is het een landelijke lijst of een gemeentelijke specifieke lijst? Of beide?**
  * Concept antwoord: Het kan beide.
* **Draait het al ergens?**
  * Concept antwoord: Enkel in ontwikkelomgevingen. Er draait nog niets landelijks of in productie.
* **Is het een openbare lijst of intern?**
  * Concept antwoord: Openbaar (ofwel, het is niet geheim)
* **Bestaat de lijst uit enkel codes en/of waarden, of is er meer informatie?**
  * Concept antwoord: Standaard enkel een code+waarde, maar meer informatie (zonder structuur) is mogelijk.
* **Moet de lijst separaat worden bijgehouden (als referentielijst) of is de lijst onderdeel van een bepaalde specificatie?**
  * Concept antwoord: Idealiter moeten lijsten in de API-specificatie staan als ze weinig veranderen en enkel in die registratie gebruikt worden. Dit maakt het leven van ontwikkelaars veel eenvoudiger. Lijsten die wijzigen of gemeente specifiek zijn, of op veel plekken gebruikt worden, kunnen beter op een referentielijst komen. Maar het is dus niet heel zwart-wit.

## Beschikbare lijsten

* Communicatiekanalen


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dienstverleningsplatform.gitbook.io/platform-generieke-dienstverlening-public/standaarden/referentielijsten-concept.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.