From 20d3a1a7a5d0d16963b67c4ed2b5d7d87ef29494 Mon Sep 17 00:00:00 2001
From: MoeFurina <noreply@focalors.ltd>
Date: Wed, 22 Jul 2026 20:07:08 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=E8=8E=B7=E5=8F=96?=
 =?UTF-8?q?=E5=85=8D=E8=B4=B9=E5=90=AC=E5=B8=82=E5=9C=BA=E7=8A=B6=E6=80=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 module/ad_listening_rights.js | 13 +++++++++++++
 public/docs/home.md           |  8 ++++++++
 2 files changed, 21 insertions(+)
 create mode 100644 module/ad_listening_rights.js

diff --git a/module/ad_listening_rights.js b/module/ad_listening_rights.js
new file mode 100644
index 0000000..6fd20fa
--- /dev/null
+++ b/module/ad_listening_rights.js
@@ -0,0 +1,13 @@
+// 获取免费听时长状态
+
+const createOption = require('../util/option.js')
+module.exports = (query, request) => {
+  const data = {
+    entrance: 'FREE_LISTEN_RN',
+  }
+  return request(
+    `/api/ad/homepage/free/tab/extend/v2`,
+    data,
+    createOption(query, 'xeapi'),
+  )
+}
diff --git a/public/docs/home.md b/public/docs/home.md
index c42a756..91970a4 100644
--- a/public/docs/home.md
+++ b/public/docs/home.md
@@ -5510,6 +5510,14 @@ let data = encodeURIComponent(
 
 **调用例子 :** `/ad/listening/rights/gain`
 
+### 获取免费听时长状态
+
+说明 : 登录后调用此接口, 获取免费听剩余时长
+
+**接口地址 :** `/ad/listening/rights`
+
+**调用例子 :** `/ad/listening/rights`
+
 ### 云小编 - 获取用户详情
 
 说明: 登录后调用此接口, 获取云小编用户详情