Risultati

Indice:

  • Panoramica della dashboard principale
  • Progetti
  • Note
  • Articoli
  • Link
  • Contatti
  • Eventi
  • Attività e modelli di attività
  • File
  • Messaggi

5. Funzionalità avanzate per utenti boss

  • Moduli dinamici
  • Integrazioni
  • Analisi e reporting avanzati
  • Flussi di lavoro automatizzati
  • Isolamento dati
  • Crittografia
  • Autorizzazioni utente
  • Conformità GDPR
  • Opzioni di esportazione dati

Per i lavoratori:

7. Gestione attività

  • Creazione e assegnazione attività
  • Aggiornamento stato attività
  • Collaborazione con i membri del team

Per gli sviluppatori:

  • Claude Code: claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
  • Codex: export ASKROBOTS_MCP_TOKEN="YOUR_TOKEN" then codex mcp add askrobots --url https://askrobots.com/api/mcp/ --bearer-token-env-var ASKROBOTS_MCP_TOKEN
  • Codex native MCP resource listing has been verified against AskRobots. Claude Code uses the same hosted endpoint, but should be validated separately in your environment.
  • The hosted endpoint exposes MCP tools, resources, and resource templates.
  • Documentazione MCP completa →

Oggetti (architettura 100x)

  • Cosa: Oggetti Python live che girano istantaneamente senza deployment
  • Visualizzazioni: Crea pagine a /v/your-view/ - L'AI modifica il codice, aggiorni, è live
  • Archivi dati: Archiviazione JSON senza schema - nessuna migrazione necessaria
  • Trigger: Automazione pianificata con espressioni cron
  • Gestisci oggetti →

12. SDK e librerie

  • Panoramica e vantaggi
  • Configurazione e installazione
  • Codice di esempio

13. Webhook e integrazioni

  • Creazione di integrazioni personalizzate
  • Utilizzo dei webhook per aggiornamenti in tempo reale

14. Buone pratiche per sviluppatori

15. Risoluzione dei problemi e FAQ

  • Problemi comuni per utenti boss
  • Problemi comuni per i lavoratori
  • Problemi specifici per sviluppatori

16. Glossario

  • Spiegazione di termini, acronimi e gergo.

17. Feedback e supporto

  • Come fornire feedback
  • Contattare il supporto
  • Link community e forum

1. Introduzione

Informazioni sul software

Our task system is a state-of-the-art web-based solution designed to streamline and simplify task management. With its intuitive interface and advanced features, it provides users an unparalleled platform to accomplish tasks efficiently and effectively.

Vantaggi principali

As a Software-as-a-Service (SaaS) offering, our task system offers the benefits of seamless updates, easy scalability, and reduced IT overhead. But what truly sets us apart is our integration with cutting-edge AI technology. This not only augments decision-making capabilities but also introduces predictive analytics and automation, ensuring that your task management is always a step ahead.

Piattaforme / Browser supportati

Compatibility is key. That's why we've ensured that our software supports all major web browsers across both desktop and mobile platforms. Furthermore, for those looking to integrate our capabilities into custom software systems, we offer a robust API that facilitates seamless connectivity.

2. Per iniziare

Configurazione account

Begin your journey by creating an account using a valid email address. Once your account is set up, explore our range of features. To access premium functionalities, choose from our subscription plans tailored to your needs.

Configurazione base

Your new account opens up to a clean slate, ready for personalization. While it might seem daunting at first, remember you don't have to master everything immediately. Start with the basics like Notes, Links, Contacts, and Events. As you become more comfortable, gradually explore more advanced features like Tasks, Task Templates, and Shell. Each module is designed to enhance your productivity at your own pace.

Onboarding iniziale utente

After registering, you'll receive an email to verify your account. This is an important step to ensure the security of your account and to activate all features. Follow the instructions in the email to complete the verification process and begin your journey with us.

3. Funzionalità principali

Panoramica della dashboard principale

Begin by exploring the main dashboard, where you'll have access to an overview of all your projects, tasks, recent activity, and important metrics. This centralized hub allows you to navigate quickly between different sections of the site and monitor ongoing work at a glance.

Progetti

Your project management system allows you to create, track, and collaborate on projects. Set deadlines, manage tasks within each project, and monitor progress with easy-to-use tools. Use the project section to view all active and archived projects.

Note

After logging in, users can create notes to capture ideas, meeting minutes, or any important information. Notes are automatically saved and can easily be searched for later. Soon you'll be able to organize notes by projects, categories or tags.

Articoli

The articles section is designed to help you create and publish longer-form content, such as documentation or reports. You can draft, edit, and collaborate on articles with other team members. The built-in version control ensures you can always revert to previous versions if needed.

After discovering useful resources, you can save and organize them under the Links section. Tag, categorize, and search your links for easy retrieval later. This section is perfect for managing research materials, external documentation, or useful references.

Contatti

After adding contacts to your system, you can manage and organize their details within the Contacts section. You can easily search for specific people, and soon categorize contacts by project or company, and integrate with other tools for communication.

Eventi

After creating events, you can view all scheduled meetings, reminders, and deadlines within the Events section. Soon you'll be able to sync events with calendars, send out invitations, and manage notifications to stay on top of important dates.

Attività e modelli di attività

After creating tasks, you can organize them by priority, assign them to team members, and track their completion status. Task templates allow you to create reusable task structures for recurring activities, ensuring consistency and saving time.

File

The Files section provides a powerful system to upload, organize, and manage documents with automatic categorization, text extraction, and task creation capabilities.

Funzionalità chiave
  • Upload intelligente: Trascina e rilascia più file con elaborazione automatica
  • Categorizzazione automatica: I file vengono organizzati automaticamente in cartelle logiche
  • Intelligenza PDF: L'estrazione del testo rende tutti i PDF ricercabili
  • Creazione attività: Crea automaticamente attività da fatture, contratti e documenti
  • Operazioni in blocco: Gestisci più file contemporaneamente
Upload file

Carica file navigando su File → Carica. Puoi:

  • Trascina e rilascia più file contemporaneamente
  • Associa file a progetti specifici
  • Vedi l'avanzamento del caricamento in tempo reale
  • Carica documenti fino al limite del tuo piano (10-100 MB)
Categorizzazione automatica

AskRobots organizza automaticamente i tuoi file usando il riconoscimento intelligente dei pattern:

  • financial/invoices/2024/ - Per i documenti delle fatture
  • contracts/vendor/active/ - Per i contratti con i fornitori
  • receipts/travel/2024/ - Per le ricevute delle spese
  • personal/photos/vacation/ - Per le immagini personali
Estrazione testo PDF

Ogni PDF viene elaborato automaticamente per:

  • Estrarre tutto il testo per la ricerca
  • Identificare informazioni chiave (date, importi, nomi)
  • Creare metadati ricercabili
  • Abilitare la ricerca full-text in tutti i documenti
Creazione attività dai documenti

Carica documenti e lascia che l'AI crei attività automaticamente:

  • Fatture → Attività di promemoria pagamento con date di scadenza
  • Contratti → Attività di promemoria revisione e rinnovo
  • Note riunioni → Azioni come attività individuali
  • Documenti progetto → Attività consegnable e milestone
Limiti di archiviazione per piano
Piano Archiviazione totale Dimensione massima file
Base 1 GB 10 MB
Pro 10 GB 50 MB
Enterprise 100 GB 100 MB

4. Oggetti (architettura 100x)

Objects are live Python code that runs instantly without deployment. This is the 100x architecture - where AI edits code, you refresh your browser, and features are live.

Perché 100x?

Traditional development takes 10-30 minutes per change (code, migrations, build, deploy, test). With Objects, changes take 10-30 seconds (edit code, refresh browser, done). That's 100x faster iteration.

Tipi di oggetti

Visualizzazioni

Pagine web live a /v/your-view/

  • Restituisci HTML, JSON o renderizza template
  • Accedi al contesto utente e ai parametri di query
  • Chiama altri oggetti per i dati
Archivi dati

Persistenza JSON senza schema

  • Nessuna migrazione necessaria
  • Semplicemente salva/carica JSON
  • Supportato da TSV per la durabilità
Trigger

Automazione pianificata

  • Espressioni cron
  • Esecuzione in background
  • Gestione errori

Esempio di avvio rapido

Ecco come l'AI crea una visualizzazione semplice:

# 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'
    }

Visita /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.

Esempio di archivio dati

# 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)}

Utilizzo di oggetti tramite MCP

Il tuo AI (Claude Code, Cursor, ecc.) può creare e modificare oggetti tramite l'API MCP:

  • create_object - Crea un nuovo oggetto con codice Python
  • get_object_source - Leggi il codice sorgente dell'oggetto
  • update_object_source - Modifica il codice dell'oggetto
  • execute_object - Chiama i metodi dell'oggetto (GET/POST/PUT/DELETE)
  • get_object_state - Leggi lo stato persistente dell'oggetto

Isolamento degli oggetti

Gli oggetti di ciascun utente sono isolati con prefissi:

  • u_1_view_dashboard - Visualizzazione dashboard dell'utente 1
  • u_1_deals - Archivio dati degli accordi dell'utente 1
  • views_landing - Visualizzazione di sistema (sola lettura)

Gli utenti possono vedere e modificare solo i propri oggetti. Gli oggetti di sistema sono disponibili come esempi in sola lettura.

Per iniziare: Vai a Oggetti per creare il tuo primo oggetto, o connetti il tuo AI tramite MCP e lascia che costruisca funzionalità per te.

5. The Future of Customizable Task Management: Unleashing The Power of Dynamic Forms

In an age of relentless digital evolution, the ways we interact with online platforms, handle tasks, and manage workflows are continuously evolving.

Traditional task management systems are static, forcing users into a one-size-fits-all approach. But imagine a world where every task, big or small, fits perfectly. Welcome to our Dynamic Form System.

  • Adaptability: Evolve your tasks as your business needs change.
  • Efficiency: Use metadata to carry forward data, eliminate redundancy, and enhance speed.
  • Personalization: Customize every element of your forms.
  • Scalability: Seamlessly handle projects of any scale or complexity.

Dive in, explore, and experience the future of task management with us.

Breaking Down the Dynamic Form System

Our task management system is engineered to offer flexibility and efficiency through its core components: Metadata, JSON Schema, and UI Schema. Each plays a crucial role in the creation and management of dynamic forms.

Metadati:
Cos'è?
Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.
Perché è importante?
Metadata serves as the backbone for contextualizing tasks. It facilitates the seamless integration of data across various tasks, ensuring that important details are carried forward. This continuity is key to maintaining efficiency and coherence in task management.
Schema JSON (Schema dati):
Cos'è?
JSON Schema acts as the architectural blueprint for your task data. It outlines the expected data types, constraints, and overall structure of the data associated with each task.
Perché è importante?
The schema's primary role is to enforce data integrity and structure. By providing a clear definition of data requirements, it ensures that all collected information is consistent, predictable, and conforms to established standards. This is crucial for maintaining data quality and facilitating automation and data processing.
Schema UI (Modello di visualizzazione):
Cos'è?
The UI Schema is responsible for the visual representation of the data structure defined by the JSON Schema. It provides customization options for the layout and design of form fields, widgets, and other interactive elements.
Perché è importante?
The UI Schema bridges the gap between backend data structures and front-end user experience. Its importance lies in its ability to tailor the presentation and interaction with the data to fit specific user needs and aesthetic preferences. This customization enhances user engagement and ensures a more intuitive and user-friendly interface.

JSON Data and Task Templates

Start with your JSON data. Don't have any? See some esempi qui o crea qui.

Schema JSON (Schema dati)

[ Picture of JSON code or UML diagram here ]

Descrivi il tuo oggetto modulo usando un file JSON. Include nomi, tipi, valori e dimensioni dei campi.

Crea il tuo schema JSON qui e anteprima del modulo online.

Schema UI (Modello di visualizzazione)

[ Picture of the code and its corresponding wireframe UI here ]

Usa un file JSON per elencare le etichette e le opzioni per l'UI.

Interfaccia utente

[ Picture of the UI with data inside, rendered in Bootstrap here ]

Il risultato finale viene visualizzato nel modulo del lavoratore. I risultati inviati vengono archiviati nel blob campo.

Esempi base

Codice di esempio:

  • Python

6. Account e fatturazione

AskRobots uses a simple wallet-based billing system. Add funds as needed, only pay for what you use, with no surprise charges or hidden fees.

Come funziona il nostro sistema portafoglio

A differenza degli abbonamenti tradizionali, il nostro sistema portafoglio ti dà il controllo completo:

  • Modello prepagato: Aggiungi fondi tra $5 e $100 in qualsiasi momento
  • Nessun rinnovo automatico: La tua carta non viene mai addebitata senza la tua autorizzazione
  • Basato sull'utilizzo: I fondi vengono dedotti solo quando usi le funzionalità AI
  • Non scade mai: Il tuo saldo rimane finché non lo usi
  • Piena trasparenza: Vedi esattamente quanto costa ogni operazione AI

Piani di abbonamento e funzionalità

Mentre la fatturazione è basata sul portafoglio, i piani determinano le tue funzionalità e i limiti:

Piano Archiviazione Dimensione file Frequenza API Ideale per
Base 1 GB 10 MB max 60/min Uso personale
Pro 10 GB 50 MB max 120/min Piccoli team
Enterprise 100 GB 100 MB max 300/min Grandi organizzazioni
Visualizza piani dettagliati

Costi utilizzo AI

Le operazioni AI vengono addebitate in base all'utilizzo effettivo:

  • GPT-4o-mini: ~$0,001 per richiesta
  • GPT-4: ~$0,03 per richiesta
  • Claude 3.5 Sonnet: ~$0,015 per richiesta
  • Analisi immagini: ~$0,005 per immagine
  • Elaborazione PDF: ~$0,01 per documento

I costi effettivi dipendono dalla complessità della richiesta e dalla lunghezza della risposta

Monitoraggio utilizzo

Monitora il tuo utilizzo in tempo reale:

  • Dashboard: Vedi il saldo del portafoglio e gli addebiti recenti
  • Pagina utilizzo AI: Suddivisione dettagliata per modello e operazione
  • Cronologia transazioni: Registro completo di tutti gli addebiti
  • Riepiloghi giornalieri: Traccia i modelli di spesa

Metodi di pagamento

Accettiamo tutti i principali metodi di pagamento tramite Stripe:

  • Carte di credito (Visa, Mastercard, American Express, Discover)
  • Carte di debito
  • Portafogli digitali (Apple Pay, Google Pay)
  • Bonifici bancari (per Enterprise)

Tutti i pagamenti vengono elaborati in modo sicuro tramite Stripe. Non memorizziamo mai i dettagli della tua carta.

Aggiunta di fondi

  1. Vai a FatturazioneAggiungi fondi
  2. Scegli l'importo (minimo $5, massimo $100)
  3. Inserisci i dettagli del pagamento
  4. Click "Add Funds"
  5. I fondi sono disponibili immediatamente

Procedure di aggiornamento/downgrade

Cambiare piano è semplice e immediato:

Aggiornamento del piano
  1. Visita la Pagina piani
  2. Seleziona il tuo nuovo piano
  3. Le modifiche hanno effetto immediatamente
  4. Archiviazione e limiti aumentano immediatamente
  5. Nessun addebito proporzionale - il sistema portafoglio rimane invariato
Downgrade del piano
  1. Assicurati di essere entro i limiti del piano inferiore (archiviazione, ecc.)
  2. Visita la pagina dei piani
  3. Seleziona il piano inferiore
  4. Potresti dover eliminare file se superi il nuovo limite di archiviazione
  5. Le funzionalità si adattano immediatamente

Notifiche saldo basso

Ti notificheremo quando:

  • Il saldo scende sotto $5,00
  • Il saldo raggiunge $0,00
  • Un'operazione fallisce per fondi insufficienti

Cronologia fatturazione e fatture

Accedi alla tua cronologia di fatturazione completa:

  • Registro transazioni: Ogni addebito con timestamp e descrizione
  • Estratti conto mensili: Riepilogo di tutte le attività
  • Opzioni di esportazione: Scarica come CSV o PDF
  • Documenti fiscali: Riepiloghi annuali per la contabilità

Trovali a: Fatturazione → Cronologia transazioni

Politica di rimborso

Offriamo rimborsi per:

  • Saldo portafoglio inutilizzato (alla chiusura dell'account)
  • Errori tecnici che risultano in addebiti eccessivi
  • Addebiti duplicati

Contatta support@askrobots.com entro 30 giorni per le richieste di rimborso.

Fatturazione Enterprise

Per le organizzazioni che necessitano:

  • Fatturazione a credito (NET 30)
  • Sconti per volume
  • Account utente multipli
  • Contratti personalizzati

Contatta sales@askrobots.com per le opzioni Enterprise.

11. Documentazione API

Panoramica API

Our API allows you to interact programmatically with our platform, enabling you to manage tasks, view statuses, and much more. It's designed for developers who want to integrate their applications or automate workflows.

Metodi di autenticazione

We use token-based authentication for securing our API. Each request must include a valid API token in the header. Tokens can be obtained through your user dashboard. You can find your API key from the dashboard or through this link.

Endpoint, formati richiesta e risposta

The API provides various endpoints to access different functionalities. Requests should be made in JSON format, and responses are also returned as JSON. Here's an example endpoint for tasks: https://askrobots.com/api/tasks/. For a detailed list of all available endpoints, their request methods, and response formats, please refer to our full API documentation.

Elenca attività
Ecco un esempio di comando curl per elencare le attività:
curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/
Sostituisci YOUR_API_TOKEN con il tuo token reale.
Dettagli attività
Per ottenere dettagli su un'attività specifica:
curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/
Sostituisci YOUR_API_TOKEN con il tuo token reale e TASK_ID con l'id dell'attività.
Elenca modelli di attività
curl -X GET \
            -H "Authorization: Token YOUR_API_TOKEN" \
            -H "Content-Type: application/json" \
            https://askrobots.com/api/tasktemplates/
    
Sostituisci YOUR_API_TOKEN con il tuo token reale e TASK_ID con l'id dell'attività.
Crea un'attività

         % 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/
    
Sostituisci YOUR_API_TOKEN con il tuo token reale. Sostituisci TEMPLATE_ID con l'ID del tuo modello. Sostituisci PROJECT_ID con l'ID del tuo progetto.
Elenca progetti

         % curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     https://askrobots.com/api/projects/
    
Sostituisci YOUR_API_TOKEN con il tuo token reale.

Riferimento endpoint API

Di seguito è riportato un elenco completo degli endpoint API disponibili:

API di ricerca globale
Metodo Endpoint Descrizione
GET /api/search/ Cerca in tutto il contenuto
Parametri di query:
  • q (obbligatorio) - Query di ricerca (min 2 caratteri)
  • types (opzionale) - Elenco separato da virgole: tasks, projects, contacts, files, notes, links, articles, events, messages
  • limit (opzionale) - Risultati massimi per tipo (default 10, max 50)
Richiesta di esempio:
curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"
Risposta di esempio:
{
  "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": [...]
    }
  }
}

Nota: I risultati vengono filtrati per l'accesso dell'utente. Vedi solo il contenuto che possiedi o a cui hai accesso.

API note
Metodo Endpoint Descrizione
GET /api/notes/ Elenca tutte le note
GET /api/notes/{id}/ Ottieni dettagli nota
POST /api/notes/ Crea nuova nota
PUT /api/notes/{id}/ Aggiorna nota
DELETE /api/notes/{id}/ Elimina nota
Campi:
  • content (obbligatorio) - Contenuto testo nota
  • project (opzionale) - UUID del progetto a cui associare
  • project_name (sola lettura) - Nome del progetto associato
Richiesta di esempio - Crea nota:
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 link
Metodo Endpoint Descrizione
GET /api/links/ Elenca tutti i link
GET /api/links/{id}/ Ottieni dettagli link
POST /api/links/ Crea nuovo link
PUT /api/links/{id}/ Aggiorna link
DELETE /api/links/{id}/ Elimina link
API eventi
Metodo Endpoint Descrizione
GET /api/events/ Elenca tutti gli eventi
GET /api/events/{id}/ Ottieni dettagli evento
POST /api/events/ Crea nuovo evento
Richiesta di esempio - Crea evento:
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 contatti
Metodo Endpoint Descrizione
GET /api/contacts/ Elenca tutti i contatti
GET /api/contacts/{id}/ Ottieni dettagli contatto
POST /api/contacts/ Crea nuovo contatto
PUT /api/contacts/{id}/ Aggiorna contatto
DELETE /api/contacts/{id}/ Elimina contatto

Filtri: ?project=UUID, ?search=text, ?ordering=last_name, ?lead_status=hot, ?organization_entity=UUID

API organizzazioni
Metodo Endpoint Descrizione
GET /api/organizations/ Elenca tutte le organizzazioni
GET /api/organizations/{id}/ Ottieni dettagli organizzazione (include contact_count)
POST /api/organizations/ Crea nuova organizzazione
PATCH /api/organizations/{id}/ Aggiorna organizzazione
DELETE /api/organizations/{id}/ Elimina organizzazione

Filtri: ?search=text (cerca nome e settore), ?project=UUID

Campi: name, website, industry, description, notes, project

API interazioni
Metodo Endpoint Descrizione
GET /api/interactions/ Elenca tutte le interazioni
GET /api/interactions/{id}/ Ottieni dettagli interazione
POST /api/interactions/ Registra una nuova interazione
PATCH /api/interactions/{id}/ Aggiorna interazione
DELETE /api/interactions/{id}/ Elimina interazione

Filtri: ?contact=UUID, ?organization=UUID, ?interaction_type=call|email|meeting|note|task

Campi: contact, interaction_type, subject, notes, duration, outcome (positive/neutral/negative/no_answer), occurred_at

API tag
Metodo Endpoint Descrizione
GET /api/tags/ Elenca tutti i tag
POST /api/tags/ Crea un tag
PATCH /api/tags/{id}/ Aggiorna tag
DELETE /api/tags/{id}/ Elimina tag

Campi: name, color (colore hex, default #6c757d)

Suggerimento: Assegna tag ai contatti tramite l'API Contatto usando tag_ids: [UUID, ...]

API file
Metodo Endpoint Descrizione
GET /api/files/ Elenca tutti i file
GET /api/files/{id}/ Ottieni dettagli file
GET /api/files/{id}/download/ Ottieni URL di download
GET /api/files/stats/ Ottieni statistiche file
POST /api/files/upload/ Carica un file
POST /api/files/categorize/ Categorizza file in blocco

Filtri: ?project=UUID, ?category=path, ?uncategorized=true, ?file_type=document

Esempio di upload file:
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/

Campi di upload:

  • file (obbligatorio) - Il file da caricare (multipart/form-data)
  • project (opzionale) - UUID del progetto a cui associare
  • category (opzionale) - Stringa percorso categoria
  • description (opzionale) - Descrizione file
API monitoraggio tempo
Metodo Endpoint Descrizione
GET /api/timelogs/ Elenca registrazioni tempo
GET /api/timelogs/running/ Ottieni timer in esecuzione
POST /api/timelogs/ Crea registrazione tempo
POST /api/timelogs/start/ Avvia nuovo timer
POST /api/timelogs/{id}/stop/ Ferma timer in esecuzione

Filtri: ?project=UUID, ?task=UUID, ?is_running=true, ?is_billable=true

API gestione agenti AI e lavoratori

Managed agents are AI agents with their own identity, token, and optional project access. Legacy AI worker endpoints remain available as compatibility paths.

Metodo Endpoint Descrizione
GET /api/workertypes/ Elenca tipi di lavoratori
GET /api/aiworkers/ List managed agents and legacy AI workers
POST /api/aiworkers/ Create managed agent from compatibility endpoint
GET /api/account/managed-agents/ List managed agents with tokens
POST /api/account/managed-agents/ Create managed agent with optional project access
POST /api/account/managed-agents/{id}/rotate-token/ Rotate managed agent token
GET /api/invitations/ Elenca inviti al progetto
POST /api/invitations/ Crea invito
POST /api/invitations/{id}/accept/ Accetta invito
GET /api/projectaccess/ Elenca autorizzazioni progetto
API fatturazione (sola lettura)
Metodo Endpoint Descrizione
GET /api/plans/ Elenca piani di abbonamento
GET /api/wallet/me/ Ottieni il saldo del portafoglio
GET /api/subscription/me/ Ottieni lo stato dell'abbonamento
GET /api/transactions/ Elenca le tue transazioni

Nota: Gli endpoint di fatturazione sono in sola lettura. Gestisci la fatturazione tramite la dashboard.

API coordinamento agenti

Per ambienti multi-agente dove più agenti AI lavorano sulle attività contemporaneamente.

Metodo Endpoint Descrizione
POST /api/tasks/{id}/claim/ Rivendica atomicamente un'attività (previene condizioni di gara)
POST /api/tasks/{id}/release/ Rilascia un'attività rivendicata al pool
POST /api/tasks/{id}/heartbeat/ Estendi timeout rivendicazione
GET /api/tasks/claimable/ Elenca attività disponibili per la rivendicazione
GET /api/tasks/my_claims/ Elenca le attività attualmente rivendicate

Parametri query: ?timeout_minutes=30, ?stale_minutes=30, ?urgency=high

Flusso di lavoro agente:
# 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/

Le rivendicazioni scadono dopo 30 minuti per default. Le rivendicazioni obsolete vengono rilasciate automaticamente.

Shell API

Execute shell commands via the API. Supports all shell commands including AI queries (/ar), quick notes, search, and more.

MetodoEndpointDescrizione
POST /api/shell/ Esegui un comando shell
Corpo della richiesta:
{
  "command": "/ar What tasks are open?",
  "session_id": "optional-uuid-for-conversation-context"
}
Risposta:
{
  "output": "You have 12 open tasks...",
  "session_id": null,
  "success": true
}
Esempio:
curl -X POST https://askrobots.com/api/shell/ \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"command": "/ping"}'
Prefissi comandi:
  • /ar — Query AI con accesso agli strumenti (attività, note, file, ecc.)
  • /note — Crea una nota rapida
  • /search — Cerca note
  • /task — Gestione attività
  • ^url — Segnalibro rapido
  • ~term — Ricerca globale fuzzy

Qualsiasi testo senza prefisso viene inviato direttamente all'agente AI.

Formati di risposta

Tutte le risposte API seguono un formato JSON coerente:

Risposta di successo (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"
}
Risposta di errore (400 Bad Request):
{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}
Risposta di paginazione:
{
  "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",
      ...
    }
  ]
}

Limitazione della frequenza

Le richieste API sono limitate per garantire un utilizzo equo:

  • 1000 richieste all'ora per gli utenti autenticati
  • 100 richieste all'ora per le richieste non autenticate
  • Le informazioni sul limite di frequenza sono incluse nelle intestazioni della risposta:
    • X-RateLimit-Limit: Richieste massime consentite
    • X-RateLimit-Remaining: Richieste rimanenti
    • X-RateLimit-Reset: Ora del ripristino del limite

Webhook

Imposta webhook per ricevere notifiche in tempo reale quando si verificano eventi:

POST /api/webhooks/
{
  "url": "https://your-app.com/webhook",
  "events": ["task.created", "task.updated", "task.completed"],
  "active": true
}

SDK e librerie

Forniamo SDK ufficiali per i linguaggi più popolari:

  • Python: pip install askrobots-sdk
  • JavaScript/Node: npm install @askrobots/sdk
  • Ruby: gem install askrobots
  • PHP: composer require askrobots/sdk
Esempio 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")

Dettagli autenticazione

Ottenimento token API
  1. Naviga a Impostazioni → Chiavi API
  2. Click "Generate New Token"
  3. Dai al tuo token un nome descrittivo
  4. Copia il token immediatamente (non verrà mostrato di nuovo)
  5. Memorizzalo in modo sicuro nella tua applicazione
Utilizzo dei token nelle richieste

Includi il tuo token nell'intestazione Authorization di ogni richiesta:

Authorization: Token YOUR_API_TOKEN

Esempio con strumenti diversi:

# 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'
    }
});

Limiti di frequenza

I limiti di frequenza API sono basati sul tuo piano di abbonamento:

Piano Limite di frequenza Limite burst Limite giornaliero
Base 60 richieste/minuto 10 richieste/secondo 10.000 richieste
Pro 120 richieste/minuto 20 richieste/secondo 50.000 richieste
Enterprise 300 richieste/minuto 50 richieste/secondo Illimitato
Intestazioni limite di frequenza

Ogni risposta include informazioni sul limite di frequenza:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432

Codici di errore

L'API usa codici di stato HTTP standard e restituisce risposte di errore JSON:

Codice di stato Significato Risposta di esempio
200 OK Successo {"data": {...}}
201 Created Risorsa creata con successo {"id": "abc123", ...}
400 Bad Request Parametri di richiesta non validi {"error": "Title is required"}
401 Unauthorized Token API non valido o mancante {"error": "Authentication credentials were not provided"}
402 Payment Required Saldo portafoglio insufficiente {"error": "Insufficient funds", "balance": 0.50}
403 Forbidden Accesso negato alla risorsa {"error": "You don't have permission to access this resource"}
404 Not Found Risorsa non trovata {"error": "Task not found"}
429 Too Many Requests Limite di frequenza superato {"error": "Rate limit exceeded", "retry_after": 60}
500 Server Error Errore interno del server {"error": "An unexpected error occurred"}

Paginazione

Gli endpoint di elenco restituiscono risultati paginati con 20 elementi per pagina per default:

{
    "count": 150,
    "next": "https://askrobots.com/api/tasks/?page=2",
    "previous": null,
    "results": [...]
}

Controlla la paginazione con parametri di query:

  • page - Numero di pagina (default: 1)
  • page_size - Elementi per pagina (max: 100)

Filtro e ricerca

La maggior parte degli endpoint di elenco supporta il filtro:

# 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

Webhook

Configura webhook per ricevere notifiche in tempo reale:

Eventi webhook
  • task.created - Nuova attività creata
  • task.completed - Attività contrassegnata come completata
  • file.uploaded - File caricato
  • file.processed - Elaborazione file completata
  • wallet.low_balance - Saldo sotto $5
Esempio di payload webhook
{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

Buone pratiche API

  • Memorizza le risposte nella cache quando possibile per ridurre le chiamate API
  • Gestisci i limiti di frequenza in modo graduale con backoff esponenziale
  • Usa i webhook invece del polling per aggiornamenti in tempo reale
  • Operazioni in batch quando si creano più risorse
  • Includi solo i campi necessari con parametri di selezione dei campi
  • Usa la paginazione correttamente per set di dati grandi
  • Memorizza i token in modo sicuro e ruotali regolarmente
Hai bisogno di aiuto? Contatta api-support@askrobots.com per domande specifiche sull'API o visita il nostro Repository esempi API per altri esempi di codice.

7. Sicurezza e privacy

AskRobots is built with security and privacy at its core. We implement industry best practices to protect your data and ensure compliance with privacy regulations.

Isolamento dati

I dati di ogni utente sono completamente isolati:

  • Sicurezza a livello di riga: Tutte le query del database vengono filtrate per ID utente
  • Nessun dato condiviso: I tuoi file, attività e progetti non sono mai accessibili ad altri utenti
  • Isolamento API: L'autenticazione basata su token garantisce che l'accesso ai dati sia specifico dell'utente
  • Confini del progetto: Anche all'interno dei team, l'accesso è controllato a livello di progetto

Crittografia

Usiamo più livelli di crittografia per proteggere i tuoi dati:

  • In transito: Tutte le connessioni usano la crittografia TLS 1.3
  • A riposo: I file sono crittografati con crittografia AES-256
  • Database: I campi sensibili usano la crittografia a livello di applicazione
  • Backup: Tutti i backup vengono crittografati prima dell'archiviazione

Procedure di backup

I tuoi dati sono protetti attraverso strategie di backup complete:

  • Backup giornalieri automatizzati di tutti i database
  • Conservazione 30 giorni per il recupero in un momento specifico
  • Test di ripristino regolari per garantire l'integrità del backup

Autorizzazioni utente

Controlli di autorizzazione granulari:

  • Accesso basato sui ruoli: Ruoli Admin, Utente e Lavoratore
  • Autorizzazioni progetto: Controlla chi può visualizzare, modificare o gestire i progetti
  • Autorizzazioni API: Token separati per diversi livelli di accesso
  • Registrazione audit: Traccia tutte le modifiche alle autorizzazioni

Sicurezza API

La nostra API implementa multiple misure di sicurezza:

  • Autenticazione token: Token API sicuri che possono essere revocati
  • Limitazione della frequenza: Previeni gli abusi con limiti di frequenza intelligenti
  • Validazione input: Tutti gli input vengono sanificati e validati
  • Protezione CORS: Condivisione di risorse cross-origin controllata

Conformità GDPR

Rispettiamo i tuoi diritti alla privacy ai sensi del GDPR:

  • Diritto di accesso: Esporta tutti i tuoi dati in qualsiasi momento
  • Diritto alla cancellazione: Elimina il tuo account e tutti i dati associati
  • Portabilità dei dati: Esporta dati in formati standard (JSON, CSV)
  • Privacy by Design: Privacy considerata in tutte le funzionalità
  • Minimizzazione dei dati: Raccogliamo solo i dati necessari

Politiche di conservazione dei dati

Politiche chiare su quanto tempo conserviamo i tuoi dati:

  • Account attivi: Dati conservati mentre l'account è attivo
  • Elementi eliminati: Eliminati soft per 30 giorni, poi rimossi definitivamente
  • Account inattivi: Notifica dopo 12 mesi, eliminazione dopo 18 mesi
  • Account con saldo negativo: Periodo di grazia di 90 giorni prima della rimozione dei dati
  • Log di audit: Conservati per 1 anno per scopi di sicurezza

Opzioni di esportazione dati

Sei proprietario dei tuoi dati e puoi esportarli in qualsiasi momento:

  • Esportazione completa dell'account: Tutti i dati in un singolo file ZIP
  • Esportazione selettiva: Scegli progetti specifici o intervalli di date
  • Formati multipli: JSON, CSV, PDF per diversi tipi di dati
  • Accesso API: Esportazione programmatica tramite la nostra API REST
  • Nessun vendor lock-in: I formati standard garantiscono la portabilità

Best practice di sicurezza per gli utenti

Aiutaci a mantenere il tuo account sicuro:

  • Password forti: Usa password uniche e complesse
  • Autenticazione a due fattori: Abilita 2FA quando disponibile
  • Gestione token API: Ruota i token regolarmente
  • Monitora l'accesso: Rivedi periodicamente i tuoi log di attività
  • Segnala problemi: Contattaci immediatamente se sospetti accessi non autorizzati
Contatto sicurezza: Per problemi di sicurezza o per segnalare vulnerabilità, invia un'email security@askrobots.com