iOS — Apple Push Notification Service (APNS)

Прямая интеграция с APNS без посредников. Требуется Apple Developer аккаунт ($99/год).

Шаг 1: Получите APNS ключ

1. Откройте Apple Developer → Keys
2. Нажмите "+" для создания нового ключа
3. Введите имя и включите "Apple Push Notifications service (APNs)"
4. Скачайте .p8 файл (хранится только один раз!)
5. Запомните Key ID (10 символов)

Шаг 2: Создайте проект

Перейдите в "Проекты" → "iOS" → "Создать проект" и загрузите:

• APNS Key (.p8) — скачанный ключ
• Key ID — идентификатор ключа
• Team ID — найдите в Apple Developer → Membership
• Bundle ID — например, com.yourcompany.app

Шаг 3: Интеграция в iOS приложение (Swift)

import UIKit
import UserNotifications

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
  
  func application(_ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    
    // Запрос разрешения на уведомления
    UNUserNotificationCenter.current().requestAuthorization(
      options: [.alert, .sound, .badge]
    ) { granted, error in
      if granted {
        DispatchQueue.main.async {
          application.registerForRemoteNotifications()
        }
      }
    }
    return true
  }
  
  // Получение Device Token
  func application(_ application: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    
    let token = deviceToken.map { String(format: "%02.2hhx", $0) }.joined()
    print("Device Token: \(token)")
    
    // Отправляем токен на сервер
    registerDeviceToken(token)
  }
  
  func registerDeviceToken(_ token: String) {
    let url = URL(string: "https://push360.ru/api/v1/ios/register")!
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("pk_ваш_api_key", forHTTPHeaderField: "X-API-Key")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    
    let body: [String: Any] = [
      "deviceToken": token,
      "userId": "user_123",
      "tags": ["ios", "premium"]
    ]
    request.httpBody = try? JSONSerialization.data(withJSONObject: body)
    
    URLSession.shared.dataTask(with: request).resume()
  }
}

Android — WebSocket Push (без Google!)

Собственная реализация push-уведомлений через WebSocket. Работает без Google Play Services и Firebase.

Шаг 1: Добавьте зависимости

// build.gradle (app)
dependencies {
    // OkHttp для WebSocket
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    
    // Для работы в фоне
    implementation 'androidx.work:work-runtime-ktx:2.9.0'
}

Шаг 2: Создайте PushService

class PushService : Service() {
    private var webSocket: WebSocket? = null
    private val client = OkHttpClient.Builder()
        .pingInterval(30, TimeUnit.SECONDS)
        .build()
    
    override fun onStartCommand(intent: Intent?, flags: Int, startId: Int): Int {
        startForeground(1, createNotification())
        connectWebSocket()
        return START_STICKY
    }
    
    private fun connectWebSocket() {
        val deviceId = Settings.Secure.getString(contentResolver, Settings.Secure.ANDROID_ID)
        val request = Request.Builder()
            .url("wss://push360.ru/ws/android?apiKey=pk_ваш_ключ&deviceId=$deviceId")
            .build()
        
        webSocket = client.newWebSocket(request, object : WebSocketListener() {
            override fun onMessage(webSocket: WebSocket, text: String) {
                val json = JSONObject(text)
                showNotification(
                    json.getString("title"),
                    json.getString("body"),
                    json.optString("url", null)
                )
            }
            
            override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) {
                // Переподключение через 5 секунд
                Handler(Looper.getMainLooper()).postDelayed({ connectWebSocket() }, 5000)
            }
        })
    }
    
    private fun showNotification(title: String, body: String, url: String?) {
        val intent = if (url != null) {
            Intent(Intent.ACTION_VIEW, Uri.parse(url))
        } else {
            packageManager.getLaunchIntentForPackage(packageName)
        }
        
        val pendingIntent = PendingIntent.getActivity(
            this, 0, intent, PendingIntent.FLAG_IMMUTABLE
        )
        
        val notification = NotificationCompat.Builder(this, "push_channel")
            .setSmallIcon(R.drawable.ic_notification)
            .setContentTitle(title)
            .setContentText(body)
            .setContentIntent(pendingIntent)
            .setAutoCancel(true)
            .build()
        
        NotificationManagerCompat.from(this).notify(System.currentTimeMillis().toInt(), notification)
    }
}

Шаг 3: Добавьте в AndroidManifest.xml

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<application ...>
    <service
        android:name=".PushService"
        android:foregroundServiceType="dataSync"
        android:exported="false" />
</application>

Flutter/Dart SDK (без Firebase!)

Кроссплатформенный SDK для Flutter. Работает на iOS (через APNs) и Android (через WebSocket) без Firebase.

dependencies:
  http: ^1.1.0
  web_socket_channel: ^2.4.0
  flutter_local_notifications: ^16.0.0
  shared_preferences: ^2.2.0

<key>UIBackgroundModes</key>
<array>
  <string>fetch</string>
  <string>remote-notification</string>
</array>

import 'push360_full.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // Инициализация Push360
  final push360 = await Push360.initialize(
    apiKey: 'pk_ваш_публичный_ключ',
    onNotificationReceived: (data) {
      print('Получено уведомление: ${data['title']}');
    },
    onNotificationClick: (data) {
      print('Клик по уведомлению: ${data['url']}');
      // Навигация по data['url']
    },
    onConnectionChanged: (connected) {
      print('WebSocket: ${connected ? 'подключён' : 'отключён'}');
    },
  );
  
  runApp(MyApp());
}

// В любом месте приложения:

// 1. Регистрация устройства (без userId при первом запуске)
final deviceId = await Push360.instance?.registerDevice();
print('Device ID: $deviceId');

// 2. После авторизации — привязываем пользователя
await Push360.instance?.linkUser('user_123');

// 3. При выходе из аккаунта
await Push360.instance?.unlinkUser();

// 4. Обновление тегов
await Push360.instance?.updateTags(['news', 'promo']);

// 1. При старте приложения (On Page Load главной страницы)
await initPush360('pk_ваш_публичный_ключ');

// 2. Сразу после — регистрация устройства
final deviceId = await registerPush360Device(null);
// Сохраните deviceId в App State!

// 3. После авторизации пользователя
await linkPush360User(currentUser.uid);

// 4. При выходе из аккаунта
await unlinkPush360User();

# pubspec.yaml (после публикации)
dependencies:
  push360_sdk: ^1.0.0

Настройка Android

<!-- android/app/src/main/AndroidManifest.xml -->
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>

<application ...>
    <!-- Для уведомлений в фоне -->
    <service
        android:name="com.dexterous.flutterlocalnotifications.ForegroundService"
        android:exported="false"
        android:stopWithTask="false"/>
</application>

Настройка iOS

<!-- ios/Runner/Info.plist -->
<key>UIBackgroundModes</key>
<array>
    <string>fetch</string>
    <string>remote-notification</string>
</array>

<!-- В Xcode: Runner → Signing & Capabilities → + Push Notifications -->

Полный пример (Full SDK)

import 'package:push360_sdk/push360_sdk.dart';

class _MyAppState extends State<MyApp> {
  late Push360SDK push;

  @override
  void initState() {
    super.initState();
    _initPush();
  }

  Future<void> _initPush() async {
    // Создаём SDK
    push = Push360SDK(
      apiUrl: 'https://push360.ru',
      apiKey: 'pk_ваш_публичный_ключ',
      debug: true,
    );

    // Инициализация
    await push.init();

    // Запрос разрешения
    final granted = await push.requestPermission();
    if (!granted) return;

    // Регистрация устройства
    await push.register(
      userId: 'user_123',       // ОБЯЗАТЕЛЬНО — ID пользователя
      tags: ['news', 'promo'],  // Теги (опционально)
    );

    // Обработка уведомлений
    push.onNotificationReceived = (notification) {
      print('📩 Получено: ${notification.title}');
    };

    // Обработка кликов
    push.onNotificationClick = (notification, action) {
      print('👆 Клик: ${notification.title}');
      if (notification.url != null) {
        Navigator.pushNamed(context, notification.url!);
      }
    };
  }

  @override
  void dispose() {
    push.dispose();
    super.dispose();
  }
}

API методы

REST API — Отправка уведомлений

Отправляйте уведомления программно с вашего сервера через REST API.

Базовый URL

https://push360.ru/api/v1

POST /notifications/send

curl -X POST https://push360.ru/api/v1/notifications/send \
  -H "X-API-Key: pk_ваш_публичный_ключ" \
  -H "X-API-Secret: sk_ваш_секретный_ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Привет!",
    "body": "Это тестовое уведомление",
    "url": "https://example.com/page",
    "icon": "https://example.com/icon.png",
    "platform": "all"
  }'

Параметры запроса

🎯 Отправка конкретному пользователю

Используйте userId в параметрах или отдельный эндпоинт:

// Способ 1: через параметр userId
curl -X POST https://push360.ru/api/v1/notifications/send \
  -H "X-API-Key: pk_ваш_ключ" \
  -H "X-API-Secret: sk_ваш_секрет" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Персональное уведомление",
    "body": "Только для вас!",
    "userId": "123"
  }'

// Способ 2: через URL
curl -X POST https://push360.ru/api/v1/notifications/send-to-user/123 \
  -H "X-API-Key: pk_ваш_ключ" \
  -H "X-API-Secret: sk_ваш_секрет" \
  -H "Content-Type: application/json" \
  -d '{"title": "Привет!", "body": "Сообщение"}'

Node.js

const response = await fetch('https://push360.ru/api/v1/notifications/send', {
  method: 'POST',
  headers: {
    'X-API-Key': 'pk_ваш_ключ',
    'X-API-Secret': 'sk_ваш_секрет',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Привет!',
    body: 'Тестовое уведомление',
    platform: 'all'
  })
});

Python

import requests

response = requests.post(
    'https://push360.ru/api/v1/notifications/send',
    headers={
        'X-API-Key': 'pk_ваш_ключ',
        'X-API-Secret': 'sk_ваш_секрет'
    },
    json={
        'title': 'Привет!',
        'body': 'Тестовое уведомление',
        'platform': 'all'
    }
)

PHP

$ch = curl_init('https://push360.ru/api/v1/notifications/send');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: pk_ваш_ключ',
        'X-API-Secret: sk_ваш_секрет',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'title' => 'Привет!',
        'body' => 'Тестовое уведомление'
    ])
]);
$response = curl_exec($ch);

PHP (Bitrix) — отправка конкретному пользователю

// Функция для отправки push-уведомления
function sendPushToUser($userId, $title, $body, $url = null) {
    $ch = curl_init('https://push360.ru/api/v1/notifications/send');
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            'X-API-Key: pk_ваш_ключ',
            'X-API-Secret: sk_ваш_секрет',
            'Content-Type: application/json'
        ],
        CURLOPT_POSTFIELDS => json_encode([
            'title' => $title,
            'body' => $body,
            'url' => $url,
            'userId' => (string)$userId  // ID пользователя Bitrix
        ])
    ]);
    $response = json_decode(curl_exec($ch), true);
    curl_close($ch);
    return $response;
}

// Пример: уведомление при новом заказе
sendPushToUser(
    $order->getUserId(),
    'Заказ оформлен!',
    'Ваш заказ #' . $order->getId() . ' принят в обработку',
    '/personal/orders/' . $order->getId() . '/'
);

// Пример: напоминание о брошенной корзине
sendPushToUser(
    $USER->GetID(),
    'Вы забыли товары в корзине',
    'Завершите оформление заказа со скидкой 5%',
    '/personal/cart/'
);

{
  "success": true,
  "data": {
    "notificationId": "550e8400-e29b-41d4-a716-446655440000",
    "status": "completed",
    "stats": { "total": 2, "sent": 2, "failed": 0 }
  }
}