nic-api 0.2.1

初始化

要开始使用api，您应该获得一对oauth应用程序登录名和 来自nic.ru的密码。这是注册页： https://www.nic.ru/manager/oauth.cgi?step=oauth.app_register

创建nic_api.DnsApi的实例并提供oauth应用程序 凭证：

fromnic_apiimportDnsApioauth_config={'APP_LOGIN':'your_application_login','APP_PASSWORD':'your_application_secret'}api=DnsApi(oauth_config)

授权

调用authorize()方法并指定用户名和密码 您的nic.ru帐户，以及用于存储OAuth令牌以备将来使用的文件：

api.authorize(username='Your_account/NIC-D',password='Your_password',token_filename='nic_token.json')

现在可以使用api了。

虽然token_filename文件中的令牌是有效的，但您不需要 既不提供用户名也不提供密码来访问api-只需创建 具有相同OAuth配置且仅传递的DnsApi类的实例 token_filename到authorize()方法。

查看服务和DNS区域

在nic.ru中，dns区域位于“services”：

api.services()

通常每个帐户有一个服务。让我们在 服务MY_SERVICE：

api.zones('MY_SERVICE')

始终检查区域之前是否有任何未提交的更改 进行任何修改-您的提交也将应用其他更改！

获取DNS记录

要查看或修改记录，需要同时指定服务和dns 区域名称：

api.records('MY_SERIVCE','example.com')

创建记录

要添加记录，请创建一个$ 子类，即ARecord：

fromnic_api.modelsimportARecordrecord_www=ARecord(name='www',a='8.8.8.8',ttl=3600)

将此记录添加到区域并提交更改：

api.add_record(record_www,'MY_SERVICE','example.com')api.commit('MY_SERVICE','example.com')

删除记录

区域中的每个记录都有一个唯一的ID，可以通过 DNSRecord.id属性。当你拿到身份证后，把它交给 delete_record方法：

api.delete_record(100000,'MY_SERVICE','example.com')api.commit('MY_SERVICE','example.com')

不要忘记总是提交更改！