{"info":{"_postman_id":"d622eaa8-9583-4d23-a207-d7a58c751537","name":"Tradlinx 공유 링크 API (KO)","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"description":"","owner":"55482299","collectionId":"d622eaa8-9583-4d23-a207-d7a58c751537","publishedId":"2sBY4LQ1bS","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"2D69FF"},"publishDate":"2026-07-13T05:37:45.000Z"},"item":[{"name":"공유 링크","item":[{"name":"1. 공유 링크 생성/연장","id":"501d02b0-ec36-4a79-a73b-63f6ecd0930d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/partners/track/v3/cargo-tracks/share-link/:track_mst_id","description":"

B/L 트래킹에 대해 새로운 Share Link를 생성하거나 기존 Share Link의 만료 기간을 연장합니다.
\n
해당 화물에 대해 유효한 Share Link가 이미 존재하는 경우에는 기존 Share Link를 반환하고 만료 기간만 연장합니다.
\n

응답 - Response Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description	Remark
api_version	`string`	API 버전
content	`ShareLink`	공유 링크 정보
transaction_time	`string`	응답이 제공된 시간(UTC)	`yyyy-MM-dd'T'HH:mm:ss.SSSSSS`

공유 링크 정보 - ShareLink

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description	Remark
track_mst_id	`string`	선적 추적 ID (UUID)
url	`string`	공유 링크 URL
end_date_time	`string`	공유 링크 만료 일시	[ISO 8601 날짜/시간 형식] `yyyy-MM-dd'T'HH:mm:ssXXX`

","urlObject":{"path":["partners","track","v3","cargo-tracks","share-link",":track_mst_id"],"host":["{{base_url}}"],"query":[],"variable":[{"id":"7905607c-15fb-4a61-a79d-b2afef9d6eb1","description":{"content":"

Identifier assigned when registering cargo tracking (UUID)

\n","type":"text/plain"},"type":"any","value":"","key":"track_mst_id"}]}},"response":[{"id":"43f7bc56-4a99-4fd4-9769-854fc629f409","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link/:track_mst_id","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link",":track_mst_id"],"variable":[{"key":"track_mst_id","value":"","description":"Identifier assigned when registering cargo tracking (UUID)"}]}},"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-03-18T23:30:40.852291\",\n \"content\": {\n \"track_mst_id\": \"550e8400-abcd-efgh-a716-446655440000\",\n \"url\": \"https://testx.tradlinx.com/TESTTEST1\",\n \"end_date_time\": \"2026-04-18T00:00:00.000+0000\"\n }\n}"}],"_postman_id":"501d02b0-ec36-4a79-a73b-63f6ecd0930d"},{"name":"2. 공유 링크 여러 건 조회","id":"d637a25d-899a-4db8-b983-d74347a17ecb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","description":"

하나 이상의 화물에 대한 공유 링크 정보를 조회합니다.

응답 - Response Body

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description	Remark
api_version	`string`	API 버전
content	`ShareLink[]`	공유 링크 정보
size	`number`	content 항목 수
transaction_time	`string`	응답이 제공된 시간 (UTC)	`yyyy-MM-dd'T'HH:mm:ss.SSSSSS`

공유 링크 정보 - ShareLink

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Description	Remark
track_mst_id	`string`	선적 추적 ID (UUID)
url	`string`	공유 링크 URL
end_date_time	`string`	공유 링크 만료 일시	[ISO 8601 날짜/시간 형식] `yyyy-MM-dd'T'HH:mm:ssXXX`

","urlObject":{"path":["partners","track","v3","cargo-tracks","share-link"],"host":["{{base_url}}"],"query":[{"description":{"content":"

(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30

\n","type":"text/plain"},"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]"}],"variable":[]}},"response":[{"id":"a9ed1e65-ea9e-48c6-8228-462c27af72df","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"content\": [\n {\n \"track_mst_id\": \"550e8400-abcd-efgh-a716-446655440000\",\n \"url\": \"https://testx.tradlinx.com/TESTTEST1\",\n \"end_date_time\": \"2026-04-18T00:00:00.000+0000\"\n },\n {\n \"track_mst_id\": \"660e8400-abcd-efgh-a716-446655440000\",\n \"url\": \"https://testx.tradlinx.com/TESTTEST2\",\n \"end_date_time\": \"2026-04-20T00:00:00.000+0000\"\n }\n ],\n \"size\": 2,\n \"transaction_time\": \"2026-03-18T15:30:00.000000\"\n}"},{"id":"9dcd7ba6-a177-49e7-afb7-ba6f459b4ea6","name":"400 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"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-03-18 09:13:36\",\n \"message\": \"RESOURCE_NOT_FOUND\"\n}"},{"id":"45663ad2-c221-4217-a7f1-5da30710baa3","name":"400 Error (2)","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"error_detail\": \"[track_mst_ids]: Required field is not provided.\",\n \"transaction_time\": \"2026-03-18 23:22:27\"\n}"},{"id":"73ef7eeb-9685-4310-94fb-4d08a5a09a44","name":"403 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"status":"Forbidden","code":403,"_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\": \"2026-03-18T07:21:13\",\n \"message\": \"UNSUPPORTED_FEATURE\"\n}"},{"id":"7ace9c0e-8ac3-4434-965c-225cd7e4840b","name":"500 Error","originalRequest":{"method":"GET","header":[{"key":"tx-clientid","value":"{{tx-clientid}}"},{"key":"tx-apikey","value":"{{tx-apikey}}"},{"key":"Content-Type","value":"application/json"}],"url":{"raw":"{{base_url}}/partners/track/v3/cargo-tracks/share-link?track_mst_ids=[Track MST ID],[Track MST ID]","host":["{{base_url}}"],"path":["partners","track","v3","cargo-tracks","share-link"],"query":[{"key":"track_mst_ids","value":"[Track MST ID],[Track MST ID]","description":"(required) Identifiers assigned when registering cargo tracking (UUID), comma-separated, up to 30"}]}},"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":"d637a25d-899a-4db8-b983-d74347a17ecb"}],"id":"bba7f54f-3f3f-41c4-9658-0b39f6cc054d","description":"

✅ 공유 링크 API - 개요

공유 링크 API는 B/L Shipment Tracking API의 확장 기능으로 제공됩니다.

공유 링크 API를 사용하면 B/L Tracking API를 통해 등록한 화물의 공유 링크를 생성할 수 있습니다. 생성된 링크를 통해 Tradlinx에 로그인하지 않아도 화물의 추적 상태, 선박 정보, 운항 경로, 컨테이너 이벤트 등 추적 정보를 확인할 수 있습니다.

공유 링크는 B/L Tracking API를 통해 등록한 화물에 대해서만 사용할 수 있습니다.

✅ Enterprise Plan 필요

공유 링크 API 이용을 원하시는 경우 help@tradlinx.com 으로 메일 주시거나 담당 영업사원에게 요청해주세요.

\n","_postman_id":"bba7f54f-3f3f-41c4-9658-0b39f6cc054d"}]}