psnawp

norte

Cómo instalar

Desde PyPI

 pip install PSNAWP

Enlaces importantes

PyPI: https://pypi.org/project/PSNAWP/

Lea los documentos: https://psnawp.readthedocs.io/en/latest/

Empezando

Precaución

Esta biblioteca es un contenedor API no oficial y de ingeniería inversa para PlayStation Network (PSN). Ha sido desarrollado basándose en la ingeniería inversa de la aplicación de PSN para Android. El contenedor API (>= v2.1.0) autocalificará el límite en 300 solicitudes cada 15 minutos. Sin embargo, sigue siendo importante que no envíe solicitudes masivas utilizando esta API. El uso excesivo de la API puede provocar que su cuenta de PSN sea prohibida temporal o permanentemente.

También puedes crear una cuenta dedicada para usar esta biblioteca para que, en el peor de los casos, no pierdas el acceso a tu cuenta principal, junto con tus videojuegos y tu progreso.

Para comenzar, necesita obtener npsso <código de 64 caracteres>. Necesitas seguir los siguientes pasos.

1. Inicie sesión en su cuenta Mi PlayStation.
2. En otra pestaña, vaya a https://ca.account.sony.com/api/v1/ssocookie
3. Si has iniciado sesión deberías ver un texto similar a este

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

Este código npsso se utilizará en la API con fines de autenticación. El token de actualización que se genera a partir de npsso dura aproximadamente 2 meses. Después de eso, debes obtener un nuevo token npsso. El bot imprimirá una advertencia si quedan menos de 3 días para el vencimiento del token de actualización.

A continuación se muestra un ejemplo rápido sobre cómo utilizar esta biblioteca.

 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" ])

Nota: Si desea crear varias instancias de psnawp, necesita obtener el código npsso de cuentas PSN independientes. Si genera un nuevo npsso con la misma cuenta, su npsso anterior caducará inmediatamente.

Contribución

Todas las publicaciones de errores y solicitudes de funciones son bienvenidas, aunque soy nuevo en la creación de bibliotecas de Python, por lo que puede que me lleve un tiempo implementar algunas funciones. Las sugerencias son bienvenidas si estoy haciendo algo que sea una forma poco convencional de hacerlo.

Descargo de responsabilidad

Este proyecto no está destinado a ser utilizado para spam, abuso ni nada por el estilo. No se respalda ningún uso de este proyecto para esos fines. Tenga esto en cuenta al crear aplicaciones utilizando este contenedor de API.

Crédito

Este proyecto contiene código de PlayStationNetwork::API y PSN-PHP Wrapper que se tradujo a Python. Además, un agradecimiento especial a @andshrew por documentar los puntos finales del PlayStation Trophy. Todas las licencias están incluidas en este repositorio.