#api-client #parcel #api #web-page #colissimo

colissimo_track

An unofficial API client for Colissimo, a parcel delivery service

2 releases

0.1.1 Sep 7, 2022
0.1.0 Jun 6, 2020

#5 in #parcel

MIT license

11KB
144 lines

colissimo_track

This crate allows you to fetch information about the status of a "Colissimo" shipment and its delivery progress (from the receiver's perspective). It uses a reverse-engineered private but not-so-complicated API used by the web page you are supposed to browse as a human.

The crate is very simple, it exports a few structs and an async fn get_tracking_info(shipment_id: &str) -> Result<Shipment, Error> function to query the shipment API.

How does it work ?

  • A first request to https://www.laposte.fr/outils/suivre-vos-envois?code={} is made with hyper. The only interesting part we keep is the access-token=[...jwt...] Set-Cookie header.
  • A second request, to https://api.laposte.fr/ssu/v1/suivi-unifie/idship/{}?lang=fr_FR, is made with the cookie. The server should, under normal conditions, respond with a JSON object representing the shipment.
  • A bit of serde magic is used to deserialize this object into a provided data structure (see crate::model::*).

Target developers / users / projects

This crate covers the very niche market of Colissimo users, that is, people living in locations where the national public French group "La Poste" operates its parcel delivery services. Since the library allows parcel tracking from the delivery receiver's perspective, the only usages I can find are various client softwares, like mobile apps or home (automation) dashboards.

I-am-a-beginner disclaimer

This is literally my first crate, and my first "finished" Rust project. While I'd love to see this crate being used (although very niche, I admit), make sure to take a look at the code inside before putting yourself and your project at potential risk !

Obviously any feedback, comment, bug report, contribution, or anything else that can help improve this crate &&/|| my Rust programming level are 100% welcome.

License

The code inside this repository is licensed under the MIT license.

Dependencies

~8–20MB
~271K SLoC