Skip to main content

No project description provided

Project description

APNS Push Notification

This Python script allows you to send push notifications to Apple devices manually. It uses the Apple Push Notification service (APNS) to deliver notifications to your application users.

Why use initialize_apns?

The initialize_apns function is used to set up the APNS with your application's specific details. This includes your key ID, team ID, bundle ID, and the path to your p8 or pem file. You can also specify whether you want to use the production or sandbox environment (default is sandbox).

How to use the script?

First, import the necessary modules:

import apns

Then, initialize the APNS with your application's details:

KEY_ID = ''  
TEAM_ID = ''  
BUNDLE_ID = 'com.test.app'
IS_PROD = False
P8_KEY_PATH = 'path/to/p8/key'  
PEM_FILE_PATH = 'path/to/pem/file'
APNS_PRIORITY = 10
APNS_EXPIRATION = 0

apns.initialize_apns(key_id=KEY_ID,
                     team_id=TEAM_ID,
                     bundle_id=BUNDLE_ID,
                     is_prod=IS_PROD,
                     p8_key_path=P8_KEY_PATH,
                     pem_file_path=PEM_FILE_PATH,
                     apns_priority=APNS_PRIORITY,
                     apns_expiration=APNS_EXPIRATION)

apns.config().verbose = True

Now, you can send a push notification:

device_token = ""  
data = {}  
title = "Hello World!"

response: APNSResponse = apns.push(device_token=device_token, title=title, data=data, badge=1, push_type=apns.PushType.alert, collapse_id=None)

Using p8 or pem file

Depending on your preference or requirements, you can use either a p8 or pem file for authentication. If you want to use a p8 file, pass the path to the p8_key_path parameter in the initialize_apns function. If you want to use a pem file, pass the path to the pem_file_path parameter.

Getting a p8 file or pem file

To get the p8 or pem file for APNS push notification, you can follow these steps:

  1. For p8 file:

    • Go to the Apple Developer Portal.
    • Navigate to the "Certificates, Identifiers & Profiles" section.
    • Under the "Keys" section, click on the "+" button to create a new key. (make sure to select Apple Push Notifications service (APNs) from the checkbox)
    • Make sure to write down the Key ID as you will need it later.
    • Download the generated p8 file and save it to a secure location.
  2. For pem file:

    • Convert the exported .p12 file to a .pem file using the following command in the terminal:
      openssl pkcs12 -clcerts -legacy -nodes -in Certificates.p12 -out AuthKey.pem
      
      Replace "Certificates.p12" with the path to your .p12 file or keep it if you're in the same directory as your .p12 file.
    • Enter the password for the .p12 file when prompted (hit Enter if blank).
    • The converted pem file will be saved as "AuthKey.pem" in the current directory.

Once you have obtained the p8 or pem file, you can use it in the initialize_apns function by providing the path to the file in the p8_key_path or pem_file_path parameter, respectively.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aipkgs_notifications-0.0.14.tar.gz (8.4 kB view details)

Uploaded Source

Built Distribution

aipkgs_notifications-0.0.14-py3-none-any.whl (9.3 kB view details)

Uploaded Python 3

File details

Details for the file aipkgs_notifications-0.0.14.tar.gz.

File metadata

  • Download URL: aipkgs_notifications-0.0.14.tar.gz
  • Upload date:
  • Size: 8.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.6.1 CPython/3.9.1 Darwin/23.1.0

File hashes

Hashes for aipkgs_notifications-0.0.14.tar.gz
Algorithm Hash digest
SHA256 73f035f05845ba926b7f9466c3360c6208c1828da4beb8152e5b2af70b19cb5e
MD5 6d52312073c030f60cfe3976ec139312
BLAKE2b-256 10714c695e0f126e4aea2c7d0af12535c024440bbb6586e0bf0d81bc4aa9442c

See more details on using hashes here.

File details

Details for the file aipkgs_notifications-0.0.14-py3-none-any.whl.

File metadata

File hashes

Hashes for aipkgs_notifications-0.0.14-py3-none-any.whl
Algorithm Hash digest
SHA256 5096b6abcd5a509581a58b1f7a3611a55b71fa44b4db050bdf4c9f7ed6fd581b
MD5 10f1cf2e378f55f7c8bdcfadc9f12df0
BLAKE2b-256 5d805e461a8aca82551702d9a974ad14d46d0f61dbd4edcfc23961bc6a5aad18

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page