sailplay 0.2.0

初始化 API 客户端

您应该从服务中获取 pin，store_department_id 和 store_department_key。

from sailplay import SailPlayClient

client = SailPlayClient(pin, store_department_id, store_department_key)

额外参数

client = SailPlayClient(
    pin, store_department_id, store_department_key,
    token="token-here", # Set token manually (default "")
    silence=True,       # Dont fail on API errors (default False)
    loglevel="debug",   # Set log level (default INFO)
)

获取 API 令牌

client.login()
print client.token

使用 api

Sailplay 有一个漂亮且简单的语法。只需看看即可

# Get events list  http://sailplay.ru/api/v2/events/list/
client.api.events.list()

# Create a new user http://sailplay.ru/api/v2/users/add/?...
client.api.users.add(user_phone='...', first_name='...', last_name='...')

# Get info about user http://sailplay.ru/api/v2/users/info/?...
client.api.users.info(user_phone='...')

# Create purchase http://sailplay.ru/api/v2/purchases/new/?...
client.api.purchases.new(**params)

# You also could use getitem syntax for params
client.api.users['custom-vars'](**params)
# Same as
client.api['users']['custom-vars'](**params)

# And etc. I hope you make decision how the client works :)

目前客户端会自动选择 API 版本。

上下文管理器

您可以在上下文中重新定义客户端设置。

with client.ctx(silence=True):
    # Errors will not be raised here
    client.api.users.add(user_phone='...', first_name='...', last_name='...')

原始 API 请求

您可以向 sailplay API 发送原始请求。

client.request(method='GET', url='/users/info', data={...})

编程愉快！