KPLC Token Lookup Tool

一个用于检索肯尼亚电力 (KPLC) 预付费代币购买记录和洞察的开放 API

- Web 界面: https://denniskabui.com/projects/my-kplc-token/ - API 参考: https://denniskabui.com/projects/my-kplc-token/docs.html

---

## 概述 一个自托管的 Web 界面和公开 API，用于检索肯尼亚电力 (KPLC) 预付费代币购买记录和交易洞察。 通过分析官方 KPLC Android 应用程序的网络交互，本项目为电表代币数据提供了一个易于访问的 REST API 和交互式仪表板。 ## 功能特性 - 检索指定电表号的完整代币购买记录 - 每笔交易的成本和单位细分 - AI 驱动的成本构成细分 - 用于集成的公开 REST API - 浏存电表号的浏览器持久化存储 - 适用于桌面和移动端的响应式 UI ## API 参考 ### 基础 URL ``` https://denniskabui.com/projects/my-kplc-token ``` ### 1. 获取代币记录 返回指定电表的历史代币交易列表。 **端点** ``` GET /api/tokens/:meter ``` - `meter` - 字符串 (必填): - 预付费电表号 (例如, `54601446543`) **示例请求** ``` curl -X GET "https://denniskabui.com/projects/my-kplc-token/api/tokens/54601446543" \ -H "Accept: application/json" ``` **示例响应** ``` { "success": true, "data": [ { "trnTimestamp": 1709280000000, "trnAmount": "500.00", "trnUnits": "18.50", "tokenNo": "1234-5678-9012-3456-7890", "recptNo": "RCT123456", "pMethod": "Cash", "concepts": [ { "codConcept": "RESSTEP0", "amount": 300.00 }, { "codConcept": "RESSTEP0TAX", "amount": 80.00 } ] } ] } ``` ### 2. 生成 AI 解释 分析特定交易的成本细分并获得通俗语言的解释。 **端点** ``` POST /api/explain ``` **示例请求** ``` curl -X POST "https://denniskabui.com/projects/my-kplc-token/api/explain" \ -H "Content-Type: application/json" \ -d '{ "amount": "500", "units": "18.5", "date": "15/12/2024", "breakdown": [ { "codConcept": "RESSTEP1", "amount": 300 }, { "codConcept": "RESSTEP0TAX", "amount": 80 } ] }' ``` **示例响应** ``` { "success": true, "explanation": "Mwananchi, you paid KES 500. About 40% of this went to taxes. Verdict: High Tax/Deductions." } ``` ## 快速开始 1. 在浏览器中打开实时门户。 2. 输入有效的 11 位预付费电表号。 3. 查看购买记录和可视化细分。 4. 使用 API 进行自动化或集成。 ## 前端技术栈 * HTML5, CSS3, JavaScript * jQuery (用于 DOM 处理和请求) * Chart.js (用于数据可视化) * Remix Icons (用于 UI 符号) * Google Fonts (Outfit, JetBrains Mono) * LocalStorage (用于持久化客户端数据) ## 数据处理与隐私 * 无用户账户或服务器端个人数据存储 * 电表号保存在用户浏览器的本地 * API 以只读模式运行，转播可公开访问的信息 ## 限制 * 依赖于上游 KPLC 服务 * 响应仅限于通过逆向工程源可获得的数据 * 如果 KPLC 更改实施细节，API 可能会失效

标签：AI分析, API集成, HTTP请求, IP 地址批量处理, KPLC, Linux取证, REST API, Token查询, Web工具, 云资产清单, 代码示例, 仪表盘, 公共事业, 可观测性, 后端开发, 开源, 数据分析, 数据可视化, 电费账单, 移动应用分析, 肯尼亚电力, 能源管理, 自托管, 购电记录查询, 费用明细, 逆向工程, 预付费电表