api.clockInOut.com

KO | EN

gitlite — search

#python #ai #typescript #llm #golang #rust #deep-learning #docker #macos #windows #awesome-list #mcp #ios #openai

api.clockInOut.com

(★ 10)

打卡小程序API

api.clockInOut.com 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# api.clockInOut.com
打卡小程序API

# 小程序
## 登录
### 授权登录
```js
  GET    http://localhost:?/session?code=${code}&iv=${iv}&encryptedData=${encryptedData}&newteo=${newteo}
```
```js
{
  iv: ${iv},        //require!
  code: ${code},        //require!
  encryptedData: ${encryptedData},        //require!
  newteo: ${newteo}        //require!
}
```
返回=>
```js
{
  status: "nowork",
  token: "xxx"
}
```

## 个人
### 查看所有公司列表
```js
  GET    http://localhost:?/user/companies?token=${token}
```
返回=>    
```js
{
  "code": 200,
  "companies": [
    {
      "_id": "xxx",        //
      "name": "xxx",        //公司名称(String)
      "logo": "xxx",        //公司logo(String)
      "address": "xxx"        //公司地址(String)
    },
    {
      "_id": "xxx",
      "name": "xxx",
      "logo": "xxx",
      "address": "xxx"
    }
  ]
}
```
### 查看公司详情
```js
  GET    http://localhost:?/user/company/:id?token=${token}
```
返回=>    
```js
{
  "code": 200,
  "company": {
    "_id": "xxx",
    "updatedTime": "xxx",
    "manager": "xxx",
    "name": "xxx",
    "logo": "xxx",
    "address": "xxx",
    "phone": 12345678901,
    "radius": 100,
    "QRcodeUrl": "xxx",
    "remark": "xxx",
    "createdTime": "xxx",
    "mottos": [],
    "corporateMember": [],
    "commutingTime": []
  }
}
```
### 申请加入公司
```js
  POST    http://localhost:?/user/company?token=${token}
```
```js
{
  companyId: ${companyId},        //公司Id
  formId: ${formId}        //form_id
}
```
未提交的返回=>  {code: 200, message: '申请已提交'}    
提交过的返回=>  {code: 202, message: '已提交过申请'}

### 退出公司
```js
  DELETE    http://localhost:?/user/tofree?token=${token}
```
返回=>  个人信息

### 打卡
```js
  POST    http://localhost:?/user/punch/:companyId?token=${token}&encrypt=${encrypt}
```
```js
{
  latitude: ${latitude},        //纬度(Number)
  longitude: ${longitude},        //经度(Number)
  time: ${time}        //时间(Date)
}
```
返回=>   
```js
{
  "code": 200,
  "sweep": {
    "_id": "xxx",
    "owner": {        //用户信息
      "updatedTime": "xxx",
      "wxName": "xxx",
      "img": "xxx",
      "employeeID": "xxx",
      "realName": "xxx",
      "status": "nowork"
    },
    "place": "xxx",       //地点
    "h_m_s": "xx:xx:xx",        //时分秒
    "createdTime": "xxx"
  }
}
```
### 查看个人信息
```js
  GET    http://localhost:?/user/info?token=${token}
```
返回=> 
```js
{
  "code": 200,        //状态码
  "user": {
    "_id": "xxx",        //用户Id
    "updatedTime": "xxx",
    "openId": "xxx",        //微信Id
    "wxName": "xxx",        //微信昵称
    "img": "xxx",        //头像
    "employeeID": "xxx",        //员工编号
    "realName": "xxx",        //真实姓名
    "status": "work",        //工作状态
    "belongsTo": {...},        //所属公司
    "remark": "xxx",        //备注
    "createdTime": "xxx",
    "punchCardRecords": [        //打卡总记录
      "xxx", "xxx"
    ]
  }
}
```
### 查看个人打卡记录
```js
  GET    http://localhost:?/user/records?token=${token}
```
返回=>  
```js
{
  "_id": "xxx",
  "updatedTime": "xxx",
  "owner": {
    "wxName": "xxx",
    "img": "xxx",
    "employeeID": "xxx",
    "realName": "xxx",
    "status": "xxx"
  },
  "normal": false,
  "today": "xxx",
  "createdTime": "xxx",
  "sweeps": [
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",        //打卡状态['OK', 'LATE', 'EARLY']
      "createdTime": "xxx"
    },
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",
      "createdTime": "xxx"
    },
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",
      "createdTime": "xxx"
    },
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",
      "createdTime": "xxx"
    },
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",
      "createdTime": "xxx"
    },
    {
      "place": "xxx",
      "h_m_s": "xxx",
      "conditions": "xxx",
      "createdTime": "xxx"
    }
  ]
}
```
### 查看today打卡记录
```js
  GET    http://localhost:?/user/record?token=${token}&today=${today}
```
返回=>  打卡记录

### 查看时间段打卡记录
```js
  GET    http://localhost:?/user/record/time?token=${token}&start=${start}&end=${end}
```
返回=>  打卡记录

## 公司
### 新增公司信息
```js
  POST    http://localhost:?/company/new?token=${token}
```
```js
{
  name: ${name},        //公司名称(String)
  address: ${address},        //公司地址(String)
  latitude: ${latitude},        //纬度(Number)
  longitude: ${longitude},        //经度(Number)
  commutingTime: ${commutingTime},        //上下班时间(Array)  eg: ["9:00", "12:00", "14:00", "18:00", "19:30", "21:00"]
  radius: ${radius},        //打卡有效范围[半径](Number)
  // logo: ${logo},        //公司logo[key: logo](String)
  // phone: ${phone}        //联系电话(Number)
}
```
返回=>  公司信息

### 更改公司logo
```js
  POST    http://localhost:?/company/logo?token=${token}
```
//  key: logo    
返回=>  公司信息

### 更改公司信息
```js
  POST    http://localhost:?/company/information?token=${token}
```
```js
{
  name: ${name},        //公司名称(String)
  address: ${address},        //公司地址(String)
  phone: ${phone},        //联系电话(Number)
  latitude: ${latitude},        //纬度(Number)
  longitude: ${longitude},        //经度(Number)
  commutingTime: ${commutingTime},        //上下班时间(Array)
  radius: ${radius},        //打卡有效范围(Number)
  remark: ${remark}        //公司备注(String)
}
```
返回=>  公司信息 + 管理员简单信息

### 生成二维码
```js
  GET    http://localhost:?/qrcode/get?token=${token}
```
返回=>  二维码链接(QRCodeUrl)

### 删除公司信息
```js
  DELETE    http://localhost:?/company/now?token=${token}
```
返回=>  状态码及'company deleted success'

### 获取申请人员列表
```js
  GET    http://localhost:?/company/applylist?token=${token}
```
返回=>  申请人员信息列表

### 验证申请人员
```js
  POST    http://localhost:?/company/applylist/:applyId?token=${token}
```
```js
{
  validation: ${validation}        //验证('pass' or 'nopass')
}
```
'pass'返回=>  {code: 200, message: 'add success'}    
'nopass'返回=>  {code: 200, message: 'refuse success'}

### 获取成员列表
```js
  GET    http://localhost:?/company/staffs?token=${token}
```
返回=>  成员信息

### 获取单天成员打卡信息
```js
  GET    http://localhost:?/company/staffs/day?token=${token}&today=${today}
```
```js
{
  today: ${today}        require!//哪一天(String)  eg: 2017-03-03
}
```
返回=>  
```js
{
  "code": 200,
  "staffRecords": [
    {        // 1个
      "_id": "xxx",
      "owner": {...},
      "normal": false,
      "today": "2017-03-03",
      "sweeps": [
        {
          "_id": "xxx",
          "place": "xxx",
          "h_m_s": "xx:xx:xx"
        },
        {
          "_id": "xxx",
          "place": "xxx",
          "h_m_s": "xx:xx:xx"
        }
      ]
    },
    {        //2个
      "_id": "xxx",
      "owner": {...},
      "normal": false,
      "today": "2017-03-03",
      "sweeps": [
        {
          "_id": "xxx",
          "place": "xxx",
          "h_m_s": "xx:xx:xx"
        },
        {
          "_id": "xxx",
          "place": "xxx",
          "h_m_s": "xx:xx:xx"
        }
      ]
    }
  ]
}
```

### 修改员工备注
```js
  POST    http://localhost:?/company/staffs/:staffId/remark?token=${token}
```
```js
{
  remark: ${remark}        //备注(String)
}
```
返回=>  员工信息

### 获取某员工today打卡记录
```js
  GET    http://localhost:?/company/staffs/:staffId/?token=${token}&today=${today}
```
// 格式: today = 2017-03-03    
返回=>  员工打卡记录

### 获取某员工时间段打卡记录
```js
  GET    http://localhost:?/company/staffs/:staffId/time?token=${token}&start=${start}&end=${end}
```
// 格式: start/end = 2017-03-03    
返回=>  员工打卡记录

<!-- ## 备忘
### 授权登录
```js
  GET    http://localhost:?/newteo/session?code=${code}&iv=${iv}&encryptedData=${encryptedData}&newteo=${newteo}
```
```js
{
  iv: ${iv},        //require!
  code: ${code},        //require!
  encryptedData: ${encryptedData},        //require!
  newteo: ${newteo}        //require!
}
```
### 添加备忘
```js
  POST    http://localhost:?/newteomemo/new?token=${token}
```
```js
{
  longitude: ${longitude},        //经度(Number)
  latitude: ${latitude},        //纬度(Number)
  input: ${input},        //备注(String)
  address: ${address}        //位置(String)
}
```
返回=>  
```js
{
  "owner": "xxx",
  "lng": xxx,
  "lat": xxx,
  "address": "xxx",
  "input": "xxx",
  "_id": "xxx",
  "createdTime": "xxx"
}
```
### 查看备忘
```js
  GET    http://localhost:?/newteomemo/all?token=${token}
```

### 删除备忘
```js
  DELETE    http://localhost:?/newteomemo/one/:memoId?token=${token}
``` -->

api.clockInOut.com

api.clockInOut.com 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

api.clockInOut.com

api.clockInOut.com 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README