Lister les synchronisations d'un entrepôt avec l'API Segment
Liste les dernières synchronisations d'un entrepôt, avec statut et durée, pour vérifier que les données arrivent. Renvoie les 200 premières, car la connexion n'envoie pas de pagination.
- Identifiant
- segment_list_warehouse_syncs
L'appel
POST https://connect.reportei.com/api/tools/segment_list_warehouse_syncs/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"warehouseId": "<warehouseId>"
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| warehouseId | string | Oui | Id of the warehouse, from List warehouses or List connected warehouses. |
Connexions possibles
Votre client connecte son compte Segment une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/segment_list_warehouse_syncs. Il devient la définition de tool de votre agent sans conversion.
Autres tools Segment
- Lister les sourcesGETListe les sources du workspace avec id, name, slug, enabled, metadata et labels. Renvoie les 200 premières, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
- Obtenir une sourceGETRenvoie une source avec ses réglages, write keys, metadata et labels.
- Lister les destinations connectéesGETListe les destinations qui reçoivent des données d'une source, avec id, name, enabled et metadata. Renvoie les 200 premières, car la connexion n'envoie pas de pagination.
- Lister les entrepôts connectésGETListe les entrepôts qui reçoivent des données d'une source. Renvoie les 200 premiers, car la connexion n'envoie pas de pagination.
- Lister les destinationsGETListe les destinations du workspace avec id, name, enabled, metadata et le sourceId auquel chacune appartient. Renvoie les 200 premières, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
- Obtenir une destinationGETRenvoie une destination avec ses réglages, metadata et le sourceId auquel elle appartient.
- Obtenir les métriques de livraisonGETRenvoie les métriques de livraison d'une destination pour les événements d'une source sur une période, chaque métrique avec son total et sa ventilation. Sans dates, couvre la dernière heure minute par minute.
- Lister les entrepôtsGETListe les entrepôts du workspace avec id, enabled, metadata et settings. Renvoie les 200 premiers, car la connexion n'envoie pas de pagination ; pagination.totalEntries indique s'il y en a plus.
Voyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
