Shopify developers（RESTAPI接口整理）

Shopify developers

作用：

• 解决了许多最困难的商业问题，但每个企业都有其独特的需求。

REST reference（REST参数）

Shopify Payments

Balance（余额）：

• 帐户的当期余额。这个数额包括任何交易尚未包括在支出.

• 检查账户的余额

Dispute（纠纷）：

• 当买方对其金融机构的一项指控的合法性提出质疑

• 争议财产属性（id,order_id(订单id),type(类型：多种类型),currency(货币),amount(金额),reason(原因：多种原因),network_reason_code(网络原因码),status(状态：多种状态),evidence_due_by(提供证据截至时间),evidence_sent_on(发送证据时间),finalized_on(定安的结果)）

Payouts(支出)

• 货币在Shopify国际账户余额和相关银行账户之间的流动。
• 支出属性（id(唯一标识符),status(状态：多种状态),date(日期),currency(货币),amount(金额)）

Transactions(交易)

• 余额交易构成规范的“帐户报表”，或一个Shopify支付帐户的分类账。资金进出账户的每一次流动都记录在这里。
• 交易属性(id,type(类型：多种类型),test(试验),payout_id(支出id),payout_status(支付状态),currency(货币),amount(金额),fee(收费),net(净额),source_id(来源id),source_type(来源类型：多种类型),source_order_transaction_id(源订单交易id),source_order_id(源顺序id),processed_at(处理事务的时间))

Access API（访问API）

AccessScope特性（存储范围）

"access_scopes": [
  {
    "handle": "write_product_listings"
  },
  {
    "handle": "read_shipping"
  }
]

AccessScope（访问范围）

• 查看应用程序安装过程中商家批准的访问范围。

StorefrontAccessToken（店面访问令牌）

• 生成一个访问店面API的店面访问令牌。

• StoreFrontAccessToken属性(id,access_token,access_scope,created_at,title)属性都是只读，但是不受唯一约束

Analytics API（分析报告）

• Shopify Query Language 编写从可用的Shopify架构获取数据的查询。ShopifyQL查询可用于使用ReportAPI发布报表。
• Report 创建、更新和删除显示在Shopify admin的Reports页面上的报表。每个报表都是由使用Shopify查询语言(ShopifyQL)编写的查询生成的。

Shopify查询语言

Analytics API被称为ShopifyQL。有效的ShopifyQL查询由类似于有效SQL请求的部分组成。让我们看一个例子。

SHOW sum(pageview_count) FROM visits SINCE -7d UNTIL -1d

获取数据(显示)

使用ShopifyQL选择、筛选和聚合数据有多种方法。

• 柱：每个模式都由许多列组成。

SHOW utm_campaign_name, utm_campaign_term, utm_campaign_source

• 聚合函数
  • 有一些功能可以帮助收集或汇总数据。
  • sum（总和）
  • min（最小值）
  • max（最大值）
  • count（计数）
  • DISTINCT（行的唯一计数）
  • avg（平均值）

别名

常用的聚合表达式作为命名别名提供。

SHOW total_pageviews VS SHOW sum(pageview_count)

上的命名别名visits模式类型都是number：

• avg_duration avg(持续时间)

• total_pageviews 和(页面浏览计数)

• total_purchases 总金额(购货计数)

• total_sessions 计数(页面浏览计数)

• total_visitors 计数(不同的用户令牌)

SHOW sum(pageview_count) AS pageviews

Aggregate Conditions

类中的条件提供支持。SHOW声明。这些可以用来过滤从包含到聚合函数中的行。聚合条件使在通常需要两个或两个以上的单个查询中返回结果成为可能。

sum(IF page_path == '' THEN pageview_count) AS home_pageviews, sum(IF page_path != '' THEN pageview_count) AS other_pageviews

Selecting schemas (FROM)

模式由关键字选择。FROM。这与