Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/afiqiqmal/parcel-track
Parcel Tracker Packagist for Local Malaysia Parcel Courier .
https://github.com/afiqiqmal/parcel-track
abx-express api citylink courier dhl-express fedex gdexpress hacktoberfest lazada library malaysia open-source parcel php poslaju poslaju-php skynet tracker travis-ci
Last synced: about 1 month ago
JSON representation
Parcel Tracker Packagist for Local Malaysia Parcel Courier .
- Host: GitHub
- URL: https://github.com/afiqiqmal/parcel-track
- Owner: afiqiqmal
- Created: 2018-05-02T06:00:57.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-04-19T21:25:07.000Z (over 1 year ago)
- Last Synced: 2024-05-21T02:22:20.789Z (6 months ago)
- Topics: abx-express, api, citylink, courier, dhl-express, fedex, gdexpress, hacktoberfest, lazada, library, malaysia, open-source, parcel, php, poslaju, poslaju-php, skynet, tracker, travis-ci
- Language: PHP
- Homepage: https://packagist.org/packages/afiqiqmal/parcel-track
- Size: 132 KB
- Stars: 16
- Watchers: 2
- Forks: 9
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
Awesome Lists containing this project
README
# Parcel Tracker
[](https://travis-ci.org/afiqiqmal/parcel-track)
[](https://codecov.io/gh/afiqiqmal/parcel-track)
[](https://packagist.org/packages/afiqiqmal/parcel-track)
[](https://packagist.org/packages/afiqiqmal/parcel-track)
[](https://www.paypal.com/paypalme/mhi9388?locale.x=en_US)
Simple Parcel Tracker for Local Parcel Courier.
Basically it just crawl the courier website or existing API. Need time to time to monitor web/api changes before failure happen.
BTW, Currently available (Successfully Scraped)
1. [Post Laju](https://www.poslaju.com.my/)
2. [GDEX](http://www.gdexpress.com/malaysia/home/)
3. [ABX Express](http://www.abxexpress.com.my/)
4. [DHL Express](https://www.logistics.dhl/my-en/home.html)
5. [DHL E-Commerce](https://www.logistics.dhl/my-en/home/our-divisions/ecommerce.html)
6. [SkyNet Express](http://www.skynet.com.my/)
7. [CityLink Express](http://www.citylinkexpress.com/MY/Consignment.aspx)
8. [FedEx Express](https://www.fedex.com/my/)
9. [LEL Express](http://www.lex.com.my/)
10. [KTM Distribution Sdn Bhd](http://www.ktmd.com.my/tracking/)
11. [UPS](https://wwwapps.ups.com/WebTracking/track)
Tested in PHP 7.1 Only
## Installation
#### Step 1: Install from composer
```
composer require afiqiqmal/parcel-track
```
Alternatively, you can specify as a dependency in your project's existing composer.json file
```
{
"require": {
"afiqiqmal/parcel-tracker": "^1.0"
}
}
```
## Usage
After installing, you need to require Composer's autoloader and add your code.
```php
require_once __DIR__ .'/../vendor/autoload.php';
```
#### Sample for Post Laju
```php
$data = parcel_track()
->postLaju()
->setTrackingNumber("ER157080065MY")
->fetch();
```
#### Sample for GDex
```php
$data = parcel_track()
->gdex()
->setTrackingNumber("4941410530")
->fetch();
```
#### Sample for Abx Express
```php
$data = parcel_track()
->abxExpress()
->setTrackingNumber("EZP843055940197")
->fetch();
```
#### Sample for DHL Express
```php
$data = parcel_track()
->dhlExpress()
->setTrackingNumber("5176011131")
->fetch();
```
#### Sample for Check Which Carrier Tracking Number belongs to
```php
$data = parcel_track()
->setTrackingNumber("5176011131")
->checkCourier();
```
### Method
Method
Param
Description
postLaju()
Post Laju Courier
abxExpress()
Post Laju Courier
dhlExpress()
DHL Express Courier
dhlCommerce()
DHL E-Commerce Courier
gdex()
GD Express Courier
skyNet()
SkyNet Express Courier
cityLink()
City Link Express Courier
fedEx()
FedEx Express Courier
lelExpress()
Lazada E-Logistic Courier
ktmDelivery()
KTM Distribution Sdn Bhd
ups()
United Parcel Service Courier
setTrackingNumber($refNumber)
String
Enter the tracking number
### Result
##### Checking Result
For checking which carrier response like below:
```json
{
"code": 200,
"error": false,
"possible_carrier": [
"ABX Express Sdn Bhd",
"City Link Express"
],
"generated_at": "2018-05-14 08:53:35",
"footer": {
"developer": {
"name": "Hafiq",
"homepage": "https://github.com/afiqiqmal"
}
}
}
```
##### Tracker Result
You should getting data tracker similarly like below:
```json
{
"code": 200,
"error": false,
"tracker": {
"tracking_number": "4941410530",
"provider": "gdex",
"delivered": true,
"checkpoints": [
{
"date": "2016-11-30 17:41:10",
"timestamp": 1480527670,
"process": "Outbound from KBR station",
"type": "item_received",
"event": "Kota Bharu"
},
{
"date": "2016-11-30 17:47:00",
"timestamp": 1480528020,
"process": "Picked up by courier",
"type": "dispatch",
"event": "Kota Bharu"
},
{
"date": "2016-12-01 03:25:11",
"timestamp": 1480562711,
"process": "In transit",
"type": "facility_process",
"event": "Petaling Jaya"
},
{
"date": "2016-12-01 10:00:16",
"timestamp": 1480586416,
"process": "Inbound to JHB station",
"type": "facility_process",
"event": "Johor Bharu"
},
{
"date": "2016-12-02 10:10:00",
"timestamp": 1480673400,
"process": "Delivered",
"type": "delivered",
"event": "Sungai Tiram"
}
]
},
"generated_at": "2018-05-03 02:07:20",
"footer": {
"source": "GD Express Sdn Bhd",
"developer": {
"name": "Hafiq",
"homepage": "https://github.com/afiqiqmal"
}
}
}
```
## Todo
- Struggling for other Parcel Data
- Keep up to date if any parcel data changes
## Issue
- If Issue happen like the api always return empty [] after cross check with real site, just let me know =)
Pftt.. I just don't know why, the Travis CI is failed. It because of `gnutls_handshake() failed`. In my local env, all Test Unit Passed . I disabled it first because always failing on travis-ci.org =)
## ChangeLog
- See changelog.md
## License
Licensed under the [MIT license](http://opensource.org/licenses/MIT)
### Donate
