L'API Ringover vous permet de connecter vos outils métiers et d'automatiser vos processus de communication. Dans ce guide, vous apprendrez à diagnostiquer et résoudre les problèmes d'accès à l'API Ringover pour rétablir rapidement le bon fonctionnement de vos intégrations.
1. Effectuer les diagnostics initiaux et identifier les erreurs
Avant toute chose, analysez les paramètres de base de votre connexion à l'API pour identifier rapidement la source du problème :
- Validez les URL cibles de vos requêtes (par exemple,
/Leads/globalsearch). - Testez votre clé API sur plusieurs endpoints différents pour vérifier sa validité globale.
- Vérifiez la validité de vos jetons d'authentification et de vos identifiants.
- Analysez minutieusement les messages d'erreur renvoyés par l'API pour comprendre la nature du blocage.
2. Comparer les environnements de Test et de Production
Des divergences de configuration entre vos environnements de test (dev) et de production peuvent bloquer vos requêtes :
Validation de l'environnement de Test
- Vérifiez que les adresses IP de votre serveur de test ne sont pas bloquées par des règles spécifiques au développement ou à la recette.
- Testez vos requêtes depuis d'autres réseaux pour isoler la panne et identifier un éventuel blocage local.
- Récupérez l'ID Ray Cloudflare généré lors des erreurs pour faciliter les recherches du support.
Validation de l'environnement de Production
- Comparez rigoureusement la configuration de production avec celle du test pour repérer d'éventuelles différences d'identifiants ou de jetons.
- Contrôlez qu'aucun blocage IP spécifique n'affecte vos serveurs de production.
- Rassemblez les détails d'erreur précis (codes HTTP, réponses JSON) propres à la production.
➡️ Checklist de comparaison (Prod vs Test) :
- Identifiants et modes d'authentification utilisés.
- Listes blanches d'adresses IP.
- Règles de sécurité réseau et pare-feu.
- Permissions attribuées au compte.
- URL des endpoints ciblés et formats des requêtes.
3. Contrôler la sécurité réseau et la réputation IP
Les mesures de sécurité réseau de Ringover ou de votre infrastructure peuvent bloquer les appels API :
- Assurez-vous que l'adresse IP de votre serveur n'est pas associée à un réseau à risque ou identifiée comme malveillante (réputation IP).
- Ajustez les mauvaises configurations réseau de vos pare-feu ou routeurs qui déclenchent des blocages intempestifs.
- Validez la mise en liste blanche de vos adresses IP directement avec votre fournisseur d'infrastructure réseau ou d'hébergement.
4. Vérifier les permissions et la configuration du compte
Certaines fonctionnalités de l'API requièrent des droits d'accès spécifiques sur votre compte Ringover :
- Confirmez que votre offre ou type de compte Ringover prend bien en charge l'accès à l'API.
- Activez toutes les permissions d'écriture nécessaires pour les opérations de modification, d'ajout ou de suppression de données.
- Vérifiez les droits d'accès spécifiques requis pour la fonctionnalité.
5. Préparer les informations à fournir au support technique
Si vous ne parvenez pas à résoudre le problème, constituez un dossier complet pour notre support afin d'accélérer l'analyse :
- Notez le code d'erreur HTTP exact (par exemple, un code 403 Forbidden).
- Récupérez l'ID Ray Cloudflare associé à la requête échouée.
- Fournissez la requête exacte comprenant l'URL, les en-têtes (headers) et les paramètres envoyés.
- Prenez des captures d'écran des messages d'erreur ou des logs de votre console de développement.
- Indiquez l'horodatage (date et heure précises) de la tentative de connexion.
- Établissez une comparaison claire entre une requête fonctionnelle et une requête en échec.
🎉 Vous savez désormais comment diagnostiquer et résoudre les problèmes d'accès à l'API Ringover pour rétablir vos intégrations en toute sécurité !