Contact Overview
The LINE WORKS Contacts API is provided to use private contact and group contact (to be provided later) features. The contact popup window provides LINE WORKS Contacts' private, public, group and domain contact data on the client's portal site, through a popup window.
Preparations
To use the LINE WORKS Contacts API, "API ID" should be included in the Contact API's request URL. For how to get your API ID, see API Common Guide.
Supported Environment
LINE WORKS supports two environments: testing and live.
- Testing environment: https://sandbox-apis.worksmobile.com
- Live environment: https://apis.worksmobile.com
Request Common
Parameters for HTTP requests are basically passed in "application/x-www-form-urlencoded" format. See the corresponding API description for the format of each parameter value.
Response Common
When an API call is made, the following common response is returned in JSON format.
Property | Type | Required | Description |
---|---|---|---|
code | String | Y | ● SUCCESS: An API call was successful, and its result is returned in "data." ● FAIL: An API call failed, and the detailed information is returned in "failType" and "message." |
data | String | Y | It contains a result value. See the corresponding API description for the format of each result value. |
failType | String | Y | It contains an error code if an API call failed. |
message | String | Y | It contains an error message if an API call failed. |
An example is shown below.
{"code ":"SUCCESS", "data": 1, "failType" : "", "message":""}
The error codes and messages will be added to each API section later.