.. include:: globals.txt

.. connect CENTER documentation master file, created by
   sphinx-quickstart on Mon Jan  7 12:45:37 2013.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. _startconnectcenter:

|connectcentername|
==========================

Diese Dokumentation beschreibt die Funktionen des AGOF |connectcenternamep| und richtet sich an die teilnehmenden Vermarkter und Agenturen innerhalb des OVK (Online-Vermarkterkreis).

AGOF |connectcentername|  ist ein Webservice, der zum standardisierten Austausch von Dokumenten zwischen Vermarktern und Agenturen dient. Über |connectcentername| 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 |connectcentername| wird ausschließlich über das :ref:`connect kit <connectkit:startconnectkit>` zugegriffen. Die hier aufgeführten Endpunkte des Webservices werden im connect kit unter der Route **/api/** angesprochen (:ref:`siehe<connectkit:callapi>`). 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 |connecturl|/ 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.

.. _adresses:

Zentrale Adressen
--------------------

.. list-table::
   :widths: 20 25 55
   :header-rows: 1

   * - URL
     - Funktion
     - Erläuterung
   * - |connecturl_offical|
     - produktives |connectcentername|
     - Dies ist das offizielle zentrale |connectcentername|. 
   * - |connecturl_test|
     - Test-|connectcentername|
     - Unter dieser URL läuft ein |connectcentername|, welches von den Funktionen mit dem zentralen |connectcentername| identisch ist. Die User und Inhalte sind aber unabhängig vom zentralen |connectcentername|. Hier können Funktionen getestet werden. Siehe auch :ref:`connect kit Handbuch Testbetrieb <connectkit:testmode>`)


Webinterface der API-Funktionen
--------------------------------

Die hier beschriebenen Funktionen können live in einem connect kit unter :swagger_url:`/` getestet werden.


Inhalt
--------------------------

.. toctree::
   :maxdepth: 3

   generic
   public
   private