{"id":94,"date":"2023-10-23T13:08:31","date_gmt":"2023-10-23T12:08:31","guid":{"rendered":"https:\/\/knowledge.catchup-apps.com\/?post_type=epkb_post_type_1&#038;p=94"},"modified":"2023-10-23T14:22:34","modified_gmt":"2023-10-23T13:22:34","slug":"api","status":"publish","type":"epkb_post_type_1","link":"https:\/\/knowledge.catchup-apps.com\/?epkb_post_type_1=api","title":{"rendered":"API"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Wir bieten verschiedene Schnittstellen an, damit Sie bestm\u00f6glich unsere Anwendung integrieren oder mit ihr interagieren k\u00f6nnen.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fcr eine eindeutigen Aufruf unserer API wird immer ein <strong>piKey<\/strong> ben\u00f6tigt. Diesen erhalten Sie von Ihrem Ansprechpartner bei uns. S\u00e4mtliche Aufrufe setzen eine sichere Verbindung \u00fcber <strong>HTTPS<\/strong> voraus und Nachrichten im <strong>JSON<\/strong>-Format mit <strong>UFT-8<\/strong> codiert.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Als Beispiel verwenden wir Anfragen f\u00fcr unseren Demo-Campus in Hamburg. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Sie haben die M\u00f6glichkeit, die Anfrageparameter als URL-Parameter oder im Body im JSON-Format anzufragen. In unseren Beispielen werden wir der \u00dcbersicht halber nur die Body-Requests auff\u00fchren.<\/p>\n\n\n\n<p class=\"has-x-large-font-size wp-block-paragraph\">App-URLs<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Wenn Sie unsere Anwendung z.B. innerhalb eines iFrames integrieren m\u00f6chten, dann ist es oftmals sinnvoll, nicht einfach nur die Startseite der Anwendung aufzurufen. Dabei haben Sie die M\u00f6glichkeit, verschiedene Einstellungen vorzunehmen. Unsere Anwendung ist so aufgebaut, dass alle notwendigen Parameter in der URL hinterlegt sind. Dies hat z.B. den Vorteil, dass Benutzer unserer Anwendung die Navigation von Start zum Ziel direkt teilen k\u00f6nnen. Zudem wird unsere Anwendung fortlaufend verbessert und erweitert, weshalb es besser ist \u00fcber die API die URL zu ermitteln, als sich das Ergebnis der API zu speichern. <\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Die M\u00f6glichkeiten und Auswirkungen sind in der folgenden Tabelle aufgef\u00fchrt:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>Schnittstelle<\/strong>:\nhttps:&#47;&#47;www.catchup-apps.com\/api\/public\/getAppUrl.php<\/code><\/pre>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Typ &amp; Default Value<\/th><th>Pflichtfeld<\/th><th>Beschreibung<\/th><\/tr><\/thead><tbody><tr><td>piKey<\/td><td>string: &#8211;<\/td><td>Ja<\/td><td>Eindeutige Bezeichnung f\u00fcr den Mandanten<\/td><\/tr><tr><td>noIntro<\/td><td>boolean: true<\/td><td>Nein<\/td><td>true: \u00dcberspringt das Intro, sodass z.B. direkt die Karte dargestellt wird.<br>false: Das Intro wird dargestellt.<\/td><\/tr><tr><td>isTerminal<\/td><td>boolean: false<\/td><td>Nein<\/td><td>true: Unsere Anwendung wird minimalistisch dargestellt, sodass der Benutzer nicht durch \u00fcberfl\u00fcssige Auswahlm\u00f6glichkeiten abgelenkt wird. Zudem besteht mit dieser Option die M\u00f6glichkeit, weitere Optionen freizuschalten.<br>false: Die Standardansicht wird verwendet.<\/td><\/tr><tr><td>terminalHandAnimation<\/td><td>boolean: false<\/td><td>Nein<\/td><td>true: Nach einer gewissen Zeit wird auf der Karte eine &#8222;Hand&#8220; dargestellt, die zur Interaktion mit dem Display animiert.<br>false: Die Standardansicht wird verwendet.<\/td><\/tr><tr><td>navigationLock<\/td><td>boolean: false<\/td><td>Nein<\/td><td>true: <br>false: <\/td><\/tr><tr><td>autoReset<\/td><td>boolean: false<\/td><td>Nein<\/td><td>true: Nach einer gewissen Zeit wird die Anwendung auf die Darstellung beim initialen URL-Aufruf zur\u00fcckgesetzt.<br>false: Die Anwendung setzt sich nicht automatisch zur\u00fcck.<\/td><\/tr><tr><td>hideTabbar<\/td><td>boolean: true<\/td><td>Nein<\/td><td>true: Die Tabbar wird ausgeblendet, sodass der Benutzer z.B. nur die Navigation verwenden kann.<br>false: Alle Funktionen der Tabbar, z.B. Neuigkeiten oder Veranstaltungen, sind verf\u00fcgbar.<\/td><\/tr><tr><td>redirect<\/td><td>boolean: false<\/td><td>Nein<\/td><td>true: Die resultierende URL wird nicht zur\u00fcckgegeben, sondern direkt aufgerufen. Dies ist insbesondere in iFrames sinnvoll.<br>false: Wir liefern Ihnen im Response die nutzbare URL zur\u00fcck.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"has-large-font-size wp-block-paragraph\">Start &amp; Destination<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">F\u00fcr die Navigation k\u00f6nnen Start- und Ziel angegeben werden. Da wir eventuell auf unterschiedlichen Fremdschl\u00fcsseln arbeiten, ermitteln wir anhand der Eingabe und der uns vorliegenden Daten die f\u00fcr unsere Navigation wichtigen <strong>Global IDs<\/strong>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Parameter<\/th><th>Typ<\/th><th>Pflichtfeld<\/th><th>Beschreibung<\/th><\/tr><\/thead><tbody><tr><td>start<\/td><td>JSON: &#8211;<\/td><td>Nein<\/td><td>Tupel bestehend aus <em>type<\/em> &amp; <em>id<\/em>, welches den Start der Navigation definiert.<\/td><\/tr><tr><td>destination<\/td><td>JSON: &#8211;<\/td><td>Nein<\/td><td>Tupel bestehend aus <em>type<\/em> &amp; <em>id<\/em>, welches das Ziel der Navigation definiert.<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">Als <em>id<\/em> und <em>type<\/em> werden non-nullable Strings erwartet.<\/figcaption><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">M\u00f6gliche Types:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Type<\/th><th>Beschreibung<\/th><\/tr><\/thead><tbody><tr><td>agfaCalendarId<\/td><td>Dedalus Agfa-Kalender ID<\/td><\/tr><tr><td>technicalRoomNumber<\/td><td>Technische Raumnummer (Aktuell die bei uns hinterlegten Fremdschl\u00fcssel)<\/td><\/tr><tr><td>roomName<\/td><td>Raum Name (Aktuell de_DE von nameLabel)<\/td><\/tr><tr><td><\/td><td><\/td><\/tr><tr><td><\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"has-medium-font-size wp-block-paragraph\">HTTP Status Codes<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th>Code<\/th><th>Beschreibung<\/th><\/tr><\/thead><tbody><tr><td>200<\/td><td>OK<\/td><\/tr><tr><td>403<\/td><td>Start- oder Ziel-type nicht valide<\/td><\/tr><tr><td>404<\/td><td>F\u00fcr mindestens eines der angegebenen ID &amp; Type-Tupel wurde kein Ergebnis gefunden<\/td><\/tr><tr><td><\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p class=\"has-x-large-font-size wp-block-paragraph\">Beispiele<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">#1<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>Request (Body)<\/strong> an https:\/\/www.catchup-apps.com\/api\/public\/getAppUrl.php\n{\n    \"piKey\": \"Basispaket-vZLgxvdW6PH8sK24Epj2RmOSUpag10etaFaFJb8\",\n    \"destination\": {\n        \"type\": \"roomName\",\n        \"id\": \"Raum EG\"\n    },\n    \"redirect\": false\n}\n<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>Response<\/strong>\nhttps:\/\/www.catchup-apps.com\/app\/map\/info\/?piKey=Basispaket-vZLgxvdW6PH8sK24Epj2RmOSUpag10etaFaFJb8&amp;noIntro=true&amp;navigationLock=false&amp;hideTabbar=true&amp;isTerminal=false&amp;autoReset=false&amp;terminalHandAnimation=false&amp;destination=1489563&amp;campusKeys=&#91;\"KPMKjRtTWcgP6oK2355txKLi7orfr6bxjxxp55CkSlh57KhgQQ\"]<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">#2<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Wir bieten verschiedene Schnittstellen an, damit Sie bestm\u00f6glich unsere Anwendung integrieren oder mit ihr interagieren k\u00f6nnen. F\u00fcr eine eindeutigen Aufruf [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"epkb_post_type_1_category":[24],"epkb_post_type_1_tag":[],"class_list":["post-94","epkb_post_type_1","type-epkb_post_type_1","status-publish","hentry","epkb_post_type_1_category-api"],"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"et-pb-post-main-image":false,"et-pb-post-main-image-fullwidth":false,"et-pb-portfolio-image":false,"et-pb-portfolio-module-image":false,"et-pb-portfolio-image-single":false,"et-pb-gallery-module-image-portrait":false},"uagb_author_info":{"display_name":"Fiona Hackmann","author_link":"https:\/\/knowledge.catchup-apps.com\/?author=2"},"uagb_comment_info":0,"uagb_excerpt":"Wir bieten verschiedene Schnittstellen an, damit Sie bestm\u00f6glich unsere Anwendung integrieren oder mit ihr interagieren k\u00f6nnen. F\u00fcr eine eindeutigen Aufruf [&hellip;]","_links":{"self":[{"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/94","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1"}],"about":[{"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/types\/epkb_post_type_1"}],"author":[{"embeddable":true,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=94"}],"version-history":[{"count":5,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/94\/revisions"}],"predecessor-version":[{"id":100,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=\/wp\/v2\/epkb_post_type_1\/94\/revisions\/100"}],"wp:attachment":[{"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=94"}],"wp:term":[{"taxonomy":"epkb_post_type_1_category","embeddable":true,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_category&post=94"},{"taxonomy":"epkb_post_type_1_tag","embeddable":true,"href":"https:\/\/knowledge.catchup-apps.com\/index.php?rest_route=%2Fwp%2Fv2%2Fepkb_post_type_1_tag&post=94"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}