Accueil
Documentation
Table des matiĂšres :
Aperçu du tableau de bord principal
Projets
Notes
Articles
Liens
Contacts
ĂvĂ©nements
TĂąches et modĂšles de tĂąches
Fichiers
Messages
Isolation des données
Chiffrement
Permissions utilisateur
Conformité RGPD
Options d'export de données
Pour les collaborateurs :
Créer et assigner des tùches
Mettre Ă jour le statut des tĂąches
Collaborer avec les membres de l'équipe
Pour les développeurs :
Configuration rapide : claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
19 outils : tĂąches, projets, contacts, notes, liens, articles, recherche
Documentation MCP complĂšte →
Qu'est-ce que c'est : Objets Python en direct qui s'exécutent instantanément sans déploiement
Vues : Créer des pages sur /v/your-view/ - L'IA modifie le code, vous actualisez, c'est en ligne
EntrepÎts de données : Stockage JSON sans schéma - aucune migration nécessaire
Déclencheurs : Automatisation planifiée avec des expressions cron
GĂ©rer les objets →
Aperçu et avantages
Configuration et installation
Exemple de code
Créer des intégrations personnalisées
Utiliser les webhooks pour des mises à jour en temps réel
ProblĂšmes courants pour les administrateurs
ProblĂšmes courants pour les collaborateurs
ProblÚmes spécifiques aux développeurs
Explication des termes, acronymes et jargon.
Comment soumettre un retour
Contacter l'assistance
Liens vers la communauté et le forum
1. Introduction
Ă propos du logiciel
Notre systÚme de gestion des tùches est une solution web de pointe conçue pour rationaliser et simplifier la gestion des tùches. Grùce à son interface intuitive et ses fonctionnalités avancées, il offre aux utilisateurs une plateforme inégalée pour accomplir leurs tùches de maniÚre efficace et productive.
Avantages clés
En tant qu'offre SaaS (Software-as-a-Service), notre systÚme de tùches bénéficie de mises à jour transparentes, d'une évolutivité aisée et d'une réduction des coûts informatiques. Mais ce qui nous distingue vraiment, c'est notre intégration avec une technologie IA de pointe. Celle-ci augmente non seulement les capacités de prise de décision, mais introduit également l'analytique prédictive et l'automatisation, garantissant que votre gestion des tùches ait toujours une longueur d'avance.
Plateformes / navigateurs pris en charge
La compatibilité est essentielle. C'est pourquoi nous avons veillé à ce que notre logiciel prenne en charge tous les principaux navigateurs web sur les plateformes de bureau et mobiles. De plus, pour ceux qui souhaitent intégrer nos fonctionnalités dans des systÚmes logiciels personnalisés, nous proposons une API robuste qui facilite une connectivité transparente.
2. Premiers pas
Configuration du compte
Commencez votre parcours en créant un compte avec une adresse e-mail valide. Une fois votre compte configuré, explorez nos fonctionnalités. Pour accéder aux fonctionnalités premium, choisissez parmi nos abonnements adaptés à vos besoins.
Configuration de base
Votre nouveau compte s'ouvre sur une page blanche, prĂȘte Ă ĂȘtre personnalisĂ©e. MĂȘme si cela peut sembler intimidant au dĂ©but, n'oubliez pas que vous n'avez pas Ă tout maĂźtriser immĂ©diatement. Commencez par les bases comme les Notes, les Liens, les Contacts et les ĂvĂ©nements. Ă mesure que vous vous familiarisez, explorez progressivement des fonctionnalitĂ©s plus avancĂ©es comme les TĂąches, les ModĂšles de tĂąches et le Terminal. Chaque module est conçu pour amĂ©liorer votre productivitĂ© Ă votre propre rythme.
Prise en main initiale
AprÚs votre inscription, vous recevrez un e-mail pour vérifier votre compte. Il s'agit d'une étape importante pour garantir la sécurité de votre compte et activer toutes les fonctionnalités. Suivez les instructions de l'e-mail pour terminer le processus de vérification et commencer votre expérience avec nous.
3. Fonctionnalités principales
Aperçu du tableau de bord principal
Commencez par explorer le tableau de bord principal, oĂč vous aurez accĂšs Ă une vue d'ensemble de tous vos projets, tĂąches, activitĂ©s rĂ©centes et indicateurs importants. Ce hub centralisĂ© vous permet de naviguer rapidement entre les diffĂ©rentes sections du site et de surveiller le travail en cours en un coup d'Ćil.
Projets
Votre systÚme de gestion de projets vous permet de créer, suivre et collaborer sur des projets. Définissez des échéances, gérez les tùches au sein de chaque projet et surveillez l'avancement avec des outils faciles à utiliser. Utilisez la section projets pour voir tous les projets actifs et archivés.
Notes
AprĂšs connexion, les utilisateurs peuvent crĂ©er des notes pour consigner des idĂ©es, des comptes rendus de rĂ©union ou toute information importante. Les notes sont enregistrĂ©es automatiquement et peuvent ĂȘtre facilement retrouvĂ©es ultĂ©rieurement. Vous pourrez bientĂŽt organiser les notes par projets, catĂ©gories ou Ă©tiquettes.
Articles
La section articles est conçue pour vous aider à créer et publier du contenu long format, comme de la documentation ou des rapports. Vous pouvez rédiger, modifier et collaborer sur des articles avec d'autres membres de l'équipe. Le contrÎle de version intégré vous garantit de pouvoir toujours revenir à des versions antérieures si nécessaire.
Liens
AprĂšs avoir dĂ©couvert des ressources utiles, vous pouvez les enregistrer et les organiser dans la section Liens. Ătiquetez, catĂ©gorisez et recherchez vos liens pour les retrouver facilement plus tard. Cette section est idĂ©ale pour gĂ©rer des documents de recherche, de la documentation externe ou des rĂ©fĂ©rences utiles.
VIDEO
AprÚs avoir ajouté des contacts à votre systÚme, vous pouvez gérer et organiser leurs informations dans la section Contacts. Vous pouvez facilement rechercher des personnes spécifiques et bientÎt catégoriser les contacts par projet ou entreprise, et les intégrer avec d'autres outils de communication.
ĂvĂ©nements
AprĂšs avoir créé des Ă©vĂ©nements, vous pouvez voir toutes les rĂ©unions planifiĂ©es, rappels et Ă©chĂ©ances dans la section ĂvĂ©nements. Vous pourrez bientĂŽt synchroniser les Ă©vĂ©nements avec des calendriers, envoyer des invitations et gĂ©rer les notifications pour ne jamais manquer une date importante.
TĂąches et modĂšles de tĂąches
AprÚs avoir créé des tùches, vous pouvez les organiser par priorité, les assigner à des membres de l'équipe et suivre leur statut d'achÚvement. Les modÚles de tùches vous permettent de créer des structures de tùches réutilisables pour les activités récurrentes, garantissant cohérence et gain de temps.
Fichiers
La section Fichiers offre un systÚme puissant pour téléverser, organiser et gérer des documents avec catégorisation automatique, extraction de texte et création automatique de tùches.
Fonctionnalités clés
Téléversement intelligent : Glisser-déposer plusieurs fichiers avec traitement automatique
Catégorisation automatique : Les fichiers sont automatiquement organisés dans des dossiers logiques
Intelligence PDF : L'extraction de texte rend tous les PDF consultables
Création de tùche : Créez automatiquement des tùches à partir de factures, contrats et documents
Opérations en masse : Gérez plusieurs fichiers à la fois
Téléversement de fichier
TĂ©lĂ©versez des fichiers en accĂ©dant Ă Fichiers â TĂ©lĂ©verser. Vous pouvez :
Glisser-déposer plusieurs fichiers à la fois
Associer des fichiers à des projets spécifiques
Voir la progression du téléversement en temps réel
Téléverser des documents jusqu'à la limite de votre abonnement (10-100 Mo)
Catégorisation automatique
AskRobots organise automatiquement vos fichiers grĂące Ă une reconnaissance intelligente des patterns :
financial/invoices/2024/ - Pour les documents de facturation
contracts/vendor/active/ - Pour les contrats fournisseurs
receipts/travel/2024/ - Pour les reçus de dépenses
personal/photos/vacation/ - Pour les images personnelles
Extraction de texte PDF
Chaque PDF est automatiquement traité pour :
Extraire tout le texte pour la recherche
Identifier les informations clés (dates, montants, noms)
Créer des métadonnées consultables
Activer la recherche plein texte dans tous les documents
Création de tùches à partir de documents
Téléversez des documents et laissez l'IA créer des tùches automatiquement :
Factures → TĂąches de rappel de paiement avec dates d'Ă©chĂ©ance
Contrats → TĂąches de rappel de rĂ©vision et de renouvellement
Notes de rĂ©union → Points d'action en tĂąches individuelles
Documents de projet → TĂąches de livrable et de jalon
Limites de stockage par abonnement
Abonnement
Stockage total
Taille de fichier maximale
Basique
1 GB
10 MB
Pro
10 GB
50 MB
Entreprise
100 GB
100 MB
4. Objets (architecture 100x)
Les objets sont du code Python en direct qui s'exĂ©cute instantanĂ©ment sans dĂ©ploiement. C'est l'architecture 100x - oĂč l'IA modifie le code, vous actualisez votre navigateur et les fonctionnalitĂ©s sont en ligne.
Pourquoi 100x ?
Le développement traditionnel prend 10 à 30 minutes par modification (code, migrations, build, déploiement, test). Avec les Objets, les modifications prennent 10 à 30 secondes (modifier le code, actualiser le navigateur, terminé). C'est une itération 100 fois plus rapide.
Types d'objets
Pages web en direct sur /v/your-view/
Retourner HTML, JSON ou afficher des modĂšles
AccĂ©der au contexte utilisateur et aux paramĂštres de requĂȘte
Appeler d'autres objets pour les données
Persistance JSON sans schéma
Aucune migration nécessaire
Enregistrez/chargez simplement du JSON
Sauvegarde TSV pour la durabilité
Automatisation planifiée
Expressions cron
Exécution en arriÚre-plan
Gestion des erreurs
Exemple de démarrage rapide
Voici comment l'IA crée une vue simple :
# Object: u_1_view_hello
# This renders at /v/hello/
def GET(request, context):
name = context.get('params', {}).get('name', 'World')
return {
'html': f'<h1>Hello, {name}!</h1>',
'title': 'Greeting'
}
Visitez /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.
Exemple d'entrepÎt de données
# Object: u_1_deals (data store)
# Stores deals as JSON in _state_manager
def GET(request, context):
deals = _state_manager.get('deals', [])
return {'deals': deals, 'count': len(deals)}
def POST(request, context):
deals = _state_manager.get('deals', [])
new_deal = context.get('data', {})
deals.append(new_deal)
_state_manager.set('deals', deals)
return {'status': 'added', 'count': len(deals)}
Utiliser les objets via MCP
Votre IA (Claude Code, Cursor, etc.) peut créer et modifier des objets via l'API MCP :
create_object - Créer un nouvel objet avec du code Python
get_object_source - Lire le code source de l'objet
update_object_source - Modifier le code de l'objet
execute_object - Appeler les méthodes de l'objet (GET/POST/PUT/DELETE)
get_object_state - Lire l'état persisté de l'objet
Isolation des objets
Les objets de chaque utilisateur sont isolés avec des préfixes :
u_1_view_dashboard - Vue du tableau de bord de l'utilisateur 1
u_1_deals - EntrepÎt de données des transactions de l'utilisateur 1
views_landing - Vue systĂšme (lecture seule)
Les utilisateurs ne peuvent voir et modifier que leurs propres objets. Les objets systĂšme sont disponibles en lecture seule Ă titre d'exemples.
Commencer : AccĂ©dez Ă
Objets pour créer votre premier objet, ou connectez votre IA via MCP et laissez-la construire des fonctionnalités pour vous.
à l'Úre de l'évolution numérique incessante, nos façons d'interagir avec les plateformes en ligne, de gérer les tùches et les flux de travail évoluent continuellement.
Les systĂšmes de gestion des tĂąches traditionnels sont statiques, imposant aux utilisateurs une approche uniforme. Mais imaginez un monde oĂč chaque tĂąche, grande ou petite, s'adapte parfaitement. Bienvenue dans notre systĂšme de formulaires dynamiques.
Adaptabilité : faites évoluer vos tùches au rythme de vos besoins métier.
Efficacité : utilisez les métadonnées pour transmettre les données, éliminer les redondances et améliorer la rapidité.
Personnalisation : personnalisez chaque élément de vos formulaires.
ĂvolutivitĂ© : gĂ©rez sans effort des projets de toute taille ou complexitĂ©.
Plongez-vous, explorez et vivez avec nous l'avenir de la gestion des tĂąches.
Décryptage du systÚme de formulaires dynamiques
Notre systÚme de gestion des tùches est conçu pour offrir flexibilité et efficacité grùce à ses composants essentiels : Métadonnées, JSON Schema et UI Schema. Chacun joue un rÎle crucial dans la création et la gestion des formulaires dynamiques.
Métadonnées :
Qu'est-ce que c'est ?
Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.
Pourquoi est-ce important ?
Les métadonnées constituent l'épine dorsale de la contextualisation des tùches. Elles facilitent l'intégration transparente des données entre les différentes tùches, garantissant que les détails importants sont transmis. Cette continuité est essentielle pour maintenir l'efficacité et la cohérence dans la gestion des tùches.
JSON Schema (schéma de données) :
Qu'est-ce que c'est ?
Le JSON Schema sert de plan architectural pour les données de vos tùches. Il définit les types de données attendus, les contraintes et la structure globale des données associées à chaque tùche.
Pourquoi est-ce important ?
Le rÎle principal du schéma est d'assurer l'intégrité et la structure des données. En fournissant une définition claire des exigences en matiÚre de données, il garantit que toutes les informations collectées sont cohérentes, prévisibles et conformes aux standards établis. C'est essentiel pour maintenir la qualité des données et faciliter l'automatisation et le traitement des données.
UI Schema (modĂšle de vue) :
Qu'est-ce que c'est ?
L'UI Schema est responsable de la représentation visuelle de la structure de données définie par le JSON Schema. Il offre des options de personnalisation pour la mise en page et le design des champs de formulaire, des widgets et autres éléments interactifs.
Pourquoi est-ce important ?
L'UI Schema comble le fossé entre les structures de données backend et l'expérience utilisateur frontend. Son importance réside dans sa capacité à adapter la présentation et l'interaction avec les données aux besoins spécifiques des utilisateurs et à leurs préférences esthétiques. Cette personnalisation améliore l'engagement des utilisateurs et garantit une interface plus intuitive et conviviale.
Données JSON et modÚles de tùches
Commencez avec vos données JSON. Vous n'en avez pas ? Consultez des exemples ici ou
créer ici .
JSON Schema (schéma de données)
[ Image de code JSON ou diagramme UML ici ]
Décrivez votre objet de formulaire à l'aide d'un fichier JSON. Il inclut les noms, types, valeurs et tailles des champs.
Créez votre JSON schema ici
et prévisualiser le formulaire en ligne .
UI Schema (modĂšle de vue)
[ Image du code et de son interface filaire correspondante ici ]
Utilisez un fichier JSON pour lister les libellés et options de l'interface.
Interface utilisateur
[ Image de l'interface avec les données, rendue en Bootstrap ici ]
Le résultat final est affiché sur le formulaire du collaborateur. Les résultats soumis sont stockés dans le blob champ.
Exemples de base
Exemple de code :
6. Compte et facturation
AskRobots utilise un systÚme de facturation simple basé sur un portefeuille. Ajoutez des fonds selon vos besoins, ne payez que ce que vous utilisez, sans frais surprise ni frais cachés.
Comment fonctionne notre systĂšme de portefeuille
Contrairement aux abonnements traditionnels, notre systĂšme de portefeuille vous donne un contrĂŽle total :
ModÚle prépayé : Ajoutez des fonds entre 5 $ et 100 $ à tout moment
Pas de renouvellement automatique : Votre carte n'est jamais débitée sans votre autorisation
Basé sur l'utilisation : Les fonds ne sont déduits que lorsque vous utilisez les fonctionnalités IA
N'expire jamais : Votre solde reste disponible jusqu'Ă ce que vous l'utilisiez
Transparence totale : Voyez exactement ce que coûte chaque opération IA
Abonnements et fonctionnalités
Bien que la facturation soit basée sur le portefeuille, les abonnements déterminent vos fonctionnalités et limites :
Abonnement
Stockage
Taille de fichier
Limite d'appels API
Idéal pour
Basique
1 GB
10 MB max
60/min
Usage personnel
Pro
10 GB
50 MB max
120/min
Petites équipes
Entreprise
100 GB
100 MB max
300/min
Grandes organisations
Voir les abonnements détaillés
Coûts d'utilisation de l'IA
Les opérations IA sont facturées en fonction de l'utilisation réelle :
GPT-4o-mini : ~0,001 $ par requĂȘte
GPT-4 : ~0,03 $ par requĂȘte
Claude 3.5 Sonnet : ~0,015 $ par requĂȘte
Analyse d'image : ~0,005 $ par image
Traitement PDF : ~0,01 $ par document
Les coĂ»ts rĂ©els dĂ©pendent de la complexitĂ© de la requĂȘte et de la longueur de la rĂ©ponse
Suivi de l'utilisation
Surveillez votre utilisation en temps réel :
Tableau de bord : Voir le solde du portefeuille et les derniers débits
Page d'utilisation IA : Détail par modÚle et par opération
Historique des transactions : Journal complet de tous les débits
Résumés quotidiens : Suivre les habitudes de dépenses
Modes de paiement
Nous acceptons tous les principaux modes de paiement via Stripe :
Cartes de crédit (Visa, Mastercard, American Express, Discover)
Cartes de débit
Portefeuilles numériques (Apple Pay, Google Pay)
Virements bancaires (pour Entreprise)
Tous les paiements sont traités de maniÚre sécurisée via Stripe. Nous ne stockons jamais les détails de votre carte.
Ajouter des fonds
AccĂ©dez Ă Facturation → Ajouter des fonds
Choisissez le montant (minimum 5 $, maximum 100 $)
Saisissez les détails de paiement
Click "Add Funds"
Les fonds sont disponibles immédiatement
Procédures de mise à niveau/rétrogradation
Changer d'abonnement est simple et immédiat :
Mettre Ă niveau votre abonnement
Accédez à la page des abonnements
Sélectionnez votre nouvel abonnement
Les modifications prennent effet immédiatement
Le stockage et les limites augmentent immédiatement
Pas de frais au prorata - le systĂšme de portefeuille reste identique
Rétrograder votre abonnement
Assurez-vous d'ĂȘtre dans les limites du plan infĂ©rieur (stockage, etc.)
Accédez à la page des abonnements
Sélectionnez l'abonnement inférieur
Vous devrez peut-ĂȘtre supprimer des fichiers si vous dĂ©passez la nouvelle limite de stockage
Les fonctionnalités s'ajustent immédiatement
Notifications de solde faible
Nous vous informerons lorsque :
Le solde tombe en dessous de 5,00 $
Le solde atteint 0,00 $
Une opération échoue par manque de fonds
Historique de facturation et factures
Accédez à votre historique de facturation complet :
Journal des transactions : Chaque débit avec horodatage et description
Relevés mensuels : Résumé de toute l'activité
Options d'export : Télécharger en CSV ou PDF
Documents fiscaux : Résumés annuels pour la comptabilité
Retrouvez-les ici : Facturation → Historique des transactions
Politique de remboursement
Nous offrons des remboursements pour :
Solde de portefeuille non utilisé (lors de la clÎture du compte)
Erreurs techniques entraĂźnant des surfacturations
Débits en double
Contactez support@askrobots.com dans les 30 jours pour toute demande de remboursement.
Facturation Entreprise
Pour les organisations nécessitant :
Facturation sur facture (NET 30)
Remises sur volume
Comptes utilisateurs multiples
Contrats personnalisés
Contactez sales@askrobots.com pour les options Entreprise.
11. Documentation API
Aperçu de l'API
Notre API vous permet d'interagir par programmation avec notre plateforme, vous donnant la possibilité de gérer des tùches, consulter des statuts et bien plus encore. Elle est conçue pour les développeurs souhaitant intégrer leurs applications ou automatiser des flux de travail.
Méthodes d'authentification
Nous utilisons une authentification par jeton pour sĂ©curiser notre API. Chaque requĂȘte doit inclure un jeton API valide dans l'en-tĂȘte. Les jetons peuvent ĂȘtre obtenus via votre tableau de bord utilisateur. Vous pouvez trouver votre clĂ© API depuis le tableau de bord ou via ce lien .
Points de terminaison, formats des requĂȘtes et rĂ©ponses
L'API fournit divers points de terminaison pour accĂ©der Ă diffĂ©rentes fonctionnalitĂ©s. Les requĂȘtes doivent ĂȘtre effectuĂ©es au format JSON, et les rĂ©ponses sont Ă©galement retournĂ©es en JSON. Voici un exemple de point de terminaison pour les tĂąches :
https://askrobots.com/api/tasks/ . Pour une liste dĂ©taillĂ©e de tous les points de terminaison disponibles, leurs mĂ©thodes de requĂȘte et formats de rĂ©ponse, veuillez consulter notre documentation API complĂšte.
Lister les tĂąches
Voici un exemple de commande curl pour lister les tĂąches :
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasks/
Remplacez YOUR_API_TOKEN par votre jeton réel.
Détails de la tùche
Pour obtenir les détails d'une tùche spécifique :
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasks/TASK_ID/
Remplacez YOUR_API_TOKEN par votre jeton réel et TASK_ID par l'identifiant de la tùche.
Lister les modĂšles de tĂąches
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasktemplates/
Remplacez YOUR_API_TOKEN par votre jeton réel et TASK_ID par l'identifiant de la tùche.
Créer une tùche
% curl -X POST \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "New Task with Template",
"urgency": "normal",
"template": "TEMPLATE_ID",
"instructions": "Please follow the template guidelines",
"json_form": {},
"metadata": {},
"priority": 1,
"due_date": "2024-03-25T00:00:00Z",
"project": "PROJECT_ID"
}' \
https://askrobots.com/api/tasks/
Remplacez YOUR_API_TOKEN par votre jeton réel.
Remplacez TEMPLATE_ID par l'identifiant de votre modĂšle.
Remplacez PROJECT_ID par l'identifiant de votre projet.
Lister les projets
% curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/projects/
Remplacez YOUR_API_TOKEN par votre jeton réel.
Référence des points de terminaison API
Vous trouverez ci-dessous une liste complĂšte des points de terminaison API disponibles :
Méthode
Point de terminaison
Description
GET
/api/search/
Rechercher dans tout le contenu
ParamĂštres de requĂȘte :
q (obligatoire) - RequĂȘte de recherche (minimum 2 caractĂšres)
types (facultatif) - Liste séparée par des virgules : tasks, projects, contacts, files, notes, links, articles, events, messages
limit (facultatif) - Résultats maximum par type (par défaut 10, maximum 50)
Exemple de requĂȘte :
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
"https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"
Exemple de réponse :
{
"query": "project",
"total_count": 15,
"types_searched": ["tasks", "notes"],
"results": {
"tasks": {
"count": 10,
"results": [
{
"id": "uuid",
"type": "task",
"title": "Create project dashboard",
"snippet": "Build the main project...",
"created_at": "2026-02-03T...",
"project": {"id": "uuid", "name": "AskRobots"},
"status": "open"
}
]
},
"notes": {
"count": 5,
"results": [...]
}
}
}
Remarque : Les résultats sont filtrés par accÚs utilisateur. Vous ne voyez que le contenu qui vous appartient ou auquel vous avez accÚs.
Méthode
Point de terminaison
Description
GET
/api/notes/
Lister toutes les notes
GET
/api/notes/{id}/
Obtenir les détails d'une note
POST
/api/notes/
Créer une nouvelle note
PUT
/api/notes/{id}/
Mettre Ă jour une note
DELETE
/api/notes/{id}/
Supprimer une note
Champs :
content (obligatoire) - Contenu textuel de la note
project (facultatif) - UUID du projet Ă associer
project_name (lecture seule) - Nom du projet associé
Exemple de requĂȘte - CrĂ©er une note :
curl -X POST \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"content": "Discussed project timeline and deliverables",
"project": "PROJECT_UUID"
}' \
https://askrobots.com/api/notes/
Méthode
Point de terminaison
Description
GET
/api/links/
Lister tous les liens
GET
/api/links/{id}/
Obtenir les détails d'un lien
POST
/api/links/
Créer un nouveau lien
PUT
/api/links/{id}/
Mettre Ă jour un lien
DELETE
/api/links/{id}/
Supprimer un lien
Méthode
Point de terminaison
Description
GET
/api/events/
Lister tous les événements
GET
/api/events/{id}/
Obtenir les détails d'un événement
POST
/api/events/
Créer un nouvel événement
Exemple de requĂȘte - CrĂ©er un Ă©vĂ©nement :
curl -X POST \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"title": "Team Meeting",
"start_date_time": "2025-06-15T14:00:00Z",
"end_date_time": "2025-06-15T15:00:00Z",
"description": "Weekly team sync",
"project": "PROJECT_ID"
}' \
https://askrobots.com/api/events/
Méthode
Point de terminaison
Description
GET
/api/contacts/
Lister tous les contacts
GET
/api/contacts/{id}/
Obtenir les détails du contact
POST
/api/contacts/
Créer un nouveau contact
PUT
/api/contacts/{id}/
Mettre Ă jour le contact
DELETE
/api/contacts/{id}/
Supprimer le contact
Filtres : ?project=UUID, ?search=text, ?ordering=last_name
Méthode
Point de terminaison
Description
GET
/api/files/
Lister tous les fichiers
GET
/api/files/{id}/
Obtenir les détails du fichier
GET
/api/files/{id}/download/
Obtenir l'URL de téléchargement
GET
/api/files/stats/
Obtenir les statistiques des fichiers
POST
/api/files/upload/
Téléverser un fichier
POST
/api/files/categorize/
Catégoriser les fichiers en masse
Filtres : ?project=UUID, ?category=path, ?uncategorized=true, ?file_type=document
Exemple de téléversement de fichier :
curl -X POST \
-H "Authorization: Token YOUR_API_TOKEN" \
-F "file=@/path/to/document.pdf" \
-F "project=PROJECT_UUID" \
-F "description=Project documentation" \
https://askrobots.com/api/files/upload/
Champs de téléversement :
file (obligatoire) - Le fichier à téléverser (multipart/form-data)
project (facultatif) - UUID du projet Ă associer
category (facultatif) - Chemin de catégorie
description (facultatif) - Description du fichier
Méthode
Point de terminaison
Description
GET
/api/timelogs/
Lister les entrées de temps
GET
/api/timelogs/running/
Obtenir les minuteries en cours
POST
/api/timelogs/
Créer une entrée de temps
POST
/api/timelogs/start/
Démarrer un nouveau minuteur
POST
/api/timelogs/{id}/stop/
ArrĂȘter le minuteur en cours
Filtres : ?project=UUID, ?task=UUID, ?is_running=true, ?is_billable=true
Méthode
Point de terminaison
Description
GET
/api/workertypes/
Lister les types d'agents
GET
/api/aiworkers/
Lister les agents IA
POST
/api/aiworkers/
Créer un agent IA
GET
/api/invitations/
Lister les invitations au projet
POST
/api/invitations/
Créer une invitation
POST
/api/invitations/{id}/accept/
Accepter l'invitation
GET
/api/projectaccess/
Lister les permissions du projet
Méthode
Point de terminaison
Description
GET
/api/plans/
Lister les plans d'abonnement
GET
/api/wallet/me/
Obtenir votre solde de portefeuille
GET
/api/subscription/me/
Obtenir votre statut d'abonnement
GET
/api/transactions/
Lister vos transactions
Remarque : Les points de terminaison de facturation sont en lecture seule. Gérez la facturation via le tableau de bord.
Pour les environnements multi-agents oĂč plusieurs agents IA travaillent sur des tĂąches simultanĂ©ment.
Méthode
Point de terminaison
Description
POST
/api/tasks/{id}/claim/
Revendiquer une tùche de maniÚre atomique (évite les conflits d'accÚs)
POST
/api/tasks/{id}/release/
Libérer une tùche revendiquée vers le pool
POST
/api/tasks/{id}/heartbeat/
Prolonger le délai de revendication
GET
/api/tasks/claimable/
Lister les tĂąches disponibles Ă revendiquer
GET
/api/tasks/my_claims/
Lister les tùches que vous avez actuellement revendiquées
ParamĂštres de requĂȘte : ?timeout_minutes=30, ?stale_minutes=30, ?urgency=high
Flux de travail des agents :
# 1. Find claimable tasks
GET /api/tasks/claimable/?urgency=high&limit=5
# 2. Claim a task atomically
POST /api/tasks/{id}/claim/?timeout_minutes=30
# 3. Send heartbeats while working
POST /api/tasks/{id}/heartbeat/
# 4. Complete or release when done
POST /api/tasks/{id}/complete_simple/
# or
POST /api/tasks/{id}/release/
Les revendications expirent aprÚs 30 minutes par défaut. Les revendications obsolÚtes sont automatiquement libérées.
Formats de réponse
Toutes les réponses API suivent un format JSON cohérent :
Réponse en cas de succÚs (200 OK) :
{
"id": "uuid-here",
"title": "Sample Note",
"content": "This is the note content",
"created_at": "2025-06-11T12:00:00Z",
"updated_at": "2025-06-11T12:00:00Z",
"user": "user-id",
"project": "project-id"
}
Réponse en cas d'erreur (400 Bad Request) :
{
"error": "Bad Request",
"message": "Title field is required",
"field_errors": {
"title": ["This field is required."]
}
}
Réponse paginée :
{
"count": 45,
"next": "https://askrobots.com/api/notes/?page=2",
"previous": null,
"results": [
{
"id": "uuid-1",
"title": "Note 1",
...
},
{
"id": "uuid-2",
"title": "Note 2",
...
}
]
}
Limitation du débit
Les requĂȘtes API sont soumises Ă une limitation du dĂ©bit pour garantir une utilisation Ă©quitable :
1 000 requĂȘtes par heure pour les utilisateurs authentifiĂ©s
100 requĂȘtes par heure pour les requĂȘtes non authentifiĂ©es
Les informations de limitation du dĂ©bit sont incluses dans les en-tĂȘtes de rĂ©ponse :
X-RateLimit-Limit: Nombre maximum de requĂȘtes autorisĂ©es
X-RateLimit-Remaining: RequĂȘtes restantes
X-RateLimit-Reset: Heure de réinitialisation de la limite
Webhooks
Configurez des webhooks pour recevoir des notifications en temps réel lors d'événements :
POST /api/webhooks/
{
"url": "https://your-app.com/webhook",
"events": ["task.created", "task.updated", "task.completed"],
"active": true
}
SDK et bibliothĂšques
Nous proposons des SDK officiels pour les langages populaires :
Python: pip install askrobots-sdk
JavaScript/Node: npm install @askrobots/sdk
Ruby: gem install askrobots
PHP: composer require askrobots/sdk
Exemple de SDK Python :
from askrobots import Client
client = Client(api_key="YOUR_API_TOKEN")
# List tasks
tasks = client.tasks.list()
# Create a new task
new_task = client.tasks.create(
title="Complete API documentation",
urgency="high",
project_id="PROJECT_ID"
)
# Update task status
client.tasks.update(new_task.id, status="completed")
Détails d'authentification
Obtention des jetons API
AccĂ©dez Ă ParamĂštres → ClĂ©s API
Click "Generate New Token"
Donnez un nom descriptif Ă votre jeton
Copiez le jeton immédiatement (il ne sera plus affiché)
Conservez-le en lieu sûr dans votre application
Utilisation des jetons dans les requĂȘtes
Incluez votre jeton dans l'en-tĂȘte Authorization de chaque requĂȘte :
Authorization: Token YOUR_API_TOKEN
Exemple avec différents outils :
# curl
curl -H "Authorization: Token YOUR_API_TOKEN" https://askrobots.com/api/tasks/
# Python requests
import requests
headers = {"Authorization": "Token YOUR_API_TOKEN"}
response = requests.get("https://askrobots.com/api/tasks/", headers=headers)
# JavaScript fetch
fetch('https://askrobots.com/api/tasks/', {
headers: {
'Authorization': 'Token YOUR_API_TOKEN'
}
});
Limites de débit
Les limites de débit API sont basées sur votre plan d'abonnement :
Abonnement
Limite de débit
Limite en rafale
Limite quotidienne
Basique
60 requĂȘtes/minute
10 requĂȘtes/seconde
10 000 requĂȘtes
Pro
120 requĂȘtes/minute
20 requĂȘtes/seconde
50 000 requĂȘtes
Entreprise
300 requĂȘtes/minute
50 requĂȘtes/seconde
Illimité
En-tĂȘtes de limitation du dĂ©bit
Chaque réponse inclut les informations de limitation du débit :
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432
Codes d'erreur
L'API utilise les codes de statut HTTP standard et renvoie des réponses d'erreur JSON :
Code de statut
Signification
Exemple de réponse
200 OK
SuccĂšs
{"data": {...}}
201 Created
Ressource créée avec succÚs
{"id": "abc123", ...}
400 Bad Request
ParamĂštres de requĂȘte invalides
{"error": "Title is required"}
401 Unauthorized
Jeton API invalide ou manquant
{"error": "Authentication credentials were not provided"}
402 Payment Required
Solde de portefeuille insuffisant
{"error": "Insufficient funds", "balance": 0.50}
403 Forbidden
AccÚs refusé à la ressource
{"error": "You don't have permission to access this resource"}
404 Not Found
Ressource introuvable
{"error": "Task not found"}
429 Too Many Requests
Limite de débit dépassée
{"error": "Rate limit exceeded", "retry_after": 60}
500 Server Error
Erreur interne du serveur
{"error": "An unexpected error occurred"}
Pagination
Les points de terminaison de liste renvoient des résultats paginés avec 20 éléments par page par défaut :
{
"count": 150,
"next": "https://askrobots.com/api/tasks/?page=2",
"previous": null,
"results": [...]
}
ContrĂŽlez la pagination avec les paramĂštres de requĂȘte :
page - Numéro de page (défaut : 1)
page_size - ĂlĂ©ments par page (max : 100)
Filtrage et recherche
La plupart des points de terminaison de liste supportent le filtrage :
# Filter tasks by project
/api/tasks/?project=PROJECT_ID
# Filter by status
/api/tasks/?status=open
# Search tasks
/api/tasks/?search=invoice
# Combine filters
/api/tasks/?project=PROJECT_ID&status=open&urgency=high
Webhooks
Configurez des webhooks pour recevoir des notifications en temps réel :
ĂvĂ©nements webhook
task.created - Nouvelle tùche créée
task.completed - Tùche marquée comme terminée
file.uploaded - Fichier téléversé
file.processed - Traitement du fichier terminé
wallet.low_balance - Solde inférieur à 5 $
Exemple de charge utile webhook
{
"event": "task.completed",
"timestamp": "2025-06-19T10:30:00Z",
"data": {
"id": "task123",
"title": "Process invoices",
"completed_by": "user456"
}
}
Bonnes pratiques API
Mettre en cache les réponses dans la mesure du possible pour réduire les appels API
Gérer les limites de débit avec élégance grùce au backoff exponentiel
Utiliser les webhooks plutÎt que l'interrogation pour les mises à jour en temps réel
Opérations par lot lors de la création de plusieurs ressources
N'inclure que les champs nécessaires avec les paramÚtres de sélection de champs
Utiliser la pagination correctement pour les grands ensembles de données
Stocker les jetons en lieu sûr et les renouveler réguliÚrement
Besoin d'aide ? Contactez api-support@askrobots.com pour des questions spécifiques à l'API ou consultez notre
DépÎt d'exemples API pour plus d'exemples de code.
7. Sécurité et confidentialité
AskRobots est conçu avec la sĂ©curitĂ© et la confidentialitĂ© au cĆur de ses prioritĂ©s. Nous appliquons les meilleures pratiques du secteur pour protĂ©ger vos donnĂ©es et assurer la conformitĂ© avec les rĂ©glementations en matiĂšre de confidentialitĂ©.
Isolation des données
Les données de chaque utilisateur sont totalement isolées :
SĂ©curitĂ© au niveau des lignes : Toutes les requĂȘtes de base de donnĂ©es sont filtrĂ©es par identifiant utilisateur
Aucune donnée partagée : Vos fichiers, tùches et projets ne sont jamais accessibles aux autres utilisateurs
Isolation API : L'authentification par jeton garantit que l'accÚs aux données est propre à chaque utilisateur
PĂ©rimĂštres de projet : MĂȘme au sein des Ă©quipes, l'accĂšs est contrĂŽlĂ© au niveau du projet
Chiffrement
Nous utilisons plusieurs couches de chiffrement pour protéger vos données :
En transit : Toutes les connexions utilisent le chiffrement TLS 1.3
Au repos : Les fichiers sont chiffrés avec le chiffrement AES-256
Base de données : Les champs sensibles utilisent un chiffrement au niveau de l'application
Sauvegardes : Toutes les sauvegardes sont chiffrées avant stockage
Procédures de sauvegarde
Vos données sont protégées par des stratégies de sauvegarde complÚtes :
Sauvegardes quotidiennes automatisées de toutes les bases de données
Conservation 30 jours pour la récupération à un instant précis
Tests de restauration réguliers pour garantir l'intégrité des sauvegardes
Permissions utilisateur
ContrĂŽles d'autorisation granulaires :
AccÚs basé sur les rÎles : RÎles Administrateur, Utilisateur et Agent
Permissions de projet : ContrÎlez qui peut afficher, modifier ou gérer les projets
Permissions API : Jetons distincts pour différents niveaux d'accÚs
Journalisation d'audit : Suivre toutes les modifications de permissions
Sécurité API
Notre API met en Ćuvre plusieurs mesures de sĂ©curitĂ© :
Authentification par jeton : Jetons API sĂ©curisĂ©s pouvant ĂȘtre rĂ©voquĂ©s
Limitation du débit : Prévenir les abus grùce à des limites de débit intelligentes
Validation des entrées : Toutes les entrées sont assainies et validées
Protection CORS : Partage de ressources entre origines contrÎlé
Conformité RGPD
Nous respectons vos droits en matiÚre de confidentialité au titre du RGPD :
Droit d'accÚs : Exportez toutes vos données à tout moment
Droit à l'effacement : Supprimez votre compte et toutes les données associées
Portabilité des données : Exportez les données dans des formats standard (JSON, CSV)
Protection de la vie privée dÚs la conception : La confidentialité est prise en compte dans toutes les fonctionnalités
Minimisation des données : Nous ne collectons que les données nécessaires
Politiques de conservation des données
Des politiques claires sur la durée de conservation de vos données :
Comptes actifs : Données conservées tant que le compte est actif
ĂlĂ©ments supprimĂ©s : Suppression temporaire pendant 30 jours, puis suppression dĂ©finitive
Comptes inactifs : Notification aprĂšs 12 mois, suppression aprĂšs 18 mois
Comptes à solde négatif : Période de grùce de 90 jours avant la suppression des données
Journaux d'audit : Conservés pendant 1 an à des fins de sécurité
Options d'export de données
Vous ĂȘtes propriĂ©taire de vos donnĂ©es et pouvez les exporter Ă tout moment :
Export complet du compte : Toutes les données dans un seul fichier ZIP
Export sélectif : Choisissez des projets spécifiques ou des plages de dates
Formats multiples : JSON, CSV, PDF pour différents types de données
AccĂšs API : Export programmatique via notre API REST
Aucune dépendance fournisseur : Les formats standard garantissent la portabilité
Bonnes pratiques de sécurité pour les utilisateurs
Aidez-nous à sécuriser votre compte :
Mots de passe robustes : Utilisez des mots de passe uniques et complexes
Authentification Ă deux facteurs : Activez l'authentification Ă deux facteurs lorsqu'elle est disponible
Gestion des jetons API : Renouvelez les jetons réguliÚrement
Surveiller les accÚs : Consultez vos journaux d'activité périodiquement
Signaler les problÚmes : Contactez-nous immédiatement si vous suspectez un accÚs non autorisé
Contact sĂ©curitĂ© : Pour tout problĂšme de sĂ©curitĂ© ou pour signaler des vulnĂ©rabilitĂ©s, veuillez envoyer un e-mail Ă
security@askrobots.com