Beacon Server

iOS 앱으로부터 위치 데이터를 수신하고 조회하는 NestJS 서버.

API

모든 API 요청은 다음 인증 헤더가 필요합니다.

Authorization: Bearer <token>

POST /api/locations
Content-Type: application/json

Request Body

필드	타입	필수	설명
`id`	`string`	✓	디바이스 또는 사용자 식별자. 128자 이하의 영문, 숫자, 하이픈(`-`), 밑줄(`_`)만 허용
`latitude`	`number`	✓	위도 (-90 ~ 90)
`longitude`	`number`	✓	경도 (-180 ~ 180)
`timestamp`	`string`	✓	ISO 8601 형식 (`2026-04-24T10:00:00Z`)

id가 허용 규칙을 벗어나면 400 Bad Request를 반환한다. 서버는 최대 1000개의 서로 다른 id만 저장한다. 초과 시 새 id는 400 Bad Request를 반환한다.

Example

{
  "id": "kiwi",
  "latitude": 37.566535,
  "longitude": 126.977969,
  "timestamp": "2026-04-24T10:00:00Z"
}

Response

201 Created

GET /api/locations/:id/latest

id가 허용 규칙을 벗어나면 400 Bad Request를 반환한다.

Response

{
  "id": "kiwi",
  "latitude": 37.566535,
  "longitude": 126.977969,
  "timestamp": "2026-04-24T10:00:00Z"
}

pnpm start:dev