1. Timeline Raw Data (Ship)_CSV

이 API는 사용자가 관리하고 있는 선박 중 개별 선박의 Raw Data를 기간을 지정하여 조회할 수 있으며

CSV 파일 형태로 결과를 제공합니다.

선박의 데이터는 DAQ 서버를 통해 수집되는 데이터이며 Vessellink DB를 통해 수신됩니다.

This API allows users to retrieve raw data of an individual vessel under their management by specifying a time period. The results are provided in CSV file format.

The vessel data is collected through the DAQ server and ingested into the Vessellink database, from which it is delivered through the API.

1.1 Request

POST https://data.vessellink.com/ext-api/file/logger 

Headers:
	api-Key : {key} 

Body:
{
  "imoNo": "1234567",
  "fromDate": "20220101120000",
  "toDate": "20220101130000"
}

※ fromDate - toDate는 최대 1개월 단위로 호출 가능함.

1.2 Response

• 반환되는 데이터의 컬럼은 선박의 장비 구성 등에 따라 상이하며, 실제 제공되는 파일은 해당 선박에서 수집 가능한 컬럼만 포함됩니다.
• 하나의 CSV 파일은 10분 단위로 구성되며, 요청한 기간 이내 혹은 포함된 구간의 데이터가 반환됩니다.
  • 예시 1) 20250101000000 ~ 20250101235000 : 2025-01-01-00-00.csv ~ 2025-01-01-23-40.csv 반환 (20250101234950까지의 데이터 조회 가능)
  • 예시 2) 20250101000000 ~ 20250101235200 : 2025-01-01-00-00.csv ~ 2025-01-01-23-50.csv 반환 (20250101235950까지의 데이터 조회 가능)

※ 전체 컬럼 list는 [email protected] 으로 문의

<Success Example>

Binary -- Response Body에 파일 바이너리 데이터를 직접 반환

 

<Error Example>

{
    "resp_status_dtl_cd": 400.1,   
    "resp_msg": "Bad Request", 
    "total_cnt": 0
    "success": [], 
    "errores": [    
        "The field lastSyncDate must be a string or array type with a minimum length of '14'."
    ] 
}