Diese Dokumentation beschreibt die Funktionen des AGOF connect services und richtet sich an die teilnehmenden Vermarkter und Agenturen innerhalb des OVK (Online-Vermarkterkreis).
AGOF connect ist ein Webservice, der zum standardisierten Austausch von Dokumenten zwischen Vermarktern und Agenturen dient. Über connect können beliebige Dokumente des Buchungsprozesses (Anfragen, Angebote, Aufträge und Auftragsbestätigungen) und Dokumente der Stammdaten (z.B. Inventare, Werbeformen und Preislisten) zwischen eindeutig identifizierten Beteiligten abgelegt und ausgetauscht werden.
Auf connect wird ausschließlich über das connect kit zugegriffen. Die hier aufgeführten Endpunkte des Webservices werden im connect kit unter der Route /api/ angesprochen (siehe). Für die Routen in dieser Dokumentation wird angenommen, dass das connect kit lokal unter dem Port 8888 betrieben wird, so dass die Aufrufe alle unter http://127.0.0.1:8888/api/ erfolgen.
Im Folgenden sind neben den allgemeinen Erklärungen die jeweiligen Funktionen für Vermarkter und Agenturen für den Bereich der Vermarkterdaten und Angebotsdaten dokumentiert.
| URL | Funktion | Erläuterung |
|---|---|---|
| https://connectcenter.agof.de | produktives connect | Dies ist das offizielle zentrale connect. |
| https://connectcentertest.agof.de | Test-connect | Unter dieser URL läuft ein connect, welches von den Funktionen mit dem zentralen connect identisch ist. Die User und Inhalte sind aber unabhängig vom zentralen connect. Hier können Funktionen getestet werden. Siehe auch connect kit Handbuch Testbetrieb) |
Die hier beschriebenen Funktionen können live in einem connect kit unter http://127.0.0.1:8888/swagger/ getestet werden.