{"id":3176,"date":"2024-03-22T11:03:17","date_gmt":"2024-03-22T11:03:17","guid":{"rendered":"https:\/\/support.alfaview.com\/developers\/request-your-api-credentials\/usage-examples\/create-group-links\/"},"modified":"2025-03-14T10:44:53","modified_gmt":"2025-03-14T10:44:53","slug":"create-group-links","status":"publish","type":"page","link":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/developers\/request-your-api-credentials\/usage-examples\/create-group-links\/","title":{"rendered":"Gruppenlinks erstellen"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"summary\">Summary<a href=\"#summary\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Group links can be shared with multiple recipients<\/li>\n\n\n\n<li>The endpoint can create multiple group links at once<\/li>\n\n\n\n<li>Required API calls: <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">guestService.v2\/createGroupLinks<\/mark><\/code><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"request\">Request<a href=\"#request\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<p>Request <button class=\"av-button av-button--error\">POST<\/button> to <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">https:\/\/apis.alfaview.com\/json\/v1\/guestService.v2\/createGroupLinks<\/mark><\/code><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"accessInfo\": {\n     \"requestId\": \"### REQUEST ID ###\",\n     \"accessToken\": \"### ACCESS TOKEN ###\"\n   },\n  \"roomId\": \"### ROOM ID ###\",\n  \"groupLinkCreations\": &#91;\n    {\n      \"description\": \"### GROUP LINK TITLE ###\",\n      \"validFrom\": \"2022-08-01T13:15:00Z\",\t\n      \"validUntil\": \"2022-08-02T14:00:00Z\",\n      \"permissionGroupId\": \"### PERMISSION GROUP ID ###\",\n    }\n  ]\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"response\">Response<a href=\"#response\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"replyInfo\": {\n    ...\n    \"statusMessage\": \"OK\"\n  },\n  \"groupLinks\": &#91;\n    {\n      ...\n      \"joinLink\": \"https:\/\/app.alfaview.com\/#\/join\/01FH0EX0VQQ378MV7Z5NAGHESK\/4173dafb-5cde\u00025c85-95a3-20ebdd43698a\/NcHef8FIc17a5jpiWy4fJ0cw2dCRpbFG\/v2\",\n      \"accessKey\": \"NcHef8FIc17a5jpiWy4fJ0cw2dCRpbFG\"\n    }\n  ]\n}<\/code><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\" class=\"wp-block-heading\" id=\"notes\">Notes<a href=\"#notes\" class=\"av-heading-anchor\"><i class=\"bi bi-link\"><\/i><\/a><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">groupLinkCreations<\/mark><\/code> can contain multiple objects, contains the following attributes\n<ul class=\"wp-block-list\">\n<li><code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">description<\/mark><\/code> the title of this group link, not visible for the recipient<\/li>\n\n\n\n<li><code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">validFrom<\/mark><\/code> and <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">validUntil<\/mark><\/code> define the time frame in which the group link is valid. If only <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">validFrom<\/mark><\/code> is defined the time range has an open end. If none are defined time range is unlimited. Both values are optional.<\/li>\n\n\n\n<li>retrieve the desired <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">permissionGroupId<\/mark><\/code> from the Business Logic Service<\/li>\n<\/ul>\n<\/li>\n\n\n\n<li>The response contains a corresponding array of group links, which then contain an individual <code><mark style=\"background-color:rgba(0, 0, 0, 0)\" class=\"has-inline-color has-vivid-cyan-blue-color\">joinLink<\/mark><\/code><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Summary Group links can be shared with multiple recipients The endpoint can create multiple group links at once Required API calls: guestService.v2\/createGroupLinks Request Request POST to https:\/\/apis.alfaview.com\/json\/v1\/guestService.v2\/createGroupLinks Response Notes description the title of this group [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":0,"parent":3170,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-3176","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3176","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/comments?post=3176"}],"version-history":[{"count":8,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3176\/revisions"}],"predecessor-version":[{"id":3177,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3176\/revisions\/3177"}],"up":[{"embeddable":true,"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/pages\/3170"}],"wp:attachment":[{"href":"https:\/\/cp-prod-wordpress.alfa.sx\/de\/wp-json\/wp\/v2\/media?parent=3176"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}