1. Overview
  2. Avaya Spaces
  3. Related Zang Products
  4. Retrieve Service Configurations
  5. Retrieve Legal Information

1 Overview

All REST API requests to Avaya Spaces are made to spacesapis.zang.io, but most client applications will also require connections to other Avaya Spaces resoures. These Avaya Spaces resources can be obtained programmatically by making a request to service-configurations endpoint, see section 4.

For example, a client application may be required to initialize a socket.io connection to Avaya Spaces. The address of the Avaya Spaces socket.io server can be obtained in the spaces object as the socketio_server_url property.

2 Avaya Spaces

Spaces:

  • server_url: Main service url (REST API). For example, https://spacesapis.zang.io.
  • socketio_server_url: SocketIO service url. For example, https://spacesapis-socket.zang.io.
  • marketing_url: Optional, Spaces marketing page url. For example, http://www.zang.io/products/spaces.

3 Related Zang Products

Accounts:

  • server_url: This is the URL of Zang Accounts. It provides authentication service. For example, https://accounts.zang.io.

Store:

  • server_url: This is the URL of Zang Store. It provides a service for customers to buy product licenses. For example, https://store.zang.io.

5 Retrieve Service Configurations

All current Spaces related service configurations can be obtained from the following API.

GET https://spacesapis.zang.io/api/service-configurations

Sample response:

{
  "spaces": {
    "server_url": "https://spacesapis.zang.io",
    "socketio_server_url": "https://spacesapis-socket.zang.io",
    "marketing_url": "https://www.zang.io/products/spaces",
  },
  "store": {
    "server_url": "https://store.zang.io",
  },
  "accounts": {
    "server_url": "https://accounts.zang.io",
  }
}

6 Retrieve Legal Information

All current Spaces related docs can be obtained from the following API.

/api/service-configurations/:region/:language/legal

GET https://spacesapis.zang.io/api/service-configurations/US/en/legal

Sample response:

{
    "credits_url":"https://storage.googleapis.com/onesnastaging/spaces/public/pages/avaya-spaces.credits-20190222.txt",
    "toc_url":"https://spaces.zang.io/us/legal/headless/general-tos",
    "toc_version":"20161013",
    "privacy_url":{
        "url":"https://www.avaya.com/en/privacy/commitment/",
        "language":"en",
        "external":true
    },
    "region":"US"
}