开始使用埃克森美孚API

API已成为许多行业实现业务创新和协作的关键要素。埃克森美孚开发人员中心提供了各种简便易用的资源，便于与我们的客户、供应商和第三方服务提供商共享我们的API。

在埃克森美孚开发人员中心，您可以快速轻松地上手，而且完全免费。本指南提供了您所需要的一切信息。

要访问我们的API规范和文档，您需要在我们的中心创建一个帐户。只需按照以下步骤操作即可： 

1. 点击页面右上角的“注册”。  

2. 输入所需信息。  

3. 浏览并接受埃克森美孚API使用条款。

4. 点击“注册”按钮。

5. 您将收到一封邮件，其中包含激活新账户的链接。请通过此连接设置密码。在激活账户后，您可以参考登录部分的说明访问API开发人员中心。

要访问API开发人员中心，请执行以下操作：

1. 请打开浏览器，输入网址 https://developer.exxonmobil.com，点击“登录”。 

2. 您将被引导至 https://apihub.exxonmobil.com, 请点击“外部用户登录”按钮。

3. 请输入您在创建API开发人员中心账户时提供的电子邮件和密码。

登录后，中心将显示与您的帐户相关的API。

如果没有找到您要查找的特定API，请使用屏幕顶部的搜索栏。 

您可以通过以下方式筛选搜索结果： 

• 类别 一 基于共同特征搜索API。 

• 集合 一 按角色搜索API，例如客户/分销商、服务提供商、原材料供应商等。 

• 标签 一 根据自定义属性搜索API，例如化学品（为埃克森美孚的化工客户、3PSP、供应商等开发的API）、仓库（为仓储服务提供商开发的API）等。

收到搜索结果后，选择一个API来访问文档页面并了解更多信息。 

每个API都有一个文档页面，您可以在其中找到上手所需的大部分信息，包括：

• 导航。

• 端点列表。

• 当前所选端点文档。

• 代码片段（以多种不同的编程语言提供）。

• 示例响应和错误代码。

要在非生产测试环境中连接并测试API，请按照以下步骤请求凭据设置和API令牌。

基本URL为：https://uat.api.ext.exxonmobil.com，所有API请求都必须通过HTTPS和TLS 1.2发出。

步骤1：申请一个调用API的帐户

通过页面右上角的“支持”表单提交请求，并提供以下信息：

• 公司名称：
• 业务联系人姓名/电子邮件：
• IT联系人姓名/电子邮件：

创建帐户后，您将获得以下凭据：

• client_id 和 client_secret，用于调用API

请妥善保管这些凭据！ 不要在源代码中对它们进行硬编码，也不要将它们存储在纯文本中。

步骤2：获取令牌

埃克森美孚API使用“OAuth2客户端凭据授予流”对请求进行身份验证。 成功调用API之前需要访问令牌。

要获取令牌，请调用 https://login.ext.exxonmobil.com/oauth/token，并传递分配给您的帐户的 client_id 和 client_secret。

POST /oauth/token HTTP/1.1
Host: login.ext.exxonmobil.com
Content-Type: application/json
{
“client_id”: “your_account_client_id”,
“client_secret”: “your_account_client_secret”,
“audience”: “https://uat.api.ext.exxonmobil.com”,
“grant_type”: “client_credentials”
}

用于生产环境的 client_id 和 client_secret 将与测试环境的不同。要获取用于生产环境的令牌，请将受众更改为 https://api.ext.exxonmobil.com.

如果调用成功，您可以在HTTP响应中找到access_token。令牌默认将在24小时后过期。令牌过期后，请重复向/oauth/token端点发出请求，以获取全新的访问令牌。

{
“access_token”: “your_access_token”,
“expire_in”: 86400,
“token_type”: “Bearer”
}

步骤3：使用令牌

现在您已经获得了令牌，请使用该令牌向资源发出请求，具体方法是使用Bearer方案来传递Authorization标头。

GET /customer/chem/v1/accounts HTTP/1.1
Host: uat.api.ext.exxonmobil.com
Authorization: Bearer {your_access_token}
Content-Type: application/json
{
“data”: {...}
}

状态代码

API返回以下状态代码。