> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取最新的 AI 活动洞察

> GET /user-logs/activity-insight/

在**管理 API** 主机 (`api.scanova.io`) 上获取账户最近一次的每周活动洞察，使用您的原始管理 API 密钥进行身份验证。

```
GET https://api.scanova.io/user-logs/activity-insight/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/user-logs/activity-insight/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 55,
    "period_start": "2026-08-31",
    "period_end": "2026-09-06",
    "ai_response": {
      "summary": ["You created 6 QR codes this week, up from an average of 2."],
      "insights": ["A shared user (member@scanova.io) logged in for the first time this week."],
      "anomalies_explained": ["QR creation spiked mid-week, likely tied to a new campaign."],
      "recommendations": ["Consider tagging the new QR codes for easier filtering later."]
    },
    "total_tokens": 412,
    "generated_at": "2026-09-07T02:15:03Z"
  }
  ```
</ResponseExample>

<Note>
  洞察是按每周计划带外生成的，而非按请求实时生成 —— 此端点始终返回最近生成的一条，忽略任何 id。如果该账户尚未生成任何洞察（例如全新账户，或首次每周任务尚未运行），则返回 `404`。
</Note>

如果当周没有发生值得关注的事情，`ai_response` 会退回到基于模板的（非 AI 生成的）摘要，而不会调用底层模型 —— `total_tokens: 0` 表示这是基于模板的响应；非零值则表示确实由 AI 生成。

## 相关内容

* [获取每日活动统计](/zh/api-reference/management-api/user-logs/activity-summary) —— 此洞察所基于的原始数据。
* [管理 API 概述](/zh/api-reference/management-api/overview) —— 适用于此端点的身份验证方案和配额规则。


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /user-logs/activity-insight/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /user-logs/activity-insight/:
    get:
      summary: Get the latest AI activity insight
      description: >-
        The most recent weekly AI-generated (or templated, if nothing notable
        happened) summary of account activity. Generated out-of-band on a weekly
        schedule, not on request — `404` if none has been generated yet.
      operationId: getActivityInsight
      responses:
        '200':
          description: The latest insight.
          content:
            application/json:
              example:
                id: 55
                period_start: '2026-08-31'
                period_end: '2026-09-06'
                ai_response:
                  summary:
                    - You created 6 QR codes this week, up from an average of 2.
                  insights:
                    - >-
                      A shared user (member@scanova.io) logged in for the first
                      time this week.
                  anomalies_explained:
                    - >-
                      QR creation spiked mid-week, likely tied to a new
                      campaign.
                  recommendations:
                    - >-
                      Consider tagging the new QR codes for easier filtering
                      later.
                total_tokens: 412
                generated_at: '2026-09-07T02:15:03Z'
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````