Notification > Notification Hub > API v1.0使用ガイド > 共通情報
| リージョン | エンドポイント |
|---|---|
| Global | https://notification-hub.api.nhncloudservice.com |
Notification Hubは、API呼び出し時の認証/認可のためにUser Access Keyトークンを使用します。User Access Keyトークンは、User Access Keyに基づいて発行されるBearerタイプの一時的なアクセストークンです。User Access Keyトークンの発行及び使用に関する詳細は、User Access Keyトークンを参照してください。
リスト照会では個人情報以外の照会条件に対して、プレフィックス及び単一文字ワイルドカード検索がサポートされます。
広告_で始まるテンプレートを検索します。
GET /message/v1.0/templates?templateName=広告 -1で終わるテンプレートを検索します。
GET /message/v1.0/templates?templateName=__-1
成功レスポンスのHTTPステータスコードは200 OKです。
{
"header": {
"isSuccessful": true,
"resultCode": 0,
"resultMessage": "SUCCESS"
}
}
失敗レスポンスのHTTPステータスコードは4xxと 5xxです。
{
"header": {
"isSuccessful": false,
"resultCode": 400629,
"resultMessage": "失敗に関する情報が含まれています。"
}
}
| 名前 | タイプ | 説明 |
|---|---|---|
| header.isSuccessful | Boolean | API呼び出し成否です。 |
| header.resultCode | Integer | 結果コードです。成功は0、失敗は400000以上の値を持ちます。 |
| header.resultMessage | String | 結果メッセージです。失敗に関する情報が含まれています。 |
!!! danger 「注意事項」 * リクエスト数の計算は、クライアント、サーバー間の時間差、ネットワーク遅延によって異なる測定を行い、計算された値が異なる場合があります。 * 300RPSを超えると、サーバーはHTTPステータスコード429(Too Many Requests)レスポンスでクライアントのリクエストを拒否します。 * リクエストが拒否された場合、クライアントが即時再試行すると、サーバーのリクエスト拒否が長い時間維持されることがあります。 * クライアントは、リクエストが拒否されたら、指数バックオフ(Exponential Backoff)のように再試行間隔を増やして呼び出すことを推奨します。
Notification Hub API使用ガイドでは、IntelliJ HTTP、cURLでのAPI呼び出し例を提供します。
IntelliJ HTTP環境変数設定ファイル例(htt-client.env.json)
{
"default": {
"endpoint": "https://notification-hub.api.nhncloudservice.com",
"appKey": "アプリキー",
"accessToken": "認証トークン"
}
}
cURL環境変数設定例
ENDPOINT=https://notification-hub.api.nhncloudservice.com
APP_KEY=アプリキー
ACCESS_TOKEN=認証トークン