跳转到主要内容

Python的Zoho API集成

项目描述

简介

mfabrik.zoho 包提供了用于轻松调用Zoho API的Python类。它们允许您将 Zoho网络应用程序数据 集成到您的Python软件中。

特性

  • 创建Zoho API会话(即票据)

  • 使用基类架构扩展API

  • 使用Zoho记录所有传入和传出的API流量

  • 支持Python 2.4、2.5和2.6(2.4需要安装额外的lxml和simplejson库)

  • 与非ASCII或Unicode字母兼容

  • 单元测试以保证代码的高质量

mfabrik.zoho旨在用于机器到机器通信,并将与任何Web框架(如Plone、Django、Google App Engine)一起工作。

要与Zoho通信,您需要用户名、密码和API密钥。有关更多信息,请参阅Zoho应用程序中的设置 > 管理员 > 开发者密钥

API支持

目前开箱即用的支持包括

  • CRM API:insert_records、get_records、delete_lead

您可以使用此库轻松封装所需的Zoho API调用。请为此包贡献补丁。

安装

要将mfabrik.zoho安装到系统范围内的Python,请按以下步骤操作。

示例(UNIX)

sudo easy_install mfabrik.zoho

示例(UNIX,Python 2.4)

sudo easy_install mfabrik.zoho lxml simplejson

用法

要学习如何使用此库,最好是研究其单元测试源代码(tests.py)。

示例用法

# Import CRM connector class
from mfabrik.zoho.crm import CRM
from mfabrik.zoho.core import ZohoException

# Initialize Zoho CRM API connection
# You need valid Zoho credentials and API key for this.
# You get necessary data from Zoho > Setup > Admin > Developer key
crm = CRM(username="myusername", password="foobar", apikey="12312312312312312323")

# Open connection can be used to make as many as possible API calls
# This will raise ZohoException if credentials are incorrect.
# Also IOError or URLError will be raised if you the connection to Zoho servers
# does not work.
crm.open()

# Lead is just a bunch of dictionaried data
# For possible lead parameters see crm.py.

# Zoho default compulsory fields: Last Name, Company

lead = {
    u"First Name" : u"Mikko",
    u"Last Name" : u"Ohtamaa",
    u"Company" : u"mFabrik Research Oy"
}

# Insert a new lead to Zoho CRM lead database.
# We support multiple leads per call, so we need to listify our one lead first.
responses = crm.insert_records([lead]) # This will raise ZohoException if lead data is invalid

# list of responses. one response is {'Modified Time': '2010-10-07 13:24:49', 'Created By': 'Developer', 'Modified By': 'Developer', 'Id': '177376000000253053', 'Created Time': '2010-10-07 13:24:49'}
# At least one response is guaranteed, otherwise an exception is raised

lead_id = responses[0]["Id"]

特殊字段 潜在客户所有者 必须是Zoho CRM用户的注册电子邮件。

日志记录

Python logging 模块中的日志记录器 Zoho API 用于输出 DEBUG 级别的 API 流量。

源代码

商业开发

本软件包采用开源 GPL 许可证。如果您希望将此代码用于商业产品,请重新许可或寻求高质量的 Zoho/Python 支持,请联系 mFabrik Research。我们一流的 Python 开发人员将乐于帮助您进行软件开发。

进一步阅读

作者

mFabrik Research Oy - 可雇佣的 Python 和 Plone 专业人士。

变更日志

1.0.2 - 1.1

  • 将协议更改为 https,根据 Zoho API 的更改 [miohtama]

1.0.1 - 1.0.2

  • 返回 CRM 领先插入 ID 结果 [tco]

1.0 - 1.0.1

  • 修复 MANIFEST.in 文件 - setuptools 默认忽略 docs/ [miohtama]

1.0

  • 初始发布