---
title: "查询店铺操作日志总数"
description: "查询店铺一定时间范围内的操作日志计数。你可以使用操作时间、资源类型、事件类型进行过滤查询。"
doc_type: openapi
doc_category: openapi
doc_version: v20270301
source_url:
html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-rest-api/store/get-store-operation-log-count'
md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-rest-api/store/get-store-operation-log-count.md'
---
# 查询店铺操作日志总数
查询店铺一定时间范围内的操作日志计数。你可以使用操作时间、资源类型、事件类型进行过滤查询。
- **Base URL:** `https://{handle}.myshopline.com/admin/openapi`
- **Required Scopes:** `read_store_log`
- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** RESTful
## Endpoint
```http
GET /store/operation_logs/count.json
```
## Base URL
* `https://{handle}.myshopline.com/admin/openapi`
* `{handle}`: `handle` ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 `open001.myshopline.com` 的店铺，其 `handle` 是 `open001` 。
## Required Permissions
* `read_store_log`
## Request
### Query Parameters
* `subject_type`
string (optional)
资源类型。有效枚举值包含：
- `inventory`：库存管理
- `collections`：分类管理
- `products`：商品管理
- `domain_management`：网址设定
- `checkout_settings`：结账设置
- `payment_settings`：付款设定
- `basic_settings`：基本资料
- `administrator_roles_and_permissions`：管理员和权限
- `plan`：套餐
- `customer_account_settings`：客户设定
- `notification_settings`：通知设定
- `store_design`：店铺设计
- `pages`：自定义页面
- `navigation`：菜单导航
- `blog`：博客
- `orders`：订单
- `draft_order`：草稿单
- `abandoned_checkouts`：弃单
- `automatic_discounts`：自动折扣
- `discount_codes`：折扣码
- `customers`：客户
- `home`：首页
- `one_page_store`：一页商店
- `store_management_list`：店铺管理列表
- `language`：修改默认语言
* `verb`
string (optional)
事件类型。其枚举值范围取决于 `subject_type`。例如，当操作为创建新的商品，对应的 `subject_type` 为 `products`，`verb` 为 `add_new_product`。`verb` 与 `subject_type` 的枚举值及对应关系参考 [verb](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/references/verb.md)。
* `created_at_max`
string (required)
操作日志结束的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。
* `created_at_min`
string (required)
操作日志开始的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。
### Request Headers
* `Content-Type`
string (required)
字段值固定为 `application/json; charset=utf-8`。
* `Authorization`
string (required)
资源的访问令牌。参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。
## Response
### Status Codes
* `200`
更多状态码信息，参考 [HTTP 状态码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/http-status-code.md?lang=zh-hans-cn)。
* `401`
* `429`
### Response Headers
* `traceId`
请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。
### Response Body
#### 200
* `data`
object
响应数据体。
* `count`
long
操作日志计数。
#### 401
* `errors`
string
错误描述。
#### 429
* `errors`
string
错误描述。
## OpenAPI Definition
```json
{
"tags": [
"查询店铺操作日志总数"
],
"description": "查询店铺一定时间范围内的操作日志计数。你可以使用操作时间、资源类型、事件类型进行过滤查询。",
"externalDocs": {
"description": "接口使用的权限点: `read_store_log` ，更多权限点使用信息，请参考:",
"url": "ec20/3cv5d7wpfgr6a8z5/xabczf5442284vkq?lang=zh-hans-cn",
"errorTableDescription": ""
},
"operationId": "XgJHy1qU",
"parameters": [
{
"name": "subject_type",
"in": "query",
"description": "资源类型。有效枚举值包含：\n- `inventory`：库存管理\n- `collections`：分类管理\n- `products`：商品管理\n- `domain_management`：网址设定\n- `checkout_settings`：结账设置\n- `payment_settings`：付款设定\n- `basic_settings`：基本资料\n- `administrator_roles_and_permissions`：管理员和权限\n- `plan`：套餐\n- `customer_account_settings`：客户设定\n- `notification_settings`：通知设定\n- `store_design`：店铺设计\n- `pages`：自定义页面\n- `navigation`：菜单导航\n- `blog`：博客\n- `orders`：订单\n- `draft_order`：草稿单\n- `abandoned_checkouts`：弃单\n- `automatic_discounts`：自动折扣\n- `discount_codes`：折扣码\n- `customers`：客户\n- `home`：首页\n- `one_page_store`：一页商店\n- `store_management_list`：店铺管理列表\n- `language`：修改默认语言",
"style": "form",
"explode": true,
"schema": {
"name": "subject_type",
"description": "资源类型。有效枚举值包含：\n- `inventory`：库存管理\n- `collections`：分类管理\n- `products`：商品管理\n- `domain_management`：网址设定\n- `checkout_settings`：结账设置\n- `payment_settings`：付款设定\n- `basic_settings`：基本资料\n- `administrator_roles_and_permissions`：管理员和权限\n- `plan`：套餐\n- `customer_account_settings`：客户设定\n- `notification_settings`：通知设定\n- `store_design`：店铺设计\n- `pages`：自定义页面\n- `navigation`：菜单导航\n- `blog`：博客\n- `orders`：订单\n- `draft_order`：草稿单\n- `abandoned_checkouts`：弃单\n- `automatic_discounts`：自动折扣\n- `discount_codes`：折扣码\n- `customers`：客户\n- `home`：首页\n- `one_page_store`：一页商店\n- `store_management_list`：店铺管理列表\n- `language`：修改默认语言",
"type": "string"
},
"examples": {
"查询店铺一定时间范围内的操作日志计数": {
"value": "products"
}
}
},
{
"name": "verb",
"in": "query",
"description": "事件类型。其枚举值范围取决于 `subject_type`。例如，当操作为创建新的商品，对应的 `subject_type` 为 `products`，`verb` 为 `add_new_product`。`verb` 与 `subject_type` 的枚举值及对应关系参考 [verb](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/references/verb.md)。",
"style": "form",
"explode": true,
"schema": {
"name": "verb",
"description": "事件类型。其枚举值范围取决于 `subject_type`。例如，当操作为创建新的商品，对应的 `subject_type` 为 `products`，`verb` 为 `add_new_product`。`verb` 与 `subject_type` 的枚举值及对应关系参考 [verb](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/references/verb.md)。",
"type": "string"
},
"examples": {
"查询店铺一定时间范围内的操作日志计数": {
"value": "add_new_product"
}
}
},
{
"name": "created_at_max",
"in": "query",
"description": "操作日志结束的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。",
"required": true,
"style": "form",
"explode": true,
"schema": {
"name": "created_at_max",
"description": "操作日志结束的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。",
"type": "string"
},
"examples": {
"查询店铺一定时间范围内的操作日志计数": {
"value": "2024-08-31T10:00:00+08:00"
}
}
},
{
"name": "created_at_min",
"in": "query",
"description": "操作日志开始的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。",
"required": true,
"style": "form",
"explode": true,
"schema": {
"name": "created_at_min",
"description": "操作日志开始的时间和日期。格式：[ISO 8601](https://en.wikipedia.org/wiki/ISO_8601)。
例子：`2023-04-12T22:59:52+08:00`。",
"type": "string"
},
"examples": {
"查询店铺一定时间范围内的操作日志计数": {
"value": "2024-08-01T10:00:00+08:00"
}
}
},
{
"name": "Content-Type",
"in": "header",
"description": "字段值固定为 `application/json; charset=utf-8`。",
"required": true,
"schema": {
"name": "Content-Type",
"type": "string",
"example": "application/json; charset=utf-8"
}
},
{
"name": "Authorization",
"in": "header",
"description": "资源的访问令牌。参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。",
"required": true,
"style": "string",
"schema": {
"name": "Authorization",
"description": "资源的访问令牌。参考 [应用授权](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/app-authorization.md?lang=zh-hans-cn) 获取访问令牌，然后将获取到的访问令牌以 Bearer 格式传入。",
"type": "string",
"example": "Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA"
},
"example": "Bearer eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9.eyJhcHBJZCI6MCwiYXBwS2V5IjoiNzU2ZjI1NWE2NjdlZTcwNTk1MzM0ZjVjYzk4NzU5MzBmN2E3NGZjMSIsImV4cCI6MTg3OTQ4MjA3NiwiaXNzIjoieXNvdWwiLCJzZWxsZXJJZCI6IjIwMDAyMzQ4ODAiLCJzdG9yZUlkIjoiMTY3MjM2OTcyOTYwNiIsInRpbWVzdGFtcCI6MTc4NDc4NzY3NjY2MSwidmVyc2lvbiI6IlYyIn0.3ZzbGAH4cLU1QR2VPEvMOQInUDvus-C4amkINSQIPuNVlXsFKj0sAt1c0KnUy9MWUOFV9cHlkf7J90r2y1FzpA"
}
],
"responses": {
"200": {
"description": "更多状态码信息，参考 [HTTP 状态码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/http-status-code.md?lang=zh-hans-cn)。",
"headers": {
"traceId": {
"description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。"
}
},
"content": {
"application/json": {
"schema": {
"name": "body",
"type": "object",
"properties": {
"data": {
"name": "data",
"description": "响应数据体。",
"type": "object",
"properties": {
"count": {
"name": "count",
"description": "操作日志计数。",
"type": "long"
}
},
"example": {
"count": null
}
}
},
"example": {
"data": {
"count": null
}
}
},
"examples": {
"查询店铺一定时间范围内的操作日志计数": {
"description": "查询店铺一定时间范围内的操作日志计数。",
"value": {
"data": {
"count": 2
}
}
}
}
}
}
},
"401": {
"headers": {
"traceId": {
"description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。"
}
},
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"errors": {
"description": "错误描述。",
"type": "string"
}
},
"required": [
"errors"
]
}
}
}
},
"429": {
"headers": {
"traceId": {
"description": "请求的全局唯一标识符。用于追踪请求在系统中的流转，以便于问题发生时进行定位和调试。"
}
},
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"errors": {
"description": "错误描述。",
"type": "string"
}
},
"required": [
"errors"
]
}
}
}
}
},
"security": [
{
"oauth2": []
}
],
"method": "get",
"path": "/store/operation_logs/count.json",
"servers": [
{
"url": "https://{handle}.myshopline.com/admin/openapi",
"variables": {
"handle": {
"default": "openapiceshidianpu",
"description": "`handle` ：店铺的唯一标识符，值为店铺域名的前缀。例如，域名为 `open001.myshopline.com` 的店铺，其 `handle` 是 `open001` 。"
}
}
}
],
"info": {
"title": "查询店铺操作日志总数",
"version": "v20270301"
},
"authIndexes": [
"read_store_log"
]
}
```