Construire une liste de prospects vérifiée en un seul appel

Ce que le workflow enchaîne

Trois étapes s'exécutent chez nous par personne : trouver les candidats correspondant à vos filtres, trouver l'adresse e-mail, puis vérifier cette adresse. Vous envoyez une requête au lieu d'en orchestrer trois, et chaque étape n'est facturée que si elle produit quelque chose.

# Discover what is available to your key rather than
# trusting a list copied from a page.
curl https://api.qannasapi.com/v1/data/workflows \
  -H "Authorization: Bearer $QANNAS_API_KEY"

Chiffrez-le avec dry_run

Envoyez le corps du workflow avec dry_run: true et vous obtenez le détail des crédits par étape sans rien exécuter. C'est le chiffre à budgéter — il suppose que chaque étape réussit pour chaque personne.

curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "inputs": {"industry": "logistics", "country": "AE"},
        "limit": 25,
        "dry_run": true
      }'

# < X-Credits-Charged: 0   # the quote is free

Lancez-le

Retirez dry_run et envoyez le même corps. Mettez format à csv si vous voulez un fichier plutôt que du JSON ; markdown est aussi disponible. La réponse porte les mêmes en-têtes de crédits que n'importe quel appel, vous pouvez donc rapprocher immédiatement l'exécution du devis.

# Same body, without dry_run. format: json | csv | markdown
curl -X POST https://api.qannasapi.com/v1/data/workflows/lead-list \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "inputs": {"industry": "logistics", "country": "AE"},
        "limit": 25,
        "format": "csv"
      }'

# < X-Credits-Charged: 138  # reconcile this against the quote

Rafraîchir en delta

Activez track_delta à la première exécution et passez le curseur renvoyé comme since_cursor à la suivante pour ne recevoir que ce qui a changé. Notez que le delta est un filtre sur ce que vous recevez, pas une remise sur ce que vous payez.

# Run one: ask for a cursor.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -d '{"query": "logistics AE", "track_delta": true}'

# Run two: receive only what changed.
# NOTE: delta filters what you RECEIVE. It is not a discount.
curl -X POST https://api.qannasapi.com/v1/data/search/people \
  -H "Authorization: Bearer $QANNAS_API_KEY" \
  -d '{"query": "logistics AE", "since_cursor": "cur_..."}'

Résumé

Checklist de mise en production

• Chiffrez avec dry_run avant chaque exécution planifiée, pas seulement la première.
• Budgétez sur le plafond ; rapprochez sur X-Credits-Charged.
• Stockez le curseur delta avec la liste, pas en mémoire applicative.
• Revérifiez les adresses régulièrement — la délivrabilité se dégrade.

Étapes suivantes