V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
爱意满满的作品展示区。
xx19941215
V2EX  ›  分享创造

工作日在线计算和节假日 API

  •  1
     
  •   xx19941215 · 2022-01-29 13:58:30 +08:00 · 2655 次点击
    这是一个创建于 1034 天前的主题,其中的信息可能已经有所发展或是发生改变。

    介绍

    之前写过一个工作日在线计算的小工具,许多网友反馈也想用 api ,这里花了点时间将 API 开放出来。

    起步

    如果您需要知道某个日期 N 个工作日之后是什么日子,您可以使用 GET 或者 POST 向下面的入口发起一个请求。

    https://calc.ygcf.info/api/v1/workday/end
    

    如果您需要知道某两个日期之前的工作日分布情况,您可以使用 GET 或者 POST 向下面的入口发起一个请求。

    https://calc.ygcf.info/api/v1/workday/count
    

    例子

    如果需要获取 2020-12-12 10 个工作日之后是什么日子。

    https://calc.ygcf.info/api/v1/workday/end?start_date=2020-12-12&days=10
    

    如果需要获取 2020-12-12 到 2020-12-31 之前的工作日分布情况。

    https://calc.ygcf.info/api/v1/workday/count?start_date=2020-12-12&end_date=2020-12-31
    

    认证

    注册之后可以在个人中心获取 token ,添加 token 参数在您的 API 请求中以获得认证。

    https://calc.ygcf.info/api/v1/workday/end?
                start_date=2020-12-12&days=10
                &token=YOUR_API_TOKEN
    

    参数

    以下是您可以在请求中添加的所有参数。

    参数 类型 示例值 描述
    token string YOUR_API_TOKEN 您的 API token
    start_date string 2020-12-12 开始日期
    days int 10 天数
    end_date string 2020-12-31 结束日期

    以下是响应中的所有参数。

    参数 类型 示例值 描述
    code int 0 0 表示请求成功
    dayOff int 10 调班
    holiday int 10 法定节假日
    total int 30 总计天数
    weekday int 30 工作日
    weekend int 30 周末

    错误

    如果请求的 HTTP 状态代码返回 4xx 或者 5xx 此时返回的数据将会带有一个 msg 字段表示错误原因。 下面是当使用了错误 token 时返回的例子。

    {
       "code": 422,
       "data": [
    
       ],
       "msg": "token 不正确"
    }
    

    大家可以前往 https://calc.ygcf.info/docs 查看详细文档。 前往开发者中心https://calc.ygcf.info/reg 注册账号获得 TOKEN 即可以开始使用。

    7 条回复    2022-01-30 12:55:30 +08:00
    gaozizhong
        1
    gaozizhong  
       2022-01-29 15:41:12 +08:00
    很好用,不错,之前自己也想开放几个自己做接口,能说一下接口计数啥的问题都是用什么技术做的吗?
    shisico
        2
    shisico  
       2022-01-29 15:46:09 +08:00
    点赞点赞
    xx19941215
        3
    xx19941215  
    OP
       2022-01-29 15:46:22 +08:00
    @gaozizhong 就是在请求进来和结束的时候记录一下各个参数然后存入数据库就行了,目前是这样简单处理的。
    hideon
        4
    hideon  
       2022-01-29 16:50:10 +08:00
    我目前也在做相同的事情,由于组内人员认为所有公开的接口都存在不确定性,所以只能自己开发了。不过也挺简单的,就是简单的入库和查询,然后每天爬一次 http://sousuo.gov.cn/s.htm?q=%E8%8A%82%E5%81%87%E6%97%A5&t=paper 看有没有最新的,如果有就通知人工更新数据库。
    xx19941215
        5
    xx19941215  
    OP
       2022-01-29 16:53:43 +08:00
    @uoolee11 哈哈 有的小团队有时候项目工期紧还是需要这么一个服务的
    xx19941215
        6
    xx19941215  
    OP
       2022-01-29 16:59:12 +08:00
    @uoolee11 小工具 19 年上线,稳定运行 2 年多了,我的小目标是先稳定在线到 2029 年哈哈,然后一直维护到我退休。
    skys215
        7
    skys215  
       2022-01-30 12:55:30 +08:00
    http://timor.tech/api/holiday

    是不是和这个一样?
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   1700 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 16:48 · PVG 00:48 · LAX 08:48 · JFK 11:48
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.