开放 API

每日一言提供简单的 JSON 接口，任何人（个人学习、小工具、机器人）都可以免费调用，无需注册。
请勿高频恶意请求，也欢迎在作品里标注数据来自 dddn.net 🙌

接口地址：https://dddn.net/api.php

1接口一览

GET ?action=today 获取今日一言（中英对照）。今日还没更新时，会自动返回最近一条并附带提示。

GET ?action=date&date=2026-10-01 按日期查询指定那一天的记录。

GET ?action=history&limit=7 获取最近若干天（最多 30 天）的记录列表。

2请求参数

参数	必填	说明
action	否	取值 `today`（默认）/ `date` / `history`
date	action=date 必填	日期，格式 `YYYY-MM-DD`
limit	否	history 返回条数，默认 7，最大 30

3返回格式

所有响应均为 UTF-8 编码的 JSON：code 为 HTTP 状态码，ok 表示成功与否，数据在 data 里。

{
  "code": 200,
  "ok": true,
  "data": {
    "date": "2026-10-02",
    "zh": "我们牢记使命。",
    "en": "Firmly hold mission in mind."
  },
  "meta": {
    "site": "每日一言",
    "home": "https://dddn.net",
    "serverAt": "2026-10-02T10:00:00+08:00",
    "date": "2026-10-02"
  }
}

接口异常时 ok 为 false，并给出 message：

{
  "code": 404,
  "ok": false,
  "message": "2026-09-31 没有数据",
  "data": null
}

4调用示例

# 今日一言
curl "https://dddn.net/api.php?action=today"

# 指定日期
curl "https://dddn.net/api.php?action=date&date=2026-10-01"

# 最近七天
curl "https://dddn.net/api.php?action=history&limit=7"

fetch('https://dddn.net/api.php?action=today')
  .then(function (res) { return res.json(); })
  .then(function (json) {
    if (!json.ok) throw new Error(json.message);
    console.log(json.data.zh);   // 我们牢记使命。
    console.log(json.data.en);   // Firmly hold mission in mind.
  })
  .catch(console.error);

import requests

r = requests.get('https://dddn.net/api.php', params={'action': 'today'}, timeout=10)
data = r.json()
print(data['data']['zh'], '/', data['data']['en'])

5在线调试

直接在这里请求，看看真实返回（用的是你当前浏览器）。

点击「发送请求」查看结果…

6状态码与调用限制

code	含义	怎么办
200	成功	正常使用 `data`
304	内容未变化	用本地缓存即可
400	参数不对	检查 action / date 格式
404	那天没有数据	换一天，或回退到最近一条
429	请求太频繁	按响应头 `Retry-After` 秒数等待
500	服务器忙	稍后重试

目前限制：每个 IP 每分钟 60 次、每天 2000 次。接口支持跨域（CORS），浏览器里可以直接请求；今日数据会缓存到当天 24:00。

7一点说明

这个 API 由个人业余维护，可能随时因为服务器调整而短暂不可用，请在你的代码里做好失败兜底。
数据每天更新一条，内容来自互联网，仅供学习交流。调用建议加上 User-Agent 注明用途，方便我识别。🤝
合作或建议：1404460018@qq.com