Tradlinx는 해상 물류 가시성(Ocean Visibility) 및 물류 운영을 위한 API를 제공합니다.
\nTMS, ERP, 고객 포털 또는 내부 물류 시스템을 구축하는 경우, Tradlinx API를 통해 물류 데이터를 애플리케이션에 손쉽게 연동할 수 있습니다.
\nMaster B/L, Container Number와 같은 표준 물류 식별자를 이용하여 화물을 추적할 수 있으며, Port Congestion, Supply Chain Issue Monitoring과 같은 logistics intelligence API도 함께 제공합니다.
\n해상 물류에서는 화물 추적 정보가 여러 선사에 분산되어 있습니다. 선사마다 서로 다른 Tracking 시스템, 데이터 형식 및 업데이트 주기를 사용하기 때문에 화물 정보를 통합하여 활용하기가 어렵습니다.
\n또한 항만 혼잡이나 공급망 이슈와 같은 중요한 물류 정보도 여러 출처에 흩어져 있어 신속하게 확인하고 대응하기 어렵습니다.
\nTradlinx는 이러한 정보를 하나의 API 플랫폼으로 표준화하여, 선사와 관계없이 동일한 데이터 구조로 화물 정보를 조회할 수 있도록 제공합니다.
\n또한 Port Congestion, Supply Chain Issue Monitoring과 같은 logistics intelligence API를 함께 제공하여 보다 효율적인 물류 운영 의사결정을 지원합니다.
\n궁금한 사항이 있으시면 Sales Team이 자세히 안내해 드립니다.
\n담당 영업사원에게 연락주시거나 help@tradlinx.com 으로 문의해주세요.
\n","_postman_id":"310f93e4-edf4-4372-bf2b-cee5297c0fc6"},{"name":"공통 API 가이드","item":[],"id":"55a90cea-058b-453c-b10b-e8f35db99514","description":"Tradlinx API의 기본 요청 URL은 https://api.tradlinx.com입니다.
API는 사전에 협의된 일정에 따라 활성화되며, 활성화 이후부터 정상적으로 요청(Request) 및 응답(Response)을 사용할 수 있습니다.
\n\\\\\\\\* : 필수 항목입니다.
? : 선택 항목입니다. (제공되지 않을 수 있음)
위 규칙을 만족하지 않는 요청은 처리되지 않습니다.
\nstring, boolean, number 외의 타입은 각 문서에 정의된 사용자 정의 타입(Custom Type)을 참고해 주세요.
오류 코드에 대한 자세한 내용은 참고자료 > 오류 코드 문서를 참고해 주세요.
\n🔑
\n아직 API 인증 정보를 발급받지 않으셨나요?
\nSales Team에 문의해 주시면 API 사용을 위한 Client ID와 API Key를 발급해 드립니다.
\n담당 영업사원에게 연락주시거나 help@tradlinx.com으로 문의해 주세요.
\nTradlinx API는 서비스 품질 향상, 데이터 제공 범위 확대 및 신규 기능 추가를 위해 지속적으로 업데이트될 수 있습니다.
\nAPI 변경 시에는 기존 연동의 안정성을 최우선으로 고려하며, 가능한 한 하위 호환성(Backward Compatibility)을 유지하는 원칙을 따릅니다.
\n하위 호환이 유지되는 변경의 예시는 다음과 같습니다.
\n새로운 Response 필드 추가
\n새로운 Enum 값 추가
\n새로운 선택(Optional) Request Parameter 추가
\n⭐ 클라이언트 애플리케이션은 알 수 없는 필드를 무시하고, 새롭게 추가된 값을 안전하게 처리할 수 있도록 구현하는 것을 권장합니다.
\n기존 연동에 영향을 줄 수 있는 변경 사항이 있는 경우에는 가능한 한 사전에 안내드립니다.
\n","_postman_id":"55a90cea-058b-453c-b10b-e8f35db99514"}],"id":"42105d3f-6972-4689-9130-fd82f51eadde","_postman_id":"42105d3f-6972-4689-9130-fd82f51eadde","description":""},{"name":"선적 트래킹 APIs","item":[{"name":"B/L 트래킹 API","item":[{"name":"1. B/L 트래킹 요청","id":"cd2dfdf8-1804-48f1-adef-78bd4fc5a372","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n {\n \"bl_no\": \"SAMPLE_BL_NO\",\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cust_corp_nm\": \"SAMPLE_CORP_NAME\",\n \"cust_nm\": \"SAMPLE_CUSTOMER_NAME\",\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"extend_tracking\": true,\n \"line_cd\": \"SAMPLE_LINE_CD\"\n }\n ]","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v2/cargo-tracks/tracking","description":"하나 이상의 Master B/L을 등록하여 화물 추적을 시작할 수 있습니다.
\n요청은 Array 형태로 구성해야 합니다.
\n각 트래킹은 bl_no + line_cd + cust_order_id 조합으로 고유하게 식별되며, 해당 식별자는 모든 B/L Tracking API에서 공통으로 사용됩니다.
cust_order_id는 고객이 사용하는 내부 식별자입니다. (예: Purchase Order 번호, House B/L 등)
한 번의 요청으로 최대 50건까지 등록할 수 있습니다.
\n지원하는 선사는 참고자료 > 추적 가능한 선사 목록을 참고해 주세요.
\n지정한 기간 내에 등록된 B/L 트래킹 목록을 조회합니다.
\n결과는 페이지네이션 형식으로 제공됩니다.
\n대량의 데이터를 조회할 경우 page와 size 파라미터를 사용하여 결과를 순차적으로 조회할 수 있습니다.
조회 기간은 트래킹 요청이 최초로 등록된 날짜 및 시간을 기준으로 합니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssZ)으로 제공됩니다.
등록일시 기준 시작일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"등록일시 기준 종료일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~1000)
\n","type":"text/plain"},"key":"size","value":"[Size]"}],"variable":[]}},"response":[{"id":"12f03a39-8a86-4d82-a2a8-3a8fb2270e7b","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/query?register_from=[Register From]®ister_to=[Register To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","query"],"query":[{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~1000)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2025-07-09T04:04:06.333705\",\n \"content\": [\n {\n \"cargo_track_id\": \"SAMPLE_CARGO_TRACK_ID\",\n \"line_cd\": \"SAMPLE_LINE_CD\",\n \"bl_no\": \"SAMPLE_BL_NO\",\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"registered_datetime\": \"2025-02-27T06:51:49Z\",\n \"tracking_status\": \"COMPLETE\",\n \"trade_type\": null,\n \"is_container_plus\": true\n }\n ],\n \"size\": 1,\n \"pagination\": {\n \"current_page\": 1,\n \"has_next\": false,\n \"total_page\": 10,\n \"total_size\": 10\n }\n}"},{"id":"d0785f3e-eedc-48a6-b6fd-3437da377541","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/query?register_from=[Register From]®ister_to=[Register To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","query"],"query":[{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~1000)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n \"transaction_time\": \"2025-03-20T05:42:27.135265\"\n}"},{"id":"ed06e86c-2de6-4edc-a98e-3929b26e9bc9","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/query?register_from=[Register From]®ister_to=[Register To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","query"],"query":[{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~1000)"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 500,\n \"type\": \"Internal Server Error\",\n \"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"e36e726e-2e52-4225-bcb6-c9f457fbfe37"},{"name":"3. B/L 트래킹 데이터 상세 조회","id":"93ced56d-edc6-4865-8ab7-2393694534b5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details?bl_nos=[BL No],[BL No],[BL No]&page=[Page]&size=[Size]","description":"하나 이상의 B/L 번호에 대한 상세 트래킹 정보를 조회합니다.
\n트래킹 상세 정보는 status가 TRACKING 상태가 된 이후부터 조회할 수 있습니다.
한 번의 요청으로 최대 50개의 B/L 번호를 조회할 수 있습니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
Master B/L 번호 목록
\n","type":"text/plain"},"key":"bl_nos","value":"[BL No],[BL No],[BL No]"},{"description":{"content":"페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"}],"variable":[]}},"response":[{"id":"2ac5ebc8-7287-493b-8806-94319b346a73","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details?bl_nos=[BL No],[BL No],[BL No]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"page","value":"[Page]","description":"페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"페이지 크기 (범위: 1~50)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"bl_no\": \"SAMPLE_BL_NO\",\n \"cargo_track_id\": \"SAMPLE_CARGO_TRACK_ID\",\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SIZE\",\n \"cntr_tp\": \"SAMPLE_CNTR_TYPE\",\n \"container_events\": [\n {\n \"event_datetime\": \"2025-07-08T07:25:39+09:00\",\n \"event_type\": \"CONTAINER_PICK_UP\",\n \"is_actual\": false,\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"transportation\": \"BARGE\"\n }\n ],\n \"seal_no\": \"SAMPLE_SEAL_NO\"\n }\n ],\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"cust_order_id\": \"SAMPLE_CUST_ORDER_ID\",\n \"is_active\": false,\n \"is_container_plus\": false,\n \"line_cd\": \"SAMPLE_LINE_CD\",\n \"origin\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pod\": {\n \"ata\": \"2025-07-08T07:25:39+09:00\",\n \"eta\": \"2025-07-08T07:25:39+09:00\",\n \"init_eta\": \"2025-07-08T07:25:39+09:00\",\n \"pod_code\": \"SAMPLE_POD_PORT_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"tx_ata\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pol\": {\n \"atd\": \"2025-07-08T07:25:39+09:00\",\n \"etd\": \"2025-07-08T07:25:39+09:00\",\n \"init_etd\": \"2025-07-08T07:25:39+09:00\",\n \"pol_code\": \"POL_PORT_CODE\",\n \"pol_name\": \"POL_NAME\",\n \"tx_atd\": \"2025-07-08T07:25:39+09:00\"\n },\n \"destination\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"registered_datetime\": \"2025-07-08T07:25:39.493Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"routes\": [\n {\n \"ata\": \"2025-07-08T07:25:39+09:00\",\n \"atd\": \"2025-07-08T07:25:39+09:00\",\n \"eta\": \"2025-07-08T07:25:39+09:00\",\n \"etd\": \"2025-07-08T07:25:39+09:00\",\n \"imo\": \"SAMPLE_IMO\",\n \"init_eta\": \"2025-07-08T07:25:39+09:00\",\n \"init_etd\": \"2025-07-08T07:25:39+09:00\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"order\": 0,\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_ata\": \"2025-07-08T07:25:39+09:00\",\n \"tx_atd\": \"2025-07-08T07:25:39+09:00\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n }\n ],\n \"tracking_status\": \"TRACKING\",\n \"trade_type\": null,\n \"trans_type\": \"DIR\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-07-08T07:25:39.493258\"\n}"},{"id":"9dd2aa04-e709-433f-9f40-6dbd7d65a74f","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details?bl_nos=[BL No],[BL No],[BL No]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"page","value":"[Page]","description":"페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"페이지 크기 (범위: 1~50)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n\t\"transaction_time\": \"2025-03-20T05:42:27.123543\"\n}"},{"id":"39b06d68-cf76-444a-8104-7bcb639c3767","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details?bl_nos=[BL No],[BL No],[BL No]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"page","value":"[Page]","description":"페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"페이지 크기 (범위: 1~50)"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"93ced56d-edc6-4865-8ab7-2393694534b5"},{"name":"4. B/L 트래킹 수정 요청","id":"462e4eff-091c-4b8c-8eb8-9eacd42e83ac","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/:cargo_track_id","description":"고유한 cargo_track_id를 이용하여 기존 B/L 트래킹 정보를 수정합니다.
기존 트래킹과 bl_no, line_cd, cust_order_id가 모두 동일한 경우 수정이 적용되지 않습니다.세 필드 중 일부만 동일한 경우에는 수정할 수 있습니다.
선적 조회를 통해 알 수 있는 선적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"cargo_track_id"}]}},"response":[{"id":"d8cece34-2b96-4a5e-b18b-f43d1d85fb75","name":"200 정상응답","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/:cargo_track_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks",":cargo_track_id"],"variable":[{"key":"cargo_track_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{}"},{"id":"b2e4832c-9ef5-4006-ae68-3f5a42ea7d25","name":"400 에러","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/:cargo_track_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks",":cargo_track_id"],"variable":[{"key":"cargo_track_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"error_detail\": \"[cust_order_id]: must not be blank\",\n\t\"transaction_time\": \"2024-08-13T05:42:27.251232\"\n}"}],"_postman_id":"462e4eff-091c-4b8c-8eb8-9eacd42e83ac"},{"name":"5. B/L 트래킹 취소 요청","id":"a053e08a-16da-4dbc-ad12-71205eaa3251","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"[\n {\n \"bl_no\": \"SAMPLE_BL_NO\",\n \"cust_order_id\": \"SAMPLE_ORDER_ID\",\n \"line_cd\": \"SAMPLE_LINE_CD\"\n }\n ]","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v2/cargo-tracks/cancel","description":"하나 이상의 B/L 트래킹을 한 번의 요청으로 취소합니다.
\n요청은 Array 형태로 구성해야 합니다.
\n각 항목은 bl_no + line_cd + cust_order_id 조합으로 식별됩니다.
한 번의 요청으로 최대 50건까지 취소할 수 있습니다.
\n트래킹이 시작되기 전까지만 Credit이 환불됩니다. tracking_status가 TRACKING 또는 COMPLETE인 경우 취소하더라도 Credit이 환불되지 않습니다.
자동 추적을 지원하지 않는 경우 하나 이상의 B/L 트래킹을 수동으로 등록할 수 있습니다.
\n요청은 Array 형태로 구성해야 합니다.
\n각 트래킹은 bl_no + line_cd + cust_order_id 조합으로 고유하게 식별되며, 동일한 조합은 중복 등록할 수 없습니다.
수동 트래킹은 요청에 포함된 POL, POD, ETD, ETA, 선박명(Vessel Name), IMO 번호 등의 운항 정보를 기반으로 트래킹 데이터를 생성합니다.
\n입력한 정보가 부정확하거나 누락된 경우 트래킹 정보가 정확하지 않거나 일부 정보가 제공되지 않을 수 있습니다.
\n한 번의 요청으로 최대 50건까지 등록할 수 있습니다.
\n수동으로 등록한 기존 B/L 트래킹정보를 수정합니다.
\n트래킹 식별자(bl_no + line_cd + cust_order_id)는 등록 후 수정할 수 없습니다.
해당 값 중 하나라도 변경해야 하는 경우, 기존 트래킹을 취소한 후 새로 등록해야 합니다.
\nB/L 트래킹은 Master B/L 번호를 이용하여 화물을 추적하는 기능입니다.
\nMaster B/L 번호와 Carrier Code를 등록하면 Tradlinx가 선사로부터 화물 정보를 지속적으로 수집하여 API를 통해 최신 Tracking 정보를 제공합니다.
\nB/L 트래킹 API는 Ocean Visibility Enterprise Plan 고객에게만 제공됩니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n다음 두 단계를 통해 바로 등록과 조회를 시작해볼 수 있습니다.
\n1. B/L 트래킹 등록
\nB/L 번호, Carrier Code 및 내부 화물 식별자를 등록합니다.
\nTradlinx가 즉시 화물 Tracking 정보를 수집하기 시작합니다.
\n2. 트래킹 상세 조회
\n동일한 bl_no + line_cd + cust_order_id를 이용하여 Tracking 정보를 조회합니다.
Tracking이 시작되면 API를 통해 화물 이벤트, 선박 정보, 운항 경로 및 컨테이너 정보를 조회할 수 있습니다.
\n하나 이상의 Container를 등록하여 화물 추적을 시작합니다.
\n요청은 Array 형태로 구성해야 합니다.
\n각 Tracking은 container_no + carrier_code + reference_no 조합으로 고유하게 식별되며, 해당 식별자는 모든 Container Tracking API에서 공통으로 사용됩니다.
reference_no는 고객이 사용하는 내부 식별자입니다. (예: Purchase Order 번호, House B/L 등)
지원하는 선사는 참고자료 > 추적 가능한 선사 목록을 참고해 주세요.
\n등록된 컨테이너 트래킹의 상세 정보를 조회합니다.
\n트래킹 상세 정보는 status가 TRACKING 상태가 된 이후부터 조회할 수 있습니다.
content 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
컨테이너 번호
\n","type":"text/plain"},"key":"container_no","value":"[Container No]"},{"description":{"content":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"관리 번호
\n","type":"text/plain"},"key":"reference_no","value":"[Reference No]"},{"description":{"content":"선사 코드
\n","type":"text/plain"},"key":"carrier_code","value":"[Carrier Code]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"disabled":true,"description":{"content":"진행 상태
\n","type":"text/plain"},"key":"status","value":""}],"variable":[]}},"response":[{"id":"766375da-005a-43b3-a15f-fb80cc32ed8e","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"container_no\": \"SAMPLE_CONTAINER_NO\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"client\": \"SAMPLE_CLIENT\",\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SZ\",\n \"cntr_tp\": \"SAMPLE_CNTR_TP\",\n \"container_events\": [\n {\n \"event_datetime\": \"SAMPLE_EVENT_DATETIME\",\n \"event_type\": \"SAMPLE_EVENT_TYPE\",\n \"is_actual\": false,\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"transportation\": \"SAMPLE_TRANSPORTATION\"\n }\n ],\n \"seal_no\": \"SAMPLE_SEAL_NO\"\n }\n ],\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"detail_status\": \"SAMPLE_DETAIL_STATUS\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"origin\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pod\": {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\"\n },\n \"pol\": {\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\"\n },\n \"destination\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"registered_datetime\": \"2025-07-08T07:25:39.493Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"routes\": [\n {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"imo\": \"SAMPLE_IMO\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"order\": 0,\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n }\n ],\n \"status\": \"SAMPLE_STATUS\",\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\",\n \"trans_type\": \"SAMPLE_TRANS_TYPE\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-07-09T05:32:47.939106\"\n}"},{"id":"30e72859-8392-4fe9-a732-76e5df5d3c3b","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-03-20T05:42:27.171506\"\n}"},{"id":"e350ae9b-17e3-4ba2-bc0f-ac2f4a3fc177","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"54ef157e-cd6f-4fc8-b82d-f5aec8246dd1"},{"name":"3. 컨테이너 트래킹 재등록 요청","id":"409c2418-f04e-4d58-a807-fe288d2c046e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id/re-enroll","description":"재시도 실패, 플랜 제한 또는 Credit 부족으로 추적할 수 없었던 컨테이너 트래킹을 다시 등록합니다.
\n한 번의 요청으로 하나의 컨테이너 트래킹만 재등록할 수 있습니다.
\n선적 조회를 통해 알 수 있는 선적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"037d9129-81f6-4101-acec-bde85666b0a3","name":"200 정상응답","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id/re-enroll","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks",":track_mst_id","re-enroll"],"variable":[{"key":"track_mst_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": {\n \"container_no\": \"SAMPLE_CONTAINER_NO\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"client\": \"SAMPLE_CLIENT\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\"\n },\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-07-09T05:22:11.380245\"\n}"},{"id":"cd7d3ef6-99d5-4022-b7ae-e6c371746522","name":"400 에러","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id/re-enroll","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks",":track_mst_id","re-enroll"],"variable":[{"key":"track_mst_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"Resource not found.\",\n \"transaction_time\": \"2026-06-25 00:37:58\",\n \"message\": \"RESOURCE_NOT_FOUND\"\n}"}],"_postman_id":"409c2418-f04e-4d58-a807-fe288d2c046e"},{"name":"4. 컨테이너 트래킹 수정 요청","id":"08b3ad06-85b1-4455-affc-760bd96e0d4f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id","description":"기존 컨테이너 트래킹의 메타데이터를 수정합니다.
\ncontainer_no + carrier_code + reference_no 조합은 고유해야 합니다.
수정으로 인해 중복 트래킹이 생성되는 경우, 이미 등록된 것으로 판단되어 수정이 적용되지 않습니다.
\n선적 조회를 통해 알 수 있는 선적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"c8363217-97c1-44f6-8b5e-6bcc2e7cae8b","name":"200 정상응답","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2026-06-25T00:32:23.190632\"\n}"},{"id":"d60e11a1-50d5-443c-ab0c-a02ae39911a7","name":"400 에러","originalRequest":{"method":"PUT","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"client\": \"SAMPLE_CLIENT_NAME\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"remark\": \"SAMPLE_REMARK\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[track_mst_id]: must not be blank\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2024-08-13T05:42:27.402256\"\n}"}],"_postman_id":"08b3ad06-85b1-4455-affc-760bd96e0d4f"},{"name":"5. 컨테이너 트래킹 취소 요청","id":"642de0bd-fac4-43f5-86b4-3cbcdd8d67e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id","description":"컨테이너 트래킹을 취소합니다.
\n한 번의 요청으로 하나의 컨테이너 트래킹만 취소할 수 있습니다.
\n트래킹이 시작되기 전까지만 Credit이 환불됩니다. status가 TRACKING 또는 COMPLETE인 트래킹은 취소하더라도 Credit이 환불되지 않습니다.
선적 조회를 통해 알 수 있는 선적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"db9f884d-c8f7-4304-bdd5-912ca1f2d5d3","name":"200 정상응답","originalRequest":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/:track_mst_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"선적 조회를 통해 알 수 있는 선적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2026-06-25T00:39:31.107587\"\n}"}],"_postman_id":"642de0bd-fac4-43f5-86b4-3cbcdd8d67e4"}],"id":"a7e50a23-0a52-4e1e-8ac2-b2ece8773747","description":"Tradlinx는 B/L, Container, Vessel 단위의 트래킹을 지원하며, 이 페이지에서는 컨테이너 트래킹 API를 설명합니다.
\n컨테이너 트래킹은 Container Number를 이용하여 화물을 추적하는 기능입니다.
\nContainer Number를 등록하면 Tradlinx가 화물 추적을 시작하며, API를 통해 최신 Tracking 정보를 제공합니다.
\n컨테이너 트래킹 API는 Ocean Visibility Enterprise Plan 고객에게만 제공됩니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n두 단계만으로 컨테이너 트래킹을 시작할 수 있습니다.
\n1. 컨테이너 트래킹 등록 →
Container Number와 Carrier Code를 등록하면 Tradlinx가 즉시 화물 추적을 시작합니다.
2. 트래킹 상세 조회 →
동일한 식별자를 이용하여 Tracking 정보를 조회합니다. status가 TRACKING 상태가 되면 화물 이벤트 및 Tracking 정보를 확인할 수 있습니다.
B/L 트래킹API로 등록된 화물의 Demurrage & Detention(D&D) 모니터링 정보를 조회합니다.
\n조회 가능한 대상은 아래 조건을 모두 만족해야 합니다.
\nAuto Tracking으로 등록된 화물
\nContainer+ 기능이 활성화된 화물
\narrivalDateTime이 존재하는 화물
content 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssZ)으로 제공됩니다.
arrivalDateTime은 아래 우선순위에 따라 결정됩니다.
POD의 Vessel Arrival at Port 이벤트
\nAIS 데이터를 기반으로 계산된 POD의 Berthing 시간
\n선사에서 제공하는 ATA
\nterminalDwellDays는 dischargeDateTime부터 gateOutDateTime까지의 기간을 기준으로 계산됩니다. dischargeDateTime이 없는 경우 arrivalDateTime을 기준으로 계산됩니다.
streetDwellDays는 dischargeDateTime부터 emptyReturnDateTime까지의 기간을 기준으로 계산됩니다.
terminalDwellDays와 streetDwellDays는 하루에 1일씩 증가하며 최대 61일까지 계산됩니다. 해당 값은 정렬(Sorting)에 사용할 수 있습니다.
terminalDwellRawDays와 streetDwellRawDays는 최대값 제한 없이 실제 경과 일수를 계산한 값입니다.
arrivalDateTime 시작일 yyyy-MM-dd'T'HH:mm:ss
\n","type":"text/plain"},"key":"arrival_from","value":"[Arrival From]"},{"description":{"content":"arrivalDateTime 종료일 yyyy-MM-dd'T'HH:mm:ss
\n","type":"text/plain"},"key":"arrival_to","value":"[Arrival To]"},{"description":{"content":"(required) 페이지 번호
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"disabled":true,"description":{"content":"선사 코드
\n","type":"text/plain"},"key":"carrier_code","value":""},{"disabled":true,"description":{"content":"POD 항만 코드
\n","type":"text/plain"},"key":"pod_location_code","value":""},{"disabled":true,"description":{"content":"Master B/L 번호
\n","type":"text/plain"},"key":"bl_no","value":""},{"disabled":true,"description":{"content":"Container 번호
\n","type":"text/plain"},"key":"container_no","value":""},{"disabled":true,"description":{"content":"관리 번호
\n","type":"text/plain"},"key":"reference_no","value":""},{"disabled":true,"description":{"content":"터미널 체류일
\n","type":"text/plain"},"key":"terminal_dwell_days","value":""},{"disabled":true,"description":{"content":"컨테이너 사용일
\n","type":"text/plain"},"key":"street_dwell_days","value":""},{"disabled":true,"description":{"content":"컨테이너 하역 여부
\n","type":"text/plain"},"key":"exists_discharge","value":""},{"disabled":true,"description":{"content":"Gate Out 여부
\n","type":"text/plain"},"key":"exists_gate_out","value":""},{"disabled":true,"description":{"content":"컨테이너 반환 여부
\n","type":"text/plain"},"key":"exists_empty_return","value":""},{"disabled":true,"description":{"content":"데이터 정렬(기본값: ARRIVAL_DATE_TIME_DESC)
\n","type":"text/plain"},"key":"order","value":""}],"variable":[]}},"response":[{"id":"9164940a-e87d-4045-9770-540992166eda","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/dnd-monitoring?arrival_from=[Arrival From]&arrival_to=[Arrival To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","dnd-monitoring"],"query":[{"key":"arrival_from","value":"[Arrival From]","description":"arrivalDateTime 시작일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"arrival_to","value":"[Arrival To]","description":"arrivalDateTime 종료일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기"},{"key":"carrier_code","value":"","description":"선사 코드","disabled":true},{"key":"pod_location_code","value":"","description":"POD 항만 코드","disabled":true},{"key":"bl_no","value":"","description":"Master B/L 번호","disabled":true},{"key":"container_no","value":"","description":"Container 번호","disabled":true},{"key":"reference_no","value":"","description":"관리 번호","disabled":true},{"key":"terminal_dwell_days","value":"","description":"터미널 체류일","disabled":true},{"key":"street_dwell_days","value":"","description":"컨테이너 사용일","disabled":true},{"key":"exists_discharge","value":"","description":"컨테이너 하역 여부","disabled":true},{"key":"exists_gate_out","value":"","description":"Gate Out 여부","disabled":true},{"key":"exists_empty_return","value":"","description":"컨테이너 반환 여부","disabled":true},{"key":"order","value":"","description":"데이터 정렬(기본값: ARRIVAL_DATE_TIME_DESC)","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"registration_type\": \"BL_TRACKING\",\n \"detail_status\": \"TRACKING\",\n \"carrier_code\": \"TRX\",\n \"carrier_name\": \"TRADLINX\",\n \"container_no\": \"TRADLINX6882\",\n \"bl_no\": \"MASTERBL1029\",\n \"reference_no\": \"reference number-0123\",\n \"pol_name\": \"Kwangyang\",\n \"pol_code\": \"KRKWA\",\n \"pod_name\": \"Pipavav\",\n \"pod_code\": \"INPAV\",\n \"latest_event\": null,\n \"terminal_dwell_days\": 1,\n \"terminal_dwell_raw_days\": 1,\n \"street_dwell_days\": 6,\n \"street_dwell_raw_days\": 6,\n \"arrival_date_time\": \"2025-10-18T12:58:57Z\",\n \"discharge_date_time\": null,\n \"gate_out_date_time\": \"2025-10-20T06:02:12Z\",\n \"empty_return_date_time\": \"2025-10-26T12:11:38Z\"\n }\n ],\n \"transaction_time\": \"2025-09-03T04:52:26.649981\",\n \"size\": 50,\n \"pagination\": {\n \"total_size\": 549,\n \"total_page\": 11,\n \"current_page\": 1,\n \"has_next\": true\n }\n}"},{"id":"7a90d237-4c0a-4b8b-b924-b356cff5774c","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/dnd-monitoring?arrival_from=[Arrival From]&arrival_to=[Arrival To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","dnd-monitoring"],"query":[{"key":"arrival_from","value":"[Arrival From]","description":"arrivalDateTime 시작일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"arrival_to","value":"[Arrival To]","description":"arrivalDateTime 종료일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기"},{"key":"carrier_code","value":"","description":"선사 코드","disabled":true},{"key":"pod_location_code","value":"","description":"POD 항만 코드","disabled":true},{"key":"bl_no","value":"","description":"Master B/L 번호","disabled":true},{"key":"container_no","value":"","description":"Container 번호","disabled":true},{"key":"reference_no","value":"","description":"관리 번호","disabled":true},{"key":"terminal_dwell_days","value":"","description":"터미널 체류일","disabled":true},{"key":"street_dwell_days","value":"","description":"컨테이너 사용일","disabled":true},{"key":"exists_discharge","value":"","description":"컨테이너 하역 여부","disabled":true},{"key":"exists_gate_out","value":"","description":"Gate Out 여부","disabled":true},{"key":"exists_empty_return","value":"","description":"컨테이너 반환 여부","disabled":true},{"key":"order","value":"","description":"데이터 정렬(기본값: ARRIVAL_DATE_TIME_DESC)","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[page]: Required field is not provided.\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-08-28T07:21:13.367404\"\n}"},{"id":"e1d1d840-856b-4491-921d-c4fc7e27f9d4","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/dnd-monitoring?arrival_from=[Arrival From]&arrival_to=[Arrival To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","dnd-monitoring"],"query":[{"key":"arrival_from","value":"[Arrival From]","description":"arrivalDateTime 시작일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"arrival_to","value":"[Arrival To]","description":"arrivalDateTime 종료일 yyyy-MM-dd'T'HH:mm:ss"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기"},{"key":"carrier_code","value":"","description":"선사 코드","disabled":true},{"key":"pod_location_code","value":"","description":"POD 항만 코드","disabled":true},{"key":"bl_no","value":"","description":"Master B/L 번호","disabled":true},{"key":"container_no","value":"","description":"Container 번호","disabled":true},{"key":"reference_no","value":"","description":"관리 번호","disabled":true},{"key":"terminal_dwell_days","value":"","description":"터미널 체류일","disabled":true},{"key":"street_dwell_days","value":"","description":"컨테이너 사용일","disabled":true},{"key":"exists_discharge","value":"","description":"컨테이너 하역 여부","disabled":true},{"key":"exists_gate_out","value":"","description":"Gate Out 여부","disabled":true},{"key":"exists_empty_return","value":"","description":"컨테이너 반환 여부","disabled":true},{"key":"order","value":"","description":"데이터 정렬(기본값: ARRIVAL_DATE_TIME_DESC)","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 500,\n \"type\": \"Internal Server Error\",\n \"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"e94505d5-e4fa-4ffe-8d60-aaa3fffcf5b1"}],"id":"09c728a7-38f0-4bda-bdcc-d229880513a9","description":"Tradlinx는 B/L 트래킹 API의 확장 기능으로 D&D 모니터링을 제공하며, 이 페이지에서는 D&D 모니터링 API를 설명합니다.
\nD&D 모니터링은 B/L 트래킹을 통해 수집된 화물 정보를 기반으로 컨테이너 단위의 Demurrage & Detention(D&D) 발생 위험을 모니터링하는 기능입니다.
\n컨테이너의 Pickup 및 Empty Return 기간을 확인하여 D&D 비용 발생 위험을 사전에 관리할 수 있습니다.
\nD&D 모니터링은 B/L 트래킹으로 등록된 화물에 대해서만 사용할 수 있습니다.
\n지원 선사는 참고자료 > 추적 가능한 선사 목록을 참고해 주세요.
\nD&D 모니터링 API는 해당 기능을 별도로 구독한 Ocean Visibility Enterprise Plan 고객에게만 제공되며, B/L 트래킹 API를 함께 사용해야 합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n","_postman_id":"09c728a7-38f0-4bda-bdcc-d229880513a9"},{"name":"AI-ETA","item":[{"name":"1. B/L 트래킹 데이터 상세 조회 (AI ETA 포함)","id":"dea3cc57-72f9-4bc4-9413-66e2e9745778","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details/ai-eta?bl_nos=[BL No],[BL No],[BL No]&tracking_status=[Tracking Status]®ister_from=[Register From]®ister_to=[Register To]&active=[Active]&page=[Page]&size=[Size]","description":"등록된 화물의 B/L 트래킹 상세 정보와 AI ETA 예측 정보를 조회합니다.
\n이 API는 B/L 트래킹 API를 함께 사용해야 하며, B/L 트래킹으로 등록된 화물에 대해서만 조회할 수 있습니다.
\nAI ETA 예측 정보를 조회하려면 기존 \"3. B/L 트래킹 상세 조회\" API 대신 이 API를 사용하면 됩니다.
\n한 번의 요청으로 최대 50건의 트래킹정보를 조회할 수 있습니다.
\n정상적으로 등록된 B/L 트래킹에 대해서만 상세 조회가 가능합니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
Master B/L 번호 목록
\n","type":"text/plain"},"key":"bl_nos","value":"[BL No],[BL No],[BL No]"},{"description":{"content":"추적 상태 필터 (콤마로 구분)
\n","type":"text/plain"},"key":"tracking_status","value":"[Tracking Status]"},{"description":{"content":"등록일시 기준 시작일 (yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"등록일시 기준 종료일 (yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"활성 상태 필터 (기본값: true)
\n","type":"text/plain"},"key":"active","value":"[Active]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"}],"variable":[]}},"response":[{"id":"7c62342a-e96b-4e69-a9a8-7d1fa592f9cb","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details/ai-eta?bl_nos=[BL No],[BL No],[BL No]&tracking_status=[Tracking Status]®ister_from=[Register From]®ister_to=[Register To]&active=[Active]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details","ai-eta"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"tracking_status","value":"[Tracking Status]","description":"추적 상태 필터 (콤마로 구분)"},{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"active","value":"[Active]","description":"활성 상태 필터 (기본값: true)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"bl_no\": \"SAMPLE_BL_NO\",\n \"cargo_track_id\": \"SAMPLE_CARGO_TRACK_ID\",\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SIZE\",\n \"cntr_tp\": \"SAMPLE_CNTR_TYPE\",\n \"container_events\": [\n {\n \"event_datetime\": \"2025-07-08T07:25:39+09:00\",\n \"event_type\": \"CONTAINER_PICK_UP\",\n \"is_actual\": false,\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"transportation\": \"BARGE\"\n }\n ],\n \"seal_no\": \"SAMPLE_SEAL_NO\"\n }\n ],\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"cust_corp_name\": \"SAMPLE_CORP_NAME\",\n \"cust_name\": \"SAMPLE_CUSTOMER_NAME\",\n \"cust_order_id\": \"SAMPLE_CUST_ORDER_ID\",\n \"is_active\": false,\n \"is_container_plus\": false,\n \"line_cd\": \"SAMPLE_LINE_CD\",\n \"origin\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pod\": {\n \"ata\": \"2025-07-08T07:25:39+09:00\",\n \"eta\": \"2025-07-08T07:25:39+09:00\",\n \"init_eta\": \"2025-07-08T07:25:39+09:00\",\n \"pod_code\": \"SAMPLE_POD_PORT_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"tx_ata\": \"2025-07-08T07:25:39+09:00\",\n \"ai_eta\": {\n \"ai_eta\": \"2025-07-10T14:00\",\n \"ai_eta_p10\": \"2025-07-09T08:00\",\n \"ai_eta_p90\": \"2025-07-12T22:00\",\n \"ai_eta_confidence\": \"30.00\"\n }\n },\n \"pol\": {\n \"atd\": \"2025-07-08T07:25:39+09:00\",\n \"etd\": \"2025-07-08T07:25:39+09:00\",\n \"init_etd\": \"2025-07-08T07:25:39+09:00\",\n \"pol_code\": \"POL_PORT_CODE\",\n \"pol_name\": \"POL_NAME\",\n \"tx_atd\": \"2025-07-08T07:25:39+09:00\"\n },\n \"destination\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"registered_datetime\": \"2025-07-08T07:25:39.493Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"routes\": [\n {\n \"ata\": \"2025-07-08T07:25:39+09:00\",\n \"atd\": \"2025-07-08T07:25:39+09:00\",\n \"eta\": \"2025-07-08T07:25:39+09:00\",\n \"etd\": \"2025-07-08T07:25:39+09:00\",\n \"imo\": \"SAMPLE_IMO\",\n \"init_eta\": \"2025-07-08T07:25:39+09:00\",\n \"init_etd\": \"2025-07-08T07:25:39+09:00\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"order\": 0,\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_ata\": \"2025-07-08T07:25:39+09:00\",\n \"tx_atd\": \"2025-07-08T07:25:39+09:00\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\",\n \"ai_eta\": {\n \"ai_eta\": \"2025-07-10T14:00\",\n \"ai_eta_p10\": \"2025-07-09T08:00\",\n \"ai_eta_p90\": \"2025-07-12T22:00\",\n \"ai_eta_confidence\": \"30.00\"\n }\n }\n ],\n \"tracking_status\": \"TRACKING\",\n \"trans_type\": \"DIR\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-07-08T07:25:39.493258\"\n}"},{"id":"ccb5c0b8-8824-4f16-b397-1f1de888522a","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details/ai-eta?bl_nos=[BL No],[BL No],[BL No]&tracking_status=[Tracking Status]®ister_from=[Register From]®ister_to=[Register To]&active=[Active]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details","ai-eta"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"tracking_status","value":"[Tracking Status]","description":"추적 상태 필터 (콤마로 구분)"},{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"active","value":"[Active]","description":"활성 상태 필터 (기본값: true)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n\t\"transaction_time\": \"2025-03-20T05:42:27.123543\"\n}"},{"id":"9b86c166-fcd7-46ed-ad4b-27efe1e7e974","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/cargo-tracks/details/ai-eta?bl_nos=[BL No],[BL No],[BL No]&tracking_status=[Tracking Status]®ister_from=[Register From]®ister_to=[Register To]&active=[Active]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","cargo-tracks","details","ai-eta"],"query":[{"key":"bl_nos","value":"[BL No],[BL No],[BL No]","description":"Master B/L 번호 목록"},{"key":"tracking_status","value":"[Tracking Status]","description":"추적 상태 필터 (콤마로 구분)"},{"key":"register_from","value":"[Register From]","description":"등록일시 기준 시작일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일시 기준 종료일 (yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"active","value":"[Active]","description":"활성 상태 필터 (기본값: true)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"dea3cc57-72f9-4bc4-9413-66e2e9745778"},{"name":"2. 컨테이너 트래킹 데이터 상세 조회 (AI ETA 포함)","id":"4e46b17b-d68e-4561-bbcf-9ccc9c40f824","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/container-tracks/details/ai-eta?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","description":"등록된 컨테이너 트래킹의 상세 정보와 AI ETA 예측 정보를 조회합니다.\\
\n이 API는 컨테이너 트래킹 API를 함께 사용해야 하며, 컨테이너 트래킹으로 등록된 컨테이너에 대해서만 조회할 수 있습니다.
\nAI ETA 예측 정보를 조회하려면 기존 \"2. 컨테이너 트래킹 상세 조회\" API 대신 이 API를 사용해야 합니다.
\n한 번의 요청으로 최대 50건의 Tracking 정보를 조회할 수 있습니다.
\n정상적으로 등록된 컨테이너 트래킹에 대해서만 상세 조회가 가능합니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssXXX)으로 제공됩니다.
컨테이너 번호
\n","type":"text/plain"},"key":"container_no","value":"[Container No]"},{"description":{"content":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"관리 번호
\n","type":"text/plain"},"key":"reference_no","value":"[Reference No]"},{"description":{"content":"선사 코드
\n","type":"text/plain"},"key":"carrier_code","value":"[Carrier Code]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"disabled":true,"description":{"content":"진행 상태
\n","type":"text/plain"},"key":"status","value":""}],"variable":[]}},"response":[{"id":"e8526477-afce-4732-8a74-647880f117d9","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/details/ai-eta?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks","details","ai-eta"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"container_no\": \"SAMPLE_CONTAINER_NO\",\n \"carrier_code\": \"SAMPLE_CARRIER_CODE\",\n \"client\": \"SAMPLE_CLIENT\",\n \"containers\": [\n {\n \"cntr_no\": \"SAMPLE_CNTR_NO\",\n \"cntr_sz\": \"SAMPLE_CNTR_SZ\",\n \"cntr_tp\": \"SAMPLE_CNTR_TP\",\n \"container_events\": [\n {\n \"event_datetime\": \"SAMPLE_EVENT_DATETIME\",\n \"event_type\": \"SAMPLE_EVENT_TYPE\",\n \"is_actual\": false,\n \"port_code\": \"SAMPLE_PORT_CODE\",\n \"transportation\": \"SAMPLE_TRANSPORTATION\"\n }\n ],\n \"seal_no\": \"SAMPLE_SEAL_NO\"\n }\n ],\n \"current_vessel\": {\n \"imo\": \"SAMPLE_IMO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\"\n },\n \"detail_status\": \"SAMPLE_DETAIL_STATUS\",\n \"internal_usage\": \"SAMPLE_INTERNAL_USAGE\",\n \"origin\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"pod\": {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\",\n \"ai_eta\": {\n \"ai_eta\": \"2025-07-10T14:00\",\n \"ai_eta_p10\": \"2025-07-09T08:00\",\n \"ai_eta_p90\": \"2025-07-12T22:00\",\n \"ai_eta_confidence\": \"30.00\"\n }\n },\n \"pol\": {\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\"\n },\n \"destination\": {\n \"location_code\": \"SAMPLE_LOCATION_CODE\",\n \"location_name\": \"SAMPLE_LOCATION_NAME\",\n \"init_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"estimate_date_time\": \"2025-07-08T07:25:39+09:00\",\n \"actual_date_time\": \"2025-07-08T07:25:39+09:00\"\n },\n \"reference_no\": \"SAMPLE_REFERENCE_NO\",\n \"registered_datetime\": \"2025-07-08T07:25:39.493Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"routes\": [\n {\n \"ata\": \"2025-07-09T05:32:47+09:00\",\n \"atd\": \"2025-07-09T05:32:47+09:00\",\n \"eta\": \"2025-07-09T05:32:47+09:00\",\n \"etd\": \"2025-07-09T05:32:47+09:00\",\n \"imo\": \"SAMPLE_IMO\",\n \"init_eta\": \"2025-07-09T05:32:47+09:00\",\n \"init_etd\": \"2025-07-09T05:32:47+09:00\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"order\": 0,\n \"pod_code\": \"SAMPLE_POD_CODE\",\n \"pod_name\": \"SAMPLE_POD_NAME\",\n \"pol_code\": \"SAMPLE_POL_CODE\",\n \"pol_name\": \"SAMPLE_POL_NAME\",\n \"tx_ata\": \"2025-07-09T05:32:47+09:00\",\n \"tx_atd\": \"2025-07-09T05:32:47+09:00\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"voyage\": \"SAMPLE_VOYAGE\",\n \"ai_eta\": {\n \"ai_eta\": \"2025-07-10T14:00\",\n \"ai_eta_p10\": \"2025-07-09T08:00\",\n \"ai_eta_p90\": \"2025-07-12T22:00\",\n \"ai_eta_confidence\": \"30.00\"\n }\n }\n ],\n \"status\": \"SAMPLE_STATUS\",\n \"track_mst_id\": \"SAMPLE_TRACK_MST_ID\",\n \"trans_type\": \"SAMPLE_TRANS_TYPE\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-07-09T05:32:47.939106\"\n}"},{"id":"49f8a678-a73f-4fa6-85d4-2ac113f4bc54","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/details/ai-eta?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks","details","ai-eta"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[page]: The value of the field must be greater than or equal to 1.\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-03-20T05:42:27.171506\"\n}"},{"id":"019d9e32-072c-49e0-bbb0-2881583d7af7","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/container-tracks/details/ai-eta?container_no=[Container No]®ister_from=[Register From]®ister_to=[Register To]&reference_no=[Reference No]&carrier_code=[Carrier Code]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","container-tracks","details","ai-eta"],"query":[{"key":"container_no","value":"[Container No]","description":"컨테이너 번호"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"reference_no","value":"[Reference No]","description":"관리 번호"},{"key":"carrier_code","value":"[Carrier Code]","description":"선사 코드"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"},{"key":"status","value":"","description":"진행 상태","disabled":true}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"4e46b17b-d68e-4561-bbcf-9ccc9c40f824"}],"id":"7bcd80a8-1619-45ab-977c-8f3b8bf9aad8","description":"AI ETA는 선적 트래킹 API를 통해 등록된 화물에 대해 AI 기반 도착 예정 시간을 제공합니다.
\n실시간 선박 데이터와 과거 운항 이력을 기반으로 선박의 도착 시간을 예측하며, 단일 ETA가 아닌 여러 도착 시나리오를 제공합니다.
\nAI ETA는 선박 지연, 항만 혼잡 및 운항 일정 변경으로 인해 발생하는 운영상의 불확실성에 대비할 수 있도록 지원합니다.
\nAI ETA는 단일 ETA 대신 확률 기반의 3가지 도착 시나리오를 제공합니다.
\nAI ETA는 확률 기반의 도착 예측 정보를 제공합니다.
\nP10과 P90 사이의 범위는 약 80% 신뢰구간(Confidence Interval) 을 의미하며, 낙관적·기준·보수적 도착 시나리오를 함께 검토할 수 있도록 지원합니다.
\nAI ETA는 해당 기능을 별도로 구독한 Ocean Visibility Enterprise Plan 고객에게만 제공되며, 선적 트래킹 API를 함께 사용해야 합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n","_postman_id":"7bcd80a8-1619-45ab-977c-8f3b8bf9aad8"}],"id":"e1090c64-87e3-4bd8-9321-dc073aaead0f","description":"선적 트래킹 API는 Master B/L 및 Container Number와 같은 표준 물류 식별자를 기반으로 화물 추적 정보를 제공합니다.
\nTradlinx는 여러 선사의 화물 추적 데이터를 수집하고 표준화하여, 선사별 트래킹 시스템 및 데이터 형식과 관계없이 일관된 API 응답을 제공합니다.
\n일반적으로 사용되는 모든 물류 식별자를 지원하는 것은 아닙니다. 트래킹기능을 설계하기 전에 아래 표를 참고해 주세요.
\n선적 트래킹 API는 선사 지원 여부에 따라 아래와 같은 정보를 제공합니다.
\n","_postman_id":"e1090c64-87e3-4bd8-9321-dc073aaead0f"},{"name":"Webhook","item":[{"name":"B/L 트래킹","item":[{"name":"1. 웹훅 이벤트 목록 조회","id":"3c0d72b0-b7b8-4b10-af2f-167ccb436425","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/webhook/events?page=[Page]&size=[Size]&status=[Status]","description":"응답 - Response
\n페이지 정보 - Pagination
\n이벤트 - Event
\n상태 코드 상세 설명
\n페이로드 타입 설명
\n","urlObject":{"path":["partners","track","v3","webhook","events"],"host":["https://api.tradlinx.com"],"query":[{"description":{"content":"(required) 페이지 번호 (최소 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (1~1000)
\n","type":"text/plain"},"key":"size","value":"[Size]"},{"description":{"content":"(required) 조회할 이벤트 상태: SUCCESS_RESPONSE, FAILURE_RESPONSE, DELIVERED, FAILURE_UNKNOWN_HOST, FAILURE_REQUEST_TIMEOUT, FAILURE_CONNECTION_REFUSED
\n","type":"text/plain"},"key":"status","value":"[Status]"}],"variable":[]}},"response":[{"id":"769fac2e-67f9-4998-b4b1-5e5685f4593d","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/webhook/events?page=[Page]&size=[Size]&status=[Status]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","webhook","events"],"query":[{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (1~1000)"},{"key":"status","value":"[Status]","description":"(required) 조회할 이벤트 상태: SUCCESS_RESPONSE, FAILURE_RESPONSE, DELIVERED, FAILURE_UNKNOWN_HOST, FAILURE_REQUEST_TIMEOUT, FAILURE_CONNECTION_REFUSED"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"content\": [\n {\n \"id\": \"8f6c1c4b-0ae4-4f31-9df7-2a13d5e4bc11\",\n \"event_name\": \"SHIPMENT.BL.UPDATED\",\n \"status\": \"SUCCESS_RESPONSE\",\n \"payload\": \"{\\\"sample\\\": \\\"payload\\\"}\",\n \"payload_type\": \"REAL\",\n \"payload_version\": \"v1\",\n \"is_resendable\": true,\n \"occurred_datetime\": \"2025-12-10T14:22:11\",\n \"created_datetime\": \"2025-12-10T14:22:12\"\n },\n {\n \"id\": \"4c2a7512-9b5c-4bd1-bd0a-afb22d8c1120\",\n \"event_name\": \"SHIPMENT.BL.UPDATED\",\n \"status\": \"SUCCESS_RESPONSE\",\n \"payload\": \"{\\\"sample\\\": \\\"payload\\\"}\",\n \"payload_type\": \"REAL\",\n \"payload_version\": \"v1\",\n \"is_resendable\": false,\n \"occurred_datetime\": \"2025-12-10T14:20:02\",\n \"created_datetime\": \"2025-12-10T14:20:03\"\n }\n ],\n \"pagination\": {\n \"current_page\": 1,\n \"has_next\": false,\n \"total_page\": 10,\n \"total_size\": 10\n }\n}"}],"_postman_id":"3c0d72b0-b7b8-4b10-af2f-167ccb436425"},{"name":"2. 웹훅 이벤트 로그 조회","id":"112d0af5-e7f6-4d82-a443-539890659b23","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/webhook/events/:event_id/log","description":"응답 - Response Body
\n페이지 정보 - Pagination
\n이벤트 로그 - EventLog
\nrequestCause 설명
\nrequestStatus 설명
\n","urlObject":{"path":["partners","track","v3","webhook","events",":event_id","log"],"host":["https://api.tradlinx.com"],"query":[],"variable":[{"id":"9ea42713-9806-48dc-8d6d-ab52468b930f","description":{"content":"조회할 Webhook Event ID
\n","type":"text/plain"},"type":"any","value":"","key":"event_id"}]}},"response":[{"id":"1643c261-80d8-470a-ba4e-a141531f6a09","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/webhook/events/:event_id/log","host":["https://api.tradlinx.com"],"path":["partners","track","v3","webhook","events",":event_id","log"],"variable":[{"key":"event_id","value":"","description":"조회할 Webhook Event ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"content\": [\n {\n \"id\": 101,\n \"event_id\": \"8f6c1c4b-0ae4-4f31-9df7-2a13d5e4bc11\",\n \"request_cause\": \"SUCCESS\",\n \"request_method\": \"POST\",\n \"request_url\": \"https://api.example.com/webhook\",\n \"request_status\": \"SUCCESS\",\n \"request_datetime\": \"2025-12-10T14:10:20.123456\",\n \"response_http_status\": 200,\n \"response_body\": \"{\\\"result\\\":\\\"ok\\\"}\",\n \"response_header\": \"{\\\"Content-Type\\\":\\\"application/json\\\"}\",\n \"response_datetime\": \"2025-12-10T14:10:20.543210\",\n \"attempts\": 1\n },\n {\n \"id\": 102,\n \"event_id\": \"8f6c1c4b-0ae4-4f31-9df7-2a13d5e4bc11\",\n \"request_cause\": \"SUCCESS\",\n \"request_method\": \"POST\",\n \"request_url\": \"https://api.example.com/webhook\",\n \"request_status\": \"FAILED\",\n \"request_datetime\": \"2025-12-10T14:12:05.333222\",\n \"response_http_status\": 504,\n \"response_body\": \"\",\n \"response_header\": \"{\\\"Content-Type\\\":\\\"application/json\\\"}\",\n \"response_datetime\": \"2025-12-10T14:12:10.888999\",\n \"attempts\": 2\n }\n ],\n \"pagination\": {\n \"current_page\": 1,\n \"has_next\": false,\n \"total_page\": 10,\n \"total_size\": 10\n }\n}"}],"_postman_id":"112d0af5-e7f6-4d82-a443-539890659b23"},{"name":"3. 웹훅 이벤트 재전송","id":"0ca9fb55-fac6-40f1-8fe0-4fe1fa653c1a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/webhook/events/:event_id","description":"특정 Webhook Event를 강제로 다시 전송(retry)합니다.
\n해당 이벤트의 기존 상태(SUCCESS/FAILURE 등)와 관계없이 재시도를 진행합니다.
\n이벤트 데이터의 보관 기간은 1개월로 제한되며, 해당 기간 종료 후 삭제 처리됩니다. 삭제된 이벤트는 재발송 되지 않습니다.
\nPath Variable
\n","urlObject":{"path":["partners","track","v3","webhook","events",":event_id"],"host":["https://api.tradlinx.com"],"query":[],"variable":[{"id":"789a3cd4-8eec-4c66-aef0-23a07e3b5bb3","description":{"content":"재전송할 Webhook Event ID
\n","type":"text/plain"},"type":"any","value":"","key":"event_id"}]}},"response":[{"id":"ec591c8b-ccac-4727-b31d-474e222077c0","name":"200 정상응답","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/webhook/events/:event_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","webhook","events",":event_id"],"variable":[{"key":"event_id","value":"","description":"재전송할 Webhook Event ID"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""},{"id":"62a98081-a500-484a-bb20-689d42a75d92","name":"4xx Error","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/webhook/events/:event_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","webhook","events",":event_id"],"variable":[{"key":"event_id","value":"","description":"재전송할 Webhook Event ID"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"NOT_FOUND_ENDPOINT\",\n \"transaction_time\": \"2025-03-20T05:42:27.135265\"\n}"}],"_postman_id":"0ca9fb55-fac6-40f1-8fe0-4fe1fa653c1a"}],"id":"ecb99617-101f-48bd-8d86-5956a78ff4b1","description":"B/L 트래킹 Webhook은 등록된 B/L 트래킹의 추적 정보가 변경될 때 실시간으로 이벤트를 전달하는 기능입니다.
\nWebhook 이벤트는 등록된 HTTPS Endpoint로 JSON Payload를 포함한 HTTP POST 요청 형태로 전송됩니다.
\n각 이벤트는 이벤트 정보와 최신 선적 트래킹 정보가 포함된 Payload로 구성됩니다.
\n{\n \"event_id\": \"31b1a972-677b-422c-a696-4228e3b5a8ff\",\n \"event_occurred_at\": \"2025-12-01T04:22:15.805606262\",\n \"event_name\": \"SHIPMENT.BL.UPDATED\",\n \"payload\": {}\n}\n\n{\n \"cargo_track_id\": \"3d8b1e76-8721-4e27-a98d-2bfb8193d4ee\",\n \"line_cd\": \"HMM\",\n \"bl_no\": \"HDMUPUSM12345678\",\n \"cust_order_id\": \"REFERENCE_NO\",\n \"cust_corp_name\": null,\n \"cust_name\": null,\n \"remark\": null,\n \"is_active\": true,\n \"registered_datetime\": \"2025-12-01T04:22:06.6305903Z\",\n \"tracking_status\": \"TRACKING\",\n \"is_container_plus\": true,\n \"trade_type\": \"EXPRT\",\n \"trans_type\": \"DIRECT\",\n \"pol\": {\n \"pol_name\": \"New Busan\",\n \"pol_code\": \"KRBNP\",\n \"init_etd\": \"2025-12-06T00:00:00+09:00\",\n \"etd\": \"2025-12-06T00:00:00+09:00\",\n \"atd\": null,\n \"tx_atd\": \"2025-12-06T00:00:00+09:00\"\n },\n \"pod\": {\n \"pod_name\": \"Manzanillo\",\n \"pod_code\": \"MXZLO\",\n \"init_eta\": \"2025-12-19T18:00:00-06:00\",\n \"eta\": \"2025-12-19T18:00:00-06:00\",\n \"ata\": null,\n \"tx_ata\": null\n },\n \"current_vessel\": {\n \"imo\": \"9976707\",\n \"mmsi\": \"563262300\",\n \"vessel_name\": \"ONE SAPPHIRE\",\n \"voyage\": \"2547E\"\n },\n \"routes\": [\n {\n \"order\": 1,\n \"pol_name\": \"New Busan\",\n \"pol_code\": \"KRBNP\",\n \"pod_name\": \"Manzanillo\",\n \"pod_code\": \"MXZLO\",\n \"imo\": \"9976707\",\n \"mmsi\": \"563262300\",\n \"vessel_name\": \"ONE SAPPHIRE\",\n \"voyage\": \"2547E\",\n \"init_etd\": \"2025-12-06T00:00:00+09:00\",\n \"etd\": \"2025-12-06T00:00:00+09:00\",\n \"atd\": null,\n \"tx_atd\": \"2025-12-06T00:00:00+09:00\",\n \"init_eta\": \"2025-12-19T18:00:00-06:00\",\n \"eta\": \"2025-12-19T18:00:00-06:00\",\n \"ata\": null,\n \"tx_ata\": null\n }\n ],\n \"containers\": [\n {\n \"cntr_no\": \"CAIU7471046\",\n \"cntr_sz\": \"40\",\n \"cntr_tp\": \"DC\",\n \"container_events\": [\n {\n \"port_code\": \"KRPUS\",\n \"event_type\": \"LOADING_ON_VESSEL\",\n \"transportation\": \"VESSEL\",\n \"is_actual\": true,\n \"event_datetime\": \"2025-12-05T16:45:00+09:00\"\n },\n {\n \"port_code\": \"KRPUS\",\n \"event_type\": \"VESSEL_DEPARTURE_FROM_PORT\",\n \"transportation\": \"VESSEL\",\n \"is_actual\": true,\n \"event_datetime\": \"2025-12-06T00:00:00+09:00\"\n },\n {\n \"port_code\": \"MXZLO\",\n \"event_type\": \"VESSEL_ARRIVAL_AT_PORT\",\n \"transportation\": \"VESSEL\",\n \"isActual\": false,\n \"event_datetime\": \"2025-12-19T17:00:00-06:00\"\n },\n {\n \"port_code\": \"MXZLO\",\n \"event_type\": \"VESSEL_BERTHING_ON_PORT\",\n \"transportation\": \"VESSEL\",\n \"isActual\": false,\n \"event_datetime\": \"2025-12-19T18:00:00-06:00\"\n },\n {\n \"port_code\": \"MXZLO\",\n \"event_type\": \"DISCHARGING_FROM_VESSEL\",\n \"transportation\": \"VESSEL\",\n \"isActual\": false,\n \"event_datetime\": \"2025-12-20T11:02:24-06:00\"\n }\n ]\n }\n ]\n}\n\ncontainers[].containerEvents[*]
\nWebhook 이벤트를 수신하려면 Webhook 요청을 처리할 수 있는 HTTPS Endpoint를 운영해야 합니다.
\n아래 절차에 따라 Endpoint를 등록하고 테스트해 주세요.
\nTradlinx Webhook은 JSON Payload로 전달됩니다.
\n따라서 Webhook 요청을 처리할 수 있는 HTTPS Endpoint를 반드시 구현해야 합니다.
\nEndpoint 호스트는 HTTPS 프로토콜만 지원합니다.
\n구독하고자 하는 이벤트와 해당 이벤트에서 지원하는 HTTP Method(GET, POST 등)를 허용하는 Endpoint를 구현해야 합니다.
요청 본문(Request Body)은 JSON Payload입니다.
\nPayload를 수신한 후 HTTP Status는 2xx(200, 201 등)를 반환해야 정상 수신으로 기록됩니다.
\nPayload는 가능한 한 빠르게 처리해야 합니다.
\nWebhook 전송량이 급증하는 경우 Endpoint 호스트에 과부하가 발생할 수 있습니다.
\n응답 대기 시간이 10초를 초과하는 경우가 3회 이상 반복되면 Endpoint가 비활성 상태로 전환될 수 있습니다.
\n이러한 문제를 예방하기 위해 비동기(Asynchronous) 처리를 권장합니다.
\n수신한 JSON Payload를 파싱합니다.
\nevent_id, event_name, event_occurred_at, payload.cargo_track_id 등 주요 필드를 추출합니다.
event_id는 추후 실패한 이벤트를 재전송하는 데 사용할 수 있습니다.
수신 성공 여부를 모니터링 시스템에 기록합니다.
\n현재, Webhook Endpoint는 Tradlinx 에서 직접 관리하고 있습니다.
\n아래 내용을 포함하여 [tech.support@tradlinx.com]으로 전달해 주세요.
\nSHIPMENT.BL.UPDATED이며, HTTP METHOD: POST 로만 요청합니다.제출 항목
\nWebhook Endpoint 등록이 완료되면 테스트용 Mock 이벤트가 자동 생성됩니다.
\n아래 API를 사용하면 Tradlinx 에서 제공하는 Webhook 이벤트 목록을 조회하거나, Mock 이벤트를 직접 재발송하여 Endpoint로 수동 발행할 수 있습니다.
\nMock 이벤트 재발행 기능을 활용해 Webhook Endpoint가 정상적으로 동작하는지 테스트하세요.
\nWebhook을 정상적으로 수신하려면 API 또는 SaaS(OceanVisibility)를 통해 구독하고자 하는 Tracking 대상 선적을 등록해야 합니다.
\n등록된 Tracking 대상 선적중 진행 상태 변경, 선적 상태 변경이 발생한 선적을 대상으로 Webhook이 발송됩니다.
\nWebhook 이벤트 수신 시 아래 가이드를 참고하여 데이터를 처리합니다.
\n선적 등록 시 저장하는 등록시 반환하는 `cargo_track_id`를 저장합니다.
\n이벤트 발생 시 업데이트 되는 Event Payload 담긴 선적 데이터의 식별자는 등록시 반환 되었던 `cargo_track_id` 입니다.
\n`cargo_track_id`를 기준으로, 데이터를 저장하거나 업데이트 하세요.
\n`cargo_track_id`가 저장소에 존재하지 않는 경우, 신규 선적 데이터로 저장합니다.
\n`cargo_track_id`가 저장소에 존재한다면, `event_occurred_at`을 기준으로 더 최신 데이터를 찾아, 업데이트 합니다.
\nWebhook Endpoint에서 이벤트 수신에 실패할 경우 Tradkinx는 초기 대기시간 2초 이후, 지수 백오프(Exponential Backoff) 전략을 사용하여 최대 3회까지 자동 재시도를 수행합니다.
\n자동 재시도에도 불구하고 이벤트를 받지 못한 경우, 사용자는 API 문서에서 제공하는 이벤트 목록 조회 API를 통해 실패한 이벤트를 확인할 수 있습니다.
\n특정 이벤트를 다시 수신하고 싶다면 조회한 `event_id`를 사용하여 Webhook 이벤트 재전송 API를 호출하면 해당 이벤트를 즉시 다시 받아볼 수 있습니다.
\n네트워크 상황 또는 재시도 정책에 따라, Webhook Endpoint는 동일한 이벤트를 여러 번 수신할 수 있습니다.
\nTradlinx는 재시도 시 동일한 event_id로 다시 전송하므로, 수신 측(클라이언트)의 Endpoint에서는 중복 이벤트 처리 방지 로직을 구현해야 합니다.
중복 방지 규칙
\n이벤트 수신 시 event_id 기준으로 이미 처리된 이벤트인지 기록합니다.
동일한 event_id가 다시 수신된 경우, 이는 재시도된 이벤트이므로 occurred_datetime 값을 확인하여 최신 이벤트인지 여부를 판단합니다.
이미 동일한 event_id에 대해 처리가 완료된 상태라면, 비즈니스 로직을 다시 실행하지 않고 무시해야 합니다.
event_id를 기준으로 데이터베이스, Redis, 또는 기타 스토리지에 “처리 완료” 상태를 기록합니다.
재수신된 이벤트가 존재할 경우 즉시 무시하거나 로깅만 수행하도록 합니다.
\nIMO No, MMSI, Call Sign, 선박명
\n","type":"text/plain"},"key":"keyword","value":"[Keyword]"}],"variable":[]}},"response":[{"id":"44309121-71a5-4032-a829-78a2a010c599","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/search?keyword=[Keyword]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks","search"],"query":[{"key":"keyword","value":"[Keyword]","description":"IMO No, MMSI, Call Sign, 선박명"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"call_sign\": \"SAMPLE_CALL_SIGN\",\n \"imo_no\": \"SAMPLE_IMO_NO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_id\": 1,\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\"\n }\n ],\n \"size\": 1,\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-08-21T06:15:46.608323\"\n}"}],"_postman_id":"9690ae0b-e182-4c6d-95f3-146faef524b6"},{"name":"2. 선박 트래킹 요청","id":"7bea3b16-f763-49eb-951f-20c7b83a38bd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"auto_renewal\": true,\n \"remark\": \"SAMPLE_REMARK\",\n \"track_group\": \"SAMPLE_TRACK_GROUP\",\n \"vessel_id\": 1\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/enroll","description":"선박을 트래킹 대상으로 등록합니다.
\n한 번의 요청으로 하나의 선박만 등록할 수 있습니다.
\n활성 상태의 트래킹 정보가 존재하는 선박은 중복 등록할 수 없습니다.
\n트래킹이 만료된 선박은 새로운 트래킹 요청을 통해 다시 등록할 수 있습니다.
\n트래킹 기간은 등록일로부터 1개월입니다.
\nauto_renewal을 활성화하면 만료 전에 Tracking 기간이 자동으로 1개월 연장되며, 이에 해당하는 Credit이 자동으로 차감됩니다.
TRACKING, DELETED, EXPIRED, PENDING
\n","type":"text/plain"},"key":"status","value":"[Status]"},{"description":{"content":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_from","value":"[Register From]"},{"description":{"content":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"register_to","value":"[Register To]"},{"description":{"content":"IMO No, MMSI, Call Sign, 선박명
\n","type":"text/plain"},"key":"keyword","value":"[Keyword]"},{"description":{"content":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디 목록
\n","type":"text/plain"},"key":"vessel_track_ids","value":"[Vessel Track ID],[Vessel Track ID]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"}],"variable":[]}},"response":[{"id":"b31f2a26-93cd-479c-8880-134b0133c703","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks?status=[Status]®ister_from=[Register From]®ister_to=[Register To]&keyword=[Keyword]&vessel_track_ids=[Vessel Track ID],[Vessel Track ID]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks"],"query":[{"key":"status","value":"[Status]","description":"TRACKING, DELETED, EXPIRED, PENDING"},{"key":"register_from","value":"[Register From]","description":"등록일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"register_to","value":"[Register To]","description":"등록일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"keyword","value":"[Keyword]","description":"IMO No, MMSI, Call Sign, 선박명"},{"key":"vessel_track_ids","value":"[Vessel Track ID],[Vessel Track ID]","description":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디 목록"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"expired_datetime\": \"2025-08-21T07:45:24Z\",\n \"registered_datetime\": \"2025-08-21T07:45:24Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"status\": \"TRACKING\",\n \"track_group\": \"SAMPLE_TRACK_GROUP\",\n \"updated_datetime\": \"2025-08-21T07:45:24Z\",\n \"vessel\": {\n \"call_sign\": \"SAMPLE_CALL_SIGN\",\n \"imo_no\": \"SAMPLE_IMO_NO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"vessel_id\": 1\n },\n \"vessel_track_id\": 1\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 1,\n \"has_next\": false,\n \"total_page\": 1,\n \"total_size\": 1\n },\n \"size\": 1,\n \"transaction_time\": \"2025-08-21T07:45:24.608323\"\n}"}],"_postman_id":"97c97729-bf90-4c05-a688-15147d6b45ed"},{"name":"4. 선박 트래킹 상세 조회","id":"dfb9874f-2228-4d40-98b3-de24c525d683","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","description":"선박의 상세 운항 정보 및 이동 정보를 조회합니다.
\nstatus가 TRACKING인 경우에만 상세 조회가 가능합니다.
선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"vessel_track_id"}]}},"response":[{"id":"63770204-e411-4d61-8abd-4d635eaf1ff5","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks",":vessel_track_id"],"variable":[{"key":"vessel_track_id","value":"","description":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"expired_datetime\": \"2025-08-21T07:45:24Z\",\n \"registered_datetime\": \"2025-08-21T07:45:24Z\",\n \"remark\": \"SAMPLE_REMARK\",\n \"status\": \"TRACKING\",\n \"track_group\": \"SAMPLE_TRACK_GROUP\",\n \"updated_datetime\": \"2025-08-21T07:45:24Z\",\n \"vessel\": {\n \"call_sign\": \"SAMPLE_CALL_SIGN\",\n \"imo_no\": \"SAMPLE_IMO_NO\",\n \"mmsi\": \"SAMPLE_MMSI\",\n \"vessel_name\": \"SAMPLE_VESSEL_NAME\",\n \"vessel_id\": 1\n },\n \"port_in_out_schedules\": [\n {\n \"arrival_datetime\": \"2025-01-01T00:00:00+09:00\",\n \"data_source\": \"PORT_CALL\",\n \"departure_datetime\": \"2025-01-01T00:00:00+09:00\",\n \"is_actual\": true,\n \"port_name\": \"SAMPLE_PORT_NAME\"\n }\n ],\n \"vessel_track_id\": 1\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-08-21T07:45:24.608323\"\n}"}],"_postman_id":"dfb9874f-2228-4d40-98b3-de24c525d683"},{"name":"5. 선박 트래킹 수정 요청","id":"4a4b1d18-a697-464d-9ac2-7d9563f4b99f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"remark\": \"SAMPLE_REMARK\",\n \"track_group\": \"SAMPLE_TRACK_GROUP\"\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","description":"기존 선박 트래킹 정보를 수정합니다.
\n수정 가능한 항목은 remark와 track_group입니다.
선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"vessel_track_id"}]}},"response":[{"id":"cf5030a4-1eac-4d29-86bc-c392d930c8cb","name":"200 정상응답","originalRequest":{"method":"PATCH","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"remark\": \"SAMPLE_REMARK\",\n \"track_group\": \"SAMPLE_TRACK_GROUP\"\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks",":vessel_track_id"],"variable":[{"key":"vessel_track_id","value":"","description":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": {\n \"vessel_id\": 1,\n \"vessel_track_id\": 1\n },\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-08-21T06:37:36.608323\"\n}"}],"_postman_id":"4a4b1d18-a697-464d-9ac2-7d9563f4b99f"},{"name":"6. 선박 트래킹 자동 갱신 수정 요청","id":"d3557ef3-6e78-48f1-83ca-d1c7d492f0e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"auto_renewal\": true\n }","options":{"raw":{"language":"json"}}},"url":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id/auto-renewal","description":"선박 트래킹의 자동 연장(Auto Renewal) 설정을 변경합니다.
\n한 번의 요청으로 하나의 선박 트래킹만 변경할 수 있습니다.
\nauto_renewal은 활성 상태(TRACKING)의 Tracking에 대해서만 변경할 수 있습니다.
선박트래킹 자동 갱신 수정 요청 데이터
\n","urlObject":{"path":["partners","track","v3","vessel-tracks",":vessel_track_id","auto-renewal"],"host":["https://api.tradlinx.com"],"query":[],"variable":[{"id":"e0f16e56-358d-4d0a-9f39-4c193347d2b4","description":{"content":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"vessel_track_id"}]}},"response":[{"id":"8b0109db-c3db-4662-bd60-9c2303cc63ef","name":"200 정상응답","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"auto_renewal\": true\n }","options":{"raw":{"language":"json"}}},"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id/auto-renewal","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks",":vessel_track_id","auto-renewal"],"variable":[{"key":"vessel_track_id","value":"","description":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"d3557ef3-6e78-48f1-83ca-d1c7d492f0e4"},{"name":"7. 선박 트래킹 취소 요청","id":"d529a3c6-761d-4f7e-a366-0903d746085b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","description":"선박 트래킹을 취소합니다.
\n한 번의 요청으로 하나의 선박 트래킹만 취소할 수 있습니다.
\nstatus가 TRACKING 또는 EXPIRED인 Tracking은 취소하더라도 Credit이 환불되지 않습니다.
선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디
\n","type":"text/plain"},"type":"any","value":"","key":"vessel_track_id"}]}},"response":[{"id":"c98f1ce0-85d0-4f21-806f-0a9b8d32618c","name":"200 정상응답","originalRequest":{"method":"DELETE","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/vessel-tracks/:vessel_track_id","host":["https://api.tradlinx.com"],"path":["partners","track","v3","vessel-tracks",":vessel_track_id"],"variable":[{"key":"vessel_track_id","value":"","description":"선박 추적 조회를 통해 알 수 있는 추적 건의 고유 아이디"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":""}],"_postman_id":"d529a3c6-761d-4f7e-a366-0903d746085b"}],"id":"04565a9a-9d64-4061-be74-e9baa23abb64","description":"Tradlinx는 B/L, Container, Vessel 단위의 트래킹을 지원하며, 이 페이지에서는 선박 트래킹 API를 설명합니다.
\n선박 트래킹은 선박의 실시간 위치, 입출항 정보 및 운항 정보를 제공합니다.
\n선박명(Vessel Name), IMO, MMSI 또는 Call Sign을 이용하여 선박 Tracking 정보를 조회할 수 있습니다.
\n선박 트래킹 API는 Ocean Visibility Enterprise Plan 고객에게만 제공됩니다.
\nAPI를 사용하려면 Enterprise Plan 구독이 필요합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n","_postman_id":"04565a9a-9d64-4061-be74-e9baa23abb64"},{"name":"Embedded MapView","item":[{"name":"B/L 트래킹","item":[{"name":"1. JSON Web Token 발행","id":"04a3331b-9497-4b6a-a42c-a85fdc02731e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""}],"url":"https://api.tradlinx.com/partners/auth/authenticate","description":"Embedded MapView 요청에 사용되는 JSON Web Token(JWT)을 발급합니다.
\n⚠️ 주의
\nClient ID와 API Key는 중요한 인증 정보이므로 서버에서 안전하게 관리해야 합니다.
\n브라우저 또는 외부에 공개되는 클라이언트에 절대 노출해서는 안 됩니다.
\n","urlObject":{"path":["partners","auth","authenticate"],"host":["https://api.tradlinx.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"04a3331b-9497-4b6a-a42c-a85fdc02731e"},{"name":"2. Embedded MapView 호출 (Form POST)","id":"5898570a-424d-4300-ba76-6f5cd80b226a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"authorization","value":"","description":"(required) Authorization key (JWT issued via /partners/auth/authenticate)
\n"},{"key":"searchType","value":"blNo","description":"\"blNo\" | \"po\" | \"trackMstId\" | \"customerCompany\" — Type of search query (default \"blNo\")
\n"},{"key":"searchValue","value":"SAMPLE_BL_NO","description":"Value to search for
\n"},{"key":"lang","value":"en","description":"\"ko\" | \"en\" — Language selection (default \"ko\")
\n"},{"key":"detail","value":"SHOW_ALL","description":"(required) \"SHOW_ALL\" | \"HIDE_TABS\" | \"HIDE_ALL\" — Method of displaying shipment details
\n"},{"key":"companyFilter","value":"true","description":"Whether to apply the customer filter (default true)
\n"},{"key":"startMode","value":"LIST","description":"\"LIST\" | \"HIDE_LIST\" | \"DETAIL\" — Initial state of the map view
\n"}]},"url":"https://app.tradlinx.com/partner-mapview/api/shipment","description":"B/L 트래킹 Embedded MapView 페이지를 요청합니다.
\n요청은 application/x-www-form-urlencoded 형식의 Form Data로 전송해야 합니다.
응답은 iframe에 직접 표시할 수 있는 MapView 페이지로 제공됩니다.
화물이 Bulk Carrier로 운송되는 경우, MapView에서 해당 선박은 \"Bulk\" 아이콘으로 표시됩니다.
B/L 트래킹 Embedded MapView는 Tradlinx Ocean Visibility의 지도 화면을 고객사의 서비스에 직접 임베드할 수 있는 기능입니다.
\n트래킹 데이터를 기반으로 컨테이너 이동 경로, 선박 위치, 운항 경로 및 화물 상태를 별도의 지도 화면을 직접 개발하지 않고도 시각화할 수 있습니다.
\nB/L 트래킹 Embedded MapView는 웹 콘텐츠 및 iframe을 지원하는 모든 환경에서 사용할 수 있습니다.
전체 화면 (지도 + Shipment 목록): 1440 × 900
\n지도만 표시: 800 × 600
\nB/L 트래킹 Embedded MapView API는 Ocean Visibility Enterprise Plan 고객에게만 제공됩니다.
\nAPI를 사용하려면 Enterprise Plan 구독이 필요합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n인증은 API 사용자가 구현한 Backend Middleware를 통해 처리해야 합니다.
\nClient ID와 API Key는 브라우저에 직접 노출되어서는 안 됩니다.
\nBrowser가 Middleware에 JWT Token을 요청합니다.
\nMiddleware가 Ocean Visibility API에 JWT Token을 요청합니다.
\nOcean Visibility API가 Middleware에 JWT Token을 반환합니다.
\nMiddleware가 Browser에 JWT Token을 반환합니다.
\nBrowser가 JWT Token을 포함하여 Embedded MapView를 요청합니다.
\nOcean Visibility MapView Server가 MapView를 반환합니다.
\n빠른 테스트를 위해 샘플 코드를 제공합니다.
\n구현 방식은 자유롭게 변경할 수 있으며, 필수 요청 규격만 준수하면 됩니다.
\n아래 코드는 참고용 예제입니다.
\n<html> \n <head> \n <title>Tradlinx Ocean Visibility B/L Embedded MapView TEST</title> \n </head> \n <body> \n <form action=\"https://app.tradlinx.com/partner-mapview/api/shipment\" name=\"viewer_form\" id=\"viewer_form\" target=\"viewer\" method=\"post\"> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"oceanVisibilityMap\"> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 시작 --> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선적 상세정보</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"fold\" value=\"false\" id=\"foldFalse\" checked /> \n <label for=\"foldFalse\">자세히 보기</label> \n <input type=\"radio\" name=\"fold\" value=\"true\" id=\"foldTrue\" /> \n <label for=\"foldTrue\">개요 보기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>언어</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"lang\" value=\"ko\" id=\"langKo\" checked /> \n <label for=\"langKo\">한국어</label> \n <input type=\"radio\" name=\"lang\" value=\"en\" id=\"langEn\" /> \n <label for=\"langEn\">영어</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>고객사 필터</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"companyFilter\" value=\"true\" id=\"companyFilterOn\" checked /> \n <label for=\"companyFilterOn\">필터 보기</label> \n <input type=\"radio\" name=\"companyFilter\" value=\"false\" id=\"companyFilterOff\" /> \n <label for=\"companyFilterOff\">필터 숨기기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>최초 상태</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"startMode\" value=\"LIST\" id=\"startModeList\" checked /> \n <label for=\"startModeList\">목록 보기</label> \n <input type=\"radio\" name=\"startMode\" value=\"HIDE_LIST\" id=\"startModeHideList\" /> \n <label for=\"startModeHideList\">목록 숨기기</label> \n <input type=\"radio\" name=\"startMode\" value=\"DETAIL\" id=\"startModeDetail\" /> \n <label for=\"startModeDetail\">첫번째 선적 상세 보기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>컨트롤러 기능 표기</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"checkbox\" name=\"controllers\" value=\"FULL_SCREEN\" id=\"controllersFullScreen\" checked /> \n <label for=\"controllersFullScreen\">전체 화면</label> \n <input type=\"checkbox\" name=\"controllers\" value=\"DIMENSION\" id=\"controllersDimension\" /> \n <label for=\"controllersDimension\">차원 전환</label> \n <input type=\"checkbox\" name=\"controllers\" value=\"LANG_SET\" id=\"controllersLangSet\" /> \n <label for=\"controllersLangSet\">언어 전환</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선적 상세 내 탭 노출</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"SHIPMENT_ROUTE\" id=\"detailTabsShipmentRoute\" checked /> \n <label for=\"detailTabsShipmentRoute\">상세정보 탭</label> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"PORT_CALLS\" id=\"detailTabsPortCalls\" /> \n <label for=\"detailTabsPortCalls\">항로 탭</label> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"SAIL_LOG\" id=\"detailTabsSailLog\" /> \n <label for=\"detailTabsSailLog\">항로로그 탭</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>검색</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <select name=\"searchType\" id=\"selectType\"> \n <option value=\"blNo\">B/L</option> \n <option value=\"po\">PO</option> \n <option value=\"trackMstId\">ID</option> \n <option value=\"customerCompany\">고객사</option> \n </select> \n <input type=\"text\" name=\"searchValue\" id=\"keyword\" /> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <button type=\"submit\" id=\"button_map\">조회</button> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 끝 --> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 지도 조회 영역 시작 --> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"frame\"> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> style=\"border: 1px solid black; height: 700px; width: 100%\" 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> allowfullscreen 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> name=\"viewer\" 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> > 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </iframe> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;> 지도 조회 영역 끝 </comment> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </form> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </body> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> <script> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> window.addEventListener(\"DOMContentLoaded\", () => { 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> // 미들웨어에서 받은 토큰으로 <input type="hidden" /> 생성 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> fetch(\"{ 인증토큰 발행 EndPoint }\") 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> .then((item) => item.text()) 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> .then((authToken) => { 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> const input = document.createElement(\"input\"); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"type\", \"hidden\"); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"name\", \"authorization\"); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"value\", authToken); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> const form = document.getElementById(\"viewer_form\"); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> form.appendChild(input); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> }); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> }); 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </script> 
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'></html> 
</div></code></pre><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ><strong class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' >MapView Example</b> 
</p><img class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' src=https://static-cdn.tradlinx.com/images/ov/mapview_example_250724.png alt=\"mapview_sample\" /></p><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ></p></x-turndown></code></p><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ></p></x-turndown>\n\nEmbedded MapView 요청에 사용되는 JSON Web Token(JWT)을 발급합니다.
\n⚠️ 주의
\nClient ID와 API Key는 중요한 인증 정보이므로 서버에서 안전하게 관리해야 합니다.
\n브라우저 또는 외부에 공개되는 클라이언트에 절대 노출해서는 안 됩니다.
\n","urlObject":{"path":["partners","auth","authenticate"],"host":["https://api.tradlinx.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"ad199328-236b-488f-9841-3bd0dead60e1"},{"name":"2. Embedded MapView 호출 (Form POST)","id":"8d1676ed-6b31-44cc-8ff0-712cd79eca9c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"authorization","value":"","description":"(required) Authorization key (JWT issued via /partners/auth/authenticate)
\n"},{"key":"searchType","value":"containerNo","description":"\"containerNo\" | \"po\" | \"trackMstId\" | \"customerCompany\" — Type of search query (default \"containerNo\")
\n"},{"key":"searchValue","value":"SAMPLE_CNTR_NO","description":"Value to search for
\n"},{"key":"lang","value":"en","description":"\"ko\" | \"en\" — Language selection (default \"ko\")
\n"},{"key":"detail","value":"SHOW_ALL","description":"(required) \"SHOW_ALL\" | \"HIDE_TABS\" | \"HIDE_ALL\" — Method of displaying shipment details
\n"},{"key":"companyFilter","value":"true","description":"Whether to apply the customer filter (default true)
\n"},{"key":"startMode","value":"LIST","description":"\"LIST\" | \"HIDE_LIST\" | \"DETAIL\" — Initial state of the map view
\n"}]},"url":"https://app.tradlinx.com/partner-mapview/api/container","description":"컨테이너 트래킹 Embedded MapView 페이지를 요청합니다.
\n요청은 application/x-www-form-urlencoded 형식의 Form Data로 전송해야 합니다.
응답은 iframe에 직접 표시할 수 있는 MapView 페이지로 제공됩니다.
컨테이너 트래킹 Embedded MapView는 Tradlinx Ocean Visibility의 지도 화면을 고객사의 서비스에 직접 임베드할 수 있는 기능입니다.
\n컨테이너 트래킹 데이터를 기반으로 컨테이너 이동 경로, 선박 위치, 운항 경로 및 화물 상태를 별도의 지도 화면을 직접 개발하지 않고도 시각화할 수 있습니다.
\n컨테이너 트래킹 Embedded MapView는 웹 콘텐츠 및 iframe을 지원하는 모든 환경에서 사용할 수 있습니다.
전체 화면 (지도 + Shipment 목록): 1440 × 900
\n지도만 표시: 800 × 600
\n컨테이너 트래킹 Embedded MapView API는 Ocean Visibility Enterprise Plan(월 100건 이상) 고객에게만 제공됩니다.
\nAPI를 사용하려면 Enterprise Plan 구독이 필요합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n인증은 API 사용자가 구현한 Backend Middleware를 통해 처리해야 합니다.
\nClient ID와 API Key는 브라우저에 직접 노출되어서는 안 됩니다.
\n![\"mapview_flow\"](\"https://static-cdn.tradlinx.com/images/ov/mapview_250602.png\")
\n\nBrowser가 Middleware에 JWT Token을 요청합니다.
\nMiddleware가 Ocean Visibility API에 JWT Token을 요청합니다.
\nOcean Visibility API가 Middleware에 JWT Token을 반환합니다.
\nMiddleware가 Browser에 JWT Token을 반환합니다.
\nBrowser가 JWT Token을 포함하여 Embedded MapView를 요청합니다.
\nOcean Visibility MapView Server가 MapView를 반환합니다.
\n빠른 테스트를 위해 샘플 코드를 제공합니다.
\n구현 방식은 자유롭게 변경할 수 있으며, 필수 요청 규격만 준수하면 됩니다.
\n아래 코드는 참고용 예제입니다.
\n%3C!DOCTYPE%20html%3E%20\n<html> \n <head> \n <title>Tradlinx Ocean Visibility Container Embedded MapView TEST</title> \n </head> \n <body> \n <form action=\"https://app.tradlinx.com/partner-mapview/api/container\" name=\"viewer_form\" id=\"viewer_form\" target=\"viewer\" method=\"post\"> \n <input type=\"hidden\" name=\"authorization\" value=\"{{ 여기에 인증 토큰을 입력하세요 }}\" /> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"oceanVisibilityMap\"> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 시작 --> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선적 상세정보</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"fold\" value=\"false\" id=\"foldFalse\" checked /> \n <label for=\"foldFalse\">자세히 보기</label> \n <input type=\"radio\" name=\"fold\" value=\"true\" id=\"foldTrue\" /> \n <label for=\"foldTrue\">개요 보기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>언어</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"lang\" value=\"ko\" id=\"langKo\" checked /> \n <label for=\"langKo\">한국어</label> \n <input type=\"radio\" name=\"lang\" value=\"en\" id=\"langEn\" /> \n <label for=\"langEn\">영어</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>고객사 필터</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"companyFilter\" value=\"true\" id=\"companyFilterOn\" checked /> \n <label for=\"companyFilterOn\">필터 보기</label> \n <input type=\"radio\" name=\"companyFilter\" value=\"false\" id=\"companyFilterOff\" /> \n <label for=\"companyFilterOff\">필터 숨기기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>최초 상태</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"radio\" name=\"startMode\" value=\"LIST\" id=\"startModeList\" checked /> \n <label for=\"startModeList\">목록 보기</label> \n <input type=\"radio\" name=\"startMode\" value=\"HIDE_LIST\" id=\"startModeHideList\" /> \n <label for=\"startModeHideList\">목록 숨기기</label> \n <input type=\"radio\" name=\"startMode\" value=\"DETAIL\" id=\"startModeDetail\" /> \n <label for=\"startModeDetail\">첫번째 선적 상세 보기</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>컨트롤러 기능 표기</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"checkbox\" name=\"controllers\" value=\"FULL_SCREEN\" id=\"controllersFullScreen\" checked /> \n <label for=\"controllersFullScreen\">전체 화면</label> \n <input type=\"checkbox\" name=\"controllers\" value=\"DIMENSION\" id=\"controllersDimension\" /> \n <label for=\"controllersDimension\">차원 전환</label> \n <input type=\"checkbox\" name=\"controllers\" value=\"LANG_SET\" id=\"controllersLangSet\" /> \n <label for=\"controllersLangSet\">언어 전환</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선적 상세 내 탭 노출</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"SHIPMENT_ROUTE\" id=\"detailTabsShipmentRoute\" checked /> \n <label for=\"detailTabsShipmentRoute\">상세정보 탭</label> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"PORT_CALLS\" id=\"detailTabsPortCalls\" /> \n <label for=\"detailTabsPortCalls\">항로 탭</label> \n <input type=\"checkbox\" name=\"detailTabs\" value=\"SAIL_LOG\" id=\"detailTabsSailLog\" /> \n <label for=\"detailTabsSailLog\">항로로그 탭</label> \n </div> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>검색</div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <select name=\"searchType\" id=\"selectType\"> \n <option value=\"containerNo\">Container</option> \n <option value=\"po\">PO</option> \n <option value=\"trackMstId\">ID</option> \n <option value=\"customerCompany\">고객사</option> \n </select> \n <input type=\"text\" name=\"searchValue\" id=\"keyword\" /> \n </div> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> \n <button type=\"submit\" id=\"button_map\">조회</button> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 끝 --> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 지도 조회 영역 시작 --> \n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"frame\"> \n <iframe style=\"border: 1px solid black; height: 700px; width: 100%\" allowfullscreen name=\"viewer\"> </iframe> \n </div> \n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 지도 조회 영역 끝 --> \n </div> \n </div> \n </div> \n </form> \n </body> \n</html> \n\nEmbedded MapView 요청에 사용되는 JSON Web Token(JWT)을 발급합니다.
\n⚠️ 주의
\nClient ID와 API Key는 중요한 인증 정보이므로 서버에서 안전하게 관리해야 합니다.
\n브라우저 또는 외부에 공개되는 클라이언트에 절대 노출해서는 안 됩니다.
\n","urlObject":{"path":["partners","auth","authenticate"],"host":["https://api.tradlinx.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"84d052b9-f5a0-4e82-9ed5-515c162c05c0"},{"name":"2. Embedded MapView 호출 (Form POST)","id":"797a2e4b-2184-4062-b9e2-da94ac89d2e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"urlencoded","urlencoded":[{"key":"authorization","value":"","description":"(required) Authorization key (JWT issued via /partners/auth/authenticate)
\n"},{"key":"searchType","value":"keyword","description":"\"keyword\" | \"trackGroup\" — Type of search query (default \"keyword\")
\n"},{"key":"searchValue","value":"SAMPLE_VESSEL_NAME","description":"Value to search for
\n"},{"key":"lang","value":"en","description":"\"ko\" | \"en\" — Language selection (default \"ko\")
\n"},{"key":"detail","value":"SHOW_ALL","description":"(required) \"SHOW_ALL\" | \"HIDE_TABS\" | \"HIDE_ALL\" — Method of displaying vessel details
\n"},{"key":"trackGroupFilter","value":"true","description":"Whether to apply the vessel group filter (default true)
\n"},{"key":"startMode","value":"LIST","description":"\"LIST\" | \"HIDE_LIST\" | \"DETAIL\" — Initial state of the map view
\n"}]},"url":"https://app.tradlinx.com/partner-mapview/api/vessel","description":"선박 트래킹 Embedded MapView 페이지를 요청합니다.
\n요청은 application/x-www-form-urlencoded 형식의 Form Data로 전송해야 합니다.
응답은 iframe에 직접 표시할 수 있는 MapView 페이지로 제공됩니다.
선박 트래킹 Embedded MapView는 Tradlinx Ocean Visibility의 지도 화면을 고객사의 서비스에 직접 임베드할 수 있는 기능입니다.
\n선박 트래킹 데이터를 기반으로 선박 위치, 운항 경로 및 입출항 정보를 별도의 지도 화면을 직접 개발하지 않고도 시각화할 수 있습니다.
\n선박 트래킹 Embedded MapView는 웹 콘텐츠 및 iframe을 지원하는 모든 환경에서 사용할 수 있습니다.
전체 화면 (지도 + Vessel 목록): 1440 × 900
\n지도만 표시: 800 × 600
\n선박 트래킹 Embedded MapView API는 Ocean Visibility Enterprise Plan(월 100건 이상) 고객에게만 제공됩니다.
\nAPI를 사용하려면 Enterprise Plan 구독이 필요합니다.
\n기능 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.
\n인증은 API 사용자가 구현한 Backend Middleware를 통해 처리해야 합니다.
\nClient ID와 API Key는 브라우저에 직접 노출되어서는 안 됩니다.
\n\n\nBrowser가 Middleware에 JWT Token을 요청합니다.
\nMiddleware가 Ocean Visibility API에 JWT Token을 요청합니다.
\nOcean Visibility API가 Middleware에 JWT Token을 반환합니다.
\nMiddleware가 Browser에 JWT Token을 반환합니다.
\nBrowser가 JWT Token을 포함하여 Embedded MapView를 요청합니다.
\nOcean Visibility MapView Server가 MapView를 반환합니다.
\n빠른 테스트를 위해 샘플 코드를 제공합니다.
\n구현 방식은 자유롭게 변경할 수 있으며, 필수 요청 규격만 준수하면 됩니다.
\n아래 코드는 참고용 예제입니다.
\n<html>\n <head>\n <title>Tradlinx Ocean Visibility Vessel Embedded MapView TEST</title>\n </head>\n <body>\n <form action=\"https://app.tradlinx.com/partner-mapview/api/vessel\" name=\"viewer_form\" id=\"viewer_form\" target=\"viewer\" method=\"post\">\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"oceanVisibilityMap\">\n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 시작 -->\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선박 상세정보</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"radio\" name=\"detail\" value=\"SHOW_ALL\" id=\"detailShowAll\" checked />\n <label for=\"detailShowAll\">전체 보기</label>\n <input type=\"radio\" name=\"detail\" value=\"HIDE_TABS\" id=\"detailHideTabs\" />\n <label for=\"detailHideTabs\">개요 보기</label>\n <input type=\"radio\" name=\"detail\" value=\"HIDE_ALL\" id=\"detailHideAll\" />\n <label for=\"detailHideAll\">숨기기</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>언어</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"radio\" name=\"lang\" value=\"ko\" id=\"langKo\" checked />\n <label for=\"langKo\">한국어</label>\n <input type=\"radio\" name=\"lang\" value=\"en\" id=\"langEn\" />\n <label for=\"langEn\">영어</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선박 그룹 필터</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"radio\" name=\"trackGroupFilter\" value=\"true\" id=\"trackGroupFilterOn\" checked />\n <label for=\"trackGroupFilterOn\">필터 보기</label>\n <input type=\"radio\" name=\"trackGroupFilter\" value=\"false\" id=\"trackGroupFilterOff\" />\n <label for=\"trackGroupFilterOff\">필터 숨기기</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>최초 상태</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"radio\" name=\"startMode\" value=\"LIST\" id=\"startModeList\" checked />\n <label for=\"startModeList\">목록 보기</label>\n <input type=\"radio\" name=\"startMode\" value=\"HIDE_LIST\" id=\"startModeHideList\" />\n <label for=\"startModeHideList\">목록 숨기기</label>\n <input type=\"radio\" name=\"startMode\" value=\"DETAIL\" id=\"startModeDetail\" />\n <label for=\"startModeDetail\">첫번째 선박 상세 보기</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>컨트롤러 기능 표기</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"checkbox\" name=\"controllers\" value=\"FULL_SCREEN\" id=\"controllersFullScreen\" checked />\n <label for=\"controllersFullScreen\">전체 화면</label>\n <input type=\"checkbox\" name=\"controllers\" value=\"DIMENSION\" id=\"controllersDimension\" />\n <label for=\"controllersDimension\">차원 전환</label>\n <input type=\"checkbox\" name=\"controllers\" value=\"LANG_SET\" id=\"controllersLangSet\" />\n <label for=\"controllersLangSet\">언어 전환</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>선박 상세 내 탭 노출</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <input type=\"checkbox\" name=\"detailTabs\" value=\"PORT_CALLS\" id=\"detailTabsPortCalls\" />\n <label for=\"detailTabsPortCalls\">항로 탭</label>\n <input type=\"checkbox\" name=\"detailTabs\" value=\"SAIL_LOG\" id=\"detailTabsSailLog\" />\n <label for=\"detailTabsSailLog\">항로 로그 탭</label>\n </div>\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>검색</div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <select name=\"searchType\" id=\"selectType\">\n <option value=\"keyword\">키워드</option>\n <option value=\"trackGroup\">선박 그룹</option>\n </select>\n <input type=\"text\" name=\"searchValue\" id=\"searchValue\" />\n </div>\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <button type=\"submit\" id=\"button_map\">조회</button>\n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 입력 영역 끝 -->\n <comment class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> 지도 조회 영역 시작 -->\n <div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' id=\"frame\">\n </div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> style=\"border: 1px solid black; height: 700px; width: 100%\"\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> allowfullscreen\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> name=\"viewer\"\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> >\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </iframe>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> <comment class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27; class=&#x27;preserveHtml&#x27;> 지도 조회 영역 끝 </comment>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </div>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </form>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </body>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> <script>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> window.addEventListener(\"DOMContentLoaded\", () => {\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> // 미들웨어에서 받은 토큰으로 <input type="hidden" /> 생성\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> fetch(\"{ 인증토큰 발행 EndPoint }\")\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> .then((item) => item.text())\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> .then((authToken) => {\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> const input = document.createElement(\"input\");\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"type\", \"hidden\");\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"name\", \"authorization\");\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> input.setAttribute(\"value\", authToken);\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> const form = document.getElementById(\"viewer_form\");\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> form.appendChild(input);\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> });\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> });\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'> </script>\n
</div><div class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'></html>\n
</div></code></pre><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ><strong class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ></b></p><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ></p><p class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' ></p></x-turndown>\n\n항만 코드(Port Code)를 입력하여 항만혼잡도 데이터를 조회합니다.
\n한 번의 요청으로 최대 30개의 Port Code를 조회할 수 있습니다.
\ncontent 내 날짜 및 시간 필드는 ISO 8601 형식(yyyy-MM-dd'T'HH:mm:ssZ)으로 제공됩니다.
(required) 항만 코드 목록
\n","type":"text/plain"},"key":"port_code_list","value":"[Port Code],[Port Code]"},{"description":{"content":"(required) 평균 집계 기간
\n","type":"text/plain"},"key":"average_period_type_list","value":"[Average Period Type],[Average Period Type]"}],"variable":[]}},"response":[{"id":"87f9b0fa-ad83-4c89-9cfa-13935ce07215","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/port-congestion?port_code_list=[Port Code],[Port Code]&average_period_type_list=[Average Period Type],[Average Period Type]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","port-congestion"],"query":[{"key":"port_code_list","value":"[Port Code],[Port Code]","description":"(required) 항만 코드 목록"},{"key":"average_period_type_list","value":"[Average Period Type],[Average Period Type]","description":"(required) 평균 집계 기간"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2026-01-12T01:22:55.347646\",\n \"content\": [\n {\n \"port_code\": \"KRINC\",\n \"port_name\": \"Incheon\",\n \"average_berth_delay_hours\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"value\": 13.1\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"value\": 9.23\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"value\": 10.98\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"value\": 12.38\n }\n ],\n \"berth_pending_vessel_count\": 20,\n \"average_berth_duration_hours\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"value\": 20.87\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"value\": 20.33\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"value\": 22.08\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"value\": 24.77\n }\n ],\n \"port_congestion_index_levels\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"level\": \"STABLE\"\n }\n ],\n \"berthing_vessel_count\": 6,\n \"latitude\": 37.343784,\n \"longitude\": 126.631836,\n \"updated_datetime\": \"2026-01-12T01:04:02Z\"\n },\n {\n \"port_code\": \"KRPUS\",\n \"port_name\": \"Busan\",\n \"average_berth_delay_hours\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"value\": 6.98\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"value\": 7.35\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"value\": 8.0\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"value\": 9.13\n }\n ],\n \"berth_pending_vessel_count\": 109,\n \"average_berth_duration_hours\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"value\": 14.95\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"value\": 16.08\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"value\": 17.25\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"value\": 18.7\n }\n ],\n \"port_congestion_index_levels\": [\n {\n \"period_type\": \"THREE_DAYS\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"ONE_WEEK\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"TWO_WEEKS\",\n \"level\": \"STABLE\"\n },\n {\n \"period_type\": \"ONE_MONTH\",\n \"level\": \"STABLE\"\n }\n ],\n \"berthing_vessel_count\": 30,\n \"latitude\": 35.10612,\n \"longitude\": 129.08546,\n \"updated_datetime\": \"2026-01-12T01:04:02Z\"\n }\n ]\n}"},{"id":"cd205f35-00dc-4fe7-972d-38b30f1c52cf","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/port-congestion?port_code_list=[Port Code],[Port Code]&average_period_type_list=[Average Period Type],[Average Period Type]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","port-congestion"],"query":[{"key":"port_code_list","value":"[Port Code],[Port Code]","description":"(required) 항만 코드 목록"},{"key":"average_period_type_list","value":"[Average Period Type],[Average Period Type]","description":"(required) 평균 집계 기간"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[average_period_type_list]: Required field is not provided.\",\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"transaction_time\": \"2025-08-28T07:21:13.367404\"\n}"},{"id":"3f0facc9-40c2-4954-a6ac-5e01bd9cdba7","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/port-congestion?port_code_list=[Port Code],[Port Code]&average_period_type_list=[Average Period Type],[Average Period Type]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","port-congestion"],"query":[{"key":"port_code_list","value":"[Port Code],[Port Code]","description":"(required) 항만 코드 목록"},{"key":"average_period_type_list","value":"[Average Period Type],[Average Period Type]","description":"(required) 평균 집계 기간"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"c1956a1f-24ce-4c2c-a9a3-24680b59985e"}],"id":"5c631236-a880-4cd6-81c8-413e8e342544","description":"항만혼잡도 API는 AIS 선박 위치 데이터를 기반으로 항만의 혼잡도 정보를 제공합니다.
\n접안 구역(Berth Area)과 묘박 구역(Anchorage Area)의 선박 운항 현황을 바탕으로 항만 혼잡도를 확인하고, 선박 운항 및 화물 운영에 미칠 수 있는 영향을 파악할 수 있습니다.
\n지원하는 항만에 대해 표준화된 항만 혼잡도 데이터를 제공하여, 일관된 방식으로 항만 현황을 조회할 수 있습니다.
\n항만혼잡도 API는 별도 구독이 필요한 서비스이며, Ocean Visibility Enterprise Plan에는 포함되어 있지 않습니다.
\n요금 및 이용 가능 여부는 담당 영업사원 또는 help@tradlinx.com 으로 문의해 주세요.
\n","_postman_id":"5c631236-a880-4cd6-81c8-413e8e342544"},{"name":"공급망 이슈 모니터링 API","item":[{"name":"1. 공급망 이슈 카테고리 조회","id":"40acb324-1274-4774-b26d-45f05f167299","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/supply-chain/categories","description":"공급망 이슈 기사 목록을 조회합니다.
\n한 번의 요청으로 최대 50개의 기사를 조회할 수 있습니다.
\n진행 상태
\n","type":"text/plain"},"key":"category_ids","value":"[Category ID],[Category ID],[Category ID]"},{"description":{"content":"게시일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"published_from","value":"[Published From]"},{"description":{"content":"게시일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)
\n","type":"text/plain"},"key":"published_to","value":"[Published To]"},{"description":{"content":"(required) 페이지 번호 (최소: 1)
\n","type":"text/plain"},"key":"page","value":"[Page]"},{"description":{"content":"(required) 페이지 크기 (범위: 1~50)
\n","type":"text/plain"},"key":"size","value":"[Size]"}],"variable":[]}},"response":[{"id":"f7acfaf1-bd02-4dcd-bb73-5f5d5b319683","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/supply-chain/articles?category_ids=[Category ID],[Category ID],[Category ID]&published_from=[Published From]&published_to=[Published To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","supply-chain","articles"],"query":[{"key":"category_ids","value":"[Category ID],[Category ID],[Category ID]","description":"진행 상태"},{"key":"published_from","value":"[Published From]","description":"게시일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"published_to","value":"[Published To]","description":"게시일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"content\": [\n {\n \"title\": \"SAMPLE_TITLE_NAME\",\n \"categories\": [\n \"SAMPLE_CATEGORY_NAME\"\n ],\n \"link\": \"SAMPLE_LINK\",\n \"published_at\": \"2025-09-08T00:00:00Z\",\n \"source\": \"SAMPLE_SOURCE_NAME\"\n },\n {\n \"title\": \"SAMPLE_TITLE_NAME\",\n \"categories\": [\n \"SAMPLE_CATEGORY_NAME_1\",\n \"SAMPLE_CATEGORY_NAME_2\"\n ],\n \"link\": \"SAMPLE_LINK\",\n \"published_at\": \"2025-09-08T00:00:00Z\",\n \"source\": \"SAMPLE_SOURCE_NAME\"\n }\n ],\n \"message\": \"SAMPLE_ERROR_CODE\",\n \"pagination\": {\n \"current_page\": 0,\n \"has_next\": false,\n \"total_page\": 0,\n \"total_size\": 0\n },\n \"size\": 1,\n \"transaction_time\": \"2025-09-08T02:08:01.397Z\"\n}"},{"id":"44335eb6-b5b2-4dae-bc48-34b73d5711ea","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/supply-chain/articles?category_ids=[Category ID],[Category ID],[Category ID]&published_from=[Published From]&published_to=[Published To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","supply-chain","articles"],"query":[{"key":"category_ids","value":"[Category ID],[Category ID],[Category ID]","description":"진행 상태"},{"key":"published_from","value":"[Published From]","description":"게시일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"published_to","value":"[Published To]","description":"게시일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"This feature is not supported on your current plan.\",\n \"transaction_time\": \"2025-09-08 01:54:43\",\n \"message\": \"UNSUPPORTED_FEATURE\"\n}"},{"id":"66603f03-cbaa-4b4e-8d73-5685015c3e28","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"https://api.tradlinx.com/partners/track/v3/supply-chain/articles?category_ids=[Category ID],[Category ID],[Category ID]&published_from=[Published From]&published_to=[Published To]&page=[Page]&size=[Size]","host":["https://api.tradlinx.com"],"path":["partners","track","v3","supply-chain","articles"],"query":[{"key":"category_ids","value":"[Category ID],[Category ID],[Category ID]","description":"진행 상태"},{"key":"published_from","value":"[Published From]","description":"게시일 범위 (시작일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"published_to","value":"[Published To]","description":"게시일 범위 (종료일)(ISO 8601 날짜 형식: yyyy-MM-dd'T'HH:mm:ssXXX)"},{"key":"page","value":"[Page]","description":"(required) 페이지 번호 (최소: 1)"},{"key":"size","value":"[Size]","description":"(required) 페이지 크기 (범위: 1~50)"}]}},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": 500,\n \"type\": \"Internal Server Error\",\n \"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"e9656bd6-30cb-4d71-9c38-9d61f2652640"}],"id":"f4c2cb68-1994-4305-8d05-d12553e54bb2","description":"공급망 이슈 모니터링 API는 해상 물류와 관련된 Supply Chain 뉴스를 제공합니다.
\nAPI를 통해 물류 운영에 영향을 줄 수 있는 뉴스 및 이벤트를 조회할 수 있습니다.
\n공급망 이슈 모니터링 API는 별도 구독이 필요한 서비스이며, 다른 API 구독에 포함되지 않습니다.
\n요금 및 이용 가능 여부는 담당 영업사원 또는 help@tradlinx.com 으로 문의해 주세요.
\n","_postman_id":"f4c2cb68-1994-4305-8d05-d12553e54bb2"},{"name":"FCL 스케줄 API","item":[{"name":"Port 목록 조회 API","id":"a57c977d-35a0-4a83-94ca-a24ac9deb354","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":"","type":"text"},{"key":"tx-apikey","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.tradlinx.com/fcl/port","description":"Port 객체의 배열(Port[])로 제공됩니다.FCL 스케줄 목록을 조회합니다.
\n페이징 정보가 없거나 유효하지 않을 경우 전체 데이터를 반환합니다.
\nFclScheduleDetail 객체의 배열(FclScheduleDetail[])로 제공됩니다.FCL 스케줄 API는 Full Container Load(FCL) 해상 운송 스케줄 정보를 조회할 수 있는 API입니다.
\n출발지와 목적지 정보를 기준으로 선박 스케줄을 조회할 수 있으며, ETD(출발 예정일), ETA(도착 예정일), 운항 선사, 선박 정보 등 FCL 운송 계획에 필요한 다양한 스케줄 데이터를 제공합니다.
\n이를 통해 고객은 자사 시스템에 해상 운송 스케줄을 연동하여 선적 계획을 수립하고, 운송 일정 관리 및 물류 운영을 보다 효율적으로 수행할 수 있습니다.
\nFCL 스케줄 API는 별도 구독이 필요한 서비스이며, 다른 API 구독에 포함되지 않습니다.
\n요금 및 이용 가능 여부는 담당 영업사원 또는 help@tradlinx.com 으로 문의해 주세요.
\n","_postman_id":"33651e5a-7a15-4678-8b77-b70b758c11d9"},{"name":"컨테이너 터미널 스케줄 API","item":[{"name":"터미널 목록 조회 API","id":"5360236c-1361-43c2-8c69-33cb91493957","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":"","type":"text"},{"key":"tx-apikey","value":"","type":"text"},{"key":"Content-Type","value":"application/json","type":"text"}],"url":"https://api.tradlinx.com/terminals/client","description":"Terminal 객체의 배열(Terminal[])로 제공됩니다.컨테이너 터미널 스케줄을 조회합니다.
\n페이징 정보가 없거나 유효하지 않을 경우 전체 데이터를 반환합니다.
\n컨테이너 터미널 스케줄 API는 국내 컨테이너 터미널의 스케줄정보를 조회할 수 있는 API입니다.
\n터미널명, 터미널 코드, 웹사이트 URL과 함께 터미널의 선박별 입출항 스케줄을 조회할 수 있습니다. 이를 통해 물류 운영에 필요한 여러 터미널의 데이터를 일관된 형식으로 제공합니다.
\n이를 통해 고객은 자사 시스템에 터미널 정보를 연동하여 선적 일정 관리, 터미널 조회 및 물류 운영 업무를 보다 효율적으로 수행할 수 있습니다.
\n컨테이너 터미널 스케줄 API는 별도 구독이 필요한 서비스이며, 다른 API 구독에 포함되지 않습니다.
\n요금 및 이용 가능 여부는 담당 영업사원 또는 help@tradlinx.com 으로 문의해 주세요.
\n","_postman_id":"33d8e7cb-7c44-4ae0-93ae-2633ed52a4f0"},{"name":"참고자료","item":[{"name":"오류 코드","item":[{"name":"트래킹 API 오류 코드","item":[],"id":"d13a6c9e-a2e3-483b-83a9-599a83410b7d","description":"이 문서에서는 B/L, Container, Vessel 트래킹 API 중 v2와 v3 에서 사용하는 오류 코드와 그에 대한 사유를 안내합니다.
\n오류 정보는 버전별로 아래와 같이 제공됩니다.
\nv2 API: reason 필드에 오류를 나타내는 Error Code가 반환됩니다.
v3 API: reason 필드에 숫자 코드 대신 오류 식별자(Description)가 반환됩니다.
v2 API: reason에 Error Code 코드 사용 (예: \"5\").
\nv3 API: reason에 Description 사용 (예: \"COLLECT_NOT_ACCEPT\").
\n두 API는 동일한 오류 정보를 다른 방식으로 제공.
\n{\n \"api_version\": \"v2\",\n \"transaction_time\": \"2024-11-14T04:40:30.790634\",\n \"content\": {\n \"success\": [],\n \"fail\": [\n {\n \"data\": {\n \"line_cd\": \"HMM\",\n \"bl_no\": \"BL123456789\"\n },\n \"reason\": \"5\"\n }\n ],\n \"total_count\": 1,\n \"success_count\": 0,\n \"fail_count\": 1\n }\n}\n\n{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2024-11-14T04:40:30.790634\",\n \"content\": {\n \"success\": [],\n \"fail\": [\n {\n \"data\": {\n \"line_cd\": \"HMM\",\n \"bl_no\": \"BL123456789\"\n },\n \"reason\": \"COLLECT_NOT_ACCEPT\"\n }\n ],\n \"total_count\": 1,\n \"success_count\": 0,\n \"fail_count\": 1\n }\n}\n\n응답 - Response Body
\n사용 가능한 크레딧의 정보 - CreditResponse
\n크레딧 종류
\n","urlObject":{"path":["partners","track","v3","credits","usage"],"host":["https://api.tradlinx.com"],"query":[],"variable":[]}},"response":[{"id":"574c83de-c21d-4c1e-b4d5-2d95a479dae0","name":"200 정상응답","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/credits/usage"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"api_version\": \"v3\",\n \"transaction_time\": \"2025-07-08T08:01:16.533152\",\n \"content\": [\n {\n \"creditType\": \"T_CREDIT\",\n \"credit\": 100,\n \"usedCredit\": 30,\n \"remainCredit\": 70,\n \"startAt\": \"2024-12-22T15:00:00\",\n \"expiredAt\": \"2029-12-22T15:00:00\"\n },\n {\n \"creditType\": \"PLAN_CREDIT\",\n \"credit\": 500000,\n \"usedCredit\": 5950,\n \"remainCredit\": 494050,\n \"startAt\": \"2025-06-30T15:00:00\",\n \"expiredAt\": \"2025-07-31T15:00:00\"\n }\n ]\n}"},{"id":"8197fb64-efdb-46dd-9d7b-0bbe010a8089","name":"400 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/credits/usage"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"error_detail\": \"This feature is not supported in your plan.\",\n\t\"transaction_time\": \"2025-03-20T05:42:27.123243\"\n}"},{"id":"538a2ab9-9726-4b2c-9caa-4d6da946f81b","name":"500 에러","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://api.tradlinx.com/partners/track/v3/credits/usage"},"status":"Internal Server Error","code":500,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n\t\"status\": 500,\n\t\"type\": \"Internal Server Error\",\n\t\"message\": \"Internal server error. Please try again in a few minutes.\"\n}"}],"_postman_id":"1406e70c-d89d-4992-a512-533fbe98165c"}],"id":"82dc45a1-dc4b-431f-bd03-5fee0bd6b1b2","description":"Credit Usage API는 Tradlinx Ocean Visibility API에서 사용하는 Credit 정보를 제공합니다.
\nAPI를 통해 Credit 유형별 할당량, 사용량, 잔여량 및 유효기간을 조회할 수 있습니다.
\n","_postman_id":"82dc45a1-dc4b-431f-bd03-5fee0bd6b1b2"},{"name":"추적 가능한 선사 목록","item":[],"id":"9f0f8ca1-d3b9-48af-b71b-0c5d5cc73512","description":"Tradlinx Ocean Visibility는 전 세계 주요 선사의 Shipment Tracking을 지원합니다.
\n아래 표에서 선사별로 지원되는 Tracking 방식(B/L Tracking, Container No. Tracking)을 확인할 수 있습니다.
\n이 페이지에서는 Tradlinx API에서 공통으로 사용하는 Port Code 목록을 제공합니다.
\nPort Code는 POL, POD 등 Ocean Visibility에서 항만과 관련된 Request 및 Response 필드에서 공통적으로 사용됩니다.
\n본 문서에는 Ocean Visibility API에서 사용하는 Port Code만 포함되어 있으며, 모든 Location Code를 제공하지는 않습니다.
\n입력값을 검증하거나 API 응답을 해석할 때 이 목록을 참고해 주세요.
\nPort Code는 Tradlinx에서 정의한 기준을 사용하며, 외부 시스템에서 사용하는 Port Code와 다를 수 있습니다.
\n아래에는 가장 자주 문의되는 질문과 답변을 정리해두었습니다.
\n추가로 궁금한 사항이 있으시면 담당 영업사원 또는 tech.support@tradlinx.com으로 문의해 주세요.
\nAPI를 이용하시려면 help@tradlinx.com 또는 담당 영업사원을 통해 요청해주세요.
\n미팅 후 Client ID와 API Key가 발급됩니다.
\n아니요. 현재는 별도의 테스트 환경을 제공하지 않습니다.
\n모든 API 테스트는 운영(Production) 환경에서 진행됩니다.
\n401 User authentication failed가 발생합니다.Client ID 또는 API Key가 올바르게 설정되지 않았을 가능성이 있습니다.
\nClient ID와 API Key가 모두 보이도록 Account Settings 화면을 캡처한 후 tech.support@tradlinx.com으로 보내주시면 확인해 드리겠습니다.
\n\"This feature is not supported on your current plan.\" 오류가 발생합니다.사용하려는 API 또는 기능명을 알려주시고, 해당 기능이 현재 구독 플랜에 포함되어 있는지 담당 영업사원에게 문의해 주세요.
\n현재 Ocean Visibility는 하나의 로그인 계정만 지원합니다.
\n필요한 경우 동일한 계정 정보를 여러 사용자가 함께 사용할 수 있습니다.
\nB/L 트래킹
\nMaster B/L을 기준으로 화물을 추적합니다.
\n동일한 B/L에 속한 모든 컨테이너의 추적 정보를 제공합니다.
\n컨테이너 트래킹
\nMaster B/L이 없어도 사용할 수 있습니다.
\nContainer Number를 기준으로 화물을 추적합니다.
\nTradlinx 에서 정의한 Carrier Code를 사용해야 합니다.
\n일반적인 SCAC Code와 다를 수 있습니다. 자세한 내용은 참고자료 > 추적 가능한 선사 목록 문서를 참고해 주세요.
\n추적 가능한 선사 목록은 선사 연동 및 운영 정책에 따라 변경될 수 있습니다.
\n변경 사항이 있을 경우 이메일을 통해 안내드립니다.
\nreference_no는 무엇인가요?reference_no는 고객이 직접 관리하는 식별자입니다.
PO 번호나 House B/L 번호 등을 자유롭게 사용할 수 있습니다.
\n아니요. 트래킹 번호는 다른 고객의 정보이므로 제공할 수 없습니다.
\n테스트 시에는 고객님의 실제 화물 정보를 사용해 주세요.
\n네. 선사에서 제공하는 시간과 AIS 기반 시간을 모두 제공합니다.
\n네. B/L 트래킹에서는 Webhook을 지원합니다.
\nWebhook 사용을 원하시면 tech.support@tradlinx.com으로 문의해 주세요.
\n다음과 같은 이유로 차이가 발생할 수 있습니다.
\n트래킹 업데이트 주기에 따른 일시적인 동기화 지연
\n선사 홈페이지와 API에서 제공하는 정보의 차이
\n선사의 데이터 업데이트 시점 차이
\n차이가 계속되는 경우 cx@tradlinx.com으로 문의해 주세요.
\n대부분 line_cd가 올바르지 않은 경우입니다.
Tradlinx는 일반적인 SCAC Code가 아닌 자체 Carrier Code를 사용합니다.
\n자세한 내용은 참고자료 > 추적 가능한 선사 목록 문서를 참고해 주세요.
\n아니요. 기존 트래킹을 취소한 후 다시 등록해 주세요.
\n페이지당 최대 조회 건수는 50건으로 제한되어 있습니다.
\n모든 데이터를 조회하려면 page, has_next, total_page를 이용해 페이지를 순차적으로 조회해 주세요.
Credit 유효기간은 UTC 기준으로 계산됩니다.
\n네. Timezone 정보가 명시되지 않은 Datetime 값은 모두 UTC 기준으로 해석하면 됩니다.
\n아니요. 기존 트래킹이 아직 만료되지 않았다면 Credit은 다시 차감되지 않으며 기존 만료일도 그대로 유지됩니다.
\n동일한 vessel_track_id를 계속 사용합니다.
Auto Renewal이 활성화되어 있으면 만료 하루 전에 Credit이 차감되고, 트래킹 기간이 한 달 연장됩니다.
\ndata_source 필드는 무엇을 의미하나요?PORT_CALL: AIS 기반 실제 입출항 정보
\nCarrier Code (MAE, ONE, ZIM 등): 선사에서 제공하는 운항 스케줄 정보
\ndata_source 값은 변경될 수 있나요?네. 입항 전에는 선사 스케줄 정보를 나타낼 수 있으며,
\n선박이 모니터링 중인 항만에 실제 도착하면 PORT_CALL로 변경될 수 있습니다.
is_actual 값을 사용하는 것이 좋나요?is_actual보다는 data_source 사용을 권장합니다.
PORT_CALL은 AIS 기반 실제 데이터이며, Carrier Code는 변경될 수 있는 선사 스케줄 정보를 의미합니다.
만료일은 항상 등록일 기준 한 달 후입니다.
\n다만 월별 날짜 수가 다르므로 실제 일수는 달라질 수 있습니다.
\n항만혼잡도 데이터는 매일 한국시간(KST) 오전 10시경 업데이트됩니다.
\n실제 업데이트 시각은 응답의 updated_datetime 값을 참고해 주세요.
average_period_type_list에는 어떤 값을 사용할 수 있나요?다음 값을 사용할 수 있습니다.
\nTHREE_DAYS
ONE_WEEK
TWO_WEEKS
ONE_MONTH
요청한 값만 응답으로 반환됩니다.
\n","_postman_id":"35de3c3b-bb51-40ec-a1e3-e3e8c63c9c19"}],"id":"cc630715-eac7-4f19-94d7-1eb285ea28fd","_postman_id":"cc630715-eac7-4f19-94d7-1eb285ea28fd","description":""}],"variable":[{"key":"base_url","value":"https://api.tradlinx.com"},{"key":"tx-clientid","value":""},{"key":"tx-apikey","value":""},{"key":"mapview_base_url","value":"https://app.tradlinx.com"},{"key":"mapview_token","value":""}]}