プロキシAPIの設定を取得する

目次

プロキシAPIの設定を取得する

プロキシAPIの設定( クラウド版 (External link) )を取得します。

URL

クラウド版

https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/PROXY_CODE

パッケージ版

環境に合わせてそれぞれ以下を置き換えてください。

  • IP_ADDRESS_OR_HOST_NAME:Garoonのインストール先のIPアドレスまたはホスト名
  • INSTALL_IDENTIFER:Garoonのインストール識別子
Windows環境
http://IP_ADDRESS_OR_HOST_NAME/scripts/INSTALL_IDENTIFER/grn.exe/api/v1/system/api/admin/proxies/code/PROXY_CODE
Linux環境
http://IP_ADDRESS_OR_HOST_NAME/cgi-bin/INSTALL_IDENTIFER/grn.cgi/api/v1/system/api/admin/proxies/code/PROXY_CODE
パスパラメーター
パラメーター名 説明
PROXY_CODE 設定を取得するプロキシAPIのプロキシコード

HTTPメソッド

GET

利用できるバージョン

  • クラウド版Garoon
  • パッケージ版Garoon 5.15以降

必要なアクセス権

リクエスト

パラメーター

なし

リクエストの例
URL

https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/sample

ヘッダー
1
2
3
{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

リクエストヘッダーの詳細は Garoon REST APIの共通仕様を参照してください。

レスポンス

プロパティ
プロパティ名 説明
status 文字列 プロキシAPI設定のステータス
  • ACTIVE:有効
  • INACTIVE:無効
proxyCode 文字列 プロキシコード
method 文字列 HTTPメソッド
url 文字列 URL
parameters[].key 文字列 パラメーターのキー
parameters[].value 文字列 パラメーターの値
headers[].key 文字列 ヘッダーのキー
headers[].value 文字列 ヘッダーの値
body[].key 文字列 ボディのキー
body[].value 文字列 ボディの値
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
{
  "status": "ACTIVE",
  "proxyCode": "sample",
  "method": "PUT",
  "url": "https://api.example.com",
  "parameters": [
    {
      "key": "app",
      "value": "1203"
    }
  ],
  "headers": [
    {
      "key": "Authorization",
      "value": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
    },
    {
      "key": "Content-Type",
      "value": "application/json"
    }
  ],
  "body": [
    {
      "key": "id",
      "value": "13"
    }
  ]
}

サンプルコード

curlを使ったリクエスト
1
2
curl -X GET 'https://sample.cybozu.com/g/api/v1/system/api/admin/proxies/code/sample' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU='
Garoon REST APIリクエストを送信するAPIを使ったリクエスト
1
await garoon.api('/api/v1/system/api/admin/proxies/code/sample', 'GET', {});