PHONE APPLI API (1.3)

はじめに

PHONE APPLI API は外部アプリケーションから PHONE APPLI PEOPLE(以下:PA PEOPLE)のデータ入出力などを行うことができるプログラミングインターフェイスです。DX 推進や業務改革にぜひご活用ください。

利用規約

本 API を利用することにより、API 利用規約 に同意したものとします。ご利用の前に必ずお読みください。

API キーの発行方法

PHONE APPLI API のご利用には API キーが必要です。
PC ブラウザ版 PA PEOPLE のメニュー[ユーザ情報]を開き、[APIキー]タブから発行、取得できます。
必要な権限範囲は 各 API の AUTHORIZATIONS をご確認ください。
※ PHONE APPLI API が有効化されていない環境では、API キー発行画面は表示されません。

制限事項

レート制限

  • トークンバケットアルゴリズムを用いて API キーごとのリクエスト数に上限を設けています。
  • 現在のリクエスト制限の詳細はレスポンスヘッダから確認することができます。
  • システムの負荷状況に応じて、リクエスト数の上限が変動する可能性があります。
  • リクエスト上限超過時のエラーついては エラーレスポンス を参照してください。

レスポンスヘッダ

レスポンスヘッダ内には以下が含まれます。

ヘッダ名 説明
x-ratelimit-remaining トークン残量
x-ratelimit-requested-tokens リクエストの処理に使用したトークンの個数
x-ratelimit-burst-capacity バケットが保持できるトークンの個数
x-ratelimit-replenish-rate 1秒間に補充されるトークンの個数

利用権限

API キー発行元のユーザが持つ閲覧・編集の権限範囲内で利用できます。

キーの発行数制限

1ユーザあたり同時に10個まで発行できます。

エラーレスポンス

エラー発生時には以下表の HTTP ステータスコードとステータスを返します。ステータスは JSON 形式のエラーオブジェクトに含まれます。例外として、HTML 形式のエラーページを返す場合があります。

コード ステータス 説明
400 INVALID_ARGUMENT リクエストの構文が正しくない場合
401 UNAUTHENTICATED 認証情報が不足している場合
403 RESOURCE_PERMISSION_DENIED 対象リソースが権限範囲外である場合
403 API_PERMISSION_DENIED 対象APIが権限範囲外である場合
403 ACCESS_DENIED IPアドレスが制限されている場合
404 NOT_FOUND 対象リソースが存在しない場合
405 METHOD_NOT_ALLOWED リクエストメソッドが受け入れられない場合
406 NOT_ACCEPTABLE 指定されたデータ形式で応答できない場合
409 CONFLICT リクエストがサーバーの状態と競合している場合
409 ALREADY_EXISTS 既存のリソースと重複する場合
413 PAYLOAD_TOO_LARGE リクエストされたデータサイズが上限を超えている場合
415 UNSUPPORTED_MEDIA_TYPE データ形式が受け入れられない場合
422 UNPROCESSABLE リクエストの構文は正しいが、指示が実行できない場合
429 - リクエスト回数が上限を超えている場合
500 INTERNAL_SERVER_ERROR 内部エラーが発生している場合
503 SERVICE_UNAVAILABLE サーバーがダウンしている場合

社内連絡先

PA PEOPLE 社内電話帳の連絡先(ユーザ)です。

ユーザタイプによる制限

一部の項目はユーザタイプによって作成/編集に制限があります。下記の表に○の記載がある項目のみ登録、変更が可能です。

対象項目 基本利用ユーザ 登録限定ユーザ 施設・備品
enabled
forceLocalAuthentication
deviceId
deviceIdAcceptInitialize
password
initialPasswordForceChange
employeeNum
position
positionAlphabet
post
skill
pbxPartition
companyMobileNum
personalMobileNum
mobileNum
webUrl
chatSettingList
m365Account
pbxAccount
spCallSettings
roles
paapiAvailable
tenantCucmAdapterSettingsId
ctiPort
tenantAvayaAdapterSettingsId
gotalkAvailable
gotalkLogDownloadAvailable
anpiLoginId
mobileMacAddress
thanksAvailable

社内連絡先一覧取得

社内電話帳に登録された連絡先(ユーザ)の情報を一覧で取得できます。権限範囲の項目のみ取得可能です。

Authorizations:
ApiKeyAuth
query Parameters
page
integer <int32> >= 0
Default: 0

取得対象ページの番号

pageSize
integer <int32> [ 1 .. 100 ]
Default: 30

1ページあたりの件数

select
Array of strings (usersGetSelectColumns)
Items Enum: "userId" "loginId" "employeeNum" "divisions" "position" "positionAlphabet" "post" "fullname" "fullnameKana" "fullnameAlphabet" "extensionNum" "phoneNum" "companyMobileNum" "personalMobileNum" "mobileNum" "faxNum" "email1" "email2" "sortScore" "collaborations" "comment" "remarks" "skill" "initialPasswordForceChange" "userType" "roles" "paapiAvailable" "enabled" "forceRequestOperator" "gotalkAvailable" "gotalkLogDownloadAvailable" "forceLocalAuthentication" "pbxFeatureAvailable" "thanksAvailable" "pbxPartition" "webUrl" "level" "pcMacAddress" "mobileMacAddress" "bleId" "deviceIdAcceptInitialize" "deviceId" "m365Account" "pbxAccount" "iosPasyncLabel" "ctiPort" "incomingPopupIosApns" "tenantCucmAdapterSettings" "tenantAvayaAdapterSettings" "anpiLoginId" "spCallSettings"

取得対象項目
※ 権限範囲の項目のみ指定可能

orderBy
string (usersGetOrderBy)
Default: "fullname"
Enum: "fullname" "sortScore" "employeeNum"

ソートの対象

  • fullname: 氏名順
  • sortScore: ソートスコア順
  • employeeNum: 社員番号順
orderDirection
string (usersGetOrderDirection)
Default: "asc"
Enum: "asc" "desc"

ソートの並び順

  • asc: 昇順
  • desc: 降順
fullname
string

取得対象の氏名(部分一致)

fullnameKana
string

取得対象の氏名カナ(部分一致)

divisionIds
Array of integers <int64> <= 50 items [ items <int64 > ]

取得対象の部署識別番号

userIds
Array of integers <int64> <= 50 items [ items <int64 > ]

取得対象のユーザ識別番号

employeeNum
string

取得対象の社員番号(完全一致)

phoneNum
string

取得対象の電話番号(完全一致)

email1
string

取得対象のEメールアドレス1(完全一致)

freeWords
Array of strings

フリーワード検索
※ カンマ区切りで AND 検索

Responses

Response samples

Content type
application/json
{
  • "hasMore": true,
  • "items": [
    ]
}

社内連絡先作成

社内連絡先(ユーザ)を作成できます。
※ ご利用にはユーザ管理権限が必要です。

Authorizations:
ApiKeyAuth
Request Body schema: application/json
userType
string (userType)
Enum: "REGULAR_USER" "REGISTRATION_ONLY_USER" "FACILITY"

ユーザタイプ

  • REGULAR_USER: 基本利用ユーザ
  • REGISTRATION_ONLY_USER: 登録限定ユーザ
  • FACILITY: 施設・備品
enabled
boolean

アカウント有効/無効

forceLocalAuthentication
boolean

SAML認証または OpenID Connect 利用環境でローカル認証のみに制限

deviceId
string <= 8 characters ^$|^[0-9a-zA-Z]+$

端末ID

deviceIdAcceptInitialize
boolean

端末ID 初回認証

loginId
required
string <= 50 characters ^[@a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+$

ログインID

password
string <= 50 characters ^(?!(\s| )*$).+

パスワード
※ 基本利用ユーザの場合必須

initialPasswordForceChange
boolean
Default: false

初期パスワード変更

sortScore
integer <int32> [ 0 .. 999999999 ]

ソートスコア

level
integer <int32> [ 1 .. 10 ]
Default: 5

レベル

fullname
required
string <= 50 characters ^(?!(\s| )*$).+

氏名

fullnameKana
string <= 50 characters

氏名カナ

fullnameAlphabet
string <= 50 characters

氏名英字

employeeNum
string <= 50 characters

社員番号

position
string <= 100 characters

役職

positionAlphabet
string <= 100 characters

役職英字

post
string <= 50 characters

職務

divisionIds
Array of integers <int64> <= 2 items unique [ items <int64 > ]

部署識別番号

comment
string <= 500 characters

コメント

remarks
string <= 500 characters

備考

skill
string <= 500 characters

スキル

pbxPartition
string <= 50 characters ^$|^[0-9A-Za-z _-]+$

パーティション
※ CUCM連携利用環境のみ有効

extensionNum
string <= 50 characters [0-9*#,;+-]*

内線番号

companyMobileNum
string <= 50 characters [0-9*#,;+-]*

会社携帯番号

personalMobileNum
string <= 50 characters [0-9*#,;+-]*

個人携帯番号

phoneNum
string <= 50 characters [0-9*#,;+-]*

電話番号

mobileNum
string <= 50 characters [0-9*#,;+-]*

携帯番号

faxNum
string <= 50 characters [0-9*#,;+-]*

FAX 番号

email1
string <= 256 characters

Eメールアドレス1

email2
string <= 256 characters

Eメールアドレス2

webUrl
string <= 256 characters ^(https?://)?[a-zA-Z0-9.!#$%&'*+/=?:^_`{|}~-]...

WEB URL

Array of objects (chatSettingElement) unique

コラボレーション

m365Account
string <= 256 characters ^[0-9A-Za-z.\-_@]*$

Microsoft 365 アカウント

pbxAccount
string <= 256 characters

PBXアカウント

iosPasyncLabel
string <= 25 characters

PA Sync表示ラベル

spCallSettings
Array of strings (spCallSettingsDefault) unique
Items Enum: "DIRECT_CALL" "SETTING_1" "SETTING_2" "SETTING_3" "SETTING_4" "SETTING_5"

スマートフォン発信機能

  • DIRECT_CALL: 直接発信(デフォルト値)
  • SETTING_1: 発信設定 1
  • SETTING_2: 発信設定 2
  • SETTING_3: 発信設定 3
  • SETTING_4: 発信設定 4
  • SETTING_5: 発信設定 5

※ 基本利用ユーザ以外は指定不可
※ 環境で登録された発信設定のみ有効

roles
Array of strings (userRole) unique
Items Enum: "ADMIN_COMPANY" "ADMIN_DIVISION" "ADMIN_USER" "ADMIN_INTERNAL_CONTACT" "ADMIN_COMMON_CONTACT" "ADMIN_INFORMATION" "ADMIN_SANSAN_IMPORT" "ADMIN_ACTION_LOG" "ADMIN_AZURE_ACTIVE_DIRECTORY" "ADMIN_ACTIVE_DIRECTORY" "ADMIN_CUCM" "ADMIN_DIAL_PICKUP" "ADMIN_CMX" "ADMIN_EX_BEACON" "ADMIN_MERAKI" "ADMIN_ANPI" "ADMIN_IBASHO" "ADMIN_THANKS" "ADMIN_GOTALK"

権限コントロール

  • ADMIN_COMPANY: 企業情報
  • ADMIN_DIVISION: 部署
  • ADMIN_USER: ユーザ
  • ADMIN_INTERNAL_CONTACT: 社内電話帳
  • ADMIN_COMMON_CONTACT: 共有電話帳
  • ADMIN_INFORMATION: お知らせ
  • ADMIN_ACTION_LOG: ログ出力
  • ADMIN_ACTIVE_DIRECTORY: AD連携
  • ADMIN_SANSAN_IMPORT: Sansan連携
  • ADMIN_CUCM: CUCM連携
  • ADMIN_GOTALK: トーク
  • ADMIN_DIAL_PICKUP: ダイヤルピックアップ
  • ADMIN_IBASHO: PA PLACE ※1
  • ADMIN_CMX: Cisco CMX ※2
  • ADMIN_MERAKI: Cisco MERAKI ※2
  • ADMIN_EX_BEACON: EXBeacon ※2
  • ADMIN_THANKS: PA THANKS
  • ADMIN_AZURE_ACTIVE_DIRECTORY: Azure AD連携
  • ADMIN_ANPI: 安否

※1 PHONE APPLI PLACE を2019年7月4日以降にご契約の場合、「ADMIN_IBASHO」が有効
※2 PHONE APPLI PLACE を2019年7月3日以前にご契約の場合、ご利用中の製品・サービスに該当する権限が有効

paapiAvailable
boolean

API利用権限

forceRequestOperator
string (ocrForceRequestOperatorDefault)
Default: "DISABLE"
Enum: "DISABLE" "FORCE" "SELECT"

名刺オペレータ入力権限

  • FORCE: 強制
  • SELECT: 選択
  • DISABLE: 無効
pbxFeatureAvailable
boolean

PBX連携
※ PBX連携利用環境のみ有効

tenantCucmAdapterSettingsId
integer <int64>

CUCMアダプタ設定識別番号
※ CUCM連携利用環境のみ有効

ctiPort
string <= 15 characters ^$|^[0-9a-zA-Z._-]+$

CTIポート
※ CUCM連携利用環境のみ有効

incomingPopupIosApns
boolean

CUCM iPhone着信通知
※ CUCM連携利用環境のみ有効

tenantAvayaAdapterSettingsId
integer <int64>

Avayaアダプタ設定識別番号
※ Avaya連携環境のみ有効

gotalkAvailable
boolean

トーク
※ トーク利用環境のみ有効

gotalkLogDownloadAvailable
boolean

トークログダウンロード
※ トーク利用環境のみ有効

anpiLoginId
string <= 32 characters ^[0-9a-zA-Z]*$

安否ログインID
※ 安否確認利用環境のみ有効

mobileMacAddress
string^$|^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$

スマートデバイス
※ PHONE APPLI PLACE 利用環境のみ有効

pcMacAddress
string^$|^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$

PC
※ PHONE APPLI PLACE 利用環境のみ有効

bleId
string <= 64 characters ^[0-9a-zA-Z:]*$

位置情報タグ
※ PHONE APPLI PLACE 利用環境のみ有効

thanksAvailable
boolean

PA THANKS
※ PHONE APPLI THANKS 利用環境のみ有効

Responses

Request samples

Content type
application/json
{
  • "userType": "REGULAR_USER",
  • "enabled": true,
  • "forceLocalAuthentication": true,
  • "deviceId": "string",
  • "deviceIdAcceptInitialize": true,
  • "loginId": "string",
  • "password": "string",
  • "initialPasswordForceChange": false,
  • "sortScore": 999999999,
  • "level": 5,
  • "fullname": "string",
  • "fullnameKana": "string",
  • "fullnameAlphabet": "string",
  • "employeeNum": "string",
  • "position": "string",
  • "positionAlphabet": "string",
  • "post": "string",
  • "divisionIds": [
    ],
  • "comment": "string",
  • "remarks": "string",
  • "skill": "string",
  • "pbxPartition": "string",
  • "extensionNum": "string",
  • "companyMobileNum": "string",
  • "personalMobileNum": "string",
  • "phoneNum": "string",
  • "mobileNum": "string",
  • "faxNum": "string",
  • "email1": "string",
  • "email2": "string",
  • "webUrl": "string",
  • "chatSettingList": [
    ],
  • "m365Account": "string",
  • "pbxAccount": "string",
  • "iosPasyncLabel": "string",
  • "spCallSettings": [
    ],
  • "roles": [
    ],
  • "paapiAvailable": true,
  • "forceRequestOperator": "DISABLE",
  • "pbxFeatureAvailable": true,
  • "tenantCucmAdapterSettingsId": 0,
  • "ctiPort": "string",
  • "incomingPopupIosApns": true,
  • "tenantAvayaAdapterSettingsId": 0,
  • "gotalkAvailable": true,
  • "gotalkLogDownloadAvailable": true,
  • "anpiLoginId": "string",
  • "mobileMacAddress": "string",
  • "pcMacAddress": "string",
  • "bleId": "string",
  • "thanksAvailable": true
}

Response samples

Content type
application/json
{
  • "userId": 0,
  • "userType": "REGULAR_USER",
  • "enabled": true,
  • "forceLocalAuthentication": true,
  • "deviceId": "string",
  • "deviceIdAcceptInitialize": true,
  • "loginId": "string",
  • "initialPasswordForceChange": true,
  • "sortScore": 0,
  • "level": 0,
  • "fullname": "string",
  • "fullnameKana": "string",
  • "fullnameAlphabet": "string",
  • "employeeNum": "string",
  • "position": "string",
  • "positionAlphabet": "string",
  • "post": "string",
  • "divisions": [
    ],
  • "comment": "string",
  • "remarks": "string",
  • "skill": "string",
  • "pbxPartition": "string",
  • "extensionNum": "string",
  • "companyMobileNum": "string",
  • "personalMobileNum": "string",
  • "phoneNum": "string",
  • "mobileNum": "string",
  • "faxNum": "string",
  • "email1": "string",
  • "email2": "string",
  • "webUrl": "string",
  • "collaborations": [
    ],
  • "m365Account": "string",
  • "pbxAccount": "string",
  • "iosPasyncLabel": "string",
  • "spCallSettings": [
    ],
  • "roles": [
    ],
  • "paapiAvailable": true,
  • "forceRequestOperator": "DISABLE",
  • "pbxFeatureAvailable": true,
  • "tenantCucmAdapterSettings": {
    },
  • "ctiPort": "string",
  • "incomingPopupIosApns": true,
  • "tenantAvayaAdapterSettings": {
    },
  • "gotalkAvailable": true,
  • "gotalkLogDownloadAvailable": true,
  • "anpiLoginId": "string",
  • "mobileMacAddress": "string",
  • "pcMacAddress": "string",
  • "bleId": "string",
  • "thanksAvailable": true
}

社内連絡先取得

社内電話帳に登録された連絡先(ユーザ)の情報を取得できます。権限範囲の項目のみ取得可能です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

取得対象のユーザ識別番号

Responses

Response samples

Content type
application/json
{
  • "userId": 0,
  • "userType": "REGULAR_USER",
  • "enabled": true,
  • "forceLocalAuthentication": true,
  • "deviceId": "string",
  • "deviceIdAcceptInitialize": true,
  • "loginId": "string",
  • "initialPasswordForceChange": true,
  • "sortScore": 0,
  • "level": 0,
  • "fullname": "string",
  • "fullnameKana": "string",
  • "fullnameAlphabet": "string",
  • "employeeNum": "string",
  • "position": "string",
  • "positionAlphabet": "string",
  • "post": "string",
  • "divisions": [
    ],
  • "comment": "string",
  • "remarks": "string",
  • "skill": "string",
  • "pbxPartition": "string",
  • "extensionNum": "string",
  • "companyMobileNum": "string",
  • "personalMobileNum": "string",
  • "phoneNum": "string",
  • "mobileNum": "string",
  • "faxNum": "string",
  • "email1": "string",
  • "email2": "string",
  • "webUrl": "string",
  • "collaborations": [
    ],
  • "m365Account": "string",
  • "pbxAccount": "string",
  • "iosPasyncLabel": "string",
  • "spCallSettings": [
    ],
  • "roles": [
    ],
  • "paapiAvailable": true,
  • "forceRequestOperator": "DISABLE",
  • "pbxFeatureAvailable": true,
  • "tenantCucmAdapterSettings": {
    },
  • "ctiPort": "string",
  • "incomingPopupIosApns": true,
  • "tenantAvayaAdapterSettings": {
    },
  • "gotalkAvailable": true,
  • "gotalkLogDownloadAvailable": true,
  • "anpiLoginId": "string",
  • "mobileMacAddress": "string",
  • "pcMacAddress": "string",
  • "bleId": "string",
  • "thanksAvailable": true
}

社内連絡先編集

社内電話帳に登録された連絡先(ユーザ)の情報を編集できます。指定した項目のみ変更が反映されます。
※ ご利用にはユーザ管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

編集対象のユーザ識別番号

Request Body schema: application/json
userType
string (userType)
Enum: "REGULAR_USER" "REGISTRATION_ONLY_USER" "FACILITY"

ユーザタイプ

  • REGULAR_USER: 基本利用ユーザ
  • REGISTRATION_ONLY_USER: 登録限定ユーザ
  • FACILITY: 施設・備品
enabled
boolean

アカウント有効/無効

forceLocalAuthentication
boolean

SAML認証または OpenID Connect 利用環境でローカル認証のみに制限

deviceId
string <= 8 characters ^$|^[0-9a-zA-Z]+$

端末ID

deviceIdAcceptInitialize
boolean

端末ID 初回認証

password
string <= 50 characters ^(?!(\s| )*$).+

パスワード
※ 基本利用ユーザに変更する場合は必須
※ 基本利用ユーザ以外は指定不可

initialPasswordForceChange
boolean

初期パスワード変更

sortScore
integer <int32> [ 0 .. 999999999 ]

ソートスコア

level
integer <int32> [ 1 .. 10 ]

レベル

fullname
string <= 50 characters ^(?!(\s| )*$).+

氏名

fullnameKana
string <= 50 characters

氏名カナ

fullnameAlphabet
string <= 50 characters

氏名英字

employeeNum
string <= 50 characters

社員番号

position
string <= 100 characters

役職

positionAlphabet
string <= 100 characters

役職英字

post
string <= 50 characters

職務

divisionIds
Array of integers <int64> <= 2 items unique [ items <int64 > ]

部署識別番号

comment
string <= 500 characters

コメント

remarks
string <= 500 characters

備考

skill
string <= 500 characters

スキル

pbxPartition
string <= 50 characters ^$|^[0-9A-Za-z _-]+$

パーティション
※ CUCM連携利用環境のみ有効

extensionNum
string <= 50 characters [0-9*#,;+-]*

内線番号

companyMobileNum
string <= 50 characters [0-9*#,;+-]*

会社携帯番号

personalMobileNum
string <= 50 characters [0-9*#,;+-]*

個人携帯番号

phoneNum
string <= 50 characters [0-9*#,;+-]*

電話番号

mobileNum
string <= 50 characters [0-9*#,;+-]*

携帯番号

faxNum
string <= 50 characters [0-9*#,;+-]*

FAX番号

email1
string <= 256 characters

Eメールアドレス1

email2
string <= 256 characters

Eメールアドレス2

webUrl
string <= 256 characters ^(https?://)?[a-zA-Z0-9.!#$%&'*+/=?:^_`{|}~-]...

WEB URL

Array of objects (chatSettingElement) unique

コラボレーション

m365Account
string <= 256 characters ^[0-9A-Za-z.\-_@]*$

Microsoft 365 アカウント

pbxAccount
string <= 256 characters

PBXアカウント

iosPasyncLabel
string <= 25 characters

PA Sync表示ラベル

spCallSettings
Array of strings (spCallSettings) unique
Items Enum: "DIRECT_CALL" "SETTING_1" "SETTING_2" "SETTING_3" "SETTING_4" "SETTING_5"

スマートフォン発信機能

  • DIRECT_CALL: 直接発信(デフォルト値)
  • SETTING_1: 発信設定 1
  • SETTING_2: 発信設定 2
  • SETTING_3: 発信設定 3
  • SETTING_4: 発信設定 4
  • SETTING_5: 発信設定 5

※ 基本利用ユーザ以外は指定不可
※ 環境で登録された発信設定のみ有効

roles
Array of strings (userRole) unique
Items Enum: "ADMIN_COMPANY" "ADMIN_DIVISION" "ADMIN_USER" "ADMIN_INTERNAL_CONTACT" "ADMIN_COMMON_CONTACT" "ADMIN_INFORMATION" "ADMIN_SANSAN_IMPORT" "ADMIN_ACTION_LOG" "ADMIN_AZURE_ACTIVE_DIRECTORY" "ADMIN_ACTIVE_DIRECTORY" "ADMIN_CUCM" "ADMIN_DIAL_PICKUP" "ADMIN_CMX" "ADMIN_EX_BEACON" "ADMIN_MERAKI" "ADMIN_ANPI" "ADMIN_IBASHO" "ADMIN_THANKS" "ADMIN_GOTALK"

権限コントロール

  • ADMIN_COMPANY: 企業情報
  • ADMIN_DIVISION: 部署
  • ADMIN_USER: ユーザ
  • ADMIN_INTERNAL_CONTACT: 社内電話帳
  • ADMIN_COMMON_CONTACT: 共有電話帳
  • ADMIN_INFORMATION: お知らせ
  • ADMIN_ACTION_LOG: ログ出力
  • ADMIN_ACTIVE_DIRECTORY: AD連携
  • ADMIN_SANSAN_IMPORT: Sansan連携
  • ADMIN_CUCM: CUCM連携
  • ADMIN_GOTALK: トーク
  • ADMIN_DIAL_PICKUP: ダイヤルピックアップ
  • ADMIN_IBASHO: PA PLACE ※1
  • ADMIN_CMX: Cisco CMX ※2
  • ADMIN_MERAKI: Cisco MERAKI ※2
  • ADMIN_EX_BEACON: EXBeacon ※2
  • ADMIN_THANKS: PA THANKS
  • ADMIN_AZURE_ACTIVE_DIRECTORY: Azure AD連携
  • ADMIN_ANPI: 安否

※1 PHONE APPLI PLACE を2019年7月4日以降にご契約の場合、「ADMIN_IBASHO」が有効
※2 PHONE APPLI PLACE を2019年7月3日以前にご契約の場合、ご利用中の製品・サービスに該当する権限が有効

paapiAvailable
boolean

API利用権限

forceRequestOperator
string (ocrForceRequestOperator)
Enum: "DISABLE" "FORCE" "SELECT"

名刺オペレータ入力権限

  • FORCE: 強制
  • SELECT: 選択
  • DISABLE: 無効
pbxFeatureAvailable
boolean

PBX連携
※ PBX連携利用環境のみ有効

tenantCucmAdapterSettingsId
integer <int64>

CUCMアダプタ設定識別番号
※ 0を指定すると初期化
※ CUCM連携利用環境のみ有効

ctiPort
string <= 15 characters ^$|^[0-9a-zA-Z._-]+$

CTIポート
※ CUCM連携利用環境のみ有効

incomingPopupIosApns
boolean

CUCM iPhone着信通知
※ CUCM連携利用環境のみ有効

tenantAvayaAdapterSettingsId
integer <int64>

Avayaアダプタ設定識別番号
※ 0を指定すると初期化
※ Avaya連携環境のみ有効

gotalkAvailable
boolean

トーク
※ トーク利用環境のみ有効

gotalkLogDownloadAvailable
boolean

トークログダウンロード
※ トーク利用環境のみ有効

anpiLoginId
string <= 32 characters ^[0-9a-zA-Z]*$

安否ログインID
※ 安否確認利用環境のみ有効

mobileMacAddress
string^$|^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$

スマートデバイス
※ PHONE APPLI PLACE 利用環境のみ有効

pcMacAddress
string^$|^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$

PC
※ PHONE APPLI PLACE 利用環境のみ有効

bleId
string <= 64 characters ^[0-9a-zA-Z:]*$

位置情報タグ
※ PHONE APPLI PLACE 利用環境のみ有効

thanksAvailable
boolean

PA THANKS
※ PHONE APPLI THANKS 利用環境のみ有効

Responses

Request samples

Content type
application/json
{
  • "userType": "REGULAR_USER",
  • "enabled": true,
  • "forceLocalAuthentication": true,
  • "deviceId": "string",
  • "deviceIdAcceptInitialize": true,
  • "password": "string",
  • "initialPasswordForceChange": true,
  • "sortScore": 999999999,
  • "level": 1,
  • "fullname": "string",
  • "fullnameKana": "string",
  • "fullnameAlphabet": "string",
  • "employeeNum": "string",
  • "position": "string",
  • "positionAlphabet": "string",
  • "post": "string",
  • "divisionIds": [
    ],
  • "comment": "string",
  • "remarks": "string",
  • "skill": "string",
  • "pbxPartition": "string",
  • "extensionNum": "string",
  • "companyMobileNum": "string",
  • "personalMobileNum": "string",
  • "phoneNum": "string",
  • "mobileNum": "string",
  • "faxNum": "string",
  • "email1": "string",
  • "email2": "string",
  • "webUrl": "string",
  • "chatSettingList": [
    ],
  • "m365Account": "string",
  • "pbxAccount": "string",
  • "iosPasyncLabel": "string",
  • "spCallSettings": [
    ],
  • "roles": [
    ],
  • "paapiAvailable": true,
  • "forceRequestOperator": "DISABLE",
  • "pbxFeatureAvailable": true,
  • "tenantCucmAdapterSettingsId": 0,
  • "ctiPort": "string",
  • "incomingPopupIosApns": true,
  • "tenantAvayaAdapterSettingsId": 0,
  • "gotalkAvailable": true,
  • "gotalkLogDownloadAvailable": true,
  • "anpiLoginId": "string",
  • "mobileMacAddress": "string",
  • "pcMacAddress": "string",
  • "bleId": "string",
  • "thanksAvailable": true
}

Response samples

Content type
application/json
{
  • "userId": 0,
  • "userType": "REGULAR_USER",
  • "enabled": true,
  • "forceLocalAuthentication": true,
  • "deviceId": "string",
  • "deviceIdAcceptInitialize": true,
  • "loginId": "string",
  • "initialPasswordForceChange": true,
  • "sortScore": 0,
  • "level": 0,
  • "fullname": "string",
  • "fullnameKana": "string",
  • "fullnameAlphabet": "string",
  • "employeeNum": "string",
  • "position": "string",
  • "positionAlphabet": "string",
  • "post": "string",
  • "divisions": [
    ],
  • "comment": "string",
  • "remarks": "string",
  • "skill": "string",
  • "pbxPartition": "string",
  • "extensionNum": "string",
  • "companyMobileNum": "string",
  • "personalMobileNum": "string",
  • "phoneNum": "string",
  • "mobileNum": "string",
  • "faxNum": "string",
  • "email1": "string",
  • "email2": "string",
  • "webUrl": "string",
  • "collaborations": [
    ],
  • "m365Account": "string",
  • "pbxAccount": "string",
  • "iosPasyncLabel": "string",
  • "spCallSettings": [
    ],
  • "roles": [
    ],
  • "paapiAvailable": true,
  • "forceRequestOperator": "DISABLE",
  • "pbxFeatureAvailable": true,
  • "tenantCucmAdapterSettings": {
    },
  • "ctiPort": "string",
  • "incomingPopupIosApns": true,
  • "tenantAvayaAdapterSettings": {
    },
  • "gotalkAvailable": true,
  • "gotalkLogDownloadAvailable": true,
  • "anpiLoginId": "string",
  • "mobileMacAddress": "string",
  • "pcMacAddress": "string",
  • "bleId": "string",
  • "thanksAvailable": true
}

社内連絡先削除

社内電話帳に登録された連絡先(ユーザ)を削除できます。
※ 顔写真も含まれます。
※ ご利用にはユーザ管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

削除対象のユーザ識別番号

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

顔写真取得

社内電話帳に登録された連絡先(ユーザ)の顔写真(JPEG)を取得できます。取得できるのは、権限範囲のユーザの顔写真です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

取得対象のユーザ識別番号
※ 自分の顔写真を取得する場合、ユーザ識別番号の代わりに me も有効

query Parameters
size
string (photoSize)
Default: "FULL"
Enum: "FULL" "THUMBNAIL"

画像サイズ

  • FULL: フルサイズ
  • THUMBNAIL: サムネイル

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

顔写真更新

社内電話帳に登録された連絡先(ユーザ)の顔写真を更新できます。
※ ご利用にはユーザ管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

更新対象のユーザ識別番号

Request Body schema:
string <binary>

顔写真

  • 画像のファイル形式:JPEG(*.jpg,*.jpeg)

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

顔写真削除

社内電話帳に登録された連絡先(ユーザ)の顔写真を削除できます。
※ ご利用にはユーザ管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

削除対象のユーザ識別番号

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}

プロフィール

PA PEOPLE 社内電話帳の連絡先(ユーザ)に紐づくプロフィールです。

プロフィール取得

プロフィールの情報を取得できます。

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

取得対象のユーザ識別番号
※ 自分のプロフィール(マイプロフィール)を取得する場合、ユーザ識別番号の代わりに me も有効

Responses

Response samples

Content type
application/json
{
  • "oneWord": "string",
  • "jobDescription": "string",
  • "skills": [
    ],
  • "toolTechnologies": [
    ],
  • "qualifications": [
    ],
  • "briefHistories": [
    ],
  • "achievementHistories": [
    ],
  • "externalLinks": [
    ],
  • "customColumns": [
    ]
}

プロフィール編集

プロフィールの情報を編集できます。指定した項目のみ変更が反映されます。
※ 自分以外のプロフィールを編集する場合、ユーザ管理権限が必要

Authorizations:
ApiKeyAuth
path Parameters
userId
required
integer <int64>

編集対象のユーザ識別番号
※ 自分のプロフィール(マイプロフィール)を編集する場合、ユーザ識別番号の代わりに me も有効

Request Body schema: application/json
oneWord
string <= 280 characters

ひとこと

jobDescription
string <= 280 characters

職務概要

skills
Array of strings <= 20 items unique [ items <= 100 characters ^(?!(\s| )*$).+ ]

スキル
※ スキルの順番は指定できません
※ 他のユーザが文字種違いのスキルを登録していた場合、既存のスキルの表記に統合されます
(例:他のユーザが「マネジメント」を登録していて、APIで「まねじめんと」を指定した場合、既存の「マネジメント」で登録される)

toolTechnologies
Array of strings <= 20 items unique [ items <= 100 characters ^(?!(\s| )*$).+ ]

ツール&テクノロジー
※ ツール&テクノロジーの順番は指定できません
※ 他のユーザが文字種違いのツール&テクノロジーを登録していた場合、既存のツール&テクノロジーの表記に統合されます
(例:他のユーザが「Tech X」を登録していて、APIで「tech x」を指定した場合、既存の「Tech X」で登録される)

qualifications
Array of strings <= 20 items unique [ items <= 100 characters ^(?!(\s| )*$).+ ]

資格
※ 資格の順番は指定できません
※ 他のユーザが文字種違いの資格を登録していた場合、既存の資格の表記に統合されます
(例:他のユーザが「社内資格 1級」を登録していて、APIで「社内資格 1級」を指定した場合、既存の「社内資格 1級」で登録される)

Array of objects (briefHistoryCommand) <= 30 items

略歴

Array of objects (achievementHistoryCommand) <= 30 items

実績・受賞歴

Array of objects (externalLinkCommand) <= 3 items

外部リンク

Array of objects (customColumnCommand) <= 3 items unique

カスタマイズ項目

Responses

Request samples

Content type
application/json
{
  • "oneWord": "string",
  • "jobDescription": "string",
  • "skills": [
    ],
  • "toolTechnologies": [
    ],
  • "qualifications": [
    ],
  • "briefHistories": [
    ],
  • "achievementHistories": [
    ],
  • "externalLinks": [
    ],
  • "customColumns": [
    ]
}

Response samples

Content type
application/json
{
  • "oneWord": "string",
  • "jobDescription": "string",
  • "skills": [
    ],
  • "toolTechnologies": [
    ],
  • "qualifications": [
    ],
  • "briefHistories": [
    ],
  • "achievementHistories": [
    ],
  • "externalLinks": [
    ],
  • "customColumns": [
    ]
}

部署

PA PEOPLE 社内電話帳の部署です。

部署一覧取得

部署の情報を一覧で取得できます。

Authorizations:
ApiKeyAuth
query Parameters
page
integer <int32> >= 0
Default: 0

取得対象ページの番号

pageSize
integer <int32> [ 1 .. 100 ]
Default: 30

1ページあたりの件数

divisionIds
Array of integers <int64> <= 50 items [ items <int64 > ]

取得対象の部署識別番号

divisionName
string

取得対象の部署名(部分一致)

Responses

Response samples

Content type
application/json
{
  • "hasMore": true,
  • "items": [
    ]
}

部署作成

部署を作成できます。
※ ご利用には部署管理権限が必要です。

Authorizations:
ApiKeyAuth
Request Body schema: application/json
parentDivisionId
integer <int64> >= 1

親部署識別番号
※ 所属する親部署がない場合は指定不要

divisionCode
required
string <= 50 characters ^[0-9a-zA-Z\-_.@(){}\[\]]+$

部署コード

divisionName
required
string <= 100 characters ^(?!(\s| )*$).+

部署名

divisionNameKana
string <= 100 characters

部署名カナ

divisionNameAlphabet
string <= 100 characters

部署名英字

divisionPhoneNum
string <= 50 characters [0-9*#,;+-]*

部署代表番号

divisionUrl
string <= 256 characters ^(https?://)?[a-zA-Z0-9.!#$%&'*+/=?:^_`{|}~-]...

部署URL

sortScore
integer <int32> [ 0 .. 999999999 ]

ソートスコア

Responses

Request samples

Content type
application/json
{
  • "parentDivisionId": 1,
  • "divisionCode": "string",
  • "divisionName": "string",
  • "divisionNameKana": "string",
  • "divisionNameAlphabet": "string",
  • "divisionPhoneNum": "string",
  • "divisionUrl": "string",
  • "sortScore": 999999999
}

Response samples

Content type
application/json
{
  • "divisionId": 0,
  • "parentDivisionId": 0,
  • "divisionCode": "string",
  • "divisionName": "string",
  • "divisionNameKana": "string",
  • "divisionNameAlphabet": "string",
  • "divisionPhoneNum": "string",
  • "divisionUrl": "string",
  • "sortScore": 0
}

部署取得

部署の情報を取得できます。

Authorizations:
ApiKeyAuth
path Parameters
divisionId
required
integer <int64>

取得対象の部署識別番号

Responses

Response samples

Content type
application/json
{
  • "divisionId": 0,
  • "parentDivisionId": 0,
  • "divisionCode": "string",
  • "divisionName": "string",
  • "divisionNameKana": "string",
  • "divisionNameAlphabet": "string",
  • "divisionPhoneNum": "string",
  • "divisionUrl": "string",
  • "sortScore": 0
}

部署編集

部署の情報を編集できます。指定した項目のみ変更が反映されます。
※ ご利用には部署管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
divisionId
required
integer <int64>

編集対象の部署識別番号

Request Body schema: application/json
parentDivisionId
integer <int64> >= 0

親部署識別番号
※ 所属する親部署がない場合は0を指定

divisionCode
string <= 50 characters ^[0-9a-zA-Z\-_.@(){}\[\]]+$

部署コード

divisionName
string <= 100 characters ^(?!(\s| )*$).+

部署名

divisionNameKana
string <= 100 characters

部署名カナ

divisionNameAlphabet
string <= 100 characters

部署名英字

divisionPhoneNum
string <= 50 characters [0-9*#,;+-]*

部署代表番号

divisionUrl
string <= 256 characters ^(https?://)?[a-zA-Z0-9.!#$%&'*+/=?:^_`{|}~-]...

部署URL

sortScore
integer <int32> [ 0 .. 999999999 ]

ソートスコア

Responses

Request samples

Content type
application/json
{
  • "parentDivisionId": 0,
  • "divisionCode": "string",
  • "divisionName": "string",
  • "divisionNameKana": "string",
  • "divisionNameAlphabet": "string",
  • "divisionPhoneNum": "string",
  • "divisionUrl": "string",
  • "sortScore": 999999999
}

Response samples

Content type
application/json
{
  • "divisionId": 0,
  • "parentDivisionId": 0,
  • "divisionCode": "string",
  • "divisionName": "string",
  • "divisionNameKana": "string",
  • "divisionNameAlphabet": "string",
  • "divisionPhoneNum": "string",
  • "divisionUrl": "string",
  • "sortScore": 0
}

部署削除

部署を削除できます。親部署を削除した場合、配下に含まれる部署も削除されます。
※ ご利用には部署管理権限が必要です。

Authorizations:
ApiKeyAuth
path Parameters
divisionId
required
integer <int64>

削除対象の部署識別番号

Responses

Response samples

Content type
application/json
{
  • "error": {
    }
}