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.

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

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

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.

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

• Vrai ou Faux
• Choix multiple
• Répondre à la question

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 :

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 à Facturation → Ajouter 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

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/

Détails de la tâche

curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/

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/
    

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/
    

Lister les projets

         % curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     https://askrobots.com/api/projects/
    

Référence des points de terminaison API

Vous trouverez ci-dessous une liste complète des points de terminaison API disponibles :

curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"

{
  "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": [...]
    }
  }
}

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/

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/

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/

# 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/

{
  "command": "/ar What tasks are open?",
  "session_id": "optional-uuid-for-conversation-context"
}

{
  "output": "You have 12 open tasks...",
  "session_id": null,
  "success": true
}

curl -X POST https://askrobots.com/api/shell/ \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"command": "/ping"}'

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 :

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 :

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

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é