API حق دسترسی تبلیغاتی

اعطا و لغو حق دسترسی تبلیغاتی مشتری با REST API اینپی فای، زمان انقضا، پاسخ و خطاها.

حق دسترسی تبلیغاتی برای هدیه، جبران مشکل یا کمپین محدود مناسب است. این رکورد از دسترسی حاصل از خرید جداست؛ لغو دسترسی تبلیغاتی، خرید معتبر مشتری را حذف نمی‌کند.

اعطای حق دسترسی
{
  "end_time_ms": 1790800200000
}
پارامترنوعتوضیح
end_time_msintegerزمان انقضا به Unix timestamp برحسب میلی‌ثانیه؛ باید در آینده باشد.
curl -X POST \
  "https://api.example.com/api/v1/subscribers/customer_123/entitlements/premium/promotional" \
  -H "Authorization: Bearer YOUR_SECRET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"end_time_ms":1790800200000}'
پاسخ 201 اطلاعات کامل مشتری را با entitlement جدید برمی‌گرداند:
{
  "status": true,
  "data": {
    "originalAppUserId": "customer_123",
    "latestExpirationDate": "2026-10-01 20:00:00",
    "entitlements": [
      {
        "identifier": "premium",
        "isActive": true,
        "isSandbox": false,
        "periodType": 3,
        "purchaseDate": "2026-09-21 20:00:00",
        "expirationDate": "2026-10-01 20:00:00",
        "ownershipType": null
      }
    ],
    "transactions": [],
    "attributes": []
  }
}
مقادیر زمانی نمونه‌اند. زمان واقعی پاسخ بر اساس زمان پردازش سرور تعیین می‌شود.
لغو دسترسی‌های تبلیغاتی
این endpoint body ندارد و همه رکوردهای تبلیغاتی همان entitlement را برای مشتری حذف می‌کند. پاسخ 200 اطلاعات به‌روز مشتری است.

خطاها

وضعیتدلیل
404entitlement با این شناسه در پروژه وجود ندارد.
422end_time_ms وجود ندارد، عدد صحیح نیست یا در آینده نیست.
403کلید مجوز اعطا یا لغو را ندارد.
اگر مشتری وجود نداشته باشد، پیش از انجام عملیات در همان پروژه ایجاد می‌شود.