소개

개요

HTTP 응답

코드 설명
200 Function successfully executed.
400 Invalid API location. Check the URL that you are using.
403 Invalid or missing API key. Check that your API key is present and matches your assigned key.
405 Invalid HTTP method. Check that the method (POST / GET)
412 Request failed. Check the response body for a more detailed description.
500 Internal server error. Try again at a later time.
503 Rate limit hit. API requests are limited to an average of 1/s. Try your request again later.

API 사용

인증

인증이 필요한 API 요청의 경우 'API-Key : 발급키' HTTP 헤더를 보내야합니다. 이를 수행하는 방법에 대한 자세한 정보는 아래의 각 항목의 cURL 예제를 참조하십시오.

API 사용량 조회

GET /v1/my/apicount

계정의 api 요청 현황

헤더

  • 필수
  • 필수

매개변수

    없음

cURL 요청 예제

curl -X GET -H "accept: application/json" -H 'Authorization: API-Key=발급키' https://api.wrapupapp.com/v1/my/apicount

응답 예제

{
	"data": {
		"api_limit_count": 1000,
		"api_remaining_cnt": 700,
		"api_used_count": 300
	},
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}

회사 목록

GET /v1/company/list

회사 데이터

헤더

  • 필수
  • 필수

매개변수

  • 선택

cURL 요청 예제

curl -X GET -H "accept: application/json" -H 'Authorization: API-Key=발급키' https://api.wrapupapp.com/v1/company/list

응답 예제

{
	"data": {
		"company": [
			  {
				"company_name": "주식회사 딥펙트",
				"company_code": "c3c6eaaf00000000",
				"reg_dt": "2020-01-26 11:05:21.0",
				"lastup_dt": null
			},
			  {
				"company_name": "주식회사 랩업",
				"company_code": "62ce953400000000",
				"reg_dt": "2020-01-26 03:36:07.0",
				"lastup_dt": null
			}
		],
	},
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}

그룹 목록

GET /v1/group/list

그룹 데이터

헤더

  • 필수
  • 필수

매개변수

  • 필수 또는 선택사항 (회사에 속한 전체 그룹)
  • 필수 또는 선택사항 (회사에 관계없이 특정한 그룹)
  • * company_code와 group_code중 반드시 하나만 입력해야합니다.

cURL 요청 예제

curl -X GET -H "accept: application/json" -H 'Authorization: API-Key=발급키' https://api.wrapupapp.com/v1/group/list?company_code=회사코드

응답 예제

{
	"data": {
		"company": {
				"company_name": "주식회사 딥펙트",
				"company_code": "c3c6eaaf00000000",
				"reg_dt": "2020-01-26 11:05:21.0",
				"lastup_dt": null
		},
		"group": [
			  {
				"group_code": "ge2bb22252000001",
				"groupname": "영업 1팀"",
				"in_time": "09:00:00",
				"out_time": "18:00:00",
				"inout_display_yn": "Y",
				"multi_check_yn": "N",
				"nextday_yn": "N",
				"beacon_yn": "N",
				"gps_yn": "N",
				"wifi_yn": "N",
				"timegmt_yn": "N",
				"timegmt": "9",
				"reg_dt": "2019-010-29 16:02:42.0"
				},
				  {
				"group_code": "ge2bb22252000000",
				"groupname": "생산 1팀",
				"in_time": "09:00:00",
				"out_time": "18:00:00",
				"inout_display_yn": "Y",
				"multi_check_yn": "Y",
				"nextday_yn": "N",
				"beacon_yn": "Y",
				"gps_yn": "Y",
				"wifi_yn": "N",
				"timegmt_yn": "N",
				"timegmt": "9",
				"reg_dt": "2019-09-23 10:56:56.0"
			}
		],
	},
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}

구성원 목록

GET /v1/member/list

그룹에 포함되어 있는 구성원 데이터

헤더

  • 필수
  • 필수

매개변수

  • 필수

cURL 요청 예제

curl -X GET -H "accept: application/json" -H 'Authorization: API-Key=발급키' https://api.wrapupapp.com/v1/member/list?group_code=그룹코드

응답 예제

{
	"data": {
		"company": {
			"company_name": "주식회사 딥펙트",
			"company_code": "c3c6eaaf00000000",
			"reg_dt": "2020-01-26 11:05:21.0",
			"lastup_dt": null
		},
		"group": {
			"group_code": "ge2bb22252000001",
			"groupname": "영업 1팀"",
			"in_time": "09:00:00",
			"out_time": "18:00:00",
			"inout_display_yn": "Y",
			"multi_check_yn": "N",
			"nextday_yn": "N",
			"beacon_yn": "N",
			"gps_yn": "N",
			"wifi_yn": "N",
			"timegmt_yn": "N",
			"timegmt": "9",
			"reg_dt": "2019-010-29 16:02:42.0"
		},
		"member": [
			{
				"auth_token": "188405b41b8000025eeeb4ba62200000",
				"username": "demo1",
				"team": "개발팀",
				"job_position": "대리",
				"fullname": "홍길동",
				"phone": "01012345678",
				"device_token": "n5LbQSGTh3Q:APA91bGAjyEBt7O9rfDlw546VV7D2o7siR8Pfaeg1gqevgqwr2343eg2wf23ewf2ef2",
				"device_type": "A",
				"reg_dt": null,
				"lastup_dt": "2019-10-01 18:41:03.0",
				"last_access_dt": "2019-12-09 14:34:44.0"
				},
			{
				"auth_token": "288405b41b8000025eeeb4ba62200000",
				"username": "demo2",
				"team": "관리팀",
				"job_position": "사원",
				"fullname": "이순신",
				"phone": "01022223333",
				"device_token": "v5LbQSGTh3Q:APA91bGAjyEBt7O9rfDlw546VV7D2o7siR8Pfaeg1gqevgqwr2343eg2wf23ewf2ef2",
				"device_type": "A",
				"reg_dt": null,
				"lastup_dt": "2019-10-02 15:49:28.0",
				"last_access_dt": "2019-11-09 13:23:12.0"
			}
		],
	},
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}

근무내역

GET /v1/inout

랩업앱을 통해 체크되는 출/퇴근 데이터

헤더

  • 필수
  • 필수

매개변수

  • 필수
  • 선택사항
  • 선택사항
  • 선택사항
  • * start_date 입력시 end_date도 필요합니다.

cURL 요청 예제

curl -X GET -H "accept: application/json" -H 'Authorization: API-Key=발급키' https://api.wrapupapp.com/v1/inout?group_code=그룹코드

응답 예제

{
	"data": {
		"company": {
			"company_name": "주식회사 딥펙트",
			"company_code": "c3c6eaaf00000000",
			"reg_dt": "2020-01-26 11:05:21.0",
			"lastup_dt": null
		},
		"group": {
			"group_code": "ge2bb22252000001",
			"groupname": "영업 1팀"",
			"in_time": "09:00:00",
			"out_time": "18:00:00",
			"inout_display_yn": "Y",
			"multi_check_yn": "N",
			"nextday_yn": "N",
			"beacon_yn": "N",
			"gps_yn": "N",
			"wifi_yn": "N",
			"timegmt_yn": "N",
			"timegmt": "9",
			"reg_dt": "2019-010-29 16:02:42.0"
		},
		"inout": [
			{
			"check_type": "I",
			"check_date": "2019-10-01 08:55:56.0",
			"check_ko_date": "2019-10-01 08:55:56.0",
			"timegmt": "9",
			"check_beacon_info": "[
				{
				"beacon_model":"Mint",
				"beacon_ver":"1.0",
				"beacon_name":"BEACON-B1",
				"major":"1000",
				"minor":"1001",
				"beacon_uuid":"1000090c-1111-1b82-77e2-000000000000",
				"mac_address":"00:EE:A1:00:2C:00",
				"location":"딥펙트 정문",
				"distance":2.64
				}
			]",
			"check_gps_info": "[
				{
				"provider":"network",
				"longitude":126.9234502,
				"latitude":37.5569694,
				"altitude":64.0999984741211,
				"gps_name":"딥펙트",
				"distance":"15"
				}
			]",
			"username": "demo1",
			"fullname": "홍길동"
			},
			{
			"check_type": "O",
			"check_date": "2019-10-01 18:00:38.0",
			"check_ko_date": "2019-10-01 18:00:38.0",
			"timegmt": "9",
			"check_beacon_info": "[
				{
				"beacon_model":"Mint",
				"beacon_ver":"1.0",
				"beacon_name":"BEACON-B1",
				"major":"1000",
				"minor":"1001",
				"beacon_uuid":"1000090c-1111-1b82-77e2-000000000000",
				"mac_address":"00:EE:A1:00:2C:00",
				"location":"딥펙트 정문",
				"distance":3.23
				}
			]",
			"check_gps_info": "[
				{
				"provider":"network",
				"longitude":126.9234502,
				"latitude":37.5569694,
				"altitude":64.0999984741211,
				"gps_name":"딥펙트",
				"distance":"15"
				}
			]",
			"username": "demo1",
			"fullname": "홍길동"
			}
		],
	},
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}

Push 보내기

POST /v1/push

그룹 또는 구성원에게 Push 메시지를 보낼 수 있습니다.

헤더

  • 필수
  • 필수

매개변수

  • 필수
  • 선택
  • 필수
  • 필수

cURL 요청 예제

curl -X POST -H "accept: application/json" -H 'Authorization: API-Key=발급키' -d 'group_code=그룹코드&username=아이디1,아이디2,아이디3...&title=제목&message=메시지' https://api.wrapupapp.com/v1/push

응답 예제

{
	"status": {
		"code": 200,
		"success": true,
		"message": "success"
	}
}