Dépannage des connecteurs

Apprenez à résoudre les problèmes courants liés aux connecteurs.

Vue d'ensemble

Lorsque vous utilisez des connecteurs, vous pouvez rencontrer des problèmes qui nécessitent une certaine connaissance des détails techniques du fonctionnement des connecteurs. Ce guide vous aidera à comprendre ces détails, à trouver des solutions aux problèmes courants liés aux connecteurs et à interpréter les codes d'erreur.

Problèmes courants liés aux connecteurs

Pourquoi mon connecteur est-il hors ligne ?

Si votre connecteur indique qu'il est hors ligne, c'est qu'il y a un problème de connexion au serveur. Il peut y avoir deux raisons à cela:1. informations d'identification incorrectes Vérifiez à nouveau les champs de saisie lors de la configuration de votre connecteur et assurez-vous que les informations sont correctes. En cas de doute, consultez la documentation du système tiers et les informations d'identification de votre compte pour vérification. Les champs peuvent être sensibles à la casse, assurez-vous donc que les valeurs que vous saisissez sont identiques à celles qui sont indiquées.2. Problèmes avec le système tiers Les problèmes de connexion peuvent provenir du système tiers lui-même et d'un problème avec son serveur. Contactez l'administrateur de votre système pour plus d'informations sur les problèmes de connexion potentiels.

Si vous n'avez pas encore configuré votre connecteur ou si vous avez besoin d'une mise à jour, consultez notre guide sur la configuration d'un connecteur, qui vous guidera pas à pas.

Que se passe-t-il si la fonction de mon connecteur échoue ?

Si une fonction de connecteur échoue, un message d'erreur s'affiche et le système ne tente pas de réessayer l'appel. Les échecs peuvent être dus à plusieurs raisons courantes :

1. Le système externe ne répond pas à la demande d'API, soit parce qu'il ne répond pas, soit parce qu'il dépasse le temps d'exécution maximal du connecteur.
2. L'hôte du connecteur est déconnecté.

Pourquoi l'hôte du connecteur est-il déconnecté ?

Vous pouvez consulter les statuts de l'hôte du connecteur à l'adresse suivante : https://[your-instance].tulip.co/account-settings/connectors-settings

Si vous utilisez un connecteur hôte sur site, vérifiez que votre serveur ou votre hôte ne présente pas de problèmes.

Pour ceux qui utilisent le Tulip Cloud Connector Host, ce connecteur doit toujours être en ligne. Le Cloud Connector Host est un service géré par Tulip. Contactez suppport@tulip.co si ce service n'est pas disponible.

Où puis-je trouver les points de terminaison de l'API pour mon système ?

Une recherche sur "API Docs [nom du système]" donnera presque toujours une page orientée vers les développeurs avec tous les points de terminaison de l'API et des détails sur les spécifications telles que l'authentification et les paramètres.s'il y a des exemples de chacun, les exemples cURL sont généralement les plus proches des connecteurs Tulip.

Si vous utilisez l'API Tulip Table, vous pouvez consulter la documentation à l'adresse suivante : https://[your-instance].tulip.co/apiDocs.

Qu'est-ce que l'autorisation de base/du porteur ?

L'autorisation de base et l'autorisation du porteur sont des en-têtes standard utilisés pour l'accès.

L'en-tête "Authorization" aura la valeur "Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==" ou "Bearer QWxhZGRpbjpvcGVuIHNlc2FtZQ==". Les clients TLS et non TLS peuvent utiliser l'autorisation de base. Le support ne doit être utilisé que pour TLS.

Qu'est-ce que X-auth-token, x-authentication, x-authentication-token ?

Il s'agit d'exemples d'en-têtes non réglementés qui sont souvent utilisés pour l'authentification. La lettre "X" indique qu'il s'agit d'en-têtes non standard.

Consultez la documentation de votre système pour plus de détails sur la manière de les configurer.

Pourquoi ma requête GET ou POST HTTP ne renvoie-t-elle pas de données ?

Si votre requête GET ou POST HTTP ne renvoie aucune donnée, examinez l'en-tête content-type. Cet en-tête est souvent requis, mais pas toujours, pour ces types de requêtes.

Pourquoi ne puis-je pas voir le résultat de ma requête SQL ?

Les colonnes de sortie doivent être mappées pour voir une réponse (alors que http affichera la réponse entière sans aucune sortie mappée).

Pourquoi mes résultats ne sont-ils pas utilisés ?

Notez le format de vos sorties. Les sorties sont sensibles à la casse et utilisent souvent CamelCase ou lowerCamelCase.

Les connecteurs HTTP utilisent également la notation par points pour les objets imbriqués dans les résultats. Pour en savoir plus sur la notation par points, lisez ce guide externe ici.

Codes d'erreur des connecteurs

HTTP

Les codes HTTP sont expansifs et leurs préfixes indiquent le type de requête.

4xx - Mauvaise demande2xx - Bonne demande3xx - Demande mixte

Consultez ce guide des codes d'erreur HTTP pour plus d'informations.

SQL

Avec SQL, les codes d'erreur proviennent généralement des requêtes elles-mêmes.

Consultez ce guide des codes d'erreur SQL pour plus d'informations.

Pour en savoir plus

• Vue d'ensemble des connecteurs HTTP

Vous avez trouvé ce que vous cherchiez ?

Vous pouvez également vous rendre sur community.tulip.co pour poser votre question ou voir si d'autres personnes ont rencontré une question similaire !