完全性検証リクエスト外部 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 secret を以下のように仮定します: secretabcdef123456 パラメータリストを以下のように仮定します:param1=value1,param2=value2
パラメータ暗号化アルゴリズム
sign 生成方法: sha1(${パラメータ値1}&${パラメータ値 2}&...&${sceret}) パラメータ値を&記号で連結した後、さらに&記号で secret を連結します:value1&value2&secretabcdef123456、その後 sha1 で暗号化します。 つまり:sha1(value1&value2&secretabcdef123456)=aae85378e487ca10534a81bf93c3eb33bc3d3086
結果例
最後にパラメータと sign 値を url の後ろに連結します、以下の通りです。 http://servicego.udesk.cn?param1=value1¶m2=value2&sign=aae85378e487ca10534a81bf93c3eb33bc3d3086