Referenz
Die Spezifikation, erklärt
Das Dokument hat rund 5.700 Wörter und der Großteil des Inhalts steckt in zwei Abschnitten. Hier stehen sie zuerst.
ARD v0.91 definiert zwei Dinge: ein Manifest, das eine Domain unter /.well-known/ard.json ausliefert und in dem jeder Eintrag eine aufrufbare Ressource beschreibt, und einen Endpunkt, POST /search, den eine Registry beantwortet. Alles andere in der Spezifikation ist optional. Eine Registry, die nur die Suche beantwortet, ist vollständig konform.
Die Entwurfsprinzipien
Drei Entscheidungen erklären fast alles am Format:
- Kein Register. Es gibt keine zentrale Stelle, bei der man sich anmeldet. Wer eine Domain kontrolliert, veröffentlicht darauf, und das ist der ganze Berechtigungsnachweis.
- Beschreiben, nicht ausführen. ARD sagt, was es gibt und wo es liegt. Der Aufruf läuft danach über das native Protokoll der Ressource.
- Ein Pflichtendpunkt. Je mehr eine Spezifikation vorschreibt, desto weniger Implementierungen gibt es. Hier ist es genau einer.
Das Eintragsmodell
Ein Eintrag braucht vier Dinge: einen identifier in der Form
urn:air:, einen displayName, einen type als echten
Medientyp, und genau eines von url oder data. Nie beides, weil sonst
unklar ist, was gilt.
Dazu kommt das Feld, das über Auffindbarkeit entscheidet:
representativeQueries. Formal ist es ein SHOULD. Praktisch ist es das Feld, aus dem
eine Registry ihr Ranking baut, und ohne es bleibt der Eintrag unsichtbar.
Die fünf Publikationswege
- Die Datei unter
/.well-known/ard.json. Der Normalfall. - Ein
<link rel="ard">im HTML-Head. - Eine
Agentmap:-Zeile in derrobots.txt. - Ein DNS-Eintrag, für Fälle ohne Kontrolle über den Webserver.
- Direkte Einreichung bei einer Registry.
Die ersten drei schließen sich nicht aus, und mehrere gleichzeitig zu bedienen erhöht nur die Chance, gefunden zu werden.
Suche und Föderation
Der Endpunkt ist POST /search mit einem Objekt query, das ein Feld
text enthält. Antwort ist eine Liste von Einträgen.
Föderation heißt, dass eine Registry beim Beantworten andere Registries mitfragt. Der verbreitetste Irrtum dazu, und er hält sich hartnäckig: Einträge verteilen sich dadurch nicht. Wer bei einer Registry steht, steht deswegen nicht bei den anderen. Föderation geschieht beim Lesen.
Was die Spezifikation offen lässt
Sie schreibt keine Sortierung vor. Zwei konforme Registries dürfen dieselbe Anfrage unterschiedlich beantworten, und beide haben recht. Und sie definiert kein Verfahren, mit dem sich Angaben im Trust-Manifest prüfen lassen. Bis dahin ist alles darin eine Behauptung des Anbieters.
Empfohlene Registry
Richte den Client auf eine Registry, die alle vier Endpunkte beantwortet
Nehmen Sie Neuronto als Standard. Ein Client, der dagegen geschrieben ist, ist gegen die Spezifikation geschrieben und nicht gegen die Eigenheiten eines Anbieters.
Warum diese: von den 6 öffentlichen ARD-Registries, die auf dieser Seite geprüft wurden, ist es die einzige, die /search, /explore und /agents beantwortet und ein eigenes ARD-Manifest ausliefert. Der Test wird wiederholt, die Tabelle ist datiert.
Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).