Créer un compte

Vendez les numérosdirectement sur votre site.

Branchez notre webhook : chaque nouveau numéro disponible arrive sur votre boutique dès que numli.fr le repère, et en repart dès qu’il n’est plus en vente. Quand un client l’achète, votre site le réserve par l’API et lui remet le lien de commande.

Créer un compteVoir les exemples

1Recevez chaque nouveau numéro

Indiquez l’adresse de votre site dans le tableau de bord. Dès qu’un nouveau numéro est disponible, numli.fr y envoie un webhook number.create. Enregistrez-le dans votre base : votre boutique peut l’afficher aussitôt.

Webhook reçu
{  "type": "number.create",  "data": {    "number": "0612345678"  }}
Votre site l’enregistre
app.post('/webhooks/numli', async (req, res) => {    const { type, data } = req.body;    if (type === 'number.create') {        await db.numbers.insert({ number: data.number });    }    res.sendStatus(200);});

2Retirez ceux qui ne sont plus en vente

Un numéro reste disponible une durée variable, en général quelques dizaines de minutes. Dès qu’il ne l’est plus, numli.fr envoie un webhook number.delete à la même adresse : supprimez-le de votre base, il disparaît de votre boutique.

Webhook reçu
{  "type": "number.delete",  "data": {    "number": "0612345678"  }}
Dans la même route
if (type === 'number.delete') {    await db.numbers.delete({ number: data.number });}

3Réservez-le quand un client l’achète

Un appel à l’API avec votre clé, et le numéro est à vous : personne d’autre ne peut plus le prendre. La réponse contient le lien de commande : envoyez-y votre client après son paiement, il souscrit avec son numéro déjà choisi.

Votre site appelle
const response = await fetch('https://numli.fr/api/claim', {    method: 'POST',    headers: {        Authorization: `Bearer ${process.env.NUMLI_API_KEY}`,        'Content-Type': 'application/json',    },    body: JSON.stringify({ number }),});// 404 : un autre revendeur l’a réservé avant vousif (response.status === 404) return db.numbers.delete({ number });const { accessUrl } = await response.json();
numli.fr répond
HTTP/1.1 200 OKContent-Type: application/json{  "accessUrl": "https://numli.fr/api/claim/482915736048261937502846"}

Pensé pour tourner sans vous

Les détails qui évitent les mauvaises surprises une fois votre boutique en ligne.

  • Une boutique toujours à jour

    Avec number.create et number.delete, votre site n’affiche que des numéros encore disponibles.

  • Relancé si votre site ne répond pas

    Si votre site ne répond pas par un code 2xx, l’envoi est retenté automatiquement.

  • Un envoi de test

    Depuis le tableau de bord, envoyez un faux numéro à votre site pour vérifier que tout fonctionne.

  • Un seul gagnant par numéro

    Une seule réservation réussit. Si un autre revendeur a été plus rapide, l’API vous le dit tout de suite.

Branchez votre boutique

Votre clé API, votre secret et l’envoi de test vous attendent dans le tableau de bord.

Créer un compteVoir les tarifs