Calendar API Overview

    The LINE WORKS Calendar API (hereinafter "Calendar API" or "API") uses HTTP and a REST endpoint structure. Responses are usually available in JSON and OAuth 2.0 is used as the authentication method.

    The Calendar API provides access to the LINE WORKS Calendar data, which are commonly used features.

    API Common Information

    Supported Environment

    LINE WORKS supports two environments: testing and live. However, the LINE WORKS Calendar API is available only in the live environment.

    • Live environment: https://apis.worksmobile.com

    Combine an HTTP method with the request URL to complete an operation. For example, here is the operation to create a calendar in the live environment.

    Example) Operation for creating a calendar

    • POST https://apis.worksmobile.com/{API ID}/calendar/createCalendar

    You can see a request URL for each API call in the corresponding API details section.

    Request Common

    LINE WORKS Access Token and Consumer Key

    With each API call, you should include a LINE WORKS access token and a consumer key in the request header. You can get the access token when you log in to the LINE WORKS system; it is re-issued every time that you log in to the system.

    For how to get a consumer key, see API Common Guide.

    The code below describes how to set a Works Mobile access token and a consumer key in the request header.

    httpMethod.setRequestHeader("Authorization", "Works Mobile access token");

httpMethod.setRequestHeader("consumerKey", "consumer key");

    userId

    A client of the API Gateway (APIGW) uses cookie-based authorization methods. The APIGW parses cookies and adds the userId parameter to make the Calendar API call; therefore, you are not required to enter the userId parameter value.

    Note

    • For details on API authentication, refer to the Overview > Preparations section in the LINE WORKS Common Guide API Reference document.

    Response Common

    It returns an error message including the following information when an API call fails.

    Property Type Required Description
    result String Y Returns "fail" when an API call fails.
    errorMessage String Y
         serverName String Y Calendar server for which an API request is made.
        calledTimestamp String Y Requested time
        requestUri String Y Requested API URI
         remoteIp String Y IP that called the calendar server
         result String Y Description of error reason.

    See the following example code.

    {
    "result": "fail",
    "errorMessage": "{\"serverName\":\"cvcapi02.caldf\",
                    \"calledTimestamp\":\"2016-08-25T14:58:24.760+09:00\",
                    \"requestUri\":\"/apigw/deskhomeBO/getScheduleList\",
                    \"remoteIp\":\"10.64.54.204\",
                    \"result\":\"com.naver.calendar.apigw.post.bean.CalendarException: cannot find userConf. userId\\u003d33578002\"
                }"
}