---
title: "iOSプッシュ通知の送信"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/push-notifications/ios/send-ios-push-notifications/
description: "このAPIは、Appleにアプリを登録し、Catalystプッシュ通知に登録し、デバイスを登録した後に、iOSアプリのユーザーにプッシュ通知を送信するために使用されます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

## iOSプッシュ通知の送信

### 説明

このAPIは、Appleにアプリを登録し、Catalystプッシュ通知に登録し、デバイスを登録した後に、iOSアプリからユーザーデバイスにテスト用のテキスト[プッシュ通知](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/introduction/)を送信するために使用されます。デバイスにプッシュ通知を送信する前に、[プッシュ通知 - iOSヘルプセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/push-notifications/ios)で説明されている**6つのステップ**を実装する必要があります。

Catalystでは、それぞれの環境の設定ファイルからappID値を渡すことで、登録済みのテストデバイスまたは本番デバイスにプッシュ通知を送信できます。テストデバイスへのプッシュ通知送信と本番デバイスへのプッシュ通知送信では、リクエストURLが異なります。これらはリクエスト詳細セクションに記載されています。

プッシュ通知メッセージと送信先の受信者を、サンプルリクエストに示すようにAPIリクエストで他の詳細とともに渡すことができます。

### リクエスト詳細

#### テスト通知を送信するリクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/push-notification/{app_id}/test

#### 本番通知を送信するリクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/push-notification/{app_id}/project-user/notify

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **app_id** (Numerical): 適切な環境の[`AppConfigurationDevelopment.plist`/ `AppConfigurationProduction.plist`ファイル](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/setup/#properties-of-the-appconfigurationdevelopmentplist-appconfigurationproductionplist-file)から取得した`notificationAppID`

#### リクエストヘッダー
 **Content-Type:** application/json

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.notifications.mobile.CUSTOM

#### リクエストJSONプロパティ

- **recipient** (string, mandatory):  プッシュ通知を送信するユーザーのメールアドレス。1回のAPI呼び出しで1人のユーザーにのみ送信できます。  

- **push_details** (json, mandatory): 
プッシュ通知のコンテンツとメタデータの詳細を含むJSON

- 
- **message** (string, mandatory): プッシュ通知のテキストコンテンツ 
 最大サイズ: 100文字 

- 
- **additional_info** (json, optional): *"sample_key" : "sample_value"*の形式で送信する必要がある追加情報 
 最大サイズ: 100文字 

- 
- **badge_count** (integer, optional): アプリのアイコン上に表示されるカウント 

- 
- **reference_id** (string, optional): 参照用のID 

- 
- **expiry_time** (integer, optional): 通知の有効期限（時間単位） 

### レスポンス詳細

レスポンスは、送信された通知のステータスを`success`または`failed`として返し、`message`や`expiry_time`を含む渡されたデータを返します。

**リクエスト例: 本番デバイス**

```bash
curl -X POST \
  https://api.catalyst.zoho.com/baas/v1/project/204000000024010/push-notification/204000000036005/project-user/notify \
  -H "Content-Type: application/json" \
  -d '{
   "recipients":"amanda.boyle@zylker.com",
   "push_details":{
   "message":"Welcome to Zylker App!",
   "badge_count":10,
   "expiry_time":12,
   "additional_info":{
         "sample_key" : "sample_value"
   }
   }
}'

```

**レスポンス例**

```json

    {
    "status": "success",
    "data": {
        "recipients": "amanda.boyle@zylker.com",
        "push_details": {
            "message": "Welcome to Zylker App!",
            "additional_info": {
                "sample_key": "sample_value"
            },
            "badge_count": 10,
            "reference_id": null,
            "expiry_time": 12
        }
    }
    }
```

### SDK Documentation

[Send Push Notifications- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/push-notifications/send-notifications/)

[Send Push Notifications- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/push-notifications/get-component-instance/)

[Send Push Notifications- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/push-notifications/get-component-instance/)

[Register Device for Push Notifications- iOS SDK](https://docs.catalyst.zoho.com/ja/sdk/ios/v2/cloud-scale/push-notifications/register-device/)

[Register Device for Push Notifications- Android SDK](https://docs.catalyst.zoho.com/ja/sdk/android/v2/cloud-scale/push-notifications/register-device/)

[Register Device for Push Notifications- Flutter SDK](https://docs.catalyst.zoho.com/ja/sdk/flutter/v2/cloud-scale/push-notifications/register-device/)

[Register Device for Push Notifications- Web SDK](https://docs.catalyst.zoho.com/ja/sdk/web/v4/cloud-scale/push-notifications/register-client/)