shlee322/delivery-tracker

🚚 Delivery and Shipping Tracking Service

Delivery Tracker

Delivery and Shipping Tracking Service

Usage

Cloud (Managed Service)

Visit : https://tracker.delivery

Self-Hosted

Setting Up the Development Environment

Delivery Tracker can be set up in local development environments and is also readily available for setup through GitHub Codespaces.

Follow the instructions below for GitHub Codespaces:

1. Click the "Open in GitHub Codespaces" button above to create a new Codespace.
2. Once in your Codespace terminal, enter pnpm install to install the necessary dependencies.
3. In GitHub Codespaces, navigate to the "Run and Debug" section from the sidebar and then click the "Run" button for "@delivery-tracker/server" to launch the server.
4. The service URL can be accessed via the Ports panel at the bottom of the GitHub Codespaces interface.

Deploying Self-Hosted Services

See Dockerfile

Additional Information

License

• Please read the LICENSE file.

Contact

• Please contact [email protected] for more information.

Project Structure

• packages/api : GraphQL API
• packages/core : Scraper code
• packages/cli : A Command Line Interface (CLI) tool that uses the execute function from packages/api.
• packages/http : A self-hosted GraphQL HTTP server that uses the execute function from packages/api.

Request additional carriers

See https://tracker.delivery/request-additional-carrier

delivery-tracker's Issues

롯데택배 운송 시작 전 에러

롯데택배 API 사용시 극히 일부 경우 아래와 같은 에러 발생
Cannot read property 'textContent' of undefined

운송 시작 전 조회 시 발생하는 것으로 추측 (확인 필요)

우체국택배 오류 메세지

1~2일전 부터 택배조회가 안되고 있습니다.
배송조회 API로 사용중인데 결과값에 도달하지 못하고
{
"message": "해당 운송장이 존재하지 않습니다."
}
라는 메세지를 출력됩니다.
개별적으로 우체국 자체 조회는 되고요.

한진택배가 이상하게 안되는 것 같습니다~

https://www.hanjin.co.kr/kor/CMS/DeliveryMgr/WaybillResult.do?mCode=MN038&wblnum=510683980391&schLang=KR&wblnumText=

다음과 같이 배송완료 되었는데~

언젠가부터

connect ECONNREFUSED 211.210.94.28:443

라고 나오면서 한진이 트랙킹이 안되는 것 같습니다 ^^

롯데는 또 잘되더라구요~

publish npm package

npm install로 설치할수있게 부탁드립니다.

return null when waybill invalid or not found

안드로이드에서 Retrofit2를 이용하여 api를 이용하는데 잘못된 운송장이나, 아직 등록이 되지 않은 운송장에 대해서는 return이 null로 나옵니다. 혹시 API에서 반환해 주지 않는걸까 해서 질문 남깁니다.

Add Dockerfile & Deploy Docker Hub

[대신택배] 조회가 되지 않습니다.

송장번호를 정상적으로 입력했음에도
403번 에러가 뜨네요.

개발하시느라 고생이 많으십니다. ^^

현재 우체국택배 모든 운송장 번호가 조회가 되지 않습니다.

현재 우체국택배 모든 운송장 번호가 조회가 되지 않습니다.

{"message":"해당 운송장이 존재하지 않습니다."}

라고 모든 운송장번호가 이렇게 response 받습니다.

de.dhl 502 Error

[CJ대한통운] 배송 조회가 되지 않습니다.

Delivery Tracker 서비스를 애용하고 있는 개발자입니다.

사용한 송장 번호는 632976615493입니다.

CJ대한통운의 택배 조회 사이트(https://www.cjlogistics.com/ko/tool/parcel/tracking)에서 조회하면 정상적으로 조회가 되는데,
Tracker API를 이용한 링크(https://apis.tracker.delivery/carriers/kr.cjlogistics/tracks/632976615493)에서 조회하면 조회가 되지 않는 것 같습니다.

확인 부탁드립니다. 감사합니다.

롯데 택배 state가 at_pickup으로 나옵니다.

롯데 택배의 경우 다른 택배와 다르게 progressses가 반대로 나와서 state가 가장 첫번째 배송 과정인 at_pickup으로 나오는 문제가 있는 것 같습니다.

status 별 우선순위 조정

시간 순 데이터가 아니라 delivered 상태를 최우선으로 조정하는 옵션 제공

2023년 Roadmap

안녕하세요. 딜리버리 트래커 개발자 이상혁입니다.

취미로 시작한 프로젝트인데 많은 분들이 관심 가져주시고 사용해주셔서 감사합니다.
몇달 동안 큰 업데이트가 없었는데요.

앞으로는 주말에 시간을 내서 주기적으로 프로젝트를 개선해나가고자 합니다.

2021년2022년2023년에는 다음과 같은 개선이 있을 것으로 예상 됩니다.
새로운 기능 제안이나 PR 은 언제든지 환영합니다.

• status 사이트 제공
• 안정적인 API 서비스 (cloud version 아키텍처 개선)
• 전반적인 코드 리팩토링 및 공식 웹사이트 개발
• 추가적인 택배사 추가
• API 개선 / 스키마 제공
• WebHook 기능 (운송장 상태 변경 시 노티)
• Proxy 기능

롯데 국제택배 추가 부탁드립니다.

https://www.lotteglogis.com/home/reservation/global/track

현재 API로는 롯데택배 - 국제택배 조회가 안되네요
감사합니다!

특정상황에서 배송조회가 제대로 되지 않는거 같습니다.

운송장 번호는 한진 506738618960 입니다.
한진택배사이트나 네이버에서는 배송완료로 상태가 변경되었는는데
delivery-tracker 에서는 배송출발까지의 상태만 표기됩니다.
해당 운송장 번호를 한진택배에서 조회해보니, 배송완료 시간이 배송출발시간보다 빠르게
나와있던데, 이런경우에 제대로 결과가 안나오는거 같습니다.

우체국 택배 조회 안됨

어제부터 우체국 택배가 안되는거 같습니다. 6월8일

잘되던게 갑자기 조회가 안되네요 cj대한통운입니다

고생이 정말 많으십니다 ㅠㅠ

347575800551 송장번호로 하면 잘나오는데

여기서는 안나오네요 ㅠㅠ

도와주십시요!!

ESLint

China Post 추가해주세요

API를 이용해서 앱 개발 시 앱에서 API테스트는 어떻게 하나요?

API를 이용해서 앱 개발 시 앱에서 API테스트는 어떻게 하나요?

실제 운송장 번호 입력하여 해야하는 건지,

아니면 따로 테스트 해볼 수 있는 운송장번호가 있어

API 확인을 할 수 있는건지,

API 적용 시 테스트는 어떻게 해야하는 지 알려주시면 감사하겠습니다.

i18n(English, more) Support

will develop i18n using these libraries.

• https://github.com/mashpie/i18n-node
• https://github.com/kazupon/vue-i18n

로젠택배 404

Request failed with status code 404

뜨면서 안불러와지네요

kr.logen 404 Error

위 사진처럼 현재 로젠택배 carrier 스크립트에 있는 url 은 404 에러가 발생합니다.
http://203.247.141.67/iLOGEN.Web.New/TRACE/TraceDetail.aspx

로젠택배 택배 검색 주소가 이쪽으로 바뀐것 같습니다.
https://www.ilogen.com/web/personal/tkSearch

Add Carrier - USPS

Multi Frontend Template

503 Error is occurred !

안녕하세요.
그동안 훌륭한 서비스를 잘 사용하고 있었습니다.
정말 감사합니다.
그런데 어제밤(1월 8일) 부터 API 503 에러가 나고 있습니다.
확인 요청 부탁드리겠습니다.
감사합니다.

CJ택배 조회 안됨

택배사에서 운송장 조회하면 되는데

배송조회 페이지에서 뒤집힌 택배차와 Cannot read property 'id' of undefined 라는 메시지가 떠요

DHL 배송 조회 무한 Loading Error

DHL 배송 조회 시 Response가 출력되지 않고 계속 무한 Loading이 되네요, DHL 회사의 문제인지 또는 다른 오류인지 확인부탁드립니다. 다른 배송사들은 모두 정상적으로 작동되는 것 같습니다!

Add Carrier - DHL

한진택배 API 오류 수정

한진택배의 배송조회 스크래핑 URL 및 파싱 수정

Add Carriers (Sprint-1)

Carriers List

• CJ대한통운 (kr.cjlogistics)
• CU 편의점택배 (kr.cupost)
• CVSnet 편의점택배 (kr.cvsnet)
• Cway Express (kr.cway #24)
• DHL (de.dhl #36)
• DHL Global Mail (de.dhl.ecommerce)
• ECMS Express ()
• EMS (un.upu.ems #38)
• Fedex (us.fedex #39)
• GSI Express (us.gsiexpress)
• GSMNtoN (kr.gsmnton)
• i-Parcel (us.i-parcel)
• SLX (kr.slx #46)
• TNT Express (nl.tnt #44)
• UPS (us.ups #40)
• USPS (us.usps #41)
• 건영택배 (kr.kunyoung #35)
• 경동택배 (kr.kdexp #34)
• 대신택배 (kr.daesin #37)
• 로젠택배 (kr.logen)
• 롯데택배 (kr.lotte)
• 성원글로벌카고 (kr.swgexp)
• 에어보이익스프레스 (us.airboyexpress)
• 우체국택배 (kr.epost)
• 워펙스코리아 (us.warpex)
• 일양로지스 (kr.ilyanglogis #33)
• 천일택배 (kr.chunilps #32)
• 판토스 (kr.pantos)
• 한의사랑택배 (kr.hanips #47)
• 한진택배 (kr.hanjin)
• 합동택배 (kr.hdexp #31)
• 한서호남택배 (kr.honamlogis #30)
• 홈픽택배 (kr.homepick #29)

Excepted

• KGB택배 : 자금난으로 운영 중단 상태으로 파악됨
• KGL네트웍스 : 홈페이지 내에 배송조회 기능을 찾을 수 없음
• 한덱스 : 한진택배와 통합
• 굿투럭 : 사이트 500 에러
• YJS글로벌(영국)
• 세방 : 배송조회 기능 찾을 수 없음
• 우리한방택배 : 운송장 번호 취득까지 보류
• 은하쉬핑 (kr.ieunha) : 운송장 번호 취득까지 보류
• 하이택배 : 운송장 번호 취득까지 보류
• 홈이노베이션로지스

배송 조회시 state 의 코드값은 어떤 것들이 있을까요?

안녕하세요 따로 문서화 된 부분을 찾지 못해 깃을 통해 질문 드립니다.

배송조회 API의 response중 state의 정의된 코드값이 알고 싶습니다.

delivered : 배송완료
..... : 집하
.....: 배송중

혹은 해당 API를 이용하여 '집하' 상태도 조회가 가능한 것인지 궁금합니다.

감사합니다.

npm install problem

below is tested on Ubuntu 18.04.

it needs root privilege.

$ npm install -g delivery-tracker-apiserver
npm WARN checkPermissions Missing write access to /usr/local/lib

install fails with the following error message.

$ sudo npm install -g delivery-tracker-apiserver delivery-tracker-client
npm ERR! Linux 5.0.0-31-generic
npm ERR! argv "/usr/bin/node" "/usr/bin/npm" "install" "-g" "delivery-tracker-apiserver" "delivery-tracker-client"
npm ERR! node v8.10.0
npm ERR! npm  v3.5.2

npm ERR! Cannot convert undefined or null to object
npm ERR! 
npm ERR! If you need help, you may report this error at:
npm ERR!     <https://github.com/npm/npm/issues>

npm ERR! Please include the following file with any support request:
npm ERR!     /home/skyer9/npm-debug.log

Http GET request 요청 시 HttpResponse 의 status code 가 false 로 나오는 오류

Http GET request 요청 시 HttpResponse 의 status code 가 false 로 나오는 오류가 나옵니다.
실제로 response를 제대로 client에서 받았는데 status code가 true 가 아니라 false로 뜹니다.

client 코드:
using (var client = new HttpClient())
{
using (HttpResponseMessage response = await client.GetAsync(uriStr))
{
DbgMsg = string.Format("HTTP Get Req.");
if (response.IsSuccessStatusCode)
{
var responseContent = response.Content.ReadAsStringAsync().Result;
DbgMsg = string.Format("Req Success.");
return false;
}
DbgMsg = string.Format($"Req. Fail-{response.IsSuccessStatusCode}");
return false;
}
}
return false;

여기서 실제로 response를 받았는데 , response.IsSuccessStatusCode 값이 false로 뜨네요.
API server에서 보내줄 때 status code로 확인 부탁 드립니다.

GraphQL Service

REST API로 구현되어있는데 GraphQL로 래핑해서도 서비스해주시면 좋을 것 같습니다.

npm으로 설치시 에러가 나는데 ㅠㅠ

gyp WARN EACCES user "root" does not have permission to access the dev dir "/root/.node-gyp/10.15.0"
gyp WARN EACCES attempting to reinstall using temporary dev dir "/root/.nvm/versions/node/v10.15.0/lib/node_modules/delivery-tracker-apiserver/node_modules/iconv/.node-gyp"
gyp WARN install got an error, rolling back install
gyp WARN install got an error, rolling back install
gyp ERR! configure error
gyp ERR! stack Error: EACCES: permission denied, mkdir '/root/.nvm/versions/node/v10.15.0/lib/node_modules/delivery-tracker-apiserver/node_modules/iconv/.node-gyp'
gyp ERR! System Linux 2.6.32-642.13.1.el6.x86_64
gyp ERR! command "/root/.nvm/versions/node/v10.15.0/bin/node" "/root/.nvm/versions/node/v10.15.0/lib/node_modules/npm/node_modules/node-gyp/bin/node-gyp.js" "rebuild"
gyp ERR! cwd /root/.nvm/versions/node/v10.15.0/lib/node_modules/delivery-tracker-apiserver/node_modules/iconv
gyp ERR! node -v v10.15.0
gyp ERR! node-gyp -v v3.8.0
gyp ERR! not ok
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! [email protected] install: node-gyp rebuild
npm ERR! Exit status 1
npm ERR!
npm ERR! Failed at the [email protected] install script.
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.

npm ERR! A complete log of this run can be found in:
npm ERR! /root/.npm/_logs/2019-01-15T07_19_32_346Z-debug.log

로젠택배 404 에러

로젠택배로 값을 넘기면
{
"message": "Request failed with status code 404"
}

값이 이렇게 나와서 조회가 안됩니다

cj대한통운택배조회 502 에러가 발생합니다.

https://tracker.delivery/guide 페이지에서 cj대한통운택배를 조회하면 주말부터 계속 Loading.. 메시지만 찍혀서
별도로 메시지를 확인해보니 502 BadGateway 등의 메시지가 반환되는 것을 확인했습니다.

혹시 cj측에서 외부 접근을 막아서 생기는 현상일까요?

바쁘시겠지만 무슨 문제인지 알려주실 수 있으면 감사하겠습니다.

한진택배 데이터가 안불러 집니다..

밑에는 한진택배 조회 사이트
https://hanex.hanjin.co.kr/kor/CMS/DeliveryMgr/WaybillResult.do?mCode=MN038&wblnum=420329077081&schLang=KR&wblnumText=420329077081

Add Carrier - FedEx

UPS 택배 조회 불가능합니다.

UPS 택배 조회 시 "403" 에러 발생 되며
"www.ups.com/track" 에서 조회 시 정상 조회 가능합니다.

API V2 Design (+ OpenAPI v3 Document)

• Versions (url base, content-type base)
• Response Content Type Change (application/vnd.~)
• /carriers -> /v1/couriers
• state -> status

[DHL] 504 Gateway Time-out 에러 발생

홈페이지 배송 조회 API에서도 Loading만 뜨고,
직접 GET 요청 하면 504 Gateway Time-out이 발생합니다.

확인 해주시면 감사하겠습니다.

frontend trackId non-numeric letter input error

세방 택배사 추가 했으면 합니다.

세방택배

롯데택배 error ㅜ.ㅜ

롯데택배 사이트 리뉴얼 되면서 tracking 접근 url이 변경된 것 같습니다.
조회가 안되네용 엉엉 ;ㅂ;

Pantos Express 추가 부탁 드립니다.

안녕하세요

평소 delivery tracker를 애용하고 있는 이용자 입니다.
혹시 괜찮으시다면, 운송사에 판토스 추가해주실 수 있으실까요~?

늘 감사 드리며, 건강 유의하세요 ^.^

감사합니다!!!!!!!!!!!!!!!!

Add Carrier - UPS

KG로지스 추가 부탁드립니다.

안녕하세요. 잘 사용하고 있습니다.

KG로지스 추가 부탁드립니다 :-)

동시 트랙픽 혹은 트래픽에 제한이 어느정도 인지 알고 싶습니다.

동시트래픽 혹은 트래픽에 대해 어느정도 제한이 있는지에 대한 정보가 없어서 글 올립니다.