安否確認サービス2 API仕様
安否確認サービス2のAPI仕様について解説します。
APIの実行方法 ¶
全体に共通したAPIの実行方法について解説します。
API認証トークンの発行
APIの使用に必要なAPI認証トークンは、システム設定の『API認証トークンの発行』で発行し、取得することができます。
API認証トークンの発行にはシステム管理者権限が必要になります。 API認証トークンをお持ちではなく、システム管理者でもない場合は、貴社のシステム管理者の方までお問い合わせ下さい。
なお、API認証トークンは1社につき1つまでとなっています。
API認証トークンを破棄した場合は、それまでのAPI認証トークンは使用できなくなりますのでご注意ください。
リクエスト方法
上記で取得したAPI認証トークンを、 Authorization
HTTPヘッダに含めてリクエストを実行します。
以下のように、 Token
の後にAPI認証トークンをご使用ください。
Authorization: Token [取得したAPI認証トークン]
指定方法が正しくない場合、 401 Unauthorized
を返却します。
使用回数制限について
安否確認サービス2APIは、お申込み人数の10倍が1日あたりの最大使用回数となっております。
各日0時に消費した使用回数は回復します。
1日の使用最大回数を超えてリクエストを実行した場合は、 429 Too Many Requests
を返却します。
なお、各レスポンスヘッダには、
残りの使用回数を X-RateLimit-Remaining
として、
使用回数が回復するまでの秒数を X-RateLimit-Reset
として記載します。
以下は使用回数制限を超過してリクエストした場合のレスポンス例です。
HTTP/1.1 429 Too Many Requests
Connection: keep-alive
Content-Length: 231
Content-Type: application/json
(中略)
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 32072
{
"error": {
"errors": [],
"message": "使用上限に達しています。時間を置いてから再度実行してください。",
"url": ""
}
}
また、全ユーザー情報取得APIは取得するユーザー数に応じて使用回数を消費します。
そのため、このAPIを実行するには、残りの使用回数が登録ユーザー数以上である必要があります。
残りの使用回数が不足している場合は、 429 Too Many Requests
を返却します。
ユーザーを管理する ¶
ユーザーを取得・追加する ¶
全ユーザー情報取得GET/v1/member
処理概要
- 登録されている全ユーザーの情報を一括取得します。
※ 次の点にご注意ください。
- 他のAPIと異なり、取得したユーザー数に応じてAPI使用回数が減算されます。
例えば、残りの使用回数が1000のときに当該APIで100ユーザーの情報を取得した場合、
残りの使用回数は900となります。
Example URI
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"members": [
{
"username": "yamada",
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIで取得"
},
{
"username": "tanaka",
"fullname": "田中花子",
"fullnameRuby": "タナカ ハナコ",
"email": "hanako@example.com",
"tel": null,
"priority": null,
"memo": null
}
],
"message": "ユーザー情報取得に成功しました。"
}
ユーザー追加POST/v1/member
処理概要
-
ユーザー情報を新しく登録します。
-
fullname, username, passwordが必須です。いずれかがない場合、400を返します。
-
username, emailの重複はできません。重複するリクエストの場合、400を返します。
Example URI
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"username": "yamada",
"password": "qawer@nasd",
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIから追加"
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"username": {
"type": "string",
"description": "ログイン名"
},
"password": {
"type": "string",
"description": "パスワード"
},
"fullname": {
"type": "string",
"description": "氏名"
},
"fullnameRuby": {
"type": "string",
"description": "氏名の読み"
},
"email": {
"type": "string",
"description": "メールアドレス(format: email)"
},
"tel": {
"type": "string",
"description": "電話番号"
},
"priority": {
"type": "number",
"description": "表示順"
},
"memo": {
"type": "string",
"description": "メモ"
}
},
"required": [
"username",
"password",
"fullname"
]
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
Body
{
"username": "yamada",
"password": "qawer@nasd",
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIから追加",
"message": "ユーザー追加に成功しました。"
}
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 32069
Body
{
"error": {
"errors:" [],
"message": "リクエスト形式が正しくありません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・追加する-post"
}
}
{
"error": {
"errors:" [],
"message": "すでに使用しているログイン名です",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・追加する-post"
}
}
{
"error": {
"errors:" [],
"message": "すでに使用しているメールアドレスです",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・追加する-post"
}
}
ユーザーを取得・編集・削除する ¶
ユーザー情報取得GET/v1/member/{username}
処理概要
-
ユーザーの情報を取得します。
-
URLにusernameが必須です。ユーザーが見つからない場合、404を返します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"member": {
"username": "yamada",
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIで取得",
},
"message": "ユーザー情報取得に成功しました。"
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "取得対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-get"
}
}
ユーザー編集PUT/v1/member/{username}
処理概要
-
ユーザー情報を編集します。
-
URLにusernameが必須です。ユーザーが見つからない場合、404を返します。
-
変更がない場合、304を返します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIから編集"
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"fullname": {
"type": "string",
"description": "氏名"
},
"fullnameRuby": {
"type": "string",
"description": "氏名の読み"
},
"email": {
"type": "string",
"description": "メールアドレス(format: email)"
},
"tel": {
"type": "string",
"description": "電話番号"
},
"priority": {
"type": "number",
"description": "表示順"
},
"memo": {
"type": "string",
"description": "メモ"
}
}
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"username": "yamada",
"password": "qawer@nasd",
"fullname": "山田太郎",
"fullnameRuby": "ヤマダ タロウ",
"email": "test@example.com",
"tel": "05038166666",
"priority": 100,
"memo": "APIから編集",
"message": "ユーザー編集に成功しました。"
}
304
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors:" [],
"message": "リクエスト形式が正しくありません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-put"
}
}
{
"error": {
"errors:" [],
"message": "すでに使用しているメールアドレスです",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-put"
}
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "更新対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-put"
}
}
ユーザー削除DELETE/v1/member/{username}
処理概要
-
ユーザーを削除します。
-
URLにusernameが必須です。ユーザーが見つからない場合、404を返します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
204
Headers
Content-Type: application/json
X-RateLimit-Remaining: 86
X-RateLimit-Reset: 29000
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [
"システム管理者であるユーザーは削除できません",
"責任者として指定されている地震発生時の設定があるため削除できません",
"責任者として指定されている津波発生時の設定があるため削除できません",
"責任者として指定されている特別警報発生時の設定があるため削除できません",
"責任者として指定されている予約送信の設定があるため削除できません"
],
"message": "削除対象のユーザーに依存する設定があるため削除できません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-delete"
}
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "削除対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーを管理する-ユーザーを取得・編集・削除する-delete"
}
}
ユーザーの所属部署を管理する ¶
ユーザーの所属部署を取得・更新する ¶
ユーザーの所属部署取得GET/v1/member/{username}/department
処理概要
-
ユーザーの所属部署情報を取得します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
Body
{
"departmentCodes": [
"dev",
"cs"
],
"message": "ユーザー所属部署取得に成功しました。"
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "取得対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-get"
}
}
ユーザーの所属部署更新PUT/v1/member/{username}/department
処理概要
-
ユーザーの所属部署情報を更新します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。 -
departmentCodes
が必須です。パラメーターがない場合、400
を返します。 -
所属が変更されない場合、
304
を返します。 -
所属部署情報を削除するには、
departmentCodes
の値に空配列[]
を指定します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"departmentCodes": [
"dev",
"cs"
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"departmentCodes": {
"type": "array",
"description": "部署コード"
}
},
"required": [
"departmentCodes"
]
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
Body
{
"departmentCodes": [
"dev",
"cs"
],
"message": "ユーザーの所属部署情報の更新に成功しました。"
}
304
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 32069
Body
{
"error": {
"errors": [],
"message": "リクエストの形式が正しくありません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "存在しない部署コードが指定されています",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "部署コードが重複しています",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "利用できない部署コードが指定されています",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "更新対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "更新対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属部署を管理する-ユーザーの所属部署を取得・更新する-put"
}
}
ユーザーの所属地域を管理する ¶
ユーザーの所属地域を取得・更新する ¶
ユーザーの所属地域取得GET/v1/member/{username}/area
処理概要
-
ユーザーの所属地域情報を取得します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
Body
{
"areaCodes": [
"350",
"351"
],
"message": "ユーザー所属地域取得に成功しました。"
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "取得対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-get"
}
}
ユーザーの所属地域更新PUT/v1/member/{username}/area
処理概要
-
ユーザーの所属地域情報を更新します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。 -
areaCodes
が必須です。パラメーターがない場合、400
を返します。
areaCodes
に設定する値に関しては操作ガイドを参照してください。 -
所属が変更されない場合、
304
を返します。 -
所属地域情報を削除するには、
areaCodes
の値に空配列[]
を指定します。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"areaCodes": [
"350",
"351"
]
}
Schema
{
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {
"areaCodes": {
"type": "array",
"description": "地域コード"
}
},
"required": [
"areaCodes"
]
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
Body
{
"areaCodes": [
"350",
"351"
],
"message": "ユーザーの所属地域情報の更新に成功しました。"
}
304
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32069
Body
{
"error": {
"errors": [],
"message": "リクエストの形式が正しくありません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "不正な地域コードが含まれています",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "地域コードが重複しています",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-put"
}
}
{
"error": {
"errors": [],
"message": "更新対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-put"
}
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"errors": [],
"message": "更新対象のユーザーが存在しません",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの所属地域を管理する-ユーザーの所属地域を取得・更新する-put"
}
}
ユーザーの役割を管理する ¶
ユーザーの役割を取得・更新する ¶
ユーザーの役割取得GET/v1/member/{username}/role
処理概要
-
ユーザーの役割情報を取得します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。 -
roleIdと役割の対応に関しては、ユーザーの役割更新を参照ください。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
Body
{
"role": [
{
"departmentCode": "",
"roleId": 2
},
{
"departmentCode": "management",
"roleId": 4
},
{
"departmentCode": "sales",
"roleId": 5
}
],
"message": "ユーザーの役割情報取得に成功しました。"
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"message": "取得対象のユーザーが存在しません",
"errors": [],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-get"
}
}
ユーザーの役割更新PUT/v1/member/{username}/role
処理概要
-
ユーザーの役割情報を更新します。
-
URLに
username
が必須です。ユーザーが見つからない場合、404
を返します。 -
role
が必須です。パラメーターがない場合、400
を返します。 -
役割が変更されない場合、
304
を返します。 -
役割情報を削除するには、
role
の値に空配列[]
を指定します。
使用方法
リクエストボディのプロパティrole
は、次のようなオブジェクトの配列であり、その1つ1つが役割を表します。
{
"roleId": 3,
"departmentCode": "sales"
}
それぞれのプロパティの意味は次の通りです。
-
roleId: 役割コードを指定する。(役割コードに関しては下表を参照ください)
-
departmentCode: 部署コードを指定する。
役割と役割コードの対応は次の通りです。
役割 | roleId |
---|---|
システム管理者 | 0 |
危機管理責任者 | 1 |
マネージャー | 2 |
部門マネージャー | 3 |
部門危機管理責任者 | 4 |
部門システム管理者 | 5 |
「部門」のつかない管理者 (roleId
: 0〜2) を設定する場合は、以下の方法で部署コードを指定できます。
-
部署コードの値に空文字を指定する
{"roleId": 0, "departmentCode": ""}
-
部署コードの値に最上位の部署コードを指定する
(ご使用環境の最上位部署コードを確認のうえ設定してください){"roleId": 0, "departmentCode": "top"}
-
部署コードプロパティを省略する
{"roleId": 0}
「部門」のつく管理者 (roleId
: 3〜5) を設定する場合は、部署コードの設定が必須となります。
入力にエラーがある場合、400
が返却され、errors
プロパティにエラーの詳細が含まれます。
※ 次の点にご注意ください。
-
役割は上書き登録となるため、
role
プロパティに含まれていない役割は対象ユーザーから削除されます。 -
役割の中には兼務できないものがあります。詳細はオンラインヘルプを参照ください。
(リンク先はCSVファイルによる役割更新に関するものですが、仕様に関しては本APIと差異はありません) -
システム管理者を0人にすることはできません。そのためシステム管理者が1人の状態で、そのユーザーからシステム管理者の役割を削除しようとすると、役割の更新が失敗します。
そのような状況でシステム管理者を変更したい場合は、まず他のユーザーにシステム管理者の権限を付与するためのリクエストを実行した後、対象のユーザーからシステム管理者権限を削除するリクエストを実行してください。
Example URI
- username
string
(required) Example: Administratorログイン名
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"role": [
{
"roleId": 2,
"departmentCode": ""
},
{
"roleId": 4,
"departmentCode": "management"
},
{
"roleId": 5,
"departmentCode": "sales"
}
]
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
Body
{
"role": [
{
"roleId": 2,
"departmentCode": ""
},
{
"roleId": 4,
"departmentCode": "management"
},
{
"roleId": 5,
"departmentCode": "sales"
}
],
"message": "ユーザーの役割情報の更新に成功しました。"
}
304
Headers
Content-Type: application/json
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 32072
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 32069
Body
{
"error": {
"message": "リクエストの形式が正しくありません。",
"errors": [],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
{
"error": {
"message": "入力に誤りがあるため、ユーザーの役割情報の更新に失敗しました。",
"errors": ["roleIdが重複しています。"],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
{
"error": {
"message": "入力に誤りがあるため、ユーザーの役割情報の更新に失敗しました。",
"errors": ["部門マネージャー、部門危機管理責任者、部門システム管理者には部署コードが必要です。"],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
{
"error": {
"message": "入力に誤りがあるため、ユーザーの役割情報の更新に失敗しました。",
"errors": ["システム管理者、危機管理責任者、マネージャーは最上位部署にのみ設定可能です。空白とするか、最上位部署の部署コードを入力してください。"],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
{
"error": {
"message": "ユーザーの役割情報の更新に失敗しました。",
"errors": [
"現在システム管理者は『Administrator』さんのみです。システム管理者を0人にすることはできません"
],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
404
Headers
Content-Type: application/json
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 31000
Body
{
"error": {
"message": "更新対象のユーザーが存在しません",
"errors": [],
"url": "https://anpi.toyokumo.co.jp/docs/api.html#ユーザーの役割を管理する-ユーザーの役割を取得・更新する-put"
}
}
部署を管理する ¶
部署を取得・更新する ¶
部署取得GET/v1/department
処理概要
- 部署全体を取得します。
Example URI
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
Body
{
"department": [
{
"code": "all",
"name": "すべて",
"parentCode": ""
},
{
"code": "A",
"name": "A",
"parentCode": "all"
}
],
"message": "部署の取得に成功しました。"
}
部署更新PUT/v1/department
処理概要
-
1つのリクエストで部署全体を更新します。
-
部署が変更されない場合、
304
を返します。 -
リクエストにエラーがある場合、
400
を返します。
使用方法
リクエストボディのプロパティdepartment
は、次のようなオブジェクトの配列であり、
その1つ1つが部署を表します。
{
"currentCode": "top",
"code": "top",
"name": "すべて",
"parentCode": ""
}
それぞれのプロパティの意味は次の通りです。
-
currentCode: 現在存在する部署のコードを指定する。
-
code: 更新後の部署コードを指定する。
-
name: 更新後の部署名を指定する。
-
parentCode: 親部署コードを指定する。
リクエストされたdepartment
プロパティ値から部署構造を構築し、
部署全体を構築された部署構造に置き換えます。
入力にエラーがある場合、400
が返却され、errors
プロパティにエラーの詳細が含まれます。
次の方法に従い、リクエストされた各部署の追加・編集・削除が判別されます。
-
追加:
currentCode
が空白のもの。 -
編集:
currentCode
が入力されているもの。 -
削除: 現在存在する部署のうち、
currentCode
に一致する部署が存在しないもの。
※ 次の点にご注意ください。
-
最上位部署は必ず含める必要があります。
-
未所属ユーザ部署を含めてはいけません。
Example URI
Headers
Content-Type: application/json
Accept: application/json
Authorization: Token eyXxxxxxx.....
Body
{
"department": [
{
"currentCode": "top",
"code": "all",
"name": "すべて",
"parentCode": ""
},
{
"currentCode": "",
"code": "A",
"name": "A",
"parentCode": "all"
}
]
}
200
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
Body
{
"department": [
{
"currentCode": "top",
"code": "all",
"name": "すべて",
"parentCode": ""
},
{
"currentCode": "",
"code": "A",
"name": "A",
"parentCode": "all"
}
],
"message": "部署の編集に成功しました。"
}
304
Headers
Content-Type: application/json
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 32072
400
Headers
Content-Type: application/json
X-RateLimit-Remaining: 98
X-RateLimit-Reset: 32069
Body
{
"error": {
"errors": [],
"message": "値はすべて文字列である必要があります。",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#部署を管理する-部署を取得・更新する-put"
}
}
{
"error": {
"errors": [
"存在しない現部署が指定されています。",
"部署コードが空白なものが含まれています。",
"部署コードにスラッシュ(/)を含めることはできません。",
"部署コードと親部署コードを同一にすることはできません。"
],
"message": "入力に誤りがあるため、部署の編集に失敗しました。",
"url": "https://anpi.toyokumo.co.jp/docs/api.html#部署を管理する-部署を取得・更新する-put"
}
}