ایران ناتیفیکیشن

تنظیم APNs مستقیم

کلید APNs اپل را برای ارسال مستقیم به iOS ثبت می‌کند.

PUThttps://api.irnoti.com/v1/sdk-apps/{id}/apns
scope: broker.write

فایل .p8 رمزنگاری‌شده ذخیره می‌شود. فقط مالک؛ سقف ۱۰ بار در ساعت.

پارامترها

ناممحلنوعتوضیح
id *مسیرstringشناسهٔ اپ.
keyId *بدنهstringشناسهٔ کلید (۱۰ نویسهٔ بزرگ/رقم).
teamId *بدنهstringشناسهٔ تیم (۱۰ نویسه).
bundleId *بدنهstringشناسهٔ بسته.
key *بدنهstringمحتوای فایل .p8.
sandboxبدنهbooleanمحیط آزمایشی اپل.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا منقضی است.
403insufficient_scopeکلید API دامنهٔ دسترسی لازم را ندارد.
400validation_errorورودی نامعتبر است (جزئیات در پاسخ).
429rate_limitedتعداد درخواست از سقف مجاز بیشتر شد؛ پس از زمان Retry-After دوباره تلاش کنید.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X PUT 'https://api.irnoti.com/v1/sdk-apps/8/apns' \
  -H "Authorization: Bearer $IRNOTI_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "-----BEGIN PRIVATE KEY-----…",
  "keyId": "ABCDE12345",
  "teamId": "TEAM123456",
  "bundleId": "com.example.shop"
}'
پاسخ نمونه200 OK
{
  "keyId": "ABCDE12345",
  "configured": true
}
تنظیم APNs مستقیم — مستندات API | ایران ناتیفیکیشن