次期Garoon REST APIに関するアンケートにご協力ください。
※2018年5月版では、REST APIはGaroon on cybozu.comでのみ利用可能です。
Garoon REST APIの概要
Garoon の予定の操作をすることができます。
プロトコル
HTTPS
フォーマット
JSON
文字コード
UTF-8
エスケープ文字
「\」を使用します。
ユーザー認証
APIを実行するリクエストには、認証のためのヘッダを追加する必要があります。
パスワード認証
リクエストヘッダに「X-Cybozu-Authorization」を追加し、「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。
// ログイン名が「Administrator」、パスワードが「cybozu」の場合 X-Cybozu-Authorization:QWRtaW5pc3RyYXRvcjpjeWJvenU=
セッション認証
セッション認証とは、Webサーバから付与されたセッションIDをCookieに保存する事でユーザを識別する認証方法です。
認証時の優先順位について
優先順位は以下の通りです。
- パスワード認証
- セッション認証
Basic認証
cybozu.com でBasic認証を利用している場合は、更にリクエストヘッダに「Authorization」ヘッダを追加し、「Basic 」と「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。
- 「Basic」 と 「ログイン名:パスワード」 の間は、半角空白が必要です。
- 「Basic」の BASE64エンコードは不要です。
// ログイン名が「Administrator」、パスワードが「cybozu」の場合 Authorization:Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
リクエスト
リクエストヘッダ
送信するリクエストに応じて以下のリクエストヘッダを指定します。
| ヘッダー名 | 必須 | 内容 |
|---|---|---|
| Host | 必須 | (サブドメイン名).cybozu.com:443 |
| Content-Type |
省略可 |
application/json |
|
X-Cybozu-Authorization |
省略可 |
「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。 |
| X-Requested-With |
省略可 |
XMLHttpRequest または空文字列以外の文字列 |
| Authorization | 省略可 | Basic認証を利用している場合、文字列「Basic」と「ログイン名:パスワード」をBASE64エンコードしたものを値に指定します。 |
リクエストURI
https://(サブドメイン名).cybozu.com/g/api/v1/(アプリケーション名)/(リソース)
レスポンス
HTTPステータスコードが「2xx」であれば正常終了、それ以外はエラー終了です。
エラーの詳細については ヘルプを参照してください。
すべてのGaroon REST APIのレスポンスヘッダには、次の情報が含まれています。
| ヘッダー名 | 内容 |
|---|---|
| X-ConcurrencyLimit-Limit |
同時接続数の上限値 |
| X-ConcurrencyLimit-Running | 現在の同時接続数 |
注意事項
IPアドレス制限を行っている環境に対するREST APIリクエストについては、次のAPIリクエストがアクセス可能です。
- アクセス許可されたIPアドレスがアクセス元となるAPIリクエスト
- アクセス許可されたクライアント証明書を利用したAPIリクエスト
制限事項
Garoon REST APIの同時実行制限があります。それはREST API要求だけがカウントされます。デフォルト値は100です。
その他、サービスに関する制限事項は、cybozu.comの制限事項 をご確認ください。
記事に関するフィードバック
直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。