> For the complete documentation index, see [llms.txt](https://docs.mqnicrnd5.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mqnicrnd5.com/guide/rest-api/edgersu-sensing-offer.md).

# EdgeRSU 센싱이력 (제공)

## 1. EdgeRSU 센싱정보 이력 조회 API (GetEdgeRSUSensingList)

### 요청 URL

```url
http://service.mqnicrnd5.com/api/v1/ers/offer/gesl
```

### 연계 주기

요청 시

### 프로토콜

HTTPS

### HTTP 메서드

GET

### 데이터 포맷

{% file src="/files/z177IK5RtYTTT6iM7NOv" %}

### 참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. <mark style="color:purple;">**접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.**</mark>

```
> GET /api/v1/ers/offer/gesl?spatialUnitType=MAPNODE&spatialUnitID=2720002800&timestampMin=1723086000&senarioNames=주간,비 HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>
```

### 요청 예시

```bash
curl --location 'http://service.mqnicrnd5.com/api/v1/ers/offer/gesl?spatialUnitType=MAPNODE&spatialUnitID=2720002800&timestampMin=1723086000&senarioNames=%EC%A3%BC%EA%B0%84%2C%EB%B9%84' \
--header 'Authorization: Bearer <접근 토큰>'
```

### 응답 예시

```json
{
    "edgeRsuSensingList": [
        {
            "edgeRsuId": "RSU00001",
            "timestamp": 1723086000,
            "senarioNames": [
                "주간",
                "비"
            ],
            "numFrames": 12,
            "basePath": "RSU00001/20240808120000_20240808125959/archive.zip"
        },
        {
            "edgeRsuId": "RSU00001",
            "timestamp": 1723089600,
            "senarioNames": [
                "주간",
                "맑음"
            ],
            "numFrames": 12,
            "basePath": "RSU00001/20240808130000_20240808135959/archive.zip"
        },
        {
            "edgeRsuId": "RSU00001",
            "timestamp": 1723093200,
            "senarioNames": [
                "주간",
                "맑음"
            ],
            "numFrames": 12,
            "basePath": "RSU00001/20240808140000_20240808145959/archive.zip"
        }
    ]
}
```

## 2. EdgeRSU 센싱데이터 압축파일 제공 API (GetSensingData)

### 요청 URL

```url
http://service.mqnicrnd5.com/api/v1/ers/offer/gsd
```

### 연계 주기

요청 시

### 프로토콜

HTTPS

### HTTP 메서드

GET

### 데이터 포맷

{% file src="/files/QxatEYLwvnEFl7eH05YH" %}

### 참고사항

API를 요청할 때 다음 예와 같이 HTTP 요청 헤더에 접근 토큰(Access Token) 을 추가해야 합니다. <mark style="color:purple;">**접근 토큰 앞에 "Bearer " 문자열을 추가해야 한다는 점에 주의하세요.**</mark>

```
> GET /api/v1/ers/offer/gsd?filePath=RSU00001/20240808140000_20240808145959/archive.zip HTTP/2
> Host: service.mqnicrnd5.com
> User-Agent: curl/7.64.1
> Accept: */*
> Authorization: Bearer <접근 토큰>
```

### 요청 예시

* <mark style="color:green;">**filePath 파라미터에 1번 API 응답으로 받은 basePath를 입력합니다.**</mark>

```bash
curl --location 'http://service.mqnicrnd5.com/api/v1/ers/offer/gsd?filePath=RSU00001%2F20240808140000_20240808145959%2Farchive.zip' \
--header 'Authorization: Bearer <접근 토큰>'
```

### 응답 예시

{% file src="/files/5PgRSBe6kOXQirB2zLID" %}

## 응답 코드

본 페이지의 제공 API 호출 시 발생할 수 있는 응답 코드입니다. 오류가 발생한 경우 아래와 같은 형식의 오류 메세지가 반환됩니다.

```json
{
    "message": "Invalid Input Value",
    "status": 400,
    "code": "C004"
}
```

<table><thead><tr><th width="110" align="center">HTTP 코드</th><th width="110" align="center">에러 코드</th><th align="center">에러 메세지</th><th align="center">설명</th></tr></thead><tbody><tr><td align="center">200</td><td align="center">-</td><td align="center">-</td><td align="center">성공</td></tr><tr><td align="center">204</td><td align="center">-</td><td align="center">-</td><td align="center">조회 대상 데이터(파일)가 존재하지 않는 경우 (응답 본문 없음)</td></tr><tr><td align="center">400</td><td align="center">C004</td><td align="center">Invalid Input Value</td><td align="center">요청 파라미터가 누락되었거나 형식·값 검증에 실패한 경우</td></tr><tr><td align="center">400</td><td align="center">C004</td><td align="center">Invalid Type Value</td><td align="center">요청 파라미터의 타입이 올바르지 않은 경우</td></tr><tr><td align="center">400</td><td align="center">C004</td><td align="center">Invalid File Path</td><td align="center">요청한 파일 경로(filePath)가 유효하지 않은 경우</td></tr><tr><td align="center">401</td><td align="center">C004</td><td align="center">Authentication Failed (인증에 실패하였습니다.)</td><td align="center">접근 토큰이 없거나 유효하지 않은(만료 포함) 경우</td></tr><tr><td align="center">401</td><td align="center">C004</td><td align="center">Access Denied (권한이 존재하지 않습니다.)</td><td align="center">해당 API에 대한 권한이 없는 경우</td></tr><tr><td align="center">404</td><td align="center">C004</td><td align="center">Not Found</td><td align="center">조회 대상 데이터 또는 파일이 존재하지 않는 경우</td></tr><tr><td align="center">404</td><td align="center">C004</td><td align="center">Page Not Found (API가 존재하지 않습니다.)</td><td align="center">요청 URL이 존재하지 않는 경우</td></tr><tr><td align="center">500</td><td align="center">C005</td><td align="center">Server Error</td><td align="center">서버 내부 오류가 발생한 경우</td></tr></tbody></table>

자세한 내용은 [Rest API 공통 가이드](/guide/common/rest-api.md)의 오류 코드 항목을 참고하세요.