Marqeta Python开发包
marqeta的Python项目详细描述
Marqeta巨蟒
marqeta python库提供了对marqeta平台的访问。
这个库是作为测试版发布的。如果您发现任何需要修复或可以改进的地方,请在github上创建一个问题。
文档
有关完整的参考文档,请参见Marqeta Core API参考
安装
使用python的包管理器pip从pypi安装。
pip install marqeta
要求
- 巨蟒3.7+
依赖关系
用法
配置客户端
在marqeta.com上创建一个帐户,以检索共享沙盒的应用程序令牌和访问令牌。对于生产,您还需要更改基本URL
。
配置客户端对象。
from marqeta import Client
base_url = "https://shared-sandbox-api.marqeta.com/v3/"
application_token = "MY_APPLICATION_TOKEN"
access_token = "MY_ACCESS_TOKEN"
timeout = 60 # seconds
client = Client(base_url, application_token, access_token, timeout)
指定基本URL时,请在/v3/
版本前缀中加上斜杠。
访问资源
作为客户端对象的属性访问核心API的资源集合。
例如,要访问/users
端点:
client.users
嵌套资源集合是父集合的属性。
例如,访问/chargebacks/{token}/transitions
端点:
client.chargebacks(token).transitions
列出对象
根据您的用例,有多种方法可以检索对象集合。库将智能地为您处理分页,除非您请求特定的数据页。
要简单地检索集合中的每个对象,请对资源调用list(limit=none)
。
users = client.users.list(limit=None)
如果为"limit"指定了一个整数,库将返回最大值limit
对象。limit
的默认值通常为none
,但是对于client.users.list()
和client.card_products.list()
的默认值分别为1000和25。
stream()
方法返回一个生成器,该生成器可根据需要有效下载后续页面,而不是一次将所有对象下载到内存中。
for user in client.users.stream():
pass
要检索单个页面,请调用page()
方法,指定开始索引
和计数
page = client.users.page(start_index=0, count=5)
users = page.data
通过传递params
dictionary:
client.users.list(params={'sort_by': '-lastModifiedTime'})
有关详细信息,请参见排序和分页。
指定其他查询参数
大多数方法支持将其他查询参数指定为params
字典。键和值与http api相同。
client.cards.find_show_pan(card_token, params={'show_cvv_number': True})
查找特定对象
调用资源集合上的find()
方法,传入对象的标记。
pip install marqeta
0
创建对象
调用资源集合的create()
方法,将数据作为python dict传入。
pip install marqeta
1
更新对象
调用资源集合的save()
方法,传入对象的标记和包含要更新的字段的python字典。
pip install marqeta
2
处理错误
对于不成功的请求,sdk将引发marqetaerror
异常。
pip install marqeta
3
异常的code
card_products包含api在json响应中返回的值。参见错误代码和消息
资源
库支持以下端点:
<表><广告>客户接受的国家/地区
客户账户持有人组
客户端身份验证控件
客户端.auth_controls.exempt_mids
客户端.自动重新加载
客户余额
客户批量发行
客户业务
客户端.业务(业务令牌).transitions
客户业务(代币).notes
客户卡产品
客户卡
客户卡(令牌).transitions
客户.退款
客户端.按存储容量使用计费(令牌).转换
客户端命令模式
client.commando_modes(token).转换
客户端数字钱包代币
客户端.数字钱包令牌(令牌).转换
客户直接存款
客户.直接存款(代币).transitions
客户直接存款账户
客户费用
客户费转账
客户资金来源
客户.资金来源.地址
客户.资金来源.ach
客户、资金来源、支付卡
客户、资金来源、计划网关
客户、资金来源、计划
client.gpa\u订单
client.gpa\u orders.unloads
客户端.kyc
client.mcc_组
客户.商户
客户、商户(代币)、商店
client.msa_订单
client.msa_orders.unloads
客户.提供订单
客户端.pins
客户端程序传输
客户端程序传输类型
客户端。按"U到U"卡
客户.推送卡.支付
客户.推送卡.支付卡
客户端.实时费用组
客户交易
客户交易(代币).related
客户端用户
客户端.用户(令牌).转换
客户端.用户(令牌).notes
client.velocity-u控件
client.webhooks