GetEcosystem (containers)

GET (/wopi/containers/(container_id)/ecosystem_pointer

The GetEcosystem operation returns the URI for the WOPI server’s Ecosystem endpoint, given a container ID.

Note

GetEcosystem (files) returns the URI for the WOPI server’s Ecosystem endpoint, given a file ID.

Parameters

• container_id (string) – A string that specifies a container ID of a container managed by host. This string must be URL safe.

Query Parameters

• access_token (string) – An access token that the host will use to determine whether the request is authorized.

Status Codes

• 200 OK – Success

• 401 Unauthorized – Invalid access token

• 404 Not Found – Resource not found/user unauthorized

• 500 Internal Server Error – Server error

• 501 Not Implemented – Operation not supported

Note

In addition to the request/response headers listed here, this operation may also use the Standard WOPI request and response headers.

Response

The response to a GetEcosystem call is JSON containing the following required properties:

• Url (string)- A URI for the WOPI server’s Ecosystem endpoint, with an access token appended. A GET request to this URL will invoke the CheckEcosystem operation.

  Caution

  This property includes an access token, and thus has important security implications. See Preventing ‘token trading’ for more details.