インターフェース業務ルールによる外部APIリクエスト説明

リクエストURL説明

• リクエストURL：ターゲットURL（トリガーモジュールでターゲットURLを設定可能）
• Method：GET
• タイムアウト時間：30秒
• リクエストパラメータ：

パラメータ名	パラメータ説明	必須かどうか	デフォルト値
sign	署名、認証説明を参照	はい	動的生成（空ではない）
[フィールドAPI名]	アクション実行時に送信するフィールドのAPI名	いいえ	フィールド値
[フィールドAPI名]...

• レスポンス構造（JSON）

フィールド名	フィールドタイプ	フィールド説明	必須かどうか
code	number	ステータスコード（200：成功）	はい
success	string	成功時の説明	いいえ
data	object	返却データ	いいえ
data.record	object	返却オブジェクト値	いいえ

説明：返却オブジェクト値のフォーマットは以下の通りです。

{
    [フィールドAPI名]:[フィールド値],
    ...
}

サポートされるフィールドタイプと値のタイプは以下の通りです：

• 単一行テキスト：string
• 日付：string
• 日時：string
• 複数行テキスト：string
• 数値：string、number
• 単一選択：string（オプションkey値）
• 複数選択：string（オプションkey値、英語のカンマ区切り）
• メールアドレス：string
• 電話番号：string
• リッチテキスト：string
• パーセンテージ：string、number

---

認証

前提条件

URLを以下のように仮定：http://servicego.udesk.cn シークレットを以下のように仮定： secretabcdef123456 パラメータリストを以下のように仮定：param1=value1，param2=value2

パラメータ暗号化アルゴリズム

sign生成方法： sha1(${パラメータ値1}&${パラメータ値2}&...&${シークレット}) パラメータ値を&記号で連結した後、さらに&記号でシークレットを連結：value1&value2&secretabcdef123456、その後sha1で暗号化します。 つまり：sha1(value1&value2&secretabcdef123456)=aae85378e487ca10534a81bf93c3eb33bc3d3086

結果例

最後にパラメータとsign値をURLの後ろに連結します、以下の通りです。 http://servicego.udesk.cn?param1=value1&param2=value2&sign=aae85378e487ca10534a81bf93c3eb33bc3d3086