Turso

Turso se connecte avec un token d'API de plateforme :

1. Ouvre Turso, va sur la page API Tokens des réglages de ton compte, ou exécute turso auth api-tokens mint polylane depuis la CLI.
2. Copie le token d'API de plateforme.
3. Colle le token dans Polylane. Si le token peut atteindre plus d'une organisation, choisis celle à connecter quand on te le demande.
4. Polylane valide le token et commence la synchronisation.

Chaque connexion couvre une seule organisation Turso. Polylane découvre ses groupes de bases de données et ses bases de données, y compris les emplacements, le placement, la filiation des branches et l'état lecture/écriture. Les tokens sont chiffrés avant d'être stockés, et l'agent ne les voit jamais. Polylane ne lit que la Platform API ; il ne se connecte jamais à tes bases de données et ne détient jamais d'identifiants de base de données.

La Platform API de Turso rapporte l'usage sous forme de compteurs cumulés par période de facturation plutôt que de séries temporelles, donc les bases de données ne portent aucun graphique de métriques. La surveillance interroge ces compteurs et observe plutôt les deltas : volume de lectures et d'écritures, trafic de synchronisation, croissance du stockage, nombre de bases de données, consommation du quota par rapport à ton forfait, et les requêtes les plus lourdes par base de données sont chacun vérifiés par rapport à l'historique propre du compte.

Dépannage

Erreur "Invalid Turso API token"

• Les tokens d'API de plateforme sont différents des tokens d'authentification de base de données ; émets-en un avec turso auth api-tokens mint ou depuis les réglages de ton compte.
• Vérifie que le token n'a pas été révoqué dans les réglages de Turso.

Erreur "Multiple Turso organizations are reachable"

• Le token peut atteindre plus d'une organisation, donc nomme celle à connecter.
• En connexion dans la console, choisis l'organisation quand on te le demande après la validation.
• En connexion via l'API, renseigne le champ organization avec le slug de l'organisation.

Ressources manquantes

• Turso peut mettre quelques minutes à tout synchroniser.
• Déclenche un Sync manuel depuis l'en-tête du compte pour rafraîchir.

Déconnexion

Déconnecte le compte dans Polylane, puis révoque le token d'API depuis les réglages de ton compte Turso ou avec turso auth api-tokens revoke.

Connecter Turso ne nécessite aucun navigateur : le même point d'accès que la console appelle tient dans un job de CI. Un seul POST authentifié crée la connexion et démarre la première synchronisation.

Prérequis

• Une clé API Polylane avec les scopes cloud_accounts:write et cloud_accounts:read. Voir Clés API et OAuth.
• L'identifiant de ton espace de travail, qui commence par ws_. Lis-le depuis GET /v1/workspaces avec la même clé.
• Un token d'API de plateforme Turso, émis depuis les réglages de ton compte ou avec turso auth api-tokens mint polylane.

Créer la connexion

curl -X POST https://api.polylane.com/v1/cloud_accounts \
  -H "x-api-key: $POLYLANE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "turso",
    "workspaceId": "ws_0abc123",
    "token": "<platform-api-token>",
    "organization": "my-org-slug"
  }'

Un seul appel connecte une organisation Turso.

• organization ne peut être omis que lorsque le token n'atteint qu'une seule organisation ; sinon l'appel échoue avec un 400 qui liste les slugs des organisations atteignables.

La réponse liste ce qui a été connecté, avec la première synchronisation déjà en cours. Réduite aux deux champs que le reste du flux lit :

{
  "success": true,
  "result": {
    "provider": "turso",
    "accounts": [{ "id": "acc_34gky74ibc92h8t2efn8csrh", "status": "syncing" }],
    "failures": []
  }
}

Un compte déjà connecté atterrit dans failures au lieu de accounts, donc répéter l'appel ne duplique jamais une connexion.

Attendre la première synchronisation

Interroge chaque compte renvoyé par son id jusqu'à ce que status atteigne ready (new à l'enregistrement, syncing pendant que les ressources arrivent) :

until [ "$(curl -s "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY" | jq -r '.result.status')" = "ready" ]; do
  sleep 15
done

Donne une échéance à la boucle pour qu'une connexion échouée fasse échouer le job au lieu de le bloquer. Une fois que le compte est ready, ses ressources sont dans la topologie et Polylane a démarré sa première vérification.

Déconnecter depuis l'API

Supprimer la connexion arrête chaque synchronisation et chaque vérification et supprime les identifiants que Polylane détenait. L'appel nécessite le scope cloud_accounts:delete :

curl -X DELETE "https://api.polylane.com/v1/cloud_accounts/$WORKSPACE_ID/$ACCOUNT_ID" \
  -H "x-api-key: $POLYLANE_API_KEY"

Révoque ensuite l'identifiant Turso côté fournisseur, comme décrit sous Disconnect ci-dessous.