ホーム
ドキュメント
目次:
メインダッシュボードの概要
プロジェクト
ノート
記事
リンク
連絡先
イベント
タスクとタスクテンプレート
ファイル
メッセージ
データ分離
暗号化
ユーザー権限
GDPRコンプライアンス
データエクスポートオプション
ワーカー向け:
タスクの作成と割り当て
タスクステータスの更新
チームメンバーとのコラボレーション
開発者向け:
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.
MCP完全ドキュメント →
内容: デプロイ不要で即時実行できるライブPythonオブジェクト
ビュー: ページを作成する場所: /v/your-view/ - AIがコードを編集し、ブラウザを更新するだけでライブになります
データストア: スキーマ不要のJSONストレージ - マイグレーション不要
トリガー: cron式によるスケジュール自動化
オブジェクトを管理 →
概要とメリット
セットアップとインストール
サンプルコード
カスタムインテグレーションの作成
リアルタイム更新のためのWebhook活用
管理者ユーザーのよくある問題
ワーカーのよくある問題
開発者固有の問題
フィードバックの送り方
サポートへのお問い合わせ
コミュニティとフォーラムのリンク
1. はじめに
ソフトウェアについて
当社のタスクシステムは、タスク管理を効率化・簡素化するために設計された最先端のWebベースソリューションです。直感的なインターフェースと高度な機能により、ユーザーがタスクを効率的かつ効果的に遂行するための比類なきプラットフォームを提供します。
主なメリット
SaaS(Software-as-a-Service)として、当社のタスクシステムはシームレスな更新、容易なスケーラビリティ、ITコストの削減というメリットを提供します。しかし私たちを真に際立たせているのは、最先端AI技術との統合です。これにより意思決定能力が強化されるだけでなく、予測分析と自動化が導入され、タスク管理が常に一歩先を行くことができます。
対応プラットフォーム / ブラウザ
互換性が重要です。そのため、デスクトップとモバイルの両プラットフォームで主要なWebブラウザすべてに対応しています。さらに、カスタムソフトウェアシステムに当社の機能を統合したい方向けに、シームレスな接続を実現する堅牢なAPIを提供しています。
2. はじめ方
アカウント設定
有効なメールアドレスでアカウントを作成することから始めましょう。アカウントを設定したら、様々な機能をご活用ください。プレミアム機能にアクセスするには、ニーズに合ったサブスクリプションプランをお選びください。
基本設定
新しいアカウントは白紙の状態から始まり、カスタマイズの準備が整っています。最初は難しく感じるかもしれませんが、すべてをすぐにマスターする必要はありません。ノート、リンク、連絡先、イベントなどの基本から始めましょう。慣れてきたら、タスク、タスクテンプレート、シェルなどのより高度な機能を少しずつ探索してください。各モジュールは、自分のペースで生産性を向上させるよう設計されています。
初期ユーザーオンボーディング
登録後、アカウントを確認するためのメールが届きます。これはアカウントのセキュリティを確保し、すべての機能を有効にするための重要なステップです。メールの指示に従って確認プロセスを完了し、私たちとの旅を始めてください。
3. 主要機能
メインダッシュボードの概要
まずメインダッシュボードを探索してください。すべてのプロジェクト、タスク、最近のアクティビティ、重要な指標の概要にアクセスできます。この集中管理ハブにより、サイトの異なるセクション間を素早く移動し、進行中の作業を一目で確認できます。
プロジェクト
プロジェクト管理システムにより、プロジェクトの作成、追跡、コラボレーションが可能です。期限を設定し、各プロジェクト内のタスクを管理し、使いやすいツールで進捗を監視できます。プロジェクトセクションを使用して、すべてのアクティブおよびアーカイブされたプロジェクトを表示してください。
ノート
ログイン後、ユーザーはアイデア、会議議事録、その他の重要な情報を記録するためのノートを作成できます。ノートは自動的に保存され、後で簡単に検索できます。近日中に、プロジェクト、カテゴリ、またはタグでノートを整理できるようになります。
記事
記事セクションは、ドキュメントやレポートなどの長文コンテンツの作成と公開を支援するために設計されています。他のチームメンバーと記事の草稿作成、編集、コラボレーションが可能です。内蔵のバージョン管理により、必要に応じて以前のバージョンに戻すことができます。
リンク
有用なリソースを見つけたら、リンクセクションで保存・整理できます。タグ付け、カテゴリ分け、検索機能により、後で簡単に取り出せます。このセクションは、調査資料、外部ドキュメント、有用な参考資料の管理に最適です。
VIDEO
システムに連絡先を追加した後、連絡先セクションで詳細を管理・整理できます。特定の人物を簡単に検索でき、近日中にプロジェクトや会社別に連絡先を分類し、他のコミュニケーションツールと統合できるようになります。
イベント
イベントを作成した後、イベントセクションで予定されているすべての会議、リマインダー、期限を表示できます。近日中に、カレンダーとのイベント同期、招待状の送信、重要な日付を把握するための通知管理が可能になります。
タスクとタスクテンプレート
タスクを作成した後、優先度別に整理し、チームメンバーに割り当て、完了状況を追跡できます。タスクテンプレートにより、繰り返し活動のための再利用可能なタスク構造を作成し、一貫性を確保して時間を節約できます。
ファイル
ファイルセクションは、自動カテゴリ分け、テキスト抽出、タスク作成機能を備えた強力なドキュメントのアップロード、整理、管理システムを提供します。
主な機能
スマートアップロード : 複数ファイルをドラッグ&ドロップして自動処理
自動カテゴリ分け : ファイルが自動的に論理的なフォルダに整理されます
PDF インテリジェンス : テキスト抽出ですべてのPDFを検索可能にします
タスク作成 : 請求書、契約書、ドキュメントからタスクを自動的に作成
一括操作 : 複数のファイルを一度に管理
ファイルアップロード
ファイル → アップロードに移動してファイルをアップロードできます。以下のことが可能です:
複数ファイルを一度にドラッグ&ドロップ
ファイルを特定のプロジェクトに関連付ける
リアルタイムのアップロード進捗を確認
プランの上限(10〜100 MB)までドキュメントをアップロード
自動カテゴリ分け
AskRobotsはインテリジェントなパターン認識を使用してファイルを自動的に整理します:
financial/invoices/2024/ - 請求書ドキュメント用
contracts/vendor/active/ - ベンダー契約用
receipts/travel/2024/ - 経費領収書用
personal/photos/vacation/ - 個人画像用
PDFテキスト抽出
すべてのPDFは自動的に処理されます:
検索用にすべてのテキストを抽出
重要情報(日付、金額、氏名)を識別
検索可能なメタデータを作成
すべてのドキュメントにわたる全文検索を有効化
ドキュメントからのタスク作成
ドキュメントをアップロードしてAIに自動でタスクを作成させる:
請求書 → 期限付き支払いリマインダータスク
契約書 → レビューと更新リマインダータスク
会議メモ → アクションアイテムを個別タスクとして作成
プロジェクトドキュメント → 成果物とマイルストーンタスク
プラン別ストレージ上限
プラン
合計ストレージ
最大ファイルサイズ
ベーシック
1 GB
10 MB
プロ
10 GB
50 MB
エンタープライズ
100 GB
100 MB
4. オブジェクト(100xアーキテクチャ)
オブジェクトはデプロイ不要で即時実行できるライブPythonコードです。これが100xアーキテクチャです— AIがコードを編集し、ブラウザを更新するだけで機能がライブになります。
なぜ100xなのか?
従来の開発では1回の変更に10〜30分かかります(コード、マイグレーション、ビルド、デプロイ、テスト)。オブジェクトを使えば、変更が10〜30秒で完了します(コード編集、ブラウザ更新、完了)。それが100倍速いイテレーションです。
オブジェクトの種類
ライブWebページ(場所: /v/your-view/
HTML、JSON、またはテンプレートをレンダリングして返す
ユーザーコンテキストとクエリパラメータにアクセス
データのために他のオブジェクトを呼び出す
スキーマ不要のJSON永続化
マイグレーション不要
JSONを保存・読み込むだけ
耐久性のためにTSVで保存
スケジュール自動化
cron式
バックグラウンド実行
エラーハンドリング
クイックスタートの例
AIがシンプルなビューを作成する方法:
# 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'
}
アクセス先: /v/hello/?name=Dan and see "Hello, Dan!" - no deploy needed.
データストアの例
# 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)}
MCP経由でオブジェクトを使用する
あなたのAI(Claude Code、Cursorなど)はMCP APIを通じてオブジェクトを作成・変更できます:
create_object - Pythonコードで新しいオブジェクトを作成
get_object_source - オブジェクトのソースコードを読む
update_object_source - オブジェクトコードを変更する
execute_object - オブジェクトメソッドを呼び出す(GET/POST/PUT/DELETE)
get_object_state - オブジェクトの永続化された状態を読む
オブジェクトの分離
各ユーザーのオブジェクトはプレフィックスで分離されています:
u_1_view_dashboard - ユーザー1のダッシュボードビュー
u_1_deals - ユーザー1の取引データストア
views_landing - システムビュー(読み取り専用)
ユーザーは自分のオブジェクトのみ表示・変更できます。システムオブジェクトは読み取り専用の例として利用できます。
始め方: 移動先:
オブジェクト 最初のオブジェクトを作成するか、MCP経由でAIを接続して機能を構築させましょう。
デジタル進化が絶え間なく続く時代において、オンラインプラットフォームとのインタラクション、タスクの処理、ワークフローの管理方法は継続的に進化しています。
従来のタスク管理システムは静的で、ユーザーに画一的なアプローチを強いています。しかし、大小を問わずすべてのタスクが完璧に合致する世界を想像してください。当社のダイナミックフォームシステムへようこそ。
適応性:ビジネスニーズの変化に合わせてタスクを進化させます。
効率性:メタデータを活用してデータを引き継ぎ、冗長性を排除し、速度を向上させます。
パーソナライズ:フォームのすべての要素をカスタマイズします。
スケーラビリティ:あらゆる規模や複雑さのプロジェクトをシームレスに処理します。
ぜひ飛び込んで、探索し、私たちとともにタスク管理の未来を体験してください。
ダイナミックフォームシステムの解説
当社のタスク管理システムは、コアコンポーネント(メタデータ、JSONスキーマ、UIスキーマ)を通じて柔軟性と効率性を提供するよう設計されています。それぞれがダイナミックフォームの作成と管理において重要な役割を果たします。
メタデータ:
それは何ですか?
Metadata is essentially "data about data." It functions as a detailed ledger, recording specific attributes and contextual information about each task.
なぜ重要なのですか?
メタデータはタスクのコンテキスト化の基盤となります。様々なタスク間でのデータのシームレスな統合を促進し、重要な詳細が引き継がれることを確保します。この継続性は、タスク管理における効率性と一貫性を維持するための鍵です。
JSONスキーマ(データスキーマ):
それは何ですか?
JSONスキーマはタスクデータの設計図として機能します。各タスクに関連するデータの予想されるデータ型、制約、全体的な構造を概説します。
なぜ重要なのですか?
スキーマの主な役割はデータの整合性と構造を強制することです。データ要件の明確な定義を提供することで、収集されたすべての情報が一貫性があり、予測可能で、確立された標準に準拠していることを確保します。これはデータ品質の維持と自動化・データ処理の促進に不可欠です。
UIスキーマ(ビューモデル):
それは何ですか?
UIスキーマは、JSONスキーマで定義されたデータ構造の視覚的表現を担当します。フォームフィールド、ウィジェット、その他のインタラクティブ要素のレイアウトとデザインのカスタマイズオプションを提供します。
なぜ重要なのですか?
UIスキーマはバックエンドのデータ構造とフロントエンドのユーザーエクスペリエンスの間のギャップを橋渡しします。その重要性は、特定のユーザーニーズと美的好みに合わせてデータのプレゼンテーションとインタラクションをカスタマイズできる能力にあります。このカスタマイズはユーザーエンゲージメントを高め、より直感的でユーザーフレンドリーなインターフェースを確保します。
JSONデータとタスクテンプレート
JSONデータから始めましょう。お持ちでない場合は、こちらをご覧ください: こちらの例 または
ここで作成 .
JSONスキーマ(データスキーマ)
[ ここにJSONコードまたはUML図の画像 ]
JSONファイルを使用してフォームオブジェクトを記述します。フィールドの名前、型、値、サイズが含まれます。
JSONスキーマを作成する こちら
そして フォームをオンラインでプレビュー .
UIスキーマ(ビューモデル)
[ ここにコードと対応するワイヤーフレームUIの画像 ]
JSONファイルを使用してUIのラベルとオプションを一覧表示します。
ユーザーインターフェース
[ ここにBootstrapでレンダリングされたデータ入りUIの画像 ]
最終結果はワーカーフォームに表示されます。送信された結果は blob フィールドに保存されます。
基本的な例
サンプルコード:
6. アカウントと請求
AskRobotsはシンプルなウォレットベースの請求システムを使用しています。必要に応じて入金し、使用した分だけ支払います。予想外の請求や隠れた手数料はありません。
ウォレットシステムの仕組み
従来のサブスクリプションとは異なり、当社のウォレットシステムは完全なコントロールを提供します:
プリペイドモデル : いつでも$5〜$100の範囲で入金可能
自動更新なし : 許可なくカードに請求されることはありません
使用量ベース : AI機能を使用したときのみ残高から差し引かれます
有効期限なし : 残高は使用するまで保持されます
完全な透明性 : 各AI操作のコストを正確に確認できます
サブスクリプションプランと機能
請求はウォレットベースですが、プランによって機能と上限が決まります:
プラン
ストレージ
ファイルサイズ
APIレート
最適な用途
ベーシック
1 GB
10 MB max
60/min
個人利用
プロ
10 GB
50 MB max
120/min
小規模チーム
エンタープライズ
100 GB
100 MB max
300/min
大規模組織
詳細プランを表示
AI利用コスト
AI操作は実際の使用量に基づいて課金されます:
GPT-4o-mini : リクエストあたり約$0.001
GPT-4 : リクエストあたり約$0.03
Claude 3.5 Sonnet : リクエストあたり約$0.015
画像解析 : 画像あたり約$0.005
PDF処理 : ドキュメントあたり約$0.01
実際のコストはリクエストの複雑さとレスポンスの長さによって異なります
使用量の追跡
リアルタイムで使用量を監視できます:
ダッシュボード : ウォレット残高と最近の請求を確認
AI使用状況ページ : モデルと操作別の詳細内訳
取引履歴 : すべての請求の完全なログ
日次サマリー : 支出パターンを追跡
支払い方法
Stripeを通じてすべての主要な支払い方法に対応しています:
クレジットカード(Visa、Mastercard、American Express、Discover)
デビットカード
デジタルウォレット(Apple Pay、Google Pay)
銀行振込(エンタープライズ向け)
すべての支払いはStripeを通じて安全に処理されます。カードの詳細情報を保存することはありません。
入金する
移動先: 請求 → 資金を追加
金額を選択(最低$5、最高$100)
支払い情報を入力
Click "Add Funds"
入金はすぐに利用可能になります
アップグレード/ダウングレードの手順
プランの変更はシンプルで即時に反映されます:
プランをアップグレードする
次のページにアクセス: プランページ
新しいプランを選択
変更は即時に反映されます
ストレージと上限はすぐに増加します
日割り請求なし - ウォレットシステムは変わりません
プランをダウングレードする
下位プランの上限内(ストレージなど)であることを確認してください
プランページにアクセス
下位プランを選択
新しいストレージ上限を超えている場合はファイルを削除する必要があります
機能は即時に調整されます
残高低下通知
以下の場合に通知します:
残高が$5.00を下回ったとき
残高が$0.00になったとき
残高不足で操作が失敗したとき
請求履歴と請求書
完全な請求履歴にアクセスできます:
取引ログ : タイムスタンプと説明付きのすべての請求
月次明細 : すべてのアクティビティのサマリー
エクスポートオプション : CSVまたはPDFでダウンロード
税務書類 : 経理用の年次サマリー
こちらで確認できます: 請求 → 取引履歴
返金ポリシー
以下の場合に返金に対応します:
未使用のウォレット残高(アカウント閉鎖時)
過大請求が発生した技術的エラー
重複請求
返金リクエストは30日以内にsupport@askrobots.comまでご連絡ください。
エンタープライズ請求
以下を必要とする組織向け:
請求書払い(NET 30)
ボリュームディスカウント
複数ユーザーアカウント
カスタム契約
エンタープライズオプションについてはsales@askrobots.comまでお問い合わせください。
11. APIドキュメント
API概要
当社のAPIにより、プラットフォームとプログラム的にやり取りでき、タスクの管理、ステータスの確認など多くのことが可能です。アプリケーションを統合したり、ワークフローを自動化したい開発者向けに設計されています。
認証方法
APIのセキュリティにはトークンベースの認証を使用しています。各リクエストには有効なAPIトークンをヘッダーに含める必要があります。トークンはユーザーダッシュボードから取得できます。APIキーはダッシュボードまたはこちらの リンク .
エンドポイント、リクエスト・レスポンス形式
APIはさまざまな機能にアクセスするための複数のエンドポイントを提供しています。リクエストはJSON形式で行い、レスポンスもJSONで返されます。タスク用のエンドポイントの例を示します:
https://askrobots.com/api/tasks/ . 利用可能なすべてのエンドポイント、リクエストメソッド、レスポンス形式の詳細なリストについては、完全なAPIドキュメントをご参照ください。
タスク一覧
タスクを一覧表示するcurlコマンドの例です:
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasks/
YOUR_API_TOKENを実際のトークンに置き換えてください。
タスクの詳細
特定のタスクの詳細を取得するには:
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasks/TASK_ID/
YOUR_API_TOKENを実際のトークンに、TASK_IDをタスクのIDに置き換えてください。
タスクテンプレート一覧
curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/tasktemplates/
YOUR_API_TOKENを実際のトークンに、TASK_IDをタスクのIDに置き換えてください。
タスクを作成する
% 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/
YOUR_API_TOKENを実際のトークンに置き換えてください。
TEMPLATE_IDをテンプレートIDに置き換えてください。
PROJECT_IDをプロジェクトIDに置き換えてください。
プロジェクト一覧
% curl -X GET \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
https://askrobots.com/api/projects/
YOUR_API_TOKENを実際のトークンに置き換えてください。
APIエンドポイントリファレンス
利用可能なAPIエンドポイントの包括的なリストを以下に示します:
メソッド
エンドポイント
説明
GET
/api/search/
すべてのコンテンツを横断して検索
クエリパラメータ:
q (必須) - 検索クエリ(最低2文字)
types (任意) - カンマ区切りリスト:tasks、projects、contacts、files、notes、links、articles、events、messages
limit (任意) - タイプあたりの最大結果数(デフォルト10、最大50)
リクエストの例:
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": [...]
}
}
}
注意: 結果はユーザーアクセスでフィルタリングされます。自分が所有するかアクセス権を持つコンテンツのみ表示されます。
メソッド
エンドポイント
説明
GET
/api/notes/
すべてのノートを一覧表示
GET
/api/notes/{id}/
ノートの詳細を取得
POST
/api/notes/
新しいノートを作成
PUT
/api/notes/{id}/
ノートを更新
DELETE
/api/notes/{id}/
ノートを削除
フィールド:
content (必須) - ノートのテキストコンテンツ
project (任意) - 関連付けるプロジェクトのUUID
project_name (読み取り専用) - 関連プロジェクトの名前
リクエストの例 - ノートを作成:
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/
メソッド
エンドポイント
説明
GET
/api/links/
すべてのリンクを一覧表示
GET
/api/links/{id}/
リンクの詳細を取得
POST
/api/links/
新しいリンクを作成
PUT
/api/links/{id}/
リンクを更新
DELETE
/api/links/{id}/
リンクを削除
メソッド
エンドポイント
説明
GET
/api/events/
すべてのイベントを一覧表示
GET
/api/events/{id}/
イベントの詳細を取得
POST
/api/events/
新しいイベントを作成
リクエストの例 - イベントを作成:
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/
メソッド
エンドポイント
説明
GET
/api/contacts/
すべての連絡先を一覧表示
GET
/api/contacts/{id}/
連絡先の詳細を取得
POST
/api/contacts/
新しい連絡先を作成
PUT
/api/contacts/{id}/
連絡先を更新
DELETE
/api/contacts/{id}/
連絡先を削除
フィルター: ?project=UUID, ?search=text, ?ordering=last_name, ?lead_status=hot, ?organization_entity=UUID
メソッド
エンドポイント
説明
GET
/api/organizations/
List all organizations
GET
/api/organizations/{id}/
Get organization details (includes contact_count)
POST
/api/organizations/
Create new organization
PATCH
/api/organizations/{id}/
Update organization
DELETE
/api/organizations/{id}/
Delete organization
フィルター: ?search=text (searches name and industry), ?project=UUID
フィールド: name, website, industry, description, notes, project
メソッド
エンドポイント
説明
GET
/api/interactions/
List all interactions
GET
/api/interactions/{id}/
Get interaction details
POST
/api/interactions/
Log a new interaction
PATCH
/api/interactions/{id}/
Update interaction
DELETE
/api/interactions/{id}/
Delete interaction
フィルター: ?contact=UUID, ?organization=UUID, ?interaction_type=call|email|meeting|note|task
フィールド: contact, interaction_type, subject, notes, duration, outcome (positive/neutral/negative/no_answer), occurred_at
メソッド
エンドポイント
説明
GET
/api/tags/
List all tags
POST
/api/tags/
Create a tag
PATCH
/api/tags/{id}/
Update tag
DELETE
/api/tags/{id}/
Delete tag
フィールド: name, color (hex color, default #6c757d)
Tip: Assign tags to contacts via the Contact API using tag_ids: [UUID, ...]
メソッド
エンドポイント
説明
GET
/api/files/
すべてのファイルを一覧表示
GET
/api/files/{id}/
ファイルの詳細を取得
GET
/api/files/{id}/download/
ダウンロード URL を取得
GET
/api/files/stats/
ファイルの統計情報を取得
POST
/api/files/upload/
ファイルをアップロード
POST
/api/files/categorize/
ファイルを一括カテゴリー分類
フィルター: ?project=UUID, ?category=path, ?uncategorized=true, ?file_type=document
ファイルアップロードの例:
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/
アップロードフィールド:
file (必須) - アップロードするファイル (multipart/form-data)
project (任意) - 関連付けるプロジェクトのUUID
category (任意) - カテゴリーパス文字列
description (任意) - ファイルの説明
メソッド
エンドポイント
説明
GET
/api/timelogs/
時間エントリーを一覧表示
GET
/api/timelogs/running/
実行中のタイマーを取得
POST
/api/timelogs/
時間エントリーを作成
POST
/api/timelogs/start/
新しいタイマーを開始
POST
/api/timelogs/{id}/stop/
実行中のタイマーを停止
フィルター: ?project=UUID, ?task=UUID, ?is_running=true, ?is_billable=true
Managed agents are AI agents with their own identity, token, and optional project access. Legacy AI worker endpoints remain available as compatibility paths.
メソッド
エンドポイント
説明
GET
/api/workertypes/
ワーカータイプを一覧表示
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/
プロジェクトへの招待を一覧表示
POST
/api/invitations/
招待を作成
POST
/api/invitations/{id}/accept/
招待を承諾
GET
/api/projectaccess/
プロジェクトの権限を一覧表示
メソッド
エンドポイント
説明
GET
/api/plans/
サブスクリプションプランを一覧表示
GET
/api/wallet/me/
ウォレット残高を確認
GET
/api/subscription/me/
サブスクリプションの状態を確認
GET
/api/transactions/
取引履歴を一覧表示
注意: 請求エンドポイントは読み取り専用です。請求の管理はダッシュボードから行ってください。
複数の AI エージェントが同時にタスクに取り組む、マルチエージェント環境向けです。
メソッド
エンドポイント
説明
POST
/api/tasks/{id}/claim/
タスクをアトミックに取得します(競合状態を防止)
POST
/api/tasks/{id}/release/
取得済みのタスクをプールに返却
POST
/api/tasks/{id}/heartbeat/
取得タイムアウトを延長
GET
/api/tasks/claimable/
取得可能なタスクを一覧表示
GET
/api/tasks/my_claims/
現在取得中のタスクを一覧表示
クエリパラメーター: ?timeout_minutes=30, ?stale_minutes=30, ?urgency=high
エージェントのワークフロー:
# 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/
取得は既定で 30 分後に期限切れになります。古い取得は自動的に解放されます。
Execute shell commands via the API. Supports all shell commands including AI queries (/ar), quick notes, search, and more.
メソッド エンドポイント 説明
POST
/api/shell/
Execute a shell command
Request body:
{
"command": "/ar What tasks are open?",
"session_id": "optional-uuid-for-conversation-context"
}
Response:
{
"output": "You have 12 open tasks...",
"session_id": null,
"success": true
}
例:
curl -X POST https://askrobots.com/api/shell/ \
-H "Authorization: Token YOUR_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"command": "/ping"}'
Command prefixes:
/ar — AI query with tool access (tasks, notes, files, etc.)
/note — Create a quick note
/search — Search notes
/task — Task management
^url — Quick bookmark
~term — Fuzzy global search
Any text without a prefix is sent directly to the AI agent.
レスポンス形式
すべての API レスポンスは一貫した JSON 形式に従います:
成功レスポンス (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"
}
エラーレスポンス (400 Bad Request):
{
"error": "Bad Request",
"message": "Title field is required",
"field_errors": {
"title": ["This field is required."]
}
}
ページネーションレスポンス:
{
"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",
...
}
]
}
レート制限
公平な利用を確保するため、API リクエストにはレート制限があります:
認証済みユーザーは1時間あたり 1000 リクエスト
未認証リクエストは1時間あたり 100 リクエスト
レート制限情報はレスポンスヘッダーに含まれます:
X-RateLimit-Limit: 許可される最大リクエスト数
X-RateLimit-Remaining: 残りリクエスト数
X-RateLimit-Reset: 制限がリセットされる時刻
Webhook
イベント発生時にリアルタイム通知を受け取るために Webhook を設定してください:
POST /api/webhooks/
{
"url": "https://your-app.com/webhook",
"events": ["task.created", "task.updated", "task.completed"],
"active": true
}
SDKとライブラリ
主要な言語向けの公式 SDK を提供しています:
Python: pip install askrobots-sdk
JavaScript/Node: npm install @askrobots/sdk
Ruby: gem install askrobots
PHP: composer require askrobots/sdk
Python SDK の例:
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")
認証の詳細
API トークンの取得
次のページへ移動してください 設定 → API キー
Click "Generate New Token"
トークンにわかりやすい名前を付けてください
トークンをすぐにコピーしてください(再表示されません)
アプリケーション内に安全に保管してください
リクエストでのトークンの使用
すべてのリクエストの Authorization ヘッダーにトークンを含めてください:
Authorization: Token YOUR_API_TOKEN
各種ツールでの例:
# 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'
}
});
レート制限
API のレート制限はサブスクリプションプランに基づきます:
プラン
レート制限
バースト制限
1日の上限
ベーシック
60 リクエスト/分
10 リクエスト/秒
10,000 リクエスト
プロ
120 リクエスト/分
20 リクエスト/秒
50,000 リクエスト
エンタープライズ
300 リクエスト/分
50 リクエスト/秒
無制限
レート制限ヘッダー
各レスポンスにはレート制限情報が含まれます:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1698765432
エラーコード
API は標準的な HTTP ステータスコードを使用し、JSON 形式のエラーレスポンスを返します:
ステータスコード
意味
レスポンスの例
200 OK
成功
{"data": {...}}
201 Created
リソースが正常に作成されました
{"id": "abc123", ...}
400 Bad Request
リクエストパラメーターが無効です
{"error": "Title is required"}
401 Unauthorized
API トークンが無効または見つかりません
{"error": "Authentication credentials were not provided"}
402 Payment Required
ウォレット残高が不足しています
{"error": "Insufficient funds", "balance": 0.50}
403 Forbidden
リソースへのアクセスが拒否されました
{"error": "You don't have permission to access this resource"}
404 Not Found
リソースが見つかりません
{"error": "Task not found"}
429 Too Many Requests
レート制限を超えました
{"error": "Rate limit exceeded", "retry_after": 60}
500 Server Error
内部サーバーエラー
{"error": "An unexpected error occurred"}
ページネーション
リストエンドポイントは既定でページあたり 20 件のページネーション結果を返します:
{
"count": 150,
"next": "https://askrobots.com/api/tasks/?page=2",
"previous": null,
"results": [...]
}
クエリパラメーターでページネーションを制御できます:
page - ページ番号(既定: 1)
page_size - 1ページあたりのアイテム数(最大: 100)
フィルタリングと検索
ほとんどのリストエンドポイントはフィルタリングをサポートしています:
# 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
リアルタイム通知を受け取るために Webhook を設定してください:
Webhook イベント
task.created - 新しいタスクが作成されました
task.completed - タスクが完了としてマークされました
file.uploaded - ファイルがアップロードされました
file.processed - ファイルの処理が完了しました
wallet.low_balance - 残高が $5 を下回っています
Webhook ペイロードの例
{
"event": "task.completed",
"timestamp": "2025-06-19T10:30:00Z",
"data": {
"id": "task123",
"title": "Process invoices",
"completed_by": "user456"
}
}
API のベストプラクティス
レスポンスをキャッシュする API 呼び出しを減らすため、可能な限りキャッシュしてください
レート制限を処理する 指数バックオフを使用して適切に処理してください
Webhook を使用する リアルタイム更新のためにポーリングではなく Webhook を使用してください
バッチ操作 複数のリソースを作成する際はバッチ処理を使用してください
必要なフィールドのみ含める フィールド選択パラメーターを使用してください
ページネーションを使用する 大規模なデータセットでは適切にページネーションを使用してください
トークンを安全に保管する 定期的にローテーションしてください
お困りですか? API に関するご質問は api-support@askrobots.com までお問い合わせいただくか、
API サンプルリポジトリ をご覧ください。
7. セキュリティとプライバシー
AskRobots はセキュリティとプライバシーを中心に構築されています。業界のベストプラクティスを実装し、お客様のデータを保護し、プライバシー規制への準拠を確保しています。
データ分離
すべてのユーザーのデータは完全に分離されています:
行レベルセキュリティ : すべてのデータベースクエリはユーザー ID でフィルタリングされます
データの共有なし : あなたのファイル、タスク、プロジェクトは他のユーザーからアクセスできません
API の分離 : トークンベースの認証により、データアクセスはユーザー固有となります
プロジェクトの境界 : チーム内でも、アクセスはプロジェクトレベルで制御されます
暗号化
お客様のデータを保護するために、複数の暗号化レイヤーを使用しています:
転送中 : すべての接続は TLS 1.3 暗号化を使用しています
保存時 : ファイルは AES-256 暗号化で保護されています
データベース : 機密フィールドはアプリケーションレベルの暗号化を使用しています
バックアップ : すべてのバックアップは保存前に暗号化されます
バックアップ手順
お客様のデータは包括的なバックアップ戦略によって保護されています:
自動日次バックアップ すべてのデータベースの
30 日間の保持 ポイントインタイムリカバリのため
定期的なリストアテスト バックアップの整合性を確保するため
ユーザー権限
きめ細かい権限制御:
ロールベースのアクセス制御 : 管理者、ユーザー、ワーカーのロール
プロジェクトの権限 : プロジェクトの閲覧、編集、管理ができるユーザーを制御します
API の権限 : アクセスレベルに応じた個別のトークン
監査ログ : すべての権限変更を追跡します
API セキュリティ
当社の API は複数のセキュリティ対策を実装しています:
トークン認証 : 失効させることができる安全な API トークン
レート制限 : インテリジェントなレート制限で不正利用を防止します
入力検証 : すべての入力はサニタイズおよび検証されます
CORS 保護 : 制御されたクロスオリジンリソース共有
GDPRコンプライアンス
GDPR に基づくプライバシーの権利を尊重しています:
アクセスの権利 : いつでもすべてのデータをエクスポートできます
消去の権利 : アカウントとすべての関連データを削除できます
データポータビリティ : 標準形式(JSON、CSV)でデータをエクスポートできます
プライバシー・バイ・デザイン : すべての機能においてプライバシーを考慮しています
データ最小化 : 必要なデータのみを収集します
データ保持ポリシー
データの保持期間に関する明確なポリシー:
アクティブなアカウント : アカウントがアクティブな間はデータを保持します
削除されたアイテム : 30 日間ソフト削除され、その後完全に削除されます
非アクティブなアカウント : 12 か月後に通知、18 か月後に削除されます
残高がマイナスのアカウント : データ削除前に 90 日間の猶予期間があります
監査ログ : セキュリティ目的で 1 年間保持されます
データエクスポートオプション
データはお客様のものであり、いつでもエクスポートできます:
アカウント全体のエクスポート : すべてのデータを 1 つの ZIP ファイルに
選択的エクスポート : 特定のプロジェクトや日付範囲を選択できます
複数の形式 : データの種類に応じた JSON、CSV、PDF
API アクセス : REST API を通じたプログラムによるエクスポート
ベンダーロックインなし : 標準形式によりデータの移植性を確保します
ユーザー向けセキュリティのベストプラクティス
アカウントのセキュリティ維持にご協力ください:
強力なパスワード : 固有で複雑なパスワードを使用してください
二要素認証 : 利用可能な場合は 2FA を有効にしてください
API トークン管理 : 定期的にトークンをローテーションしてください
アクセスの監視 : 定期的にアクティビティログを確認してください
問題の報告 : 不正アクセスが疑われる場合はすぐにご連絡ください