zoukankan      html  css  js  c++  java
  • Apex 的 API 简介

    Salesforce 数据API分类

    Salesforce中提供了四种数据API接口。数据API接口为开发者提供了操作Salesforce数据的能力。它们分别是:

    • REST API:依据RESTful方法对数据进行新建、读取、更新、删除(CRUD)处理。REST API支持JSON和XML格式。REST API是轻量级的API,适用于处理网络应用或移动应用中。
    • SOAP API:基于SOAP协议,使用WSDL格式的文件处理数据。只支持XML格式。适用于服务器之间的通信。
    • Bulk API:是一种特殊定制的REST API,针对大批量数据(50000条记录或更多)的处理有更好的效果。
    • Streaming API:适用于当数据发生变化时发送提示消息。

    启用API权限

    要使用API,需要在用户的简档中,将“已启用 API”(API Enabled)复选框勾选。

    API限制

    Salesforce中有两种API限制。“并发限制”限制了同时运行的持续时间高于20秒的API请求的数量,“数量限制”限制了24小时之内运行的API请求的总数。

    要查看可运行的API的剩余数量,可以在设置界面中搜索“系统概览”,打开“系统概览”页面。在“API 使用情况”部分可以查看最近24小时之内运行的API数量,和最多允许的数量。

    系统概览界面

    要设定API的使用通知,可以在设置界面中搜索“API 使用通知”,打开“所有API 使用通知”界面。点击“新建”按钮即可新建API使用通知,当API使用数量达到一定的阈值时,会自动发送邮件通知相关的用户。

    编辑API使用通知界面

    生成API WSDL文件

    在设置界面下,搜索“API”,点击“开发”菜单项下面的“API”链接,进入“API WSDL”页面。

    API WSDL界面

    在此页面中,可以生成和下载各种WSDL和客户端证书,供API开发者使用。

    比如:

    • 点击“生成企业 WSDL”链接,在显示的窗口中点击“Generate”按钮,即可得到一个WSDL文件
    • 在SoapUI中使用此文件新建项目,即可建立与相应Salesforce系统的API通信
    • 开发者可以使用“login”操作来进行登录请求。注意,在Salesforce登录时,密码的部分需要输入密码和安全口令(Security Token)。比如密码是“123”,安全口令是“abc”,那么在“”标签中需要输入“123abc”。示例如下:
    <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:enterprise.soap.sforce.com">
       <soapenv:Header>
          <urn:LoginScopeHeader>
             <urn:organizationId></urn:organizationId>
             <!--Optional:-->
             <urn:portalId></urn:portalId>
          </urn:LoginScopeHeader>
       </soapenv:Header>
       <soapenv:Body>
          <urn:login>
             <urn:username>用户名</urn:username>
             <urn:password>密码和安全口令</urn:password>
          </urn:login>
       </soapenv:Body>
    </soapenv:Envelope>
    
    • 在登录成功后,系统会生成会话ID(在“”标签中)和服务器URL(在“”标签中)。开发者需要记录下它们,以便于在以后的其他请求中使用
    • 开发者可以使用比如“create”等操作来对各种对象进行操作请求。在相应的标签中输入相应的值,并且在对应的标签中输入之前的会话ID或服务器URL,即可发送请求,完成操作

    企业WSDL和合作伙伴WSDL的区别

    Salesforce中最经常使用的是两种WSDL:

    • 企业WSDL(Enterprise WSDL)
    • 合作伙伴WSDL(Partner WSDL)

    它们有以下特点:

    1. 企业WSDL是强类型的,它和特定的某个Salesforce组织紧密联系在一起。当此Salesforce组织被修改之后,比如自定义字段、对象被修改,生成的企业WSDL也会不同
    2. 合作伙伴WSDL是弱类型的,不和特定的Salesforce组织联系在一起,所以当Salesforce组织被修改之后,不会生成不同的合作伙伴WSDL

    如果开发者需要通过API对某个特定的Salesforce组织进行CRUD操作,则使用企业WSDL。如果对多个Salesforce组织进行操作,则使用合作伙伴WSDL。

  • 相关阅读:
    [转载]重构代码的7个阶段
    查看JDK源码
    敏捷结果30天之第七天:设定边界值和缓冲
    敏捷结果30天之第十一天:高效能、慢生活
    他们到底需要神马???——戏说“用户需求”
    敏捷结果30天之第一天:总体认识敏捷结果方法
    敏捷结果30天之第五天:使用热图标识出重要事情
    重构代码学习笔记一:重构的原则
    开发可统计单词个数的Android驱动程序(2)
    使用Android NDK和Java测试Linux驱动
  • 原文地址:https://www.cnblogs.com/chengcheng0148/p/apex_api_basic.html
Copyright © 2011-2022 走看看