管理API.
构建应用程序
快速启动
指导
教程
建筑渠道
快速启动
指导
教程
建筑店面
管理货币
指导
合作伙伴信息
成为合作伙伴
入门
POS解决方案
ERP解决方案
PIM解决方案
OMS的解决方案
营销解决方案
运输解决方案
付款解决方案

客户和用户

OAuth范围

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

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

什么是客户?

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

客户团体

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

客户群按计划

客户组仅在特定计划上提供。看BigCommerce定价了解更多。

什么是订阅者?

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

订阅者也可以添加:

  • 在结账时注册时事通讯
  • 发送一个邮政要求对用户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允许您定义属性的值。

名称 - 值对

每个客户最多可以存储50个名称-值对。

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

客户地址包括客户地址和电话号码。客户可以对其存储多个地址。

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

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

V2客户API

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

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

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

V2和V3客户api的区别

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

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

发出请求

V3客户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客户APIUpsert客户属性值插入表单字段值和客户属性的操作。Upsert查找与现有记录的匹配,如果存在的话,则进行更新。如果没有匹配,它将创建一个新记录。

认证对象

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

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

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

用户API

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

常问问题

我应该使用哪种API ?

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

如何验证客户密码?

密码验证目前仅在V2客户API上可用。我们建议使用V3客户API重置或输入新密码,因为BigCommerce打算弃用V2客户API。

相关资源伟德棋牌大全

文章

端点

人则