python的logup sdk
logup的Python项目详细描述
logupsdkforpython使python开发人员能够轻松地将logup服务集成到他们的项目中。
开始
注册登录
在开始之前,你需要一个登录帐户。请看Getting started 有关如何创建日志帐户和创建第一个gate的信息,请参阅《开发人员指南》的第节。
初始化logup client对象
id_gate="{your-id-gate}"gate_secret_key="{your-gate-secret-key}"# Create an instance of LogupClient using the default API Versionlogup_client=LogupClient(id_gate,gate_secret_key)# Create an instance of LogupClient specifying the API versionapi_version="v1_1"logup_client_1=LogupClient(id_gate,gate_secret_key,api_version)
现在您可以验证收到的令牌了。在登录后将用户发送到的重定向页面上,从 url这些参数:
- loguptoken:用于验证用户身份的唯一令牌
- is new user:如果用户是您网站的新用户,则为true;如果用户说他已经在您的网站上拥有帐户,则为false。More about this parameter
验证用户身份
这段代码是如何验证收到的标记是否正确,并查看用户是谁。
logup_token="{very-long-token-received-as-URL-query-parameter}"is_new_user=TrueorFalseiflogup_client.is_logup_verified(logup_token,is_new_user):# user was successfully logged in!# get the subscription objectsubscription=logup_client.subscriptionelse:print("Ops, the user did not log in")
订阅
使用Subscription对象,您可以获得有关登录的参与者的更多信息,以及对其保存的 分贝。db是可以与用户关联的参数的键值存储。Read mode about DB。
读取值
订阅对象就是这样生成的:
subscription.id_subscription# the id of the subscriptionsubscription.id_actor# the id of the actor that access the subscriptionsubscription.is_new_user# true if it is a new user, false otherwise
对于id actor和id subscription之间的差异解释see our documentation。
获取订阅数据库值
读取该订阅的数据库值。
db=subscription.dbprint("idSubscription retrieved: "+subscription.id_subscription)print("With this DB associated: ")print(db)
添加/更新数据库值
添加或更新数据库值。
data={"key-test":"","second-key-test":1,"third-key-test":True}db=subscription.update_db(data)print("Db values updated: ")print(db)
某些限制可能适用于要添加到数据库的值:请在 documentation。 当您更新或添加值时,不需要给出所有以前的值,但是只需要给出那些您需要更新/添加的值。 响应的数据库将具有当前存储在数据库中的所有值。
删除db值
keys=["third-key-test"]db=subscription.delete_db_value(keys)print("New db values: ")print(db)
输入一个数组,其中一个或多个字符串表示要从数据库中删除的键。响应将具有 没有删除值的当前数据库。
在自定义对象上操作
如果要对登录期间检索到的订阅进行操作,则需要创建新的 订阅对象,您正在查找的订阅ID。这是一个示例:
id_subscription="sub_XXXXXXXXXXX"subscription=logup_client.subscription_custom(id_subscription)# on subscription now you can perform all the operation mentioned above
记住,如果您创建一个自定义的新订阅,您将没有
的值- IDactor
- isnewuser
因为它们与试图访问您网站的用户相关,而不是与一般加载订阅相关。