psnawp

n

インストール方法

PyPIから

 pip install PSNAWP

重要なリンク

PyPI: https://pypi.org/project/PSNAW​​P/

ドキュメントを読む: https://psnawp.readthedocs.io/en/latest/

はじめる

注意

このライブラリは、PlayStation Network (PSN) 用の非公式でリバース エンジニアリングされた API ラッパーです。 PSN Android アプリのリバース エンジニアリングに基づいて開発されました。 API ラッパー (v2.1.0 以上) は、15 分あたり 300 リクエストに自己レート制限を設けます。ただし、この API を使用して一括リクエストを送信しないことが重要です。 API を過度に使用すると、PSN アカウントが一時的または永久に禁止される可能性があります。

このライブラリを使用する専用のアカウントを作成することもできます。これにより、最悪の場合、ビデオ ゲームや進行状況とともに、プライマリ アカウントへのアクセスが失われないようになります。

開始するには、npsso <64 文字コード> を取得する必要があります。次の手順に従う必要があります

1. My PlayStation アカウントにログインします。
2. 別のタブで、 https://ca.account.sony.com/api/v1/ssocookieに移動します。
3. ログインしている場合は、次のようなテキストが表示されるはずです

{ "npsso" : " <64 character npsso code> " }

この npsso コードは、認証目的で API で使用されます。 npsso から生成されるリフレッシュ トークンの有効期間は約 2 か月です。その後、新しい npsso トークンを取得する必要があります。リフレッシュ トークンの有効期限が残り 3 日未満の場合、ボットは警告を出力します。

以下は、このライブラリの使用方法の簡単な例です。

 from psnawp_api import PSNAWP
from psnawp_api . models import SearchDomain
from psnawp_api . models . trophies import PlatformType

psnawp = PSNAWP ( "<64 character npsso code>" )

# Your Personal Account Info
client = psnawp . me ()
print ( f"Online ID: { client . online_id } " )
print ( f"Account ID: { client . account_id } " )
print ( f"Profile: { client . get_profile_legacy () } n " )

# Your Registered Devices
devices = client . get_account_devices ()
for device in devices :
    print ( f"Device: { device } n " )

# Your Friends List
friends_list = client . friends_list ()
for friend in friends_list :
    print ( f"Friend: { friend } n " )

# Your Players Blocked List
blocked_list = client . blocked_list ()
for blocked_user in blocked_list :
    print ( f"Blocked User: { blocked_user } n " )

# Your Friends in "Notify when available" List
available_to_play = client . available_to_play ()
for user in available_to_play :
    print ( f"Available to Play: { user } n " )

# Your trophies (PS4)
for trophy in client . trophies ( "NPWR22810_00" , PlatformType . PS4 ):
    print ( trophy )

# Your Chat Groups
groups = client . get_groups ()
first_group_id = None  # This will be used later to test group methods
for id , group in enumerate ( groups ):
    if id == 0 :  # Get the first group ID
        first_group_id = group . group_id

    group_info = group . get_group_information ()
    print ( f"Group { id } : { group_info } n " )

# Your Playing time (PS4, PS5 above only)
titles_with_stats = client . title_stats ()
for title in titles_with_stats :
    print (
        f" 
        Game: { title . name } - 
        Play Count: { title . play_count } - 
        Play Duration: { title . play_duration } n "
    )


# Other User's
example_user_1 = psnawp . user ( online_id = "VaultTec-Co" )  # Get a PSN player by their Online ID
print ( f"User 1 Online ID: { example_user_1 . online_id } " )
print ( f"User 1 Account ID: { 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 ())

# Example of getting a user by their account ID
user_account_id = psnawp . user ( account_id = "9122947611907501295" )
print ( f"User Account ID: { user_account_id . online_id } " )


# Messaging and Groups Interaction
group = psnawp . group ( group_id = first_group_id )  # This is the first group ID we got earlier - i.e. the first group in your groups list
print ( group . get_group_information ())
print ( group . get_conversation ( 10 ))  # Get the last 10 messages in the group
print ( group . send_message ( "Hello World" ))
print ( group . change_name ( "API Testing 3" ))
# print(group.leave_group()) # Uncomment to leave the group

# Create a new group with other users - i.e. 'VaultTec-Co' and 'test'
example_user_2 = psnawp . user ( online_id = "test" )
new_group = psnawp . group ( users_list = [ example_user_1 , example_user_2 ])
print ( new_group . get_group_information ())
# You can use the same above methods to interact with the new group - i.e. send messages, change name, etc.

# Searching for Game Titles
search = psnawp . search ( search_query = "GTA 5" , search_domain = SearchDomain . FULL_GAMES )
for search_result in search :
    print ( search_result [ "result" ][ "invariantName" ])

注: psnawp の複数のインスタンスを作成する場合は、別の PSN アカウントから npsso コードを取得する必要があります。同じアカウントで新しい npsso を生成すると、以前の npsso はすぐに期限切れになります。

貢献

バグの再投稿や機能リクエストはすべて歓迎されますが、私は Python ライブラリの作成が初心者なので、一部の機能を実装するには時間がかかる場合があります。型破りな方法で何かを行っている場合は、提案を歓迎します。

免責事項

このプロジェクトは、スパム、悪用、またはその類のものに使用することを意図したものではありません。それらの目的でこのプロジェクトを使用することは承認されません。この API ラッパーを使用してアプリケーションを作成する場合は、この点に留意してください。

クレジット

このプロジェクトには、PlayStationNetwork::API と Python に変換された PSN-PHP Wrapper のコードが含まれています。また、PlayStation トロフィーのエンドポイントを文書化してくださった @andshrew に心より感謝いたします。すべてのライセンスはこのリポジトリに含まれています。