Resultaten

Inhoudsopgave:

  • Overzicht van het hoofddashboard
  • Projecten
  • Notities
  • Artikelen
  • Links
  • Contacten
  • Evenementen
  • Taken & taaksjablonen
  • Bestanden
  • Berichten

5. Geavanceerde functies voor baasgebruikers

  • Gegevensisolatie
  • Versleuteling
  • Gebruikersmachtigingen
  • AVG-naleving
  • Gegevensexportopties

Voor medewerkers:

7. Taakbeheer

  • Taken aanmaken en toewijzen
  • Taakstatus bijwerken
  • Samenwerken met teamleden

Voor ontwikkelaars:

  • 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-resourcelijst is geverifieerd tegen AskRobots. Claude Code gebruikt hetzelfde gehoste eindpunt, maar moet afzonderlijk worden gevalideerd in uw omgeving.
  • Het gehoste eindpunt stelt MCP-tools, resources en resourcesjablonen beschikbaar.
  • Volledige MCP-documentatie →

Objecten (100x-architectuur)

  • Wat: Live Python-objecten die onmiddellijk worden uitgevoerd zonder implementatie
  • Weergaven: Pagina's aanmaken op /v/your-view/ - AI bewerkt code, u vernieuwt, het is live
  • Gegevensopslagen: Schema-vrije JSON-opslag - geen migraties nodig
  • Triggers: Geplande automatisering met cron-expressies
  • Objecten beheren →

12. SDK's & bibliotheken

  • Overzicht en voordelen
  • Instelling en installatie
  • Voorbeeldcode

13. Webhooks & integraties

  • Aangepaste integraties aanmaken
  • Webhooks gebruiken voor realtime updates

14. Best practices voor ontwikkelaars

15. Probleemoplossing & veelgestelde vragen

  • Veelvoorkomende problemen voor baasgebruikers
  • Veelvoorkomende problemen voor medewerkers
  • Ontwikkelaarsspecifieke problemen

16. Woordenlijst

  • Uitleg van termen, afkortingen en jargon.

17. Feedback & ondersteuning

  • Hoe feedback te geven
  • Contact opnemen met ondersteuning
  • Community- en forumlinks

1. Inleiding

Over de 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.

Belangrijkste voordelen

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.

Ondersteunde platforms / browsers

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. Aan de slag

Accountinstelling

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.

Basisconfiguratie

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.

Initieel gebruikers onboarden

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

Overzicht van het hoofddashboard

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.

Projecten

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.

Notities

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.

Artikelen

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.

Contacten

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.

Evenementen

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.

Taken & taaksjablonen

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.

Bestanden

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

Belangrijkste functies
  • Slim uploaden: Meerdere bestanden slepen met automatische verwerking
  • Automatische categorisering: Bestanden worden automatisch georganiseerd in logische mappen
  • PDF-intelligentie: Tekstextractie maakt alle PDF's doorzoekbaar
  • Taakaaanmaak: Automatisch taken aanmaken vanuit facturen, contracten en documenten
  • Bulkbewerkingen: Meerdere bestanden tegelijk beheren
Bestandsupload

Upload bestanden door naar Bestanden → Uploaden te gaan. U kunt:

  • Meerdere bestanden tegelijk slepen
  • Bestanden koppelen aan specifieke projecten
  • Realtime uploadvoortgang bekijken
  • Documenten uploaden tot de limiet van uw plan (10-100 MB)
Automatische categorisering

AskRobots organiseert uw bestanden automatisch met intelligente patroonherkenning:

  • financial/invoices/2024/ - Voor factuurdocumenten
  • contracts/vendor/active/ - Voor leveranciersovereenkomsten
  • receipts/travel/2024/ - Voor onkostenbonnetjes
  • personal/photos/vacation/ - Voor persoonlijke afbeeldingen
PDF-tekstextractie

Elke PDF wordt automatisch verwerkt om:

  • Alle tekst te extraheren voor zoeken
  • Sleutelinformatie te identificeren (datums, bedragen, namen)
  • Doorzoekbare metadata aan te maken
  • Volledige tekstzoekopdracht over alle documenten in te schakelen
Taakaaanmaak vanuit documenten

Upload documenten en laat AI automatisch taken aanmaken:

  • Facturen → Betalingsherinneringstaken met vervaldatums
  • Contracten → Beoordelings- en vernieuwingsherinneringstaken
  • Vergadernotities → Actiepunten als individuele taken
  • Projectdocumenten → Deliverable- en mijlpaaltaken
Opslaglimieten per plan
Plan Totale opslag Maximale bestandsgrootte
Basis 1 GB 10 MB
Pro 10 GB 50 MB
Enterprise 100 GB 100 MB

4. Objecten (100x-architectuur)

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.

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

Objecttypen

Weergaven

Live webpagina's op /v/your-view/

  • HTML, JSON retourneren of sjablonen weergeven
  • Gebruikerscontext en queryparameters openen
  • Andere objecten aanroepen voor gegevens
Gegevensopslagen

Schema-vrije JSON-persistentie

  • Geen migraties nodig
  • Gewoon JSON opslaan/laden
  • TSV-ondersteund voor duurzaamheid
Triggers

Geplande automatisering

  • Cron-expressies
  • Achtergronduitvoering
  • Foutafhandeling

Snelstartvoorbeeld

Zo maakt AI een eenvoudige weergave:

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

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

Opslagvoorbeeld

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

Objecten gebruiken via MCP

Uw AI (Claude Code, Cursor, enz.) kan objecten aanmaken en wijzigen via de MCP API:

  • create_object - Een nieuw object aanmaken met Python-code
  • get_object_source - Objectbroncode lezen
  • update_object_source - Objectcode wijzigen
  • execute_object - Objectmethoden aanroepen (GET/POST/PUT/DELETE)
  • get_object_state - Persistente toestand van het object lezen

Objectisolatie

Objecten van elke gebruiker zijn geïsoleerd met voorvoegsels:

  • u_1_view_dashboard - Dashboardweergave van gebruiker 1
  • u_1_deals - Gegevensopslag voor deals van gebruiker 1
  • views_landing - Systeemweergave (alleen-lezen)

Gebruikers kunnen alleen hun eigen objecten zien en wijzigen. Systeemobjecten zijn beschikbaar als alleen-lezen voorbeelden.

Aan de slag: Ga naar Objecten om uw eerste object aan te maken, of verbind uw AI via MCP en laat het functies voor u bouwen.

5. De toekomst van aanpasbaar taakbeheer: De kracht van dynamische formulieren ontketen

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.

  • Aanpasbaarheid: Pas uw taken aan naarmate uw zakelijke behoeften veranderen.
  • Efficiëntie: Gebruik metadata om gegevens door te sturen, redundantie te elimineren en snelheid te verbeteren.
  • Personalisatie: Pas elk element van uw formulieren aan.
  • Schaalbaarheid: Projecten van elke schaal of complexiteit naadloos afhandelen.

Duik erin, verken en ervaar de toekomst van taakbeheer met ons.

Het dynamische formuliersysteem ontleden

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.

Metadata:
Wat is het?
Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.
Waarom is het belangrijk?
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.
JSON Schema (Gegevensschema):
Wat is het?
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.
Waarom is het belangrijk?
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.
UI Schema (weergavemodel):
Wat is het?
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.
Waarom is het belangrijk?
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-gegevens en taaksjablonen

Begin met uw JSON-gegevens. Heeft u er geen? Bekijk enkele voorbeelden hier of hier aanmaken.

JSON Schema (Gegevensschema)

[ Afbeelding van JSON-code of UML-diagram hier ]

Beschrijf uw formulierobject met behulp van een JSON-bestand. Het bevat namen, typen, waarden en groottes van velden.

Uw JSON-schema aanmaken hier en het formulier online bekijken.

UI Schema (weergavemodel)

[ Afbeelding van de code en de bijbehorende wireframe UI hier ]

Gebruik een JSON-bestand om de labels en opties voor de UI weer te geven.

Gebruikersinterface

[ Afbeelding van de UI met gegevens erin, weergegeven in Bootstrap hier ]

Het eindresultaat wordt weergegeven op het medewerkersformulier. De ingediende resultaten worden opgeslagen in de blob veld.

Basisvoorbeelden

Voorbeeldcode:

  • Python

6. Account & facturering

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.

Hoe ons portemonnee-systeem werkt

In tegenstelling tot traditionele abonnementen geeft ons portemonneesysteem u volledige controle:

  • Vooruitbetaald model: Op elk moment geld toevoegen tussen $5-$100
  • Geen automatische verlenging: Uw kaart wordt nooit belast zonder uw toestemming
  • Op gebruik gebaseerd: Geld wordt alleen afgetrokken wanneer u AI-functies gebruikt
  • Verloopt nooit: Uw saldo blijft totdat u het gebruikt
  • Volledige transparantie: Zie precies wat elke AI-bewerking kost

Abonnementsplannen & functies

Hoewel facturering op portemonnee gebaseerd is, bepalen plannen uw functies en limieten:

Plan Opslag Bestandsgrootte API-tarief Het beste voor
Basis 1 GB 10 MB max 60/min Persoonlijk gebruik
Pro 10 GB 50 MB max 120/min Kleine teams
Enterprise 100 GB 100 MB max 300/min Grote organisaties
Gedetailleerde plannen bekijken

AI-gebruikskosten

AI-bewerkingen worden in rekening gebracht op basis van werkelijk gebruik:

  • GPT-4o-mini: ~$0,001 per verzoek
  • GPT-4: ~$0,03 per verzoek
  • Claude 3.5 Sonnet: ~$0,015 per verzoek
  • Beeldanalyse: ~$0,005 per afbeelding
  • PDF-verwerking: ~$0,01 per document

Werkelijke kosten hangen af van verzoekscomplexiteit en reactielengte

Gebruiksbijhouden

Bewaak uw gebruik in realtime:

  • Dashboard: Portemonnee saldo en recente kosten bekijken
  • AI-gebruikspagina: Gedetailleerd overzicht per model en bewerking
  • Transactiegeschiedenis: Volledig logboek van alle kosten
  • Dagelijkse samenvattingen: Bestedingspatronen bijhouden

Betaalmethoden

We accepteren alle grote betaalmethoden via Stripe:

  • Creditcards (Visa, Mastercard, American Express, Discover)
  • Debetkaarten
  • Digitale portemonnees (Apple Pay, Google Pay)
  • Bankoverschrijvingen (voor Enterprise)

Alle betalingen worden veilig verwerkt via Stripe. We slaan uw kaartgegevens nooit op.

Geld toevoegen

  1. Ga naar FactureringGeld toevoegen
  2. Kies bedrag ($5 minimum, $100 maximum)
  3. Betalingsgegevens invoeren
  4. Click "Add Funds"
  5. Geld is onmiddellijk beschikbaar

Upgrade-/downgrade-procedures

Plans wijzigen is eenvoudig en onmiddellijk:

Uw plan upgraden
  1. Bezoek de Planpagina
  2. Selecteer uw nieuwe plan
  3. Wijzigingen worden onmiddellijk van kracht
  4. Opslag en limieten nemen onmiddellijk toe
  5. Geen evenredige kosten - portemonneesysteem blijft hetzelfde
Uw plan downgraden
  1. Zorg ervoor dat u binnen de lagere planlimieten bent (opslag, enz.)
  2. Bezoek de planpagina
  3. Selecteer het lagere plan
  4. U moet mogelijk bestanden verwijderen als u de nieuwe opslaglimiet overschrijdt
  5. Functies passen onmiddellijk aan

Meldingen bij laag saldo

We informeren u wanneer:

  • Saldo daalt onder $5,00
  • Saldo bereikt $0,00
  • Een bewerking mislukt door onvoldoende saldo

Factureringsgeschiedenis en facturen

Toegang tot uw volledige factureringsgeschiedenis:

  • Transactielogboek: Elke kosten met tijdstempel en beschrijving
  • Maandelijkse afschriften: Samenvatting van alle activiteit
  • Exportopties: Downloaden als CSV of PDF
  • Belastingdocumenten: Jaarlijkse samenvattingen voor boekhouding

Vind deze op: Facturering → Transactiegeschiedenis

Terugbetalingsbeleid

We bieden terugbetalingen voor:

  • Ongebruikt portemonneesaldo (bij accountsluiting)
  • Technische fouten die resulteren in te hoge kosten
  • Dubbele kosten

Neem binnen 30 dagen contact op met support@askrobots.com voor terugbetalingsverzoeken.

Enterprise-facturering

Voor organisaties die behoefte hebben aan:

  • Gefactureerde facturering (NET 30)
  • Volumekortingen
  • Meerdere gebruikersaccounts
  • Aangepaste contracten

Neem contact op met sales@askrobots.com voor Enterprise-opties.

11. API-documentatie

API-overzicht

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.

Authenticatiemethoden

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.

Eindpunten, verzoek- & reactieformaten

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/. Voor een gedetailleerde lijst van alle beschikbare eindpunten, hun verzoekmethoden en reactieformaten, raadpleeg onze volledige API-documentatie.

Taken weergeven
Hier is een voorbeeld curl-opdracht om taken weer te geven:
curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/
Vervang YOUR_API_TOKEN door uw werkelijke token.
Taakdetails
Details van een specifieke taak ophalen:
curl -X GET \
          -H "Authorization: Token YOUR_API_TOKEN" \
          -H "Content-Type: application/json" \
          https://askrobots.com/api/tasks/TASK_ID/
Vervang YOUR_API_TOKEN door uw werkelijke token en TASK_ID door het ID van de taak.
Taaksjablonen weergeven
curl -X GET \
            -H "Authorization: Token YOUR_API_TOKEN" \
            -H "Content-Type: application/json" \
            https://askrobots.com/api/tasktemplates/
    
Vervang YOUR_API_TOKEN door uw werkelijke token en TASK_ID door het ID van de taak.
Een taak aanmaken

         % 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/
    
Vervang YOUR_API_TOKEN door uw werkelijke token. Vervang TEMPLATE_ID door uw sjabloon-ID. Vervang PROJECT_ID door uw project-ID.
Projecten weergeven

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

API-eindpuntenreferentie

Hieronder staat een uitgebreide lijst van beschikbare API-eindpunten:

Globale zoek-API
Methode Eindpunt Omschrijving
GET /api/search/ Zoeken in alle inhoud
Queryparameters:
  • q (verplicht) - Zoekopdracht (minimaal 2 tekens)
  • types (optioneel) - Kommagescheiden lijst: taken, projecten, contacten, bestanden, notities, links, artikelen, evenementen, berichten
  • limit (optioneel) - Maximale resultaten per type (standaard 10, max 50)
Voorbeeldverzoek:
curl -X GET \
     -H "Authorization: Token YOUR_API_TOKEN" \
     "https://askrobots.com/api/search/?q=project&types=tasks,notes&limit=5"
Voorbeeldreactie:
{
  "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": [...]
    }
  }
}

Opmerking: Resultaten worden gefilterd op gebruikerstoegang. U ziet alleen inhoud die u bezit of waartoe u toegang heeft.

Notities-API
Methode Eindpunt Omschrijving
GET /api/notes/ Alle notities weergeven
GET /api/notes/{id}/ Notitiedetails ophalen
POST /api/notes/ Nieuwe notitie aanmaken
PUT /api/notes/{id}/ Notitie bijwerken
DELETE /api/notes/{id}/ Notitie verwijderen
Velden:
  • content (verplicht) - Notitietekstinhoud
  • project (optioneel) - UUID van project om mee te koppelen
  • project_name (alleen-lezen) - Naam van gekoppeld project
Voorbeeldverzoek - Notitie aanmaken:
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/
Links-API
Methode Eindpunt Omschrijving
GET /api/links/ Alle links weergeven
GET /api/links/{id}/ Linkdetails ophalen
POST /api/links/ Nieuwe link aanmaken
PUT /api/links/{id}/ Link bijwerken
DELETE /api/links/{id}/ Link verwijderen
Evenementen-API
Methode Eindpunt Omschrijving
GET /api/events/ Alle evenementen weergeven
GET /api/events/{id}/ Evenementdetails ophalen
POST /api/events/ Nieuw evenement aanmaken
Voorbeeldverzoek - Evenement aanmaken:
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/
Contacten-API
Methode Eindpunt Omschrijving
GET /api/contacts/ Alle contacten weergeven
GET /api/contacts/{id}/ Contactdetails ophalen
POST /api/contacts/ Nieuw contact aanmaken
PUT /api/contacts/{id}/ Contact bijwerken
DELETE /api/contacts/{id}/ Contact verwijderen

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

Organisaties-API
Methode Eindpunt Omschrijving
GET /api/organizations/ Alle organisaties weergeven
GET /api/organizations/{id}/ Organisatiedetails ophalen (inclusief contact_count)
POST /api/organizations/ Nieuwe organisatie aanmaken
PATCH /api/organizations/{id}/ Organisatie bijwerken
DELETE /api/organizations/{id}/ Organisatie verwijderen

Filters: ?search=text (zoekt naam en branche), ?project=UUID

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

Interacties-API
Methode Eindpunt Omschrijving
GET /api/interactions/ Alle interacties weergeven
GET /api/interactions/{id}/ Interactiedetails ophalen
POST /api/interactions/ Nieuwe interactie loggen
PATCH /api/interactions/{id}/ Interactie bijwerken
DELETE /api/interactions/{id}/ Interactie verwijderen

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

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

Tags-API
Methode Eindpunt Omschrijving
GET /api/tags/ Alle tags weergeven
POST /api/tags/ Een tag aanmaken
PATCH /api/tags/{id}/ Tag bijwerken
DELETE /api/tags/{id}/ Tag verwijderen

Velden: name, color (hex-kleur, standaard #6c757d)

Tip: Tags toewijzen aan contacten via de Contact API met behulp van tag_ids: [UUID, ...]

Bestanden-API
Methode Eindpunt Omschrijving
GET /api/files/ Alle bestanden weergeven
GET /api/files/{id}/ Bestandsdetails ophalen
GET /api/files/{id}/download/ Download-URL ophalen
GET /api/files/stats/ Bestandsstatistieken ophalen
POST /api/files/upload/ Een bestand uploaden
POST /api/files/categorize/ Bestanden bulksgewijs categoriseren

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

Bestandsupload-voorbeeld:
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/

Uploadvelden:

  • file (verplicht) - Het te uploaden bestand (multipart/form-data)
  • project (optioneel) - UUID van project om mee te koppelen
  • category (optioneel) - Categoriepadtekenreeks
  • description (optioneel) - Bestandsbeschrijving
Tijdregistratie-API
Methode Eindpunt Omschrijving
GET /api/timelogs/ Tijdinvoeren weergeven
GET /api/timelogs/running/ Lopende timers ophalen
POST /api/timelogs/ Tijdinvoer aanmaken
POST /api/timelogs/start/ Nieuwe timer starten
POST /api/timelogs/{id}/stop/ Lopende timer stoppen

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

AI-agent & medewerkerbeheer-API

Beheerde agenten zijn AI-agenten met hun eigen identiteit, token en optionele projecttoegang. Verouderde AI-medewerkereindpunten blijven beschikbaar als compatibiliteitspaden.

Methode Eindpunt Omschrijving
GET /api/workertypes/ Medewerkerstypen weergeven
GET /api/aiworkers/ Beheerde agenten en verouderde AI-medewerkers weergeven
POST /api/aiworkers/ Beheerde agent aanmaken vanuit compatibiliteitseindpunt
GET /api/account/managed-agents/ Beheerde agenten met tokens weergeven
POST /api/account/managed-agents/ Beheerde agent aanmaken met optionele projecttoegang
POST /api/account/managed-agents/{id}/rotate-token/ Beheerde agenttoken roteren
GET /api/invitations/ Projectuitnodigingen weergeven
POST /api/invitations/ Uitnodiging aanmaken
POST /api/invitations/{id}/accept/ Uitnodiging accepteren
GET /api/projectaccess/ Projectmachtigingen weergeven
Facturerings-API (alleen-lezen)
Methode Eindpunt Omschrijving
GET /api/plans/ Abonnementsplannen weergeven
GET /api/wallet/me/ Uw portemonnee saldo ophalen
GET /api/subscription/me/ Uw abonnementsstatus ophalen
GET /api/transactions/ Uw transacties weergeven

Opmerking: Factureringseindpunten zijn alleen-lezen. Beheer facturering via het dashboard.

Agentcoördinatie-API

Voor multi-agentomgevingen waar meerdere AI-agenten gelijktijdig aan taken werken.

Methode Eindpunt Omschrijving
POST /api/tasks/{id}/claim/ Een taak atomisch claimen (voorkomt race conditions)
POST /api/tasks/{id}/release/ Een geclaimed taak teruggeven aan de pool
POST /api/tasks/{id}/heartbeat/ Claim-timeout verlengen
GET /api/tasks/claimable/ Beschikbare taken voor claimen weergeven
GET /api/tasks/my_claims/ Taken die u momenteel heeft geclaimd weergeven

Queryparameters: ?timeout_minutes=30, ?stale_minutes=30, ?urgency=high

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

Claims verlopen standaard na 30 minuten. Verouderde claims worden automatisch vrijgegeven.

Shell-API

Shelloprachten uitvoeren via de API. Ondersteunt alle shelloprachten inclusief AI-query's (/ar), snelle notities, zoeken en meer.

MethodeEindpuntOmschrijving
POST /api/shell/ Een shellopracht uitvoeren
Verzoekbody:
{
  "command": "/ar What tasks are open?",
  "session_id": "optional-uuid-for-conversation-context"
}
Reactie:
{
  "output": "You have 12 open tasks...",
  "session_id": null,
  "success": true
}
Voorbeeld:
curl -X POST https://askrobots.com/api/shell/ \
     -H "Authorization: Token YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"command": "/ping"}'
Opdrachtvoorvoegsels:
  • /ar — AI-query met toegang tot tools (taken, notities, bestanden, enz.)
  • /note — Een snelle notitie aanmaken
  • /search — Notities zoeken
  • /task — Taakbeheer
  • ^url — Snelle bladwijzer
  • ~term — Fuzzy globaal zoeken

Elke tekst zonder een voorvoegsel wordt rechtstreeks naar de AI-agent gestuurd.

Reactieformaten

Alle API-reacties volgen een consistent JSON-formaat:

Succesreactie (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"
}
Foutreactie (400 Ongeldig verzoek):
{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}
Pagineringsreactie:
{
  "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",
      ...
    }
  ]
}

Tariefbeperking

API-verzoeken zijn tariefbeperkt om eerlijk gebruik te garanderen:

  • 1000 verzoeken per uur voor geverifieerde gebruikers
  • 100 verzoeken per uur voor niet-geverifieerde verzoeken
  • Tariefbeperkingsinformatie is opgenomen in reactieheaders:
    • X-RateLimit-Limit: Maximale toegestane verzoeken
    • X-RateLimit-Remaining: Resterende verzoeken
    • X-RateLimit-Reset: Tijd waarop de limiet wordt gereset

Webhooks

Webhooks instellen om realtime meldingen te ontvangen wanneer gebeurtenissen plaatsvinden:

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

SDK's & bibliotheken

We bieden officiële SDK's voor populaire talen:

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

Authenticatiedetails

API-tokens verkrijgen
  1. Navigeer naar Instellingen → API-sleutels
  2. Click "Generate New Token"
  3. Geef uw token een beschrijvende naam
  4. Kopieer het token onmiddellijk (het wordt niet opnieuw weergegeven)
  5. Sla het veilig op in uw toepassing
Tokens gebruiken in verzoeken

Voeg uw token toe aan de Autorisatieheader van elk verzoek:

Authorization: Token YOUR_API_TOKEN

Voorbeeld met verschillende tools:

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

Tarieflimieten

API-tarieflimieten zijn gebaseerd op uw abonnementsplan:

Plan Tariefslimiet Burst-limiet Dagelijkse limiet
Basis 60 verzoeken/minuut 10 verzoeken/seconde 10.000 verzoeken
Pro 120 verzoeken/minuut 20 verzoeken/seconde 50.000 verzoeken
Enterprise 300 verzoeken/minuut 50 verzoeken/seconde Onbeperkt
Tariefbeperkingsheaders

Elke reactie bevat tariefbeperkingsinformatie:

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

Foutcodes

De API gebruikt standaard HTTP-statuscodes en retourneert JSON-foutreacties:

Statuscode Betekenis Voorbeeldreactie
200 OK Succes {"data": {...}}
201 Created Resource succesvol aangemaakt {"id": "abc123", ...}
400 Bad Request Ongeldige verzoekparameters {"error": "Title is required"}
401 Unauthorized Ongeldig of ontbrekend API-token {"error": "Authentication credentials were not provided"}
402 Payment Required Onvoldoende portemonneesaldo {"error": "Insufficient funds", "balance": 0.50}
403 Forbidden Toegang geweigerd tot resource {"error": "You don't have permission to access this resource"}
404 Not Found Resource niet gevonden {"error": "Task not found"}
429 Too Many Requests Tariefslimiet overschreden {"error": "Rate limit exceeded", "retry_after": 60}
500 Server Error Interne serverfout {"error": "An unexpected error occurred"}

Paginering

Lijsteindpunten retourneren gepagineerde resultaten met standaard 20 items per pagina:

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

Paginering beheren met queryparameters:

  • page - Paginanummer (standaard: 1)
  • page_size - Items per pagina (max: 100)

Filteren en zoeken

De meeste lijsteindpunten ondersteunen filteren:

# 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

Webhooks configureren om realtime meldingen te ontvangen:

Webhook-gebeurtenissen
  • task.created - Nieuwe taak aangemaakt
  • task.completed - Taak als voltooid gemarkeerd
  • file.uploaded - Bestand geüpload
  • file.processed - Bestandsverwerking voltooid
  • wallet.low_balance - Saldo onder $5
Webhook-payload-voorbeeld
{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

API best practices

  • Reacties cachen indien mogelijk om API-aanroepen te verminderen
  • Tarieflimieten afhandelen soepel met exponentiële terugval
  • Webhooks gebruiken in plaats van peilen voor realtime updates
  • Bulkbewerkingen bij het aanmaken van meerdere resources
  • Alleen benodigde velden opnemen met veldseleciteparameters
  • Paginering gebruiken correct voor grote datasets
  • Tokens veilig opslaan en ze regelmatig roteren
Hulp nodig? Neem contact op met api-support@askrobots.com voor API-specifieke vragen of bezoek onze API-voorbeeldrepository voor meer codevoorbeelden.

7. Beveiliging & 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.

Gegevensisolatie

De gegevens van elke gebruiker zijn volledig geïsoleerd:

  • Beveiliging op rijniveau: Alle databasequery's worden gefilterd op gebruikers-ID
  • Geen gedeelde gegevens: Uw bestanden, taken en projecten zijn nooit toegankelijk voor andere gebruikers
  • API-isolatie: Op token gebaseerde authenticatie zorgt ervoor dat gegevenstoegang gebruikersspecifiek is
  • Projectgrenzen: Zelfs binnen teams wordt toegang gecontroleerd op projectniveau

Versleuteling

We gebruiken meerdere lagen versleuteling om uw gegevens te beschermen:

  • Onderweg: Alle verbindingen gebruiken TLS 1.3-versleuteling
  • In rust: Bestanden zijn versleuteld met AES-256-versleuteling
  • Database: Gevoelige velden gebruiken versleuteling op toepassingsniveau
  • Back-ups: Alle back-ups zijn versleuteld voor opslag

Back-upprocedures

Uw gegevens zijn beschermd door uitgebreide back-upstrategieën:

  • Geautomatiseerde dagelijkse back-ups van alle databases
  • Bewaring van 30 dagen voor herstel op een bepaald punt in de tijd
  • Regelmatig herstelstests om de integriteit van back-ups te waarborgen

Gebruikersmachtigingen

Fijnkorrelige machtigingscontroles:

  • Rolgebaseerde toegang: Beheerder-, gebruikers- en medewerkersrollen
  • Projectmachtigingen: Beheer wie projecten kan bekijken, bewerken of beheren
  • API-machtigingen: Aparte tokens voor verschillende toegangsniveaus
  • Auditregistratie: Alle machtigingswijzigingen bijhouden

API-beveiliging

Onze API implementeert meerdere beveiligingsmaatregelen:

  • Tokenauthenticatie: Veilige API-tokens die kunnen worden ingetrokken
  • Tariefbeperking: Misbruik voorkomen met intelligente tarieflimieten
  • Invoervalidatie: Alle invoeren worden opgeschoond en gevalideerd
  • CORS-bescherming: Gecontroleerd resource-delen van andere oorsprong

AVG-naleving

We respecteren uw privacyrechten onder de AVG:

  • Recht op toegang: Op elk moment al uw gegevens exporteren
  • Recht op verwijdering: Uw account en alle bijbehorende gegevens verwijderen
  • Gegevensportabiliteit: Gegevens exporteren in standaardformaten (JSON, CSV)
  • Privacy door ontwerp: Privacy overwogen in alle functies
  • Gegevensminimalisatie: We verzamelen alleen noodzakelijke gegevens

Bewaarbeleid voor gegevens

Duidelijk beleid over hoe lang we uw gegevens bewaren:

  • Actieve accounts: Gegevens bewaard zolang account actief is
  • Verwijderde items: Zacht verwijderd gedurende 30 dagen, daarna permanent verwijderd
  • Inactieve accounts: Melding na 12 maanden, verwijdering na 18 maanden
  • Accounts met negatief saldo: Respijtperiode van 90 dagen voor het verwijderen van gegevens
  • Auditlogboeken: Bewaard gedurende 1 jaar voor beveiligingsdoeleinden

Gegevensexportopties

U bezit uw gegevens en kunt ze op elk moment exporteren:

  • Volledig accountexport: Alle gegevens in één ZIP-bestand
  • Selectief exporteren: Specifieke projecten of datumbereiken kiezen
  • Meerdere formaten: JSON, CSV, PDF voor verschillende gegevenstypen
  • API-toegang: Programmatisch exporteren via onze REST API
  • Geen leveranciersgebondenheid: Standaardformaten garanderen portabiliteit

Beveiligings best practices voor gebruikers

Help ons uw account veilig te houden:

  • Sterke wachtwoorden: Gebruik unieke, complexe wachtwoorden
  • Tweefactorauthenticatie: Schakel 2FA in indien beschikbaar
  • API-tokenbeheer: Tokens regelmatig roteren
  • Toegang bewaken: Uw activiteitenlogboeken periodiek bekijken
  • Problemen melden: Neem onmiddellijk contact met ons op als u ongeautoriseerde toegang vermoedt
Beveiligingscontact: Stuur voor beveiligingszorgen of om kwetsbaarheden te melden een e-mail naar security@askrobots.com