SaaS製品認証情報取得
OpenAPI説明
当該OpenAPIは、個別にテナントIDを指定して、外部SaaS製品の認証情報を照会する。
OpenAPI権限
当該OpenAPIはテナント権限が必要です。
リクエストURI
/api/openapi/externalService/authenticationInfo
リクエスト形式
GET
リクエストパラメータ例
- /api/openapi/externalService/authenticationInfo?serviceCode=0
リクエストパラメータ説明
| 項目 | タイプ | 必須 | 制限 | 説明 |
|---|---|---|---|---|
| serviceCode | String | 最大2文字 | SaaSコード 0:BillOne 1:日本ICS請求書管理オプション 2:楽楽精算 3:Bakuraku 4:奉行Edge受領請求書DXクラウド |
OpenAPIリターン例
{
"tenantId": "1214732595705114600",
"authenticationInfos": [
{
"serviceCode": "0",
"serviceName": "BillOne",
"authenticationInfo1": "24a67f14-8uy9-4143-b69b-316607b86ip9",
"authenticationInfo2": "OUYE4YzM1MDctOTE2NC00MDc5YUIzN2UtMTlmNzA1YzE4YjNB2",
"authenticationInfo3": "f609ee9c-88f0-4d88-9210-a5da0a3cd41d",
"authenticationInfo4": "",
"receivingDepartment": "DxCG連携用受領部門",
"depositAccountItemCode": "",
"status": true
},
{
"serviceCode": "1",
"serviceName": "日本ICS請求書管理オプション",
"authenticationInfo1": "24a67f14-8uy9-2342-b69b-3889607b86opi",
"authenticationInfo2": "WERE4YzM1MDctOTE2NC00MDc5YUIzN2UtMTlmNzA1YzE4YjNB45",
"authenticationInfo3": "wqrqwe9c-88f0-4d88-9210-a5da0a3c42ef",
"authenticationInfo4": "",
"receivingDepartment": "",
"depositAccountItemCode": "",
"status": true
},
{
"serviceCode": "2",
"serviceName": "楽楽精算",
"authenticationInfo1": "XXXX",
"authenticationInfo2": "XXXX",
"authenticationInfo3": "XXXXXXXX",
"authenticationInfo4": "2",
"receivingDepartment": "",
"depositAccountItemCode": "123",
"status": true
},
{
"serviceCode": "3",
"serviceName": "Bakuraku",
"authenticationInfo1": "XXXX",
"authenticationInfo2": "XXXX",
"status": true
},
{
"serviceCode": "4",
"serviceName": "奉行Edge受領請求書DXクラウド",
"authenticationInfo1": "XXXX",
"authenticationInfo2": "XXXX",
"status": true
}
]
}
OpenAPIリターン項目
| パラメータ名 | タイプ | 規則 | 説明 |
|---|---|---|---|
| tenantId | String | テナントID | |
| authenticationInfos | authenticationInfo[] | 外部SaaS製品の認証情報 |
authenticationInfo
| パラメータ名 | タイプ | 規則 | 説明 |
|---|---|---|---|
| serviceCode | String | SaaSコード | |
| serviceName | String | SaaS名 | |
| authenticationInfo1 | String | 認証情報1 BillOne、日本ICS請求書管理オプション:Client ID 楽楽精算:ドメイン Bakuraku:APIキー 奉行Edge受領請求書DXクラウド:アクセストークン | |
| authenticationInfo2 | String | 認証情報2 BillOne、日本ICS請求書管理オプション:Client Secret 楽楽精算:アカウント Bakuraku:定期出力ID 奉行Edge受領請求書DXクラウド:法人接続情報 | |
| authenticationInfo3 | String | 認証情報3 BillOne、日本ICS請求書管理オプション:リフレッシュトークン 楽楽精算:APIトークン | |
| authenticationInfo4 | String | 認証情報4 BillOne、日本ICS請求書管理オプション:- 楽楽精算:自動ファイル出力設定ID | |
| receivingDepartment | String | [受領部門]取得元項目名 | |
| depositAccountItemCode | String | 預り金勘定科目コード | |
| status | Boolean | ステータス true:有効 false:無効 |
失敗例
{
"message": "テナントの権限がありません",
"errorCode": "120001"
}
項目説明
| 項目名 | タイプ | 説明 |
|---|---|---|
| message | String | メッセージを返す |
| errorCode | String | エラーコードを返す |
エラーコード説明
| errorCode | message | 説明 |
|---|---|---|
| 120001 | テナントの権限がありません | |
| spd.32741.012 | 対応外の請求書受領サービスです |