Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/stdakov/bgpost
Package tracking, using data from the Bulgarian post
https://github.com/stdakov/bgpost
bgpost
Last synced: 4 days ago
JSON representation
Package tracking, using data from the Bulgarian post
- Host: GitHub
- URL: https://github.com/stdakov/bgpost
- Owner: stdakov
- License: mit
- Created: 2020-11-20T15:59:46.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-08-13T06:40:34.000Z (3 months ago)
- Last Synced: 2024-08-13T07:52:13.537Z (3 months ago)
- Topics: bgpost
- Language: JavaScript
- Homepage: https://bgpost.dakovdev.com/
- Size: 567 KB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# bgpost
This api uses screen scraping to get the package travelling information from the bulgarian post.
## Guidelines
### Tracking number
#### For international shipments:
13 characters: First letter R, C, E or V, followed by a second letter from A to Z, followed by nine digits, followed by two letters with the country code from which the shipment was sent.
For example: **RH054250664CN**, **CP004152151EN**, **EC610548787UA**, **VV015975882ES**.
#### For domestic shipments:
An alphanumeric combination of thirteen characters. The number starts with the letters PS.
For example: **PS123456789A**, **PS004152151EN**, **PS610548787UA**, **PS015975882ES**.
### RESTful URLs
- Get package data:
- GET https://bgpost.dakovdev.com/api/v1/tracking?code=tracking-number
Good response:
```json
[
{
"date": "09.08.2020 22:35",
"location": "SINGAPORE SAL",
"event": "Insert item into bag (Otb) and Send item abroad",
"info": "",
"status": "traveling"
},
{
"date": "12.08.2020 22:35",
"location": "SINGAPORE SAL",
"event": "Send item abroad (EDI-received)",
"info": "",
"status": "traveling"
},
{
"date": "31.08.2020 11:15",
"location": "SOFIA LC/AO",
"event": "Receive item at office of exchange (Inb)",
"info": "",
"status": "traveling"
},
{
"date": "31.08.2020 13:18",
"location": "SOFIA LC/AO",
"event": "Send item to domestic location (Inb)",
"info": "",
"status": "traveling"
},
{
"date": "11.09.2020 16:30",
"location": "IRM CC 1880",
"event": "Deliver item (Inb)",
"info": "",
"status": "traveling"
}
]
```
Bad response (wrong or not supported tracking number):
```json
[
{
"date": "",
"location": "",
"event": "",
"info": "",
"status": "wrong_code"
}
]
```
Bad response (missing information):
```json
[
{
"date": "",
"country": "",
"location": "",
"event": "",
"info": "",
"status": "no_data"
}
]
```