Résultats

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

5. Fonctionnalités avancées pour les utilisateurs administrateurs

  • Isolation des donnĂ©es
  • Chiffrement
  • Permissions utilisateur
  • ConformitĂ© RGPD
  • Options d'export de donnĂ©es

Pour les collaborateurs :

7. Gestion des tĂąches

  • 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 →

🚀 Objets (architecture 100x)

  • 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 →

12. SDK et bibliothĂšques

  • Aperçu et avantages
  • Configuration et installation
  • Exemple de code

13. Webhooks et intégrations

  • CrĂ©er des intĂ©grations personnalisĂ©es
  • Utiliser les webhooks pour des mises Ă  jour en temps rĂ©el

14. Bonnes pratiques pour les développeurs

15. Dépannage et FAQ

  • ProblĂšmes courants pour les administrateurs
  • ProblĂšmes courants pour les collaborateurs
  • ProblĂšmes spĂ©cifiques aux dĂ©veloppeurs

16. Glossaire

  • Explication des termes, acronymes et jargon.

17. Retours et assistance

  • 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.

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.

Contacts

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

Vues

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
EntrepÎts de données

Persistance JSON sans schéma

  • Aucune migration nĂ©cessaire
  • Enregistrez/chargez simplement du JSON
  • Sauvegarde TSV pour la durabilitĂ©
Déclencheurs

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.

5. L'avenir de la gestion personnalisée des tùches : exploiter la puissance des formulaires dynamiques

À 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 :

  • Python

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

  1. Accédez à FacturationAjouter des fonds
  2. Choisissez le montant (minimum 5 $, maximum 100 $)
  3. Saisissez les détails de paiement
  4. Click "Add Funds"
  5. 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
  1. Accédez à la page des abonnements
  2. Sélectionnez votre nouvel abonnement
  3. Les modifications prennent effet immédiatement
  4. Le stockage et les limites augmentent immédiatement
  5. Pas de frais au prorata - le systĂšme de portefeuille reste identique
Rétrograder votre abonnement
  1. Assurez-vous d'ĂȘtre dans les limites du plan infĂ©rieur (stockage, etc.)
  2. Accédez à la page des abonnements
  3. Sélectionnez l'abonnement inférieur
  4. Vous devrez peut-ĂȘtre supprimer des fichiers si vous dĂ©passez la nouvelle limite de stockage
  5. 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 :

🔍 API de recherche globale
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.

📝 API des notes
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/
🔗 API des liens
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
📅 API des Ă©vĂ©nements
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/
📇 API des contacts
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

📁 API Fichiers
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
⏱ API de suivi du temps
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

đŸ€– API de gestion des agents
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
💰 API de facturation (lecture seule)
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.

đŸ€ API de coordination des agents

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
  1. AccĂ©dez Ă  ParamĂštres → ClĂ©s API
  2. Click "Generate New Token"
  3. Donnez un nom descriptif Ă  votre jeton
  4. Copiez le jeton immédiatement (il ne sera plus affiché)
  5. 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