An open API service indexing awesome lists of open source software.

https://github.com/rigwild/suivi-poste

Suivre les envois postaux
https://github.com/rigwild/suivi-poste

Last synced: 6 months ago
JSON representation

Suivre les envois postaux

Awesome Lists containing this project

README

          

# suivi-poste
[![npm badge](https://img.shields.io/npm/v/suivi-poste.svg?logo=npm)](https://www.npmjs.com/package/suivi-poste)

> Suivre les envois postaux

La Poste fourni en Open Data une [API de suivi postal](https://developer.laposte.fr/products/suivi/latest). Ce module permet de consommer cette API.

Les produits supportés sont les suivants :

- Courriers suivis national
- Courriers suivis international
- Colis Colissimo
- Envois Chronopost

Il faut s'inscrire sur le portail [developer.laposte.fr](https://developer.laposte.fr) pour générer une clef d'API en mode production.

Documentation des réponses d'API : https://developer.laposte.fr/products/suivi/latest

## Installation
```
$ yarn add suivi-poste
```

## Usage
```ts
import { suiviPosteApi } from 'suivi-poste'

const suiviPoste = suiviPosteApi({ token: 'my-api-key' })

const result = await suiviPoste.getTracking('6A15602676300', 'A00000001', '6A15602683841')
console.log(result)

/* =>
{ lang: 'fr_FR',
scope: 'open',
returnCode: 200,
shipment:
{ idShip: '6A15602676300',
holder: 4,
product: 'colissimo',
...
*/
```

## Related
- [suivi-poste-cli](https://github.com/rigwild/suivi-poste-cli) - CLI pour ce module
- [suivi-poste-proxy](https://github.com/rigwild/suivi-poste-proxy) - Serveur proxy pour ce module

## License
[The MIT license](./LICENSE)