NO. OJBK-DEV / 长期有效二〇二六年八月四日
OJBK.DEV

没毛病认证中心 · 综合受理

徽章 & 接口

伍 · BADGE

生成一枚长得像 CI 徽章的东西,贴进你自己的 README。
没有构建、没有检查、没有任何依据 —— 它只是说这玩意 ojbk。

这段代码 ojbk
颜色
来点现成的
Markdown
![这段代码](https://ojbk.dev/b/%E8%BF%99%E6%AE%B5%E4%BB%A3%E7%A0%81.svg)
HTML
<img src="https://ojbk.dev/b/%E8%BF%99%E6%AE%B5%E4%BB%A3%E7%A0%81.svg" alt="这段代码">
直接就是图片地址
https://ojbk.dev/b/%E8%BF%99%E6%AE%B5%E4%BB%A3%E7%A0%81.svg

徽章接口

GET /b/

不用这个页面也行,URL 自己拼就完了:

GET https://ojbk.dev/b/<左边文案>.svg
参数默认说明
msgojbk右边那半截的文案,最长 24 字
color4c1右边底色。六位/三位十六进制,或 green red blue orange yellow black 这些名字
labelColor555左边底色,同上
styleflat给 flat-square 就是方角

左边文案最长 40 字,超了会被截断。缓存是浏览器一天、边缘一周 —— 改了文案看不到变化的话,是 GitHub 的图片代理在缓存,换个文案就行。

玄学发版接口

GET /api/ok

让玄学替你决定今天能不能发版。一天一签,全网一致,跟老黄历对得上。周五永远是否 —— 这是唯一的硬规则。

$ curl https://ojbk.dev/api/ok

{
  "ojbk": false,
  "reason": "今天是周五。不用算了。",
  "date": "2026-08-04",
  "friday": true
}
参数干什么的
roll=1不按日期出签,每次现摇。摇到同意为止也是一种工作方法。
ci=1不同意时返回 403,好让 curl -f 非零退出,直接卡住流水线
format=text返回纯文本而不是 JSON,方便在 shell 里直接看

加进 CI,让它替你拦周五的版本:

- name: 问一下今天能不能发
  run: curl -fsS "https://ojbk.dev/api/ok?ci=1&format=text"

出事了别说是我让你加的。

限流

429

两条接口都按 IP 记账,正常贴进 README、挂进流水线都碰不到。 额度是软的,不是硬上限:

接口额度超了会怎样
/b/*.svg120 次 / 分钟返回一张写着「慢点 429」的徽章
/api/ok60 次 / 分钟429 + Retry-After
/api/ok?roll=130 次 / 分钟现摇不走缓存,额度更紧
计数方式按边缘机房跨机房各算各的,所以是削峰不是封顶

每个响应都带 RateLimit-LimitRateLimit-RemainingRateLimit-Reset, 想知道自己还剩多少看响应头就行。