Gestion des API Keys
Gérez facilement vos API keys et intégrez ProcessMind à vos applications en toute sécurité.
Ce guide propose exemples et bonnes pratiques pour utiliser l’API ProcessMind. Que vous vouliez récupérer des données, soumettre des infos ou automatiser vos process, maîtriser notre API est essentiel.
ProcessMind permet de téléverser des fichiers directement vers vos datatables grâce à des URL presignées. Cette méthode sécurise les uploads sans exposer votre clé API ou d’autres données sensibles. Notez que les URL presignées sont limitées dans le temps : il faut les utiliser rapidement après leur génération. Pour obtenir l’URL d’upload direct, faites une requête GET à l’endpoint dédié. L’URL se récupère via le menu des paramètres du dataset [Get upload URL] sur ProcessMind. Vous pouvez définir une durée limite de 1 heure, 1 semaine ou 1 mois maximum.
Méthode | Endpoint | Description |
---|---|---|
GET | /tenant/{tenantId}/datatable/{datatableId}/uploads/presignedurl | Retourne une URL temporaire pré-signée pour téléverser un fichier sur une datatable. |
GET | /tenant/{tenantId}/datasets | Liste les datasets du tenant indiqué. |
GET | /tenant/{tenantId} | Affiche les détails du tenant spécifié. |
GET | /tenant/{tenantId}/organization | Affiche les infos sur l’organisation du tenant. |
Toutes les requêtes API doivent être envoyées à l’URL de base suivante : https://api.processmind.com
Endpoint : GET /tenant/{tenantId}/datatable/{datatableId}/uploads/presignedurl
Paramètres :
Renvoie : Un objet réponse contenant PreSignedUploadUrl, une URL temporaire à utiliser pour téléverser un fichier (généralement via HTTP PUT).
Exemple (avec le helper) :
const presignedUrl = await getPresignedUploadUrl({
apiKey,
tenantId: 'tenant-123',
datatableId: 'table-456'
});
console.log(presignedUrl); // ex : https://s3.amazonaws.com/…?X-Amz-Signature=…
Endpoint : GET /tenant/{tenantId}/datasets
Paramètres :
Renvoie : Un tableau d’objets dataset appartenant au tenant.
Exemple :
const datasets = await getDatasets({
apiKey,
tenantId: 'tenant-123'
});
console.log(datasets);
Endpoint : GET /tenant/{tenantId}
Paramètres :
Renvoie : Un objet avec les métadonnées du tenant : nom, date de création et plan.
Exemple :
const tenantInfo = await getTenant({
apiKey,
tenantId: 'tenant-123'
});
console.log(tenantInfo);
Endpoint : GET /tenant/{tenantId}/organization
Paramètres :
Renvoie : Les informations sur l’organisation associée au tenant (ex : nom d’entreprise, adresse, contacts).
Exemple :
const org = await getOrganization({
apiKey,
tenantId: 'tenant-123'
});
console.log(org);
La fonction uploadFile montre comment téléverser un fichier via une URL pré-signée. Le workflow est :
Exemple simplifié avec fetch :
async function uploadFile({ apiKey, tenantId, datatableId, file }) {
// Étape 1 : obtenir une URL pré-signée
const uploadUrl = await getPresignedUploadUrl({ apiKey, tenantId, datatableId });
// Étape 2 : upload du fichier via PUT
await fetch(uploadUrl, {
method: 'PUT',
headers: {
'Content-Type': file.type
},
body: file
});
// Étape 3 : prévenir votre API si besoin
// (dépend de votre backend)
}
info
Script Bash minimal pour uploader un fichier sur ProcessMind via deux appels curl et variables personnalisables
Upload d’un fichier CSV local vers ProcessMind via une URL présignée.
Étapes :
Configuration :
Upload d’un fichier CSV local vers une API distante avec une URL présignée.
Étapes :
Configuration :