Readme#
PlayStation Network API Wrapper Python (PSNAWP)#
Retrieve User Information, Trophies, Game and Store data from the PlayStation Network
Coverage Report
File Stmts Miss Cover Missing src/psnawp_api init.py 3 0 100% psnawp.py 35 0 100% src/psnawp_api/core init.py 0 0 100% authenticator.py 46 3 3 93% psnawp_exceptions.py 9 0 100% src/psnawp_api/models init.py 0 0 100% client.py 70 0 100% game_title.py 22 0 100% group.py 52 0 100% search.py 22 0 100% title_stats.py 84 23 23 73% user.py 71 0 100% src/psnawp_api/models/listing init.py 0 0 100% listing_generator.py 36 5 5 86% pagination_arguments.py 15 0 100% src/psnawp_api/models/trophies init.py 0 0 100% trophy.py 112 0 100% trophy_constants.py 25 0 100% trophy_group.py 89 0 100% trophy_summary.py 25 0 100% trophy_titles.py 86 0 100% utility_functions.py 7 0 100% src/psnawp_api/utils init.py 0 0 100% endpoints.py 2 0 100% misc.py 31 1 1 97% request_builder.py 72 15 15 79% TOTAL 914 47 95%
How to install#
From PyPI#
pip install PSNAWP
Using setup.py#
To install the library into python. First you need to clone the repo at your local machine and run the following command from the root directory of the repo
python setup.py install
Important Links#
PyPI: https://pypi.org/project/PSNAWP/
Read the Docs: https://psnawp.readthedocs.io/en/latest/
Getting Started#
To get started you need to obtain npsso <64 character code>. You need to follow the following steps
Login into your My PlayStation account.
In another tab, go to https://ca.account.sony.com/api/v1/ssocookie
If you are logged in you should see a text similar to this
{"npsso":"<64 character npsso code>"}
This npsso code will be used in the api for authentication purposes. The refresh token that is generated from npsso lasts about 2 months. After that you have to get a new npsso token. The bot will print a warning if there are less than 3 days left in refresh token expiration.
Following is the quick example on how to use this library
from psnawp_api import PSNAWP
psnawp = PSNAWP('<64 character npsso code>')
# This is you
client = psnawp.me()
print(client.online_id)
print(client.account_id)
print(client.get_account_devices())
print(client.get_profile_legacy())
print(client.friends_list())
print(client.blocked_list())
print(client.available_to_play())
groups = client.get_groups()
print(groups)
# Getting user from online
example_user_1 = psnawp.user(online_id="VaultTec-Co")
example_user_2 = psnawp.user(online_id="test")
print(example_user_1.online_id)
print(example_user_1.account_id)
print(example_user_1.profile())
print(example_user_1.prev_online_id)
print(example_user_1.get_presence())
print(example_user_1.friendship())
print(example_user_1.is_blocked())
# Getting user from Account ID
user_account_id = psnawp.user(account_id='9122947611907501295')
print(user_account_id.online_id)
# Sending Message
group = psnawp.group(group_id='38335156987791a6750a33ae452ec8666177b65e-103')
print(group.get_group_information())
print(group.get_conversation(10))
print(group.send_message("Hello World"))
print(group.change_name("API Testing 3"))
print(group.leave_group())
# Creating new group
new_group = psnawp.group(users_list=[example_user_1, example_user_2])
search = psnawp.search()
print(search.get_title_id(title_name="GTA 5"))
print(search.universal_search("GTA 5"))
# Get Play Times (PS4, PS5 above only)
titles_with_stats = client.title_stats()
Note: If you want to create multiple instances of psnawp you need to get npsso code from separate PSN accounts. If you generate a new npsso with same account your previous npsso will expire immediately.
Contribution#
All bug reposts and features requests are welcomed, although I am new at making python libraries, so it may take me a while to implement some features. Suggestions are welcomes if I am doing something that is an unconventional way of doing it.
Disclaimer#
This project was not intended to be used for spam, abuse, or anything of the sort. Any use of this project for those purposes is not endorsed. Please keep this in mind when creating applications using this API wrapper.
Credit#
This project contains code from PlayStationNetwork::API and PSN-PHP Wrapper that was translated to Python. See more in LICENSE