1. Einführung

Über die Software

Unser Aufgabensystem ist eine hochmoderne webbasierte Lösung, die das Aufgabenmanagement optimiert und vereinfacht. Mit seiner intuitiven Oberfläche und erweiterten Funktionen bietet es Benutzern eine unvergleichliche Plattform, um Aufgaben effizient und effektiv zu erledigen.

Wichtigste Vorteile

Als Software-as-a-Service (SaaS) bietet unser Aufgabensystem nahtlose Updates, einfache Skalierbarkeit und reduzierten IT-Aufwand. Was uns jedoch wirklich auszeichnet, ist die Integration modernster KI-Technologie. Diese erweitert nicht nur die Entscheidungsfähigkeiten, sondern führt auch Predictive Analytics und Automatisierung ein, sodass Ihr Aufgabenmanagement stets einen Schritt voraus ist.

Unterstützte Plattformen / Browser

Kompatibilität ist entscheidend. Deshalb haben wir sichergestellt, dass unsere Software alle gängigen Webbrowser auf Desktop- und Mobilplattformen unterstützt. Darüber hinaus bieten wir für diejenigen, die unsere Funktionen in eigene Softwaresysteme integrieren möchten, eine robuste API für nahtlose Konnektivität.

2. Erste Schritte

Kontoeinrichtung

Beginnen Sie Ihre Reise, indem Sie ein Konto mit einer gültigen E-Mail-Adresse erstellen. Sobald Ihr Konto eingerichtet ist, erkunden Sie unsere Funktionen. Um auf Premium-Funktionen zuzugreifen, wählen Sie einen auf Ihre Bedürfnisse zugeschnittenen Abonnementplan.

Grundkonfiguration

Ihr neues Konto startet mit einem leeren Blatt, bereit zur Personalisierung. Auch wenn es anfangs überwältigend erscheinen mag, müssen Sie nicht alles sofort beherrschen. Beginnen Sie mit den Grundlagen wie Notizen, Links, Kontakten und Ereignissen. Wenn Sie sich wohler fühlen, erkunden Sie schrittweise erweiterte Funktionen wie Aufgaben, Aufgabenvorlagen und Shell. Jedes Modul ist darauf ausgelegt, Ihre Produktivität in Ihrem eigenen Tempo zu steigern.

Erstmalige Benutzereinführung

Nach der Registrierung erhalten Sie eine E-Mail zur Bestätigung Ihres Kontos. Dies ist ein wichtiger Schritt, um die Sicherheit Ihres Kontos zu gewährleisten und alle Funktionen zu aktivieren. Folgen Sie den Anweisungen in der E-Mail, um den Verifizierungsprozess abzuschließen und Ihre Reise mit uns zu beginnen.

3. Kernfunktionen

Übersicht über das Haupt-Dashboard

Beginnen Sie damit, das Haupt-Dashboard zu erkunden, wo Sie eine Übersicht über alle Ihre Projekte, Aufgaben, aktuelle Aktivitäten und wichtige Kennzahlen haben. Dieser zentrale Hub ermöglicht es Ihnen, schnell zwischen verschiedenen Bereichen der Website zu navigieren und laufende Arbeiten auf einen Blick zu verfolgen.

Projekte

Ihr Projektmanagementsystem ermöglicht es Ihnen, Projekte zu erstellen, zu verfolgen und gemeinsam daran zu arbeiten. Setzen Sie Fristen, verwalten Sie Aufgaben innerhalb jedes Projekts und überwachen Sie den Fortschritt mit benutzerfreundlichen Werkzeugen. Nutzen Sie den Projektbereich, um alle aktiven und archivierten Projekte anzuzeigen.

Notizen

Nach der Anmeldung können Benutzer Notizen erstellen, um Ideen, Besprechungsnotizen oder wichtige Informationen festzuhalten. Notizen werden automatisch gespeichert und können später einfach durchsucht werden. Bald können Sie Notizen nach Projekten, Kategorien oder Tags organisieren.

Artikel

Der Artikelbereich ist darauf ausgelegt, Ihnen bei der Erstellung und Veröffentlichung von Langform-Inhalten wie Dokumentationen oder Berichten zu helfen. Sie können Artikel entwerfen, bearbeiten und mit anderen Teammitgliedern gemeinsam daran arbeiten. Die integrierte Versionskontrolle stellt sicher, dass Sie bei Bedarf jederzeit zu früheren Versionen zurückkehren können.

Links

Nachdem Sie nützliche Ressourcen entdeckt haben, können Sie diese im Links-Bereich speichern und organisieren. Versehen Sie Ihre Links mit Tags, kategorisieren und durchsuchen Sie sie für einen späteren einfachen Zugriff. Dieser Bereich ist ideal für die Verwaltung von Forschungsmaterialien, externer Dokumentation oder nützlicher Referenzen.

Kontakte

Nachdem Sie Kontakte zu Ihrem System hinzugefügt haben, können Sie deren Details im Kontakte-Bereich verwalten und organisieren. Sie können einfach nach bestimmten Personen suchen und bald Kontakte nach Projekt oder Unternehmen kategorisieren sowie mit anderen Kommunikationstools integrieren.

Ereignisse

Nach dem Erstellen von Ereignissen können Sie alle geplanten Besprechungen, Erinnerungen und Fristen im Ereignisse-Bereich anzeigen. Bald können Sie Ereignisse mit Kalendern synchronisieren, Einladungen versenden und Benachrichtigungen verwalten, um wichtige Termine im Blick zu behalten.

Aufgaben und Aufgabenvorlagen

Nach dem Erstellen von Aufgaben können Sie diese nach Priorität ordnen, an Teammitglieder zuweisen und deren Abschlussstatus verfolgen. Aufgabenvorlagen ermöglichen es Ihnen, wiederverwendbare Aufgabenstrukturen für wiederkehrende Aktivitäten zu erstellen, die Konsistenz gewährleisten und Zeit sparen.

Dateien

Der Dateien-Bereich bietet ein leistungsstarkes System zum Hochladen, Organisieren und Verwalten von Dokumenten mit automatischer Kategorisierung, Textextraktion und Aufgabenerstellungsfunktionen.

Wichtigste Funktionen

• Intelligentes Hochladen: Mehrere Dateien per Drag-and-Drop mit automatischer Verarbeitung
• Automatische Kategorisierung: Dateien werden automatisch in logische Ordner organisiert
• PDF-Intelligenz: Textextraktion macht alle PDFs durchsuchbar
• Aufgabenerstellung: Automatisch Aufgaben aus Rechnungen, Verträgen und Dokumenten erstellen
• Massenoperationen: Mehrere Dateien gleichzeitig verwalten

Datei-Hochladen

Laden Sie Dateien hoch, indem Sie zu Dateien → Hochladen navigieren. Sie können:

• Mehrere Dateien gleichzeitig per Drag-and-Drop
• Dateien mit bestimmten Projekten verknüpfen
• Echtzeit-Fortschritt beim Hochladen anzeigen
• Dokumente bis zum Limit Ihres Plans hochladen (10–100 MB)

Automatische Kategorisierung

AskRobots organisiert Ihre Dateien automatisch mithilfe intelligenter Mustererkennung:

• financial/invoices/2024/ - Für Rechnungsdokumente
• contracts/vendor/active/ - Für Lieferantenvereinbarungen
• receipts/travel/2024/ - Für Ausgabenbelege
• personal/photos/vacation/ - Für persönliche Bilder

PDF-Textextraktion

Jede PDF wird automatisch verarbeitet, um:

• Gesamten Text für die Suche zu extrahieren
• Schlüsselinformationen zu identifizieren (Daten, Beträge, Namen)
• Durchsuchbare Metadaten zu erstellen
• Volltextsuche über alle Dokumente zu ermöglichen

Aufgabenerstellung aus Dokumenten

Laden Sie Dokumente hoch und lassen Sie die KI automatisch Aufgaben erstellen:

• Rechnungen → Zahlungserinnerungsaufgaben mit Fälligkeitsdaten
• Verträge → Überprüfungs- und Verlängerungserinnerungsaufgaben
• Besprechungsnotizen → Aktionspunkte als einzelne Aufgaben
• Projektdokumente → Liefergegenstände und Meilensteinaufgaben

Speicherlimits nach Plan

4. Objekte (100x-Architektur)

Objekte sind Live-Python-Code, der sofort ohne Deployment ausgeführt wird. Dies ist die 100x-Architektur – wo KI Code bearbeitet, Sie Ihren Browser aktualisieren und Funktionen live sind.

Warum 100x?

Herkömmliche Entwicklung benötigt 10–30 Minuten pro Änderung (Code, Migrationen, Build, Deployment, Test). Mit Objekten dauern Änderungen 10–30 Sekunden (Code bearbeiten, Browser aktualisieren, fertig). Das ist eine 100-mal schnellere Iteration.

Objekttypen

Schnellstart-Beispiel

So erstellt die KI eine einfache Ansicht:

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

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

Datenspeicher-Beispiel

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

Objekte über MCP verwenden

Ihre KI (Claude Code, Cursor usw.) kann Objekte über die MCP-API erstellen und bearbeiten:

• create_object - Ein neues Objekt mit Python-Code erstellen
• get_object_source - Objekt-Quellcode lesen
• update_object_source - Objekt-Code bearbeiten
• execute_object - Objektmethoden aufrufen (GET/POST/PUT/DELETE)
• get_object_state - Persistierten Zustand des Objekts lesen

Objektisolierung

Die Objekte jedes Benutzers sind mit Präfixen isoliert:

• u_1_view_dashboard - Dashboard-Ansicht von Benutzer 1
• u_1_deals - Deals-Datenspeicher von Benutzer 1
• views_landing - Systemansicht (nur Lesezugriff)

Benutzer können nur ihre eigenen Objekte anzeigen und bearbeiten. Systemobjekte stehen als schreibgeschützte Beispiele zur Verfügung.

5. Die Zukunft des anpassbaren Aufgabenmanagements: Die Kraft dynamischer Formulare entfesseln

In einem Zeitalter unaufhörlicher digitaler Evolution entwickeln sich die Arten, wie wir mit Online-Plattformen interagieren, Aufgaben erledigen und Arbeitsabläufe verwalten, kontinuierlich weiter.

Herkömmliche Aufgabenmanagementsysteme sind statisch und zwingen Benutzer in einen Einheitsansatz. Aber stellen Sie sich eine Welt vor, in der jede Aufgabe, groß oder klein, perfekt passt. Willkommen in unserem dynamischen Formularsystem.

• Anpassungsfähigkeit: Entwickeln Sie Ihre Aufgaben entsprechend den sich ändernden Geschäftsanforderungen.
• Effizienz: Verwenden Sie Metadaten, um Daten weiterzuführen, Redundanz zu eliminieren und die Geschwindigkeit zu erhöhen.
• Personalisierung: Passen Sie jedes Element Ihrer Formulare an.
• Skalierbarkeit: Verwalten Sie nahtlos Projekte jeder Größe und Komplexität.

Tauchen Sie ein, erkunden Sie und erleben Sie mit uns die Zukunft des Aufgabenmanagements.

Das dynamische Formularsystem im Detail

Unser Aufgabenmanagementsystem ist so konzipiert, dass es durch seine Kernkomponenten Flexibilität und Effizienz bietet: Metadaten, JSON Schema und UI Schema. Jede Komponente spielt eine entscheidende Rolle bei der Erstellung und Verwaltung dynamischer Formulare.

Metadaten:

Was ist das?

Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.

Warum ist das wichtig?

Metadaten dienen als Rückgrat für die Kontextualisierung von Aufgaben. Sie ermöglichen die nahtlose Integration von Daten über verschiedene Aufgaben hinweg und stellen sicher, dass wichtige Details weitergegeben werden. Diese Kontinuität ist der Schlüssel zur Aufrechterhaltung von Effizienz und Kohärenz im Aufgabenmanagement.

JSON Schema (Datenschema):

Was ist das?

JSON Schema dient als architektonischer Bauplan für Ihre Aufgabendaten. Es beschreibt die erwarteten Datentypen, Einschränkungen und die Gesamtstruktur der mit jeder Aufgabe verbundenen Daten.

Warum ist das wichtig?

Die Hauptaufgabe des Schemas besteht darin, Datenintegrität und -struktur durchzusetzen. Durch eine klare Definition der Datenanforderungen stellt es sicher, dass alle gesammelten Informationen konsistent, vorhersehbar und konform mit etablierten Standards sind. Dies ist entscheidend für die Aufrechterhaltung der Datenqualität und die Erleichterung von Automatisierung und Datenverarbeitung.

UI Schema (Ansichtsmodell):

Was ist das?

Das UI Schema ist für die visuelle Darstellung der durch das JSON Schema definierten Datenstruktur verantwortlich. Es bietet Anpassungsoptionen für das Layout und Design von Formularfeldern, Widgets und anderen interaktiven Elementen.

Warum ist das wichtig?

Das UI Schema überbrückt die Lücke zwischen Backend-Datenstrukturen und der Frontend-Benutzererfahrung. Seine Bedeutung liegt in der Fähigkeit, die Darstellung und Interaktion mit den Daten an spezifische Benutzerbedürfnisse und ästhetische Vorlieben anzupassen. Diese Anpassung steigert das Benutzerengagement und sorgt für eine intuitivere und benutzerfreundlichere Oberfläche.

JSON-Daten und Aufgabenvorlagen

Beginnen Sie mit Ihren JSON-Daten. Haben Sie keine? Sehen Sie sich einige Beispiele hier an oder hier erstellen.

JSON Schema (Datenschema)

[ Bild von JSON-Code oder UML-Diagramm hier ]

Beschreiben Sie Ihr Formularobjekt mithilfe einer JSON-Datei. Sie enthält Namen, Typen, Werte und Größen der Felder.

Erstellen Sie Ihr JSON Schema hier und das Formular online in der Vorschau anzeigen.

UI Schema (Ansichtsmodell)

[ Bild des Codes und der entsprechenden Wireframe-Oberfläche hier ]

Verwenden Sie eine JSON-Datei, um die Beschriftungen und Optionen für die Oberfläche aufzulisten.

Benutzeroberfläche

[ Bild der Oberfläche mit Daten, in Bootstrap gerendert, hier ]

Das Endergebnis wird im Mitarbeiterformular angezeigt. Die übermittelten Ergebnisse werden im blob Feld gespeichert.

Grundlegende Beispiele

• Wahr oder Falsch
• Multiple Choice
• Frage beantworten

Beispielcode:

• Python

6. Konto und Abrechnung

AskRobots verwendet ein einfaches walletbasiertes Abrechnungssystem. Laden Sie nach Bedarf Guthaben auf, zahlen Sie nur für das, was Sie nutzen, ohne unerwartete Gebühren oder versteckte Kosten.

Wie unser Wallet-System funktioniert

Im Gegensatz zu herkömmlichen Abonnements gibt Ihnen unser Wallet-System vollständige Kontrolle:

• Prepaid-Modell: Guthaben zwischen 5 $ und 100 $ jederzeit aufladen
• Keine automatische Verlängerung: Ihre Karte wird nie ohne Ihre Erlaubnis belastet
• Nutzungsbasiert: Guthaben wird nur abgezogen, wenn Sie KI-Funktionen nutzen
• Verfällt nie: Ihr Guthaben bleibt erhalten, bis Sie es verwenden
• Vollständige Transparenz: Sehen Sie genau, was jede KI-Operation kostet

Abonnementpläne und Funktionen

Während die Abrechnung walletbasiert ist, bestimmen Pläne Ihre Funktionen und Limits:

KI-Nutzungskosten

KI-Operationen werden basierend auf der tatsächlichen Nutzung berechnet:

• GPT-4o-mini: ~0,001 $ pro Anfrage
• GPT-4: ~0,03 $ pro Anfrage
• Claude 3.5 Sonnet: ~0,015 $ pro Anfrage
• Bildanalyse: ~0,005 $ pro Bild
• PDF-Verarbeitung: ~0,01 $ pro Dokument

Tatsächliche Kosten hängen von der Anfragekomplexität und Antwortlänge ab

Nutzungsverfolgung

Überwachen Sie Ihre Nutzung in Echtzeit:

• Dashboard: Wallet-Guthaben und aktuelle Belastungen anzeigen
• KI-Nutzungsseite: Detaillierte Aufschlüsselung nach Modell und Operation
• Transaktionsverlauf: Vollständiges Protokoll aller Belastungen
• Tägliche Zusammenfassungen: Ausgabenmuster verfolgen

Zahlungsmethoden

Wir akzeptieren alle gängigen Zahlungsmethoden über Stripe:

• Kreditkarten (Visa, Mastercard, American Express, Discover)
• Debitkarten
• Digitale Wallets (Apple Pay, Google Pay)
• Banküberweisungen (für Enterprise)

Alle Zahlungen werden sicher über Stripe abgewickelt. Wir speichern niemals Ihre Kartendaten.

Guthaben aufladen

1. Gehen Sie zu Abrechnung → Guthaben aufladen
2. Betrag wählen (mindestens 5 $, höchstens 100 $)
3. Zahlungsdetails eingeben
4. Click "Add Funds"
5. Guthaben ist sofort verfügbar

Upgrade-/Downgrade-Verfahren

Das Wechseln von Plänen ist einfach und sofort wirksam:

Ihren Plan upgraden

1. Besuchen Sie die Pläne-Seite
2. Wählen Sie Ihren neuen Plan
3. Änderungen treten sofort in Kraft
4. Speicher und Limits erhöhen sich sofort
5. Keine anteiligen Gebühren – das Wallet-System bleibt unverändert

Ihren Plan downgraden

1. Stellen Sie sicher, dass Sie innerhalb der Limits des niedrigeren Plans sind (Speicher usw.)
2. Besuchen Sie die Pläne-Seite
3. Wählen Sie den niedrigeren Plan
4. Sie müssen möglicherweise Dateien löschen, wenn Sie das neue Speicherlimit überschreiten
5. Funktionen passen sich sofort an

Benachrichtigungen bei niedrigem Guthaben

Wir benachrichtigen Sie, wenn:

• Das Guthaben unter 5,00 $ fällt
• Das Guthaben 0,00 $ erreicht
• Eine Operation aufgrund unzureichender Mittel fehlschlägt

Abrechnungsverlauf und Rechnungen

Greifen Sie auf Ihren vollständigen Abrechnungsverlauf zu:

• Transaktionsprotokoll: Jede Belastung mit Zeitstempel und Beschreibung
• Monatliche Abrechnungen: Zusammenfassung aller Aktivitäten
• Exportoptionen: Als CSV oder PDF herunterladen
• Steuerdokumente: Jährliche Zusammenfassungen für die Buchhaltung

Diese finden Sie unter: Abrechnung → Transaktionsverlauf

Rückerstattungsrichtlinie

Wir bieten Rückerstattungen für:

• Ungenutztes Wallet-Guthaben (bei Kontoschließung)
• Technische Fehler, die zu Überlastungen führen
• Doppelte Belastungen

Wenden Sie sich innerhalb von 30 Tagen an support@askrobots.com für Rückerstattungsanfragen.

Enterprise-Abrechnung

Für Organisationen, die Folgendes benötigen:

• Rechnungsstellung (NET 30)
• Mengenrabatte
• Mehrere Benutzerkonten
• Individuelle Verträge

Wenden Sie sich an sales@askrobots.com für Enterprise-Optionen.

11. API-Dokumentation

API-Übersicht

Unsere API ermöglicht es Ihnen, programmatisch mit unserer Plattform zu interagieren, um Aufgaben zu verwalten, Status anzuzeigen und vieles mehr. Sie ist für Entwickler konzipiert, die ihre Anwendungen integrieren oder Arbeitsabläufe automatisieren möchten.

Authentifizierungsmethoden

Wir verwenden tokenbasierte Authentifizierung zur Absicherung unserer API. Jede Anfrage muss ein gültiges API-Token im Header enthalten. Tokens können über Ihr Benutzer-Dashboard erhalten werden. Ihren API-Schlüssel finden Sie im Dashboard oder über diesen Link.

Endpunkte, Anfrage- und Antwortformate

Die API bietet verschiedene Endpunkte für den Zugriff auf unterschiedliche Funktionen. Anfragen sollten im JSON-Format gestellt werden, und Antworten werden ebenfalls als JSON zurückgegeben. Hier ist ein Beispielendpunkt für Aufgaben: https://askrobots.com/api/tasks/. Eine detaillierte Liste aller verfügbaren Endpunkte, ihrer Anfragemethoden und Antwortformate finden Sie in unserer vollständigen API-Dokumentation.

Aufgaben auflisten

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

Aufgabendetails

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

Aufgabenvorlagen auflisten

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

Eine Aufgabe erstellen

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

Projekte auflisten

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

API-Endpunkte-Referenz

Nachfolgend finden Sie eine umfassende Liste der verfügbaren API-Endpunkte:

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/

Antwortformate

Alle API-Antworten folgen einem einheitlichen JSON-Format:

Erfolgsantwort (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"
}

Fehlerantwort (400 Bad Request):

{
  "error": "Bad Request",
  "message": "Title field is required",
  "field_errors": {
    "title": ["This field is required."]
  }
}

Seitenweise Antwort:

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

Anfragebegrenzung

API-Anfragen werden begrenzt, um eine faire Nutzung sicherzustellen:

• 1000 Anfragen pro Stunde für authentifizierte Benutzer
• 100 Anfragen pro Stunde für nicht authentifizierte Anfragen
• Informationen zur Anfragebegrenzung sind in den Antwortheadern enthalten:
  • X-RateLimit-Limit: Maximal erlaubte Anfragen
  • X-RateLimit-Remaining: Verbleibende Anfragen
  • X-RateLimit-Reset: Zeitpunkt der Rücksetzung des Limits

Webhooks

Richten Sie Webhooks ein, um Echtzeit-Benachrichtigungen bei Ereignissen zu erhalten:

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

SDKs und Bibliotheken

Wir stellen offizielle SDKs für gängige Programmiersprachen bereit:

• Python: pip install askrobots-sdk
• JavaScript/Node: npm install @askrobots/sdk
• Ruby: gem install askrobots
• PHP: composer require askrobots/sdk

Python-SDK-Beispiel:

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")

Authentifizierungsdetails

API-Token erhalten

1. Navigieren Sie zu Einstellungen → API-Schlüssel
2. Click "Generate New Token"
3. Geben Sie Ihrem Token einen aussagekräftigen Namen
4. Kopieren Sie den Token sofort (er wird nicht erneut angezeigt)
5. Speichern Sie ihn sicher in Ihrer Anwendung

Token in Anfragen verwenden

Fügen Sie Ihren Token in den Authorization-Header jeder Anfrage ein:

Authorization: Token YOUR_API_TOKEN

Beispiel mit verschiedenen Werkzeugen:

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

Anfragelimits

API-Anfragelimits basieren auf Ihrem Abonnementplan:

Anfragelimit-Header

Jede Antwort enthält Informationen zum Anfragelimit:

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

Fehlercodes

Die API verwendet Standard-HTTP-Statuscodes und gibt JSON-Fehlerantworten zurück:

Seitenumbruch

Listenendpunkte geben standardmäßig paginierte Ergebnisse mit 20 Einträgen pro Seite zurück:

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

Paginierung über Abfrageparameter steuern:

• page - Seitennummer (Standard: 1)
• page_size - Einträge pro Seite (max: 100)

Filtern und Suchen

Die meisten Listenendpunkte unterstützen das Filtern:

# 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 konfigurieren, um Echtzeit-Benachrichtigungen zu erhalten:

Webhook-Ereignisse

• task.created - Neue Aufgabe erstellt
• task.completed - Aufgabe als abgeschlossen markiert
• file.uploaded - Datei hochgeladen
• file.processed - Dateiverarbeitung abgeschlossen
• wallet.low_balance - Guthaben unter 5 $

Webhook-Payload-Beispiel

{
    "event": "task.completed",
    "timestamp": "2025-06-19T10:30:00Z",
    "data": {
        "id": "task123",
        "title": "Process invoices",
        "completed_by": "user456"
    }
}

API-Best-Practices

• Antworten zwischenspeichern wenn möglich, um API-Aufrufe zu reduzieren
• Anfragelimits handhaben mit exponentiellem Backoff
• Webhooks verwenden anstatt für Echtzeit-Updates abzufragen
• Stapeloperationen beim Erstellen mehrerer Ressourcen
• Nur benötigte Felder einbeziehen mit Feldauswahlparametern
• Paginierung verwenden für große Datensätze korrekt einsetzen
• Token sicher speichern und regelmäßig erneuern

7. Sicherheit und Datenschutz

AskRobots wurde mit Sicherheit und Datenschutz als Grundprinzip entwickelt. Wir setzen branchenübliche Best Practices um, um Ihre Daten zu schützen und die Einhaltung von Datenschutzbestimmungen zu gewährleisten.

Datenisolierung

Die Daten jedes Benutzers sind vollständig isoliert:

• Sicherheit auf Zeilenebene: Alle Datenbankabfragen werden nach Benutzer-ID gefiltert
• Keine gemeinsam genutzten Daten: Ihre Dateien, Aufgaben und Projekte sind für andere Benutzer nicht zugänglich
• API-Isolierung: Token-basierte Authentifizierung stellt sicher, dass der Datenzugriff benutzerspezifisch ist
• Projektgrenzen: Auch innerhalb von Teams wird der Zugriff auf Projektebene gesteuert

Verschlüsselung

Wir verwenden mehrere Verschlüsselungsebenen, um Ihre Daten zu schützen:

• Während der Übertragung: Alle Verbindungen verwenden TLS 1.3-Verschlüsselung
• Im Ruhezustand: Dateien werden mit AES-256-Verschlüsselung gesichert
• Datenbank: Sensible Felder verwenden Verschlüsselung auf Anwendungsebene
• Sicherungen: Alle Sicherungen werden vor der Speicherung verschlüsselt

Sicherungsverfahren

Ihre Daten sind durch umfassende Sicherungsstrategien geschützt:

• Automatisierte tägliche Sicherungen aller Datenbanken
• 30-tägige Aufbewahrung für zeitpunktgenaue Wiederherstellung
• Regelmäßige Wiederherstellungstests zur Sicherstellung der Sicherungsintegrität

Benutzerberechtigungen

Fein abgestufte Berechtigungssteuerung:

• Rollenbasierter Zugriff: Rollen: Administrator, Benutzer und Worker
• Projektberechtigungen: Steuern Sie, wer Projekte anzeigen, bearbeiten oder verwalten darf
• API-Berechtigungen: Separate Token für verschiedene Zugriffsebenen
• Audit-Protokollierung: Alle Berechtigungsänderungen nachverfolgen

API-Sicherheit

Unsere API implementiert mehrere Sicherheitsmaßnahmen:

• Token-Authentifizierung: Sichere API-Token, die widerrufen werden können
• Anfragebegrenzung: Missbrauch durch intelligente Anfragelimits verhindern
• Eingabevalidierung: Alle Eingaben werden bereinigt und validiert
• CORS-Schutz: Kontrolliertes Cross-Origin-Resource-Sharing

DSGVO-Konformität

Wir respektieren Ihre Datenschutzrechte gemäß DSGVO:

• Auskunftsrecht: Exportieren Sie jederzeit alle Ihre Daten
• Recht auf Löschung: Löschen Sie Ihr Konto und alle zugehörigen Daten
• Datenportabilität: Daten in Standardformaten exportieren (JSON, CSV)
• Datenschutz durch Technikgestaltung: Datenschutz in allen Funktionen berücksichtigt
• Datensparsamkeit: Wir erfassen nur notwendige Daten

Datenspeicherungsrichtlinien

Klare Richtlinien zur Aufbewahrungsdauer Ihrer Daten:

• Aktive Konten: Daten werden während der Kontoaktivität aufbewahrt
• Gelöschte Elemente: Für 30 Tage als gelöscht markiert, danach endgültig entfernt
• Inaktive Konten: Benachrichtigung nach 12 Monaten, Löschung nach 18 Monaten
• Konten mit negativem Saldo: 90-tägige Kulanzfrist vor der Datenlöschung
• Audit-Protokolle: Für 1 Jahr zu Sicherheitszwecken aufbewahrt

Datenexportoptionen

Ihre Daten gehören Ihnen und können jederzeit exportiert werden:

• Vollständiger Kontoexport: Alle Daten in einer einzigen ZIP-Datei
• Selektiver Export: Bestimmte Projekte oder Datumsbereiche auswählen
• Mehrere Formate: JSON, CSV, PDF für verschiedene Datentypen
• API-Zugriff: Programmgesteuerter Export über unsere REST API
• Kein Herstellerabhängigkeit: Standardformate gewährleisten Portabilität

Sicherheits-Best-Practices für Benutzer

Helfen Sie uns, Ihr Konto zu schützen:

• Starke Passwörter: Verwenden Sie einzigartige, komplexe Passwörter
• Zwei-Faktor-Authentifizierung: 2FA aktivieren, wenn verfügbar
• API-Token-Verwaltung: Token regelmäßig erneuern
• Zugriff überwachen: Überprüfen Sie Ihre Aktivitätsprotokolle regelmäßig
• Probleme melden: Kontaktieren Sie uns sofort, wenn Sie unbefugten Zugriff vermuten