Es ist leider nicht möglich, alle Kataloge als GIATA-Flip-Cat bereitzustellen. Die Liste der Kataloge, die als GIATA-Flip-Cat bereitgestellt werden, kann über die GIATA-XML-Schnittstelle ermittelt werden.

Rufen Sie dafür die Katalog-Liste eines Veranstalters auf (hier ein Beispiel für den Veranstalter TUI, Code 'tui', Ausschnitt):

https://xml.giatamedia.com/?sc=list&list=catalog&vc=tui

<CatalogList>
    <cr>
        <cn>Deluxe Nordamerika - 2021/2022</cn>
        <cid>21729</cid>
        <cid_infox/>
        <flipcat>0</flipcat>
        <pdf_url/>
    </cr>
    <cr>
        <cn>Deluxe: Karibik, Mittel- und Südamerika - 2020/2021</cn>
        <cid>21728</cid>
        <cid_infox/>
        <flipcat>1</flipcat>
        <pdf_url/>
    </cr>
    <cr>
        ...

Der Ausgabe einer solchen Anfrage können Sie entnehmen, ob für einen Katalog ein entsprechender Flip-Cat existiert: Hat das Element 'flipcat' den Wert '1', dann existiert er, hat es den Wert '0', dann nicht. Benötigen Sie einen Katalog, der noch nicht als Flip-Cat vorliegt, dann können Sie uns gerne ansprechen.

Wenn Sie über eine solche Anfrage ermittelt haben, dass der anzuzeigende Katalog als Flip-Cat vorliegt, müssen Sie sich für diesen Katalog die Katalog-ID merken (Element 'cid'). Diese Katalog-ID ist in der Regel unveränderlich, sie muss also nur einmal ermittelt werden (Ausnahme: Weitere Auflagen eines Kataloges werden mit neuen Katalog-IDs versehen, werden dann aber auch als eigene Flip-Cats betrachtet).

Um flexibler auf eventuelle Serverausfälle und Überlastungen reagieren zu können, müssen Sie die Server getrennt vom URL-Pfad und im Idealfall auch häufiger ermitteln.

Rufen Sie dafür folgenden URL auf (natürlich mit Ihren Zugangsdaten):

https://xml.giatamedia.com/?sc=list&list=flipcat_server

<serverlist>
    <service name="flipcat">
        <servers>
            <server>
                <scheme>https</scheme>
                <host>flipcat.giatamedia.com</host>
                <port>443</port>
                <capacity>70</capacity>
            </server>
            <server>
                <scheme>https</scheme>
                <host>flipcat123.giatamedia.com</host>
                <port>443</port>
                <capacity>30</capacity>
            </server>
        </servers>
    </service>
</serverlist>

Die Summe aller Werte des 'capacity'-Elements ergibt 100. Server mit dem Wert '0' für das 'capacity'-Element sollten Sie ignorieren. Je größer der Wert des 'capacity'-Elements ist, um so relativ häufiger sollten Sie diesen Server nutzen.

Mit der ermittelten Katalog-ID können Sie nun den URL-Pfad für den anzuzeigenden Flip-Cat über folgenden Aufruf (natürlich wiederum mit Ihren Zugangsdaten) ermitteln (Ausgabe gekürzt):

https://xml.giatamedia.com/?sc=flipcat&katid=21728

<flipcat catalogId="21728">
    <urlPath>/index.html?fc=MTE1NzMxMDM1NnwaRDlAUYoqfH...</urlPath>
</flipcat>

	URL-codieren Sie Ihre Parameter
	Bitte denken Sie daran, Ihre Werte, die Sie dem URL mitgeben, zu codieren!

Beispiel:

https://xml.giatamedia.com/?sc=flipcat&katid=21728

	Achtung
	Bitte beachten Sie, dass diese URLs nur eine begrenzte Gültigkeit haben und regelmäßig neu abgerufen werden müssen. Benutzen Sie keine URLs, die älter als 12 Stunden sind!

Den URL, den Sie so über die GIATA-XML-Schnittstelle ermittelt haben, können Sie um folgenden GET-Parameter ergänzen: