Querying Bulletin Board Publications

Description

This API is used to query bulletin board publications.

Debugging

You can debug this API in API Explorer.

Prototype

**Table 1** Prototype
Request Method	GET
Request Address	/v1/usg/sss/publications
Transport Protocol	HTTPS

Request Parameters

**Table 2** Parameters
Parameter	Mandatory	Type	Location	Description
offset	No	Integer	Query	Query offset. If the value exceeds the maximum number of records available, records on the last page are returned. Default value: 0.
limit	No	Integer	Query	Number of records to query. Default value: 10.
searchKey	No	String	Query	Search criteria. Fuzzy search by name is supported.
X-Access-Token	Yes	String	Header	Authorization token. Use the value of accessToken in the response to the request for Authenticating an App ID.
X-Request-Id	No	String	Header	Request ID, which is used for fault tracing and locating. You are advised to use a UUID. If this parameter is not carried, a request ID is automatically generated.
Accept-Language	No	String	Header	Language. Values: zh-CN for Chinese (default) and en-US for English.

Status Codes

**Table 3** Status codes
HTTP Status Code	Description
200	Operation successful.
400	Invalid parameters.
401	Authentication is not performed or fails.
403	Insufficient permissions.
500	Server exception.

Response Parameters

**Table 4** Response Parameters
Parameter	Type	Description
count	Integer	Total number of records.
limit	Integer	Number of records displayed per page. Default value: 10.
offset	Integer	Number of the query start page. The value starts from 0.
data	Array of PublicationResponseBase objects	Publication details.

**Table 5** PublicationResponseBase data structure
Parameter	Type	Description
createTime	Long	Creation time.
endTime	Long	End time.
id	String	Publication ID.
lastUpdatedBy	String	Updater.
publishName	String	Publication name.
publishScope	String	Publication scope.
publishStatus	String	Publication status on the current time. NOT_ONLINE: to be published. PUBLISHING: being published. ALREADY_OFFLINE: removed.
startTime	Long	Start time.
updateTime	Long	Update time.

Example Request

GET /v1/usg/sss/publications?offset=0&limit=10&searchKey=
Connection: keep-alive
X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE
Content-Type: application/json
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

Example Response

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 1329
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 21facce44sd8efa02329afd189da7f3d

{
    "count": 1,
    "data": [
        {
            "createTime": 1593538236711,
            "endTime": 253402271999000,
            "id": "2baafa7ffef04c62a3c3f79f9f8a1a3a",
            "lastUpdatedBy": "",
            "publishName": "cCu78RV8Ai",
            "publishScope": "",
            "publishStatus": "PUBLISHING",
            "startTime": 0,
            "updateTime": 1593538236711
        }
    ],
    "limit": 10,
    "offset": 0
}

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.

Example cURL Command

curl -k -i -X GET -H 'X-Access-Token: cnrfzn5OLRjwoaOf2F7PfMwVjJ6zScFogbDE' 
https://api.meeting.huaweicloud.com/v1/usg/sss/publications?offset=0&limit=10

Parent topic: Bulletin Board Publication Management

Previous topic: Deleting Bulletin Board Publications

Next topic: Querying Details of a Publication by ID