徽章 & 接口
生成一枚长得像 CI 徽章的东西,贴进你自己的 README。
没有构建、没有检查、没有任何依据 —— 它只是说这玩意 ojbk。
颜色
来点现成的
<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徽章接口
不用这个页面也行,URL 自己拼就完了:
GET https://ojbk.dev/b/<左边文案>.svg
| 参数 | 默认 | 说明 |
|---|---|---|
| msg | ojbk | 右边那半截的文案,最长 24 字 |
| color | 4c1 | 右边底色。六位/三位十六进制,或 green red blue orange yellow black 这些名字 |
| labelColor | 555 | 左边底色,同上 |
| style | flat | 给 flat-square 就是方角 |
左边文案最长 40 字,超了会被截断。缓存是浏览器一天、边缘一周 —— 改了文案看不到变化的话,是 GitHub 的图片代理在缓存,换个文案就行。
玄学发版接口
让玄学替你决定今天能不能发版。一天一签,全网一致,跟老黄历对得上。周五永远是否 —— 这是唯一的硬规则。
$ 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"
限流
两条接口都按 IP 记账,正常贴进 README、挂进流水线都碰不到。 额度是软的,不是硬上限:
| 接口 | 额度 | 超了会怎样 |
|---|---|---|
| /b/*.svg | 120 次 / 分钟 | 返回一张写着「慢点 429」的徽章 |
| /api/ok | 60 次 / 分钟 | 429 + Retry-After |
| /api/ok?roll=1 | 30 次 / 分钟 | 现摇不走缓存,额度更紧 |
| 计数方式 | 按边缘机房 | 跨机房各算各的,所以是削峰不是封顶 |
每个响应都带 RateLimit-Limit、RateLimit-Remaining、RateLimit-Reset, 想知道自己还剩多少看响应头就行。