在你的网站上添加小组件

Instatus 提供三种在自己网站上展示状态的方式：事件期间弹出的浮动小组件、放在页脚的徽章，以及用于构建自定义小组件的 summary.json 端点。

要添加小组件，请前往 dashboard.instatus.com，选择你的状态页，打开小组件，选择小组件类型并复制代码。

---

如何添加浮动小组件？

1. 在 instatus.com/login 登录 Instatus，然后选择你的状态页。

2. 进入小组件 → Floating。

3. 按你的喜好自定义小组件：

• 背景色
• 前景色
• 小组件相对页面的位置

4. 复制小组件脚本，粘贴到 HTML 页面的 body 中。

---

如何在页脚添加状态徽章？

1. 在 instatus.com/login 登录 Instatus，然后选择你的状态页。

2. 进入小组件 → Badge。

3. 选择浅色或深色模式

4. 选择尺寸（小、中或大） 🤏

5. 把代码嵌入你的 HTML 页面

---

如何构建自定义小组件？

从你的状态页获取 summary.json，即可得到当前状态、进行中的事件和维护等实时数据，用于你自己的小组件：

https://[YOUR-STATUS-PAGE]/summary.json

响应示例：

{
  "page": {
    "name": "Instatus",
    "url": "https://instat.us",
    "status": "HASISSUES"
  },
  "activeIncidents": [
	{
      "name": "We're facing an issue with our API",
      "started": "Sat Jun 11 2022 18:55:50 (Coordinated Universal Time)",
      "status": "INVESTIGATING",
      "impact": "MAJOROUTAGE",
      "url": "https://testing-widget.instatus.com/incident/cl4a"
    }
  ],
  "activeMaintenances": [
    {
      "name": "Database maintenance",
      "start": "Sat Jun 11 2022 18:55:54 (Coordinated Universal Time)",
      "status": "NOTSTARTEDYET",
      "duration": "60",
      "url": "https://testing-widget.instatus.com/maintenance/cl4"
    }
  ]
}

可能的页面状态：

• UP
• HASISSUES
• UNDERMAINTENANCE

可能的事件状态：

• INVESTIGATING
• IDENTIFIED
• MONITORING
• RESOLVED

可能的维护状态：

• NOTSTARTEDYET
• INPROGRESS
• COMPLETED