Alle Bronnen

De connector die de gereedschappen van alle andere connectoren op één adres aanbiedt. Deze connector leest zelf niets.

Adres: https://besluitbron.nl/mcp/unified/v1.

Hoe de namen zijn opgebouwd

Elk gereedschap draagt de naam van de bron ervoor, gescheiden door een liggend streepje. tweedekamer_get_vote is het gereedschap get_vote van Tweede Kamer. De voorvoegsels zijn:

Het voorvoegsel dient niet alleen de leesbaarheid. De gereedschapskist is op naam gesleuteld. Zonder voorvoegsel zou zij niet eens te bouwen zijn, want elke bron kent een search_documents.

Drie gereedschappen dragen geen voorvoegsel. Zij gaan niet over één bron maar over alle:

• list_capabilities vertelt welke bron welke vraag kan beantwoorden. Dat is op dit adres het aangewezen startpunt;
• platform_status vertelt of een bron nog nieuw materiaal binnenhaalt;
• list_platform_calls geeft de aanroepen terug achter één eerder antwoord, zie Logging en Verantwoording.

De eerste twee nemen een bron als parameter. Het derde niet: het request_id uit een antwoord wijst die ene aanroep al aan, ongeacht welke bron hem heeft uitgevoerd. Welke bron dat was, staat in het antwoord zelf, bij elke aanroep die het opsomt.

Tot versie 1.3.40 stond hier per bron een eigen list_platform_calls, dus zeven in totaal. Die zeven werkten niet: een aanroep op dit adres wordt vastgelegd onder de connector unified, terwijl elk van de zeven om een bronnaam vroeg. Het antwoord was daarom altijd dat er geen aanroepen bekend waren. Vanaf versie 1.3.41 is er één gereedschap en werkt het.

Waarvoor deze connector geschikt is

Voor een vraag waarvan vooraf niet vaststaat op welke bestuurslaag zij thuishoort. En voor een vraag die de lagen uitdrukkelijk met elkaar verbindt: wat de raad besloot, wat daarover is bekendgemaakt en wat de rechter erover oordeelde.

De prijs

Ruim zestig gereedschapsbeschrijvingen concurreren om de aandacht van de assistent. Dat kost aandacht die anders naar de vraag zou gaan. Het vergroot ook de kans dat een verkeerd gereedschap wordt gekozen. Wie weet welke bron nodig is, is met het adres van die bron beter af, zie Connector.

Een aanbod, geen platform

Deze connector heeft een eigen adres, een eigen schakelaar en een eigen aansluitpagina, en telt daarmee als connector. Hij telt niet mee bij de vraag of deze installatie een bron aanbiedt. Een adres dat alleen de gereedschappen van anderen doorgeeft, houdt de dienst namelijk niet in de lucht wanneer alle bronnen zijn uitgezet. Zie Connectorregister.