这是Pythonic API设计策略吗?
作者:互联网
这是我要问的问题的前奏:我已经为我的公司用Python构建了一个与网关无关的支付API.目前我只编写代码来支持Authorize.net,并希望从Python程序员那里得到一些关于我的API设计清晰度的反馈,比我有更多的经验.
我选择自己滚动,因为存在的其他包更像是一个想法或特定于Authorize.net(我想编写一个更通用的包具有更清晰的界面).我特别从一个包中得到了一些灵感(pythorize),但不喜欢他们的API.
在我开始描述我正在做的事情之前,这里是包的bitbucket上公共存储库的链接:paypy(注意那些可能想要使用它的人:代码是稳定的,但文档严重缺乏).
我当前的策略是使用嵌套字典并将其传递给付款方法类的构造函数.在Authorize.net CIM API上创建新用户配置文件的示例:
>>> options = {'tran_key' : 'test_tran_key',
... 'login' : 'developer_login',
... 'testing' : True,
... 'validation': 'testMode',
... 'customer': {'description': 'Some description of the customer profile',
... 'id' : 22,
... 'email' : 'johnny_doe@gmail.com'},
... 'billing': [{'type': 'individual',
... 'profile': {'city' : 'Carlsbad',
... 'state' : 'California',
... 'zip' : '92009',
... 'firstname' : 'John',
... 'address' : '12 Alicante Rd. Suite 9',
... 'lastname' : 'Doe',
... 'country' : 'USA',
... 'phone' : '(858) 557-2674'},
... 'payment': {'card': {'ccv' : '524',
... 'number' : '4111111111111111',
... 'expiration' : '2014-04'}}},
... {'type' : 'individual',
... 'profile' : {'city' : 'Las Vegas',
... 'state' : 'Nevada',
... 'zip' : '79112',
... 'firstname' : 'John',
... 'address' : '78 Cloud Front',
... 'lastname' : 'Doe',
... 'country' : 'USA',
... 'phone' : '(858) 557-2674'},
... 'payment': {'card': {'ccv' : '499',
... 'number' : '4111111111111111',
... 'expiration' : '2012-11'}}},
... {'profile': {'city' : 'Carlsbad',
... 'state' : 'California',
... 'zip' : '92009',
... 'firstname' : 'John',
... 'address' : '12 Alicante Rd. Suite 9',
... 'lastname' : 'Doe',
... 'company' : 'Xmarks',
... 'country' : 'USA',
... 'phone' : '(858) 557-2674'},
... 'payment': {'bank': {'name_on_account' : 'John Doe',
... 'account' : '829330184383',
... 'type' : 'checking',
... 'name' : 'Bank of America',
... 'routing' : '122400724'}}}],
... 'shipping': [{'city' : 'Carlsbad',
... 'state' : 'California',
... 'zip' : '92009',
... 'firstname' : 'John',
... 'address' : '12 Alicante Rd. Suite 9',
... 'lastname' : 'Doe',
... 'country' : 'USA',
... 'phone' : '(858) 557-2674'}]}
>>> profile = Profile(options)
>>> result = profile.create()
>>> result.code
'I00001'
>>> print 'Customer Profile ID:' + str(result)
Customer Profile ID: 2758851
>>> print 'Customer Payment Profile IDs:' + repr(result.payment_ids)
Customer Payment Profile IDs: ['2380878', '2380879', '2380880']
>>> print 'Customer Shipping Profile IDs:' + repr(result.shipping_ids)
Customer Shipping Profile IDs: ['2427568']
>>>
>>>
>>> options = {'id' : str(result),
... 'tran_key' : '86U5pvA9TcxZ5b8D',
... 'testing' : True,
... 'login' : '5b3PhGX68'}
>>> profile = Profile(options)
>>> result = profile.remove()
>>> result.code
'I00001'
>>> ^D
你会注意到我为结果对象使用了几种魔术方法(比如str等).我也使用AIM和ARB方法的字典策略,并认为这是向支付API传达“选项”的最简单方法 – 因为在某些时候会有适用于GoogleCheckout,Paypal等的适配器……
另一个想法是使用描述符和对象而不是字典来将选项数据传递给适配器.
与所有支付网关API(特别是PayPal和Authorize.net)一样,接口往往有点凌乱,并且没有任何标准化,因此很难避免某些与网关相关的选项.
解决方法:
深深嵌套的词典在Python中可能并不少见,也许它们可能是“Pythonic”,但它确实不是一个好主意,所以我声称它不是Pythonic.
我会做一个嵌套的类的层次结构.这将更加清晰,IMO,并且还有使您能够进行类型检查的好处.
事实上,我可能会使用一些模式模块来做到这一点.
那你怎么输入这些数据呢?人们合理地不应该键入Python代码,对吧?
标签:python,api,payment-processing,authorize-net 来源: https://codeday.me/bug/20190630/1340855.html