[POST] /carrier

인증 방법

요청 정보

이 API는 선사의 화물 정보를 시스템에 등록하거나 업데이트 할 수 있습니다.

Swagger 문서 바로가기

인증 방법

Carrier API는 사용자 인증을 위해 Swagger UI에서 Basic Authorize 인증 방식을 제공합니다.

인증 절차는 다음과 같습니다:

우측 상단의 [Authorize] 버튼을 클릭합니다.

팝업 창에 제공받은 인증 정보(아이디, 비밀번호)를 입력합니다.

입력 후 다시 [Authorize] 버튼을 클릭하여 인증을 진행합니다.

인증이 완료되면 [Close] 버튼을 클릭하여 인증 창을 닫습니다.

Swagger UI에서 호출되는 모든 API 요청에 인증 토큰이 자동으로 포함되어 전송됩니다.

요청 정보

Request URL : [POST] https://insight.seavantage.com/api/carrier

실행 순서

Swagger 문서에서 우측 상단의 Select a definition 메뉴에서 Carrier 을 선택합니다.

/carrier 경로로 이동합니다.

[Try it out] 버튼을 클릭하여 입력창을 활성화합니다.

아래 요청 Parameters 조건에 따라 결과가 반환됩니다.

•

Request body : 선사의 화물정보를 입력하면 화물의 세부 정보를 시스템에 등록하거나 업데이트

[Execute] 버튼을 클릭합니다.

하단 응답 영역에서 등록 결과를 확인합니다.

Request body 예시

{
  "cust_cd": "ABCDEF",
  "cust_name": "Seavantage",
  "VINs": [
    {
      "VIN": "string"
    }
  ],
  "carrierCode": "EUKO",
  "bookingNo": "string",
  "mblNo": "SOMEBILL2025001",
  "ships": [
    {
      "pol_en": "Busan",
      "pod_en": "New York",
      "imo_no": "1234567",
      "call_sign": "string",
      "vessel_name": "string",
      "pol": "KRPUS",
      "etd": "20250125010000",
      "atd": "20250125010000",
      "pod": "USNYC",
      "eta": "20250125010000",
      "ata": "20250125010000",
      "mmsi": "123456789"
    }
  ]
}
JavaScript
복사

필드 설명

필드	설명
cust_cd	선사에서 고객을 식별하기 위해 사용하는 고객 코드
cust_name	선사에서 고객을 식별하기 위해 사용하는 고객사명
VIN	차량 번호 (Vehicle Identification Number)
carrierCode	SCAC 코드
bookingNo	Booking 번호
mblNo	M-B/L 번호
pol_en	선적지 위치명 (영문)
pod_en	양하지 위치명 (영문)
imo_no	IMO 번호
call_sign	호출부호
vessel_name	선명
pol	선적지 UNLOCODE
etd	선적지에 대한 Estimated Time of Departure
atd	선적지에 대한 Actual Time of Departure
pod	하역지 UNLOCODE
eta	하역지 Estimated Time of Arrival
ata	하역지 Actual Time of Arrival
mmsi	선박 고유 식별 번호

응답 정보

요청이 성공하거나 실패했을 때 공통적으로 아래와 같은 형식으로 응답이 반환됩니다.

응답 예시

{
  "code": 201,
  "message": "Created",
  "error": false,
  "timestamp": "2025-08-22T01:04:57.593170861",
  "response": null
}
JSON
복사

응답 필드 상세 설명

응답 항목별 정의

필드명	예시 값	설명
code	201	응답 상태 코드 (HTTP status code와 동일하게 사용됨) (아래 별도 응답 상태 코드표 참조)
message	success	응답 메시지 (상태에 따른 설명)
error	false	오류 여부 true: 오류 발생 false: 정상 처리
timestamp	2025-05-14T01:09:00.834665213	응답 생성 시각 (UTC 기준)
response	null	응답 성공 및 실패 시 null

응답 코드 종류

코드	설명
201	정상 처리 (Created)
400	잘못된 파라미터 (Bad request)
401	인증 필요 (Unauthorized)
403	권한 없음 (Forbidden)
422	처리 불가 (Unprocessable entity)
429	요청 과다 (Too many requests)