Aller au contenu principal
Guides techniques

Créer votre compte API Rodz : authentification et première requête

Peter Cools · · Mis à jour le 3 mai 2026 · 11 min de lecture

En résumé : Pour créer votre compte API Rodz et commencer à exploiter les signaux d’affaires B2B, suivez ce guide. Il couvre la création de compte, la récupération de votre clé API, l’authentification via Bearer token et l’envoi de votre première requête. Quinze minutes suffisent pour être opérationnel.

Qu’est-ce que l’API Rodz ? Votre passerelle vers les signaux d’affaires B2B

L’API Rodz est une interface REST qui donne accès par programmation aux signaux d’affaires détectés par la plateforme. Un signal d’affaires, c’est un contexte dans lequel se trouve une entreprise : une levée de fonds, un recrutement actif, un déménagement, un changement de dirigeant. Ce contexte conditionne les problèmes que la cible rencontre et, par extension, les solutions qu’elle cherche. L’API expose ces signaux en temps réel, au format JSON.

Concrètement, elle permet de :

  • lister les types de signaux disponibles parmi les 108 configurations produites en temps réel
  • configurer des alertes personnalisées selon le secteur, la zone géographique ou la taille d’entreprise
  • récupérer les signaux détectés pour les injecter dans un CRM, des séquences d’emailing ou des outils internes
  • recevoir des notifications via webhooks dès qu’un signal correspond aux critères définis

L’infrastructure qui alimente cette API repose sur plus de 350 scrapers et 250 sources de données. C’est ce qui garantit une détection rapide des événements, pas une base actualisée en différé.

Ce guide s’adresse aux développeurs, aux équipes RevOps et à toute personne technique souhaitant intégrer les signaux Rodz dans un workflow existant. Aucune connaissance préalable de l’API n’est requise. Des bases en HTTP et en ligne de commande suffisent.

Prérequis

Avant de commencer, voici ce qu’il faut avoir sous la main :

  1. Un compte Rodz actif. Si ce n’est pas encore fait, créez-le sur app.rodz.io/register. L’inscription prend moins de deux minutes.
  2. Un terminal avec cURL installé. cURL est préinstallé sur macOS et la plupart des distributions Linux. Sous Windows, il est disponible nativement depuis Windows 10 ou via Git Bash.
  3. Une connexion internet. L’API est accessible via HTTPS sur api.rodz.io.
  4. Un éditeur de texte (VS Code, Sublime Text, ou tout autre) pour noter vos clés et examiner les réponses JSON.
  5. (Optionnel) Un client API graphique comme Postman ou Insomnia, si vous préférez une interface visuelle pour tester vos requêtes.

Comment créer votre compte Rodz et configurer l’accès API

Créer votre compte Rodz en moins de 2 minutes

Rendez-vous sur app.rodz.io/register et remplissez le formulaire d’inscription. Vous recevrez un email de confirmation. Cliquez sur le lien pour activer votre compte.

Une fois le compte créé, vous accédez au dashboard principal où vous pouvez configurer vos premiers signaux d’affaires et accéder aux paramètres API.

Localiser votre clé API après avoir créé votre compte

Une fois connecté au dashboard Rodz :

  1. Cliquez sur votre avatar en haut à droite
  2. Sélectionnez Paramètres puis API
  3. Votre clé API s’affiche dans la section Clés d’accès
  4. Cliquez sur Copier pour la placer dans votre presse-papier

Votre clé ressemble à ceci :

rz_live_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

Règles de sécurité :

  • Ne partagez jamais votre clé publiquement (pas de commit dans un dépôt Git public)
  • Stockez-la dans une variable d’environnement ou un gestionnaire de secrets
  • Chaque clé est liée à votre compte et à vos permissions. Si vous suspectez une fuite, régénérez-la immédiatement depuis le dashboard

Pour stocker votre clé dans une variable d’environnement, ajoutez cette ligne à votre fichier ~/.bashrc ou ~/.zshrc :

export RODZ_API_KEY="your_api_key_here"

Rechargez ensuite votre terminal :

source ~/.bashrc

Configurer l’authentification Bearer token pour votre compte

L’API Rodz utilise l’authentification par Bearer token. Chaque requête HTTP doit inclure un en-tête Authorization contenant votre clé API précédée du mot-clé Bearer.

Le format est le suivant :

Authorization: Bearer your_api_key_here

Ce mécanisme est standard dans les API REST. Le serveur vérifie la validité du token à chaque requête. Si le token est absent, mal formaté ou invalide, l’API renvoie une erreur 401 Unauthorized.

Pourquoi Bearer token ?

Le Bearer token a trois avantages concrets par rapport à d’autres méthodes d’authentification :

  • Simplicité d’implémentation : un seul en-tête HTTP suffit
  • Compatibilité universelle : fonctionne avec tous les clients HTTP (cURL, Postman, fetch, axios, etc.)
  • Sans état (stateless) : le serveur n’a pas besoin de maintenir une session, ce qui allège les performances

Envoyer votre première requête API avec votre nouveau compte

Commençons par une requête simple : interroger l’endpoint qui liste les types de signaux disponibles sur la plateforme.

Requête : lister les types de signaux

Ouvrez votre terminal et exécutez la commande suivante :

curl -X GET "https://api.rodz.io/v1/signals/types" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Accept: application/json"

Si vous avez configuré la variable d’environnement :

curl -X GET "https://api.rodz.io/v1/signals/types" \
  -H "Authorization: Bearer $RODZ_API_KEY" \
  -H "Accept: application/json"

Décortiquer la commande

  • curl -X GET : envoie une requête HTTP GET
  • "https://api.rodz.io/v1/signals/types" : l’URL de l’endpoint. Le préfixe /v1/ indique la version de l’API
  • -H "Authorization: Bearer ..." : l’en-tête d’authentification
  • -H "Accept: application/json" : indique au serveur que vous attendez une réponse au format JSON

Réponse attendue

Si tout est correct, vous recevrez une réponse HTTP 200 OK avec un corps JSON similaire à celui-ci :

{
  "status": "success",
  "data": {
    "signal_types": [
      {
        "id": "fundraising",
        "name": "Levée de fonds",
        "description": "Détecte les entreprises ayant récemment réalisé une levée de fonds",
        "category": "financial",
        "available_filters": ["amount_min", "amount_max", "sector", "location"]
      },
      {
        "id": "hiring",
        "name": "Recrutement",
        "description": "Détecte les entreprises publiant activement des offres d'emploi",
        "category": "hr",
        "available_filters": ["job_title", "department", "sector", "location"]
      },
      {
        "id": "management_change",
        "name": "Changement de dirigeant",
        "description": "Détecte les nominations et départs de dirigeants",
        "category": "organizational",
        "available_filters": ["role", "sector", "company_size"]
      }
    ],
    "total": 108
  }
}

Ce résultat dit trois choses utiles. Chaque signal a un identifiant unique (id) que vous utiliserez dans vos requêtes suivantes. Les signaux sont catégorisés (financier, RH, organisationnel, etc.). Des filtres sont disponibles pour affiner vos recherches selon vos critères de prospection.

Comprendre le format de réponse

Toutes les réponses de l’API Rodz suivent une structure JSON cohérente.

Structure standard d’une réponse réussie

{
  "status": "success",
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 25,
    "total": 108,
    "total_pages": 5
  }
}
  • status : "success" ou "error"
  • data : les données demandées (objet ou tableau selon l’endpoint)
  • meta : les informations de pagination pour les endpoints qui retournent des listes

Structure d’une réponse d’erreur

{
  "status": "error",
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key",
    "details": null
  }
}

Le champ code fournit une valeur programmatique exploitable. Le champ message donne une explication lisible pour le débogage.

Gérer les erreurs courantes après avoir créé votre compte

Trois codes d’erreur HTTP reviennent régulièrement. Voici comment les interpréter et les résoudre.

401 Unauthorized

HTTP/1.1 401 Unauthorized

Cause : votre clé API est absente, mal formatée ou invalide.

Solutions :

  • Vérifiez que l’en-tête Authorization est bien présent dans votre requête
  • Assurez-vous que le format est Bearer your_api_key_here (avec un espace après Bearer)
  • Régénérez votre clé depuis le dashboard si nécessaire

Pour diagnostiquer le problème, ajoutez l’option -v (verbose) à votre commande cURL :

curl -v -X GET "https://api.rodz.io/v1/signals/types" \
  -H "Authorization: Bearer your_api_key_here"

403 Forbidden

HTTP/1.1 403 Forbidden

Cause : votre clé est valide, mais vous n’avez pas les permissions pour accéder à cette ressource.

Solutions :

  • Vérifiez que votre abonnement inclut l’accès à l’endpoint demandé
  • Certains endpoints sont réservés aux plans Pro et Enterprise
  • Contactez l’équipe Rodz si vous pensez que vos permissions sont incorrectes

429 Too Many Requests

HTTP/1.1 429 Too Many Requests

Cause : vous avez dépassé le nombre de requêtes autorisées dans la fenêtre de temps définie (rate limiting).

Solutions :

  • Consultez les en-têtes de réponse pour connaître vos limites :
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1709654400

  • X-RateLimit-Limit : nombre maximum de requêtes par fenêtre

  • X-RateLimit-Remaining : requêtes restantes

  • X-RateLimit-Reset : timestamp UNIX de réinitialisation du compteur

  • Mettez en œuvre un mécanisme de retry avec backoff exponentiel

  • Mettez en cache les réponses qui ne changent pas fréquemment (comme la liste des types de signaux)

Pour une documentation complète des endpoints, des limites et de la gestion d’erreurs, consultez la référence API Rodz.

Aller plus loin

Maintenant que l’authentification fonctionne et que vous savez lire une réponse, voici comment avancer.

Configurer votre premier signal

L’étape suivante consiste à créer une configuration de signal adaptée à votre cible commerciale. Par exemple : « Je veux contacter une entreprise quand elle lève des fonds dans le secteur SaaS en France. » Voici comment le traduire en requête API :

curl -X POST "https://api.rodz.io/v1/signals/configurations" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "signal_type": "fundraising",
    "name": "Levées de fonds SaaS France",
    "filters": {
      "sector": "saas",
      "location": "FR",
      "amount_min": 1000000
    },
    "delivery": {
      "method": "api_polling"
    }
  }'

Le guide complet pour configurer votre premier signal est disponible dans l’article Configurer son premier signal d’affaires via l’API Rodz.

Recevoir les signaux en temps réel

Plutôt que d’interroger l’API régulièrement (polling), vous pouvez configurer un webhook pour recevoir les signaux dès leur détection. La latence baisse, l’architecture se simplifie.

Consultez le guide dédié : Recevoir des signaux en temps réel avec les webhooks Rodz.

Intégrer les signaux dans votre CRM

Les signaux récupérés via l’API peuvent alimenter directement votre CRM. Les intégrations les plus courantes passent par :

  • un script personnalisé qui interroge l’API et crée des tâches ou des contacts dans votre CRM
  • un outil d’automatisation comme Make qui orchestre le flux entre l’API Rodz et vos outils
  • les webhooks combinés à un middleware pour transformer les données avant injection

Questions fréquentes

L’API Rodz est-elle gratuite ?

L’API est incluse dans les abonnements Rodz. Le nombre de requêtes autorisées et les endpoints accessibles dépendent de votre plan. Créez un compte sur app.rodz.io/register pour découvrir les options disponibles.

Quelle est la différence entre l’API et le dashboard Rodz ?

Le dashboard est une interface visuelle pour consulter et configurer vos signaux manuellement. L’API offre les mêmes fonctionnalités, mais par programmation. Elle est faite pour les équipes qui veulent automatiser l’intégration des signaux dans leurs workflows existants.

Puis-je utiliser l’API avec Python, JavaScript ou un autre langage ?

Oui. L’API est une API REST standard accessible via HTTPS. Tout langage capable d’envoyer des requêtes HTTP peut l’utiliser. Voici un exemple rapide en Python :

import requests

headers = {
    "Authorization": "Bearer your_api_key_here",
    "Accept": "application/json"
}

response = requests.get("https://api.rodz.io/v1/signals/types", headers=headers)
data = response.json()

for signal_type in data["data"]["signal_types"]:
    print(f"{signal_type['id']}: {signal_type['name']}")

Comment régénérer ma clé API ?

Connectez-vous au dashboard Rodz, accédez à Paramètres > API, puis cliquez sur Régénérer la clé. L’ancienne clé est immédiatement invalidée. Pensez à mettre à jour tous vos scripts et intégrations avec la nouvelle clé.

Quelles sont les limites de requêtes (rate limits) ?

Les limites varient selon votre plan. Les en-têtes X-RateLimit-* de chaque réponse indiquent vos limites actuelles et le nombre de requêtes restantes. Pour les détails complets, consultez la référence API.

L’API prend-elle en charge la pagination ?

Oui. Les endpoints qui retournent des listes prennent en charge la pagination via les paramètres page et per_page :

curl -X GET "https://api.rodz.io/v1/signals/types?page=2&per_page=10" \
  -H "Authorization: Bearer your_api_key_here"

Les informations de pagination sont incluses dans l’objet meta de la réponse.

Les données de l’API sont-elles conformes au RGPD ?

Oui. Rodz traite exclusivement des données d’entreprises issues de sources publiques. La publication d’une offre d’emploi, d’un changement de poste ou d’une levée de fonds annoncée constitue par construction la base légale de l’intérêt légitime. Aucune donnée personnelle au sens du RGPD n’est collectée sans cette base. Pour en savoir plus, consultez l’article sur le RGPD et les signaux d’affaires.

Où trouver la documentation complète de l’API ?

La documentation technique complète, avec la liste de tous les endpoints, les paramètres acceptés et les exemples de réponses, est disponible sur api.rodz.io/docs.

Commencez à exploiter les signaux d’affaires par API

Vous avez maintenant les bases : création de compte, authentification, première requête, lecture des réponses et gestion des erreurs. L’étape suivante est de configurer votre premier signal pour commencer à recevoir des opportunités commerciales qualifiées.

Pour explorer tous les endpoints disponibles, consultez la documentation API complète.

Pour intégrer l’API dans votre stack technique, réservez un appel avec l’équipe Rodz.

#API #signaux d'affaires #authentification #guide technique #getting started
Partager :

Détectez vos prochains clients automatiquement

100 crédits offerts. Sans carte bancaire.

Essayer Rodz gratuitement Découvrir les 14 signaux

Générez votre stratégie outbound gratuitement

Notre IA analyse votre entreprise et crée un playbook complet : ICP, personas, templates d'emails, scripts d'appels.

Générer ma stratégie