客户和用户

OAuth范围

名称	允许	范围
客户	调整	store_v2_customers
客户	只读	store_v2_customers_read_only

有关可用身份验证方法的更多信息，请参见身份验证。

什么是客户？

客户是任何在商店购买商品并创建帐户的人。BigCommerce将针对客户的电子邮件地址、客户地址和姓名存储为记录。有两个api可以用来操作客户数据。您可以使用自定义扩展客户记录的数据帐户注册表单字段和客户属性端点(V3)。

客户团体

客户组允许您组织客户，给予他们折扣，并限制对特定产品或类别的访问。有关更多信息，请参阅客户团体。

什么是订阅者？

订阅者是已签署商店的时事通讯的人。注册字段的位置位于大多数店面主题的页脚。

订阅者也可以添加：

• 在结账时注册时事通讯
• 发送一个邮政要求对用户API

在可能的情况下，API表示订户的起源。当客户使用单页结账时为时事通讯注册时，订单ID成为订户记录的一部分。当客户使用优化的单页结账时，客户在退房前成为订阅者，导致没有订单ID的用户记录。

用户和客户

• 订阅者并不总是客户。有人可以注册时事通讯而无需创建帐户。
• 客户并不总是订阅者。注册时事通讯是创建帐户并购买项目的单独行动。
• 客户和用户可以是相同的。如果购物者在店面检查，则创建一个帐户并选择进入时事通讯，他们都是客户和订户。

什么是嘉宾？

店铺设置可以配置为允许购物者在不创建帐户的情况下完成结账。这些购物者不会被捕获为顾客，也不会存储在BigCommerce上。如果希望捕获客户数据，则使用店面API.能帮忙。

客户登录API.

这客户登录API.允许单点登录。一旦客户通过登录到第三方系统（CMS，Portal或App）进行身份验证，您可以使用客户登录API将客户无缝登录到客户的BigCommerce客户帐户。

当前客户的API

这当前客户的API允许您的应用程序识别已登录的客户。当您需要显示特定于客户的信息时，此标识非常有用。

客户API

有两个可用的客户API端点:

• V3客户API
• V2客户API

V3客户API

这V3客户API由客户，客户属性，客户地址和客户表格字段组成。

客户在商店购买并创建一个帐户。客户对象包括客户的地址，属性，表单字段和身份验证。V3客户API可以以更高的效率完成与现有V2客户API相同的任务。

客户属性和客户属性值让您将其他信息存储在客户身上。客户属性定义名称值对的名称和存储的信息类型（例如，“名称”:“鞋码”那“类型”:“数量”）。客户属性值Endpoint允许您定义属性的值。

客户属性与客户单独创建。创建名称和类型后，可以使用名称值对向客户添加属性。

客户地址由客户地址和电话号码组成。客户可以对其存储多个地址。

客户表单字段值是客户地址或客户注册的字段，接受任何字符串数据。例如，注册字段可以具有客户输入批发商ID或者对于地址字段，使它们输入任何特殊的传递指令。有关创建表单字段的详细信息，请参阅帐户注册字段。

您可以使用API​​访问和编辑客户和客户地址记录上的字段的值。

V2客户API

V2客户API由客户、客户地址和客户组组成。客户对象由客户姓名和电话号码等基本客户信息组成。

客户地址由客户的地址和电话号码组成。客户可以对其存储多个地址。

客户团体允许您组织客户，给予他们折扣，并限制对特定产品或类别的访问。V3客户API尚未提供客户组。

V2和V3客户端api的区别

当通过两个API提供资源时，我们建议使用V3客户API作为BigCommerce最终将所有现有的V2资源迁移到V3。

本节将介绍V2和V3客户端api之间的重要区别。

发出请求

V3 Customers API更易于使用。它减少了完成任务所需的API调用的数量。例如，要使用V2 API创建新客户，您必须进行多个API调用。使用V3 API，您可以一步创建客户属性和地址，允许您在一个API调用中批量创建多个客户及其子资源。

创建一个客户

V3上的单个客户:

• /顾客

V2上的单个客户:

• /客户/ {customer_id}
• /客户/ {customer_id} /地址

疑问

使用V3客户API，查询成为一个强大的工具。有一个得到使用过滤器细化请求的每个资源端点。V2 API需要使用不同的端点来获取客户子资源。

获取客户地址

在V3上通过名称和公司获取客户地址：

/客户/地址吗?公司:= bigcommerce commongood&customer_id: in1, 2、3

在V2上通过名称和公司获取客户地址：

/客户/ {customer_id} /地址/ {customer_address_id}

请求

V3的客户邮政和放请求需要一个数组对象。

更新客户(V3版本)

/放置https://api.bigcommerce.com/stores/{store_hash►/ vustomers.

[{“ID”：12.那“电子邮件”：“janedoe.com”那“first_name”：“简”那“last_name”：“母鹿”}]

示例更新客户（V2）

/ put https://api.bigcommerce.com/stores/

{“first_name”：“简”那“电子邮件”：“jane@email.com”那“电话”：“1234567890”}

颠覆

您可以使用V3 Customers APIUpsert客户属性值升级表单字段值和客户属性的操作。Upsert将查找与现有记录匹配的记录，如果有则进行更新。如果不匹配，它将创建一条新记录。

认证对象

V3 Customers API提供了两种设置客户密码的方法:

• 您可以在此下设置新密码身份验证> new_password.A的对象放或邮政请求。
• 若要提示客户重置密码，请设置force_password_reset至真正的在下面身份验证> new_password.A的对象放或邮政请求。

密码确认和验证在V2客户API下仍然可用。

用户API

订阅者API允许您管理注册了商店时事通讯的订阅者。

常问问题

我应该使用哪个API ?

尽可能使用V3客户API，因为BigCommerce最终将弃用现有的V2客户API。

如何验证客户密码？

此时，密码验证仅在V2 Customers API上可用。我们建议使用V3 Customers API重置或输入新密码，因为BigCommerce不建议使用V2 Customers API。

相关资源

文章

• 在帐户注册表单中添加和编辑字段
• 结帐设置

端点

• 客户登录API.
• 当前客户的API
• 客户V3 API
• 客户团体（客户v2 api）
• 密码验证（客户v2 api）
• 密码确认（客户v2 api）
• 店面订阅
• 用户API

人则

• 顾客