在进行第一个API调用之前，您需要准备以下内容:
- 客户ID和客户机密:如果您没有这些信息，请联系您的客户代表。
- 证书签名请求(CSR):有关更详细的信息，请参阅证书签名请求:https://developers.188bet金宝搏appadp.com/articles/general/generate-a-certificate-signing-request
指南
使用POSTMAN进行第一个API调用
发表在
2019年11月12日下午5:11
最后修改
2022年12月13日12:47PM
188bet金宝搏appADP版权信息
188bet金宝搏appADP、ADP标志和始终为人们设计是ADP, Inc.的商标。
Windows是微软公司的注册商标。
所有其他商标均为其各自所有者的财产。
版权©2022188bet金宝搏appADP公司。188bet金宝搏appADP所有权和机密-保留所有权利。未经ADP, Inc.明确书面许可，不得以任何格式复制这些材料。188bet金宝搏app
未经ADP, Inc.明确书面许可，不得以任何格式复制这些材料。188bet金宝搏app188bet金宝搏appADP“按原样”提供本出版物，不作任何形式的明示或默示保证，包括但不限于对适销性或适合特定目的的默示保证。188bet金宝搏appADP不对本出版物中可能包含的任何技术不准确或印刷错误负责。此处的信息定期进行更改，此类更改将纳入本出版物的新版本。188bet金宝搏appADP可以对本出版物中描述的产品和/或程序进行改进和/或更改。
发表在
2019年11月12日下午5:11
最后修改
2022年12月13日12:47PM
目录
章1
先决条件
章2
安装和准备邮差
- 安装邮差https://www.getpostman.com/apps
- 使用以下步骤，将您的ADP颁发的. pem文件和. key文件(作为CS188bet金宝搏appR流程的一部分)添加到用于域的Postman中。你可以使用在https://www.getpostman.com/docs/postman/sending_api_requests/certificates
- 单击设置。
- 点击证书并选择CRT文件(证书)密钥文件．然后,单击添加
- 在设置翻到下一页SSL证书验证上。如果没有提示您选择安全套接字层(SSL)证书，并且这是您在此Postman会话中的第一个请求，那么您应该检查以确保您的SSL >证书已正确安装。选择了适当的证书后，在启动新的Postman会话之前，不会再次提示您输入证书。如果您知道您的SSL证书已正确安装，请关闭Postman并打开谷歌Chrome浏览器并再次尝试您的请求。
- (可选)导入ADP api。188bet金宝搏app
Postman允许您存储api集合并与其他人共享。188bet金宝搏appADP将继续在GITHUB上共享样本集合。
例如，您可以通过单击找到ADP Workforce Now集188bet金宝搏app合在这里．到达指定位置后，下载文件并单击进口导入列表文件。
- 单击设置。
章3.
打第一个电话
请求不记名令牌
对ADP api的每个请求都需要附带一个授权标188bet金宝搏app头，该标头包含由ADP安全令牌服务颁发的承载令牌。188bet金宝搏app
在邮差，打开令牌的请求．若要公开标头，请单击头．
如果POST请求成功，您将收到来自服务器的HTTP 200，响应正文中包含您的令牌。复制
access_token价值。
您将收到一个访问令牌作为响应，有效期为一小时。同样可以通过添加以下头文件来进行API调用:
授权:无记名{accessToken}
Postman允许您存储api集合并与其他人共享。188bet金宝搏appADP将继续在GITHUB上共享样本集合。
例如，您可以通过单击找到ADP Workforce Now集188bet金宝搏app合在这里．到达指定位置后，下载文件并单击进口导入列表文件。
使用您的不记名令牌进行API调用
如果已经有一个API集合，可以从集合中选择一个API。下面的示例显示了选择GET HR - Worker (List) API并进行第一次调用。
打开HR >员工(名单)请求并单击头以公开头文件。
将您的记名令牌粘贴到授权标头中，然后单击Send。
请注意记住，在你的代币左边留出一个空间。由于Postman是一个基于浏览器的应用程序，所以浏览器缓存机制将响应保存到缓存中。为了确保您在ADP应用程序中所做的更改反映在Postman中，我们建议188bet金宝搏app在每个请求之间的查询字符串中放置一个cache-buster。
例如,
preventCache =时间戳，其中timestamp是一个唯一的值，例如当前时间。在构建应用程序时不需要这样做，因为基于浏览器的缓存不会发挥作用。如果请求成功，您将在几条记录内收到来自服务器的HTTP 200消息。下面的示例显示了GET HR - Worker (List) API请求的响应:
章4
经常遇到的错误和解决方案
在尝试使用ADP的安全令牌服务进行身份验证时收到HTTP 401错误188bet金宝搏app188bet金宝搏app
错误
当您未能在请求头中提供有效凭据时，ADP安全令牌服务将返回HTTP 401错误188bet金宝搏app。188bet金宝搏app
决议
在联系ADP代表寻求帮助之前，请采取以下建议的故障排除步骤:188bet金宝搏app
- 在将它们发送到授权头之前，请确保在您的开放授权2 (OAuth2)客户端ID和客户端秘密中有base-64编码。
- 确保您也在OAuth2客户端ID和客户端秘密之间使用base-64编码冒号(“:”)。
- 确保在Basic和base-64编码凭证之间有空格。
- 确保在请求中包含adp颁发的SSL证书。188bet金宝搏app
从其他api收到一个HTTP 401错误
错误
当您未能在请求头中提供有效的承载令牌时，将从ADP安全令牌服务以外的api返回HTTP 401错误。188bet金宝搏app188bet金宝搏app
决议
在联系ADP代表寻求帮助之前，请采取以下建议的故障排除步骤:188bet金宝搏app
- 确保已向请求添加了授权标头，以及从ADP安全令牌服务获取的承载令牌。188bet金宝搏app188bet金宝搏app
- 确保在承载者和授权标头中使用的令牌之间有一个空格。
- 检查响应正文是否有“过期令牌”消息。如果该消息出现在响应中，则获取一个新的不记名令牌并重新提交请求应能解决该问题。
收到一个HTTP 403错误
错误
当您提供的承载令牌有效，但您没有被授权访问所请求的资源时，将从服务器返回HTTP 403错误。
决议
首先，确认在请求统一资源指示器(Uniform Resource Indicator, URI)中没有犯错误。如果请求URI正确，请与您的ADP代表联系，请求访问相关URI。188bet金宝搏app
章5
其他有用连结
章6
使用邮差收藏
- 导航到https://github.com/188bet金宝搏appadpllc/marketplace-sample-payloads/tree/master/wfn．
复制整个JavaScript对象表示法(JSON)，如下所示:
选择邮递员>导入标签>粘贴原始文本．
点击进口
章7
步骤2:创建一个连接对象- Python
使用连接工厂根据您的授权类型创建连接
#使用新的配置对象创建一个连接acConnection = ADPAPIConnectionFactory().createConnection188bet金宝搏app(AuthorizationCodeConfiguration)
章8
步骤2:创建一个连接对象- Java
使用连接工厂根据您的授权类型创建连接
//获取AD188bet金宝搏appP连接，使用连接工厂和配置authorizationCodeConnection = (authorizationCodeConnection) CONNECTION_FACTORY_INSTANCE.createConnection(authorizationCodeConfiguration);//从授权连接获取Url authorizationUrl = "redirect:" + authorizationCodeConnection.getAuthorizationUrl();//CALL BACK HANDLER //获取代码值String requestCode = (String) request.getParameter("code ");//映射请求代码到连接配置((AuthorizationCodeConfiguration) AuthorizationCodeConfiguration . getconnectionconfiguration ()).setAuthorizationCode(requestCode);使用POSTMAN进行第一个API调用
最后更新:2022年12月13日
总结本指南概述了如何使用Postman对ADP®进行第一次应用程序编程接口(API)调用。188bet金宝搏app如果您已经熟悉Postman，那么您可以跳过此文档。
下载指南．下载
章1
章2
章3.
章4
章5
章6
