利用 IBM WebSphere Cast Iron Web API Services,您只需点击几下就可以组装和显示 API。您还可以通过所提供的分析法来分析您的 Web API 的使用情况,并利用社区挂钩在品牌化的开发人员门户中将 Web API 社区社交化。
Web API 是一个快速增长的业务渠道,可帮助您的企业进入新的市场,并吸引新的客户与合作伙伴。它们还可以帮助您从大型开发人员社区中挖掘创新,而不仅仅是在您的公司的开发人员中挖掘创新。
由于 Web API 显示关键的业务资产和服务(如产品目录或电话清单),所以它们就像是您的企业的外部人员。它们应该是自我描述性,并且简单易用。它们也应该使用 Representational State Transfer (REST) 架构风格,这样就可以很容易地从浏览器或移动设备调用它们。
利用 IBM WebSphere Cast Iron Web API Services,您只需点击几下就可以组装和显示 API。您还可以通过所提供的分析法来分析您的 Web API 的使用情况,并利用社区挂钩在品牌化的开发人员门户中将 Web API 社区社交化。本文指导您逐步使用 IBM WebSphere Cast Iron Web API 来创建一个 Web API,并通过调用该 Web API 来创建 Salesforce.com 客户关系管理系统 (CRM) 中的联系人。
先决条件
本文的主要目标是 API 开发人员。本文包含了创建一个示例 Web API 的详细步骤,因此,即使是初学者也应该能够完成它。然而,JavaScript Object Notation (JSON) 和 REST 的先验知识将有助于增加对材料的理解。
为了实现本文中的示例,您需要:
一个工作站,含一个标准 Internet 浏览器(Google Chrome 18 或更高版本、Mozilla Firefox 10 或更高版本,或 Internet Explorer®9 或更高版本)
一个 Internet 连接
一个有效的 Cast Iron Web API 管理 ID 和登录凭据(您可以 注册一个免费试用版本)
一个有效的 Salesforce.com 帐户和登录凭据(您可以 注册一个开发人员帐户)。
创建和测试 Web API
想象一下,有一家企业使用 Salesforce.com 存储其 CRM 信息,但只有公司的员工才可以访问这些信息。该企业希望显示一个 Web API,让应用程序开发人员能够创建可以访问 Salesforce.com 环境的创新型移动应用程序。例如,他们可以创建一个应用程序,如果客户希望销售代表联系他们,就可以将自己的联系方式直接添加到 Salesforce.com。为了实现此功能,请按照本文中提供的分步说明来创建一个 Salesforce.com Web API 并进行测试,这个 Web API 显示了一个名为 create_contact的资源。
在浏览器中打开 https://webapi.castiron.com,启动 Cast Iron Web API Services。
单击右上角的 Sign In,在窗口中输入您的凭据,然后单击 Sign In,如 图 1所示。
图 1. 登录到 Cast Iron Web API Services
在 Getting Started with Web API页面上,单击顶部的 Create或 APIs菜单项,以创建一个新的 API,如 图 2所示。
图 2. 创建一个新的 API
在 Create new API框中,输入 API 名称为 Salesforce.com,上下文为 salesforce,还有描述是 API to expose Salesforce.com objects,如 图 3和 图 4所示。
请注意,API 的 Uniform Resource Indicator (URI) 显示在 Create new API方框的底部。URI 的格式为:
https://<company>.web.castiron.com/<context>,
其中 <company>是您的 Web API 公司名称,<context>是您刚才输入的上下文。
单击 Create。