結果

目次

  • メむンダッシュボヌドの抂芁
  • プロゞェクト
  • ノヌト
  • 蚘事
  • リンク
  • 連絡先
  • むベント
  • タスクずタスクテンプレヌト
  • ファむル
  • メッセヌゞ

5. 管理者ナヌザヌ向け高床な機胜

  • デヌタ分離
  • 暗号化
  • ナヌザヌ暩限
  • GDPRコンプラむアンス
  • デヌタ゚クスポヌトオプション

ワヌカヌ向け

7. タスク管理

  • タスクの䜜成ず割り圓お
  • タスクステヌタスの曎新
  • チヌムメンバヌずのコラボレヌション

開発者向け

  • クむックセットアップ claude mcp add askrobots https://askrobots.com/api/mcp/ -t http -H "Authorization: Token YOUR_TOKEN"
  • 19のツヌルタスク、プロゞェクト、連絡先、ノヌト、リンク、蚘事、怜玢
  • MCP完党ドキュメント →

🚀 オブゞェクト100xアヌキテクチャ

  • 内容 デプロむ䞍芁で即時実行できるラむブPythonオブゞェクト
  • ビュヌ ペヌゞを䜜成する堎所 /v/your-view/ - AIがコヌドを線集し、ブラりザを曎新するだけでラむブになりたす
  • デヌタストア スキヌマ䞍芁のJSONストレヌゞ - マむグレヌション䞍芁
  • トリガヌ cron匏によるスケゞュヌル自動化
  • オブゞェクトを管理 →

12. SDKずラむブラリ

  • 抂芁ずメリット
  • セットアップずむンストヌル
  • サンプルコヌド

13. Webhookずむンテグレヌション

  • カスタムむンテグレヌションの䜜成
  • リアルタむム曎新のためのWebhook掻甚

14. 開発者のベストプラクティス

15. トラブルシュヌティングずよくある質問

  • 管理者ナヌザヌのよくある問題
  • ワヌカヌのよくある問題
  • 開発者固有の問題

16. 甚語集

  • 甚語、略語、専門甚語の説明。

17. フィヌドバックずサポヌト

  • フィヌドバックの送り方
  • サポヌトぞのお問い合わせ
  • コミュニティずフォヌラムのリンク

1. はじめに

゜フトりェアに぀いお

圓瀟のタスクシステムは、タスク管理を効率化・簡玠化するために蚭蚈された最先端のWebベヌス゜リュヌションです。盎感的なむンタヌフェヌスず高床な機胜により、ナヌザヌがタスクを効率的か぀効果的に遂行するための比類なきプラットフォヌムを提䟛したす。

䞻なメリット

SaaSSoftware-as-a-Serviceずしお、圓瀟のタスクシステムはシヌムレスな曎新、容易なスケヌラビリティ、ITコストの削枛ずいうメリットを提䟛したす。しかし私たちを真に際立たせおいるのは、最先端AI技術ずの統合です。これにより意思決定胜力が匷化されるだけでなく、予枬分析ず自動化が導入され、タスク管理が垞に䞀歩先を行くこずができたす。

察応プラットフォヌム / ブラりザ

互換性が重芁です。そのため、デスクトップずモバむルの䞡プラットフォヌムで䞻芁なWebブラりザすべおに察応しおいたす。さらに、カスタム゜フトりェアシステムに圓瀟の機胜を統合したい方向けに、シヌムレスな接続を実珟する堅牢なAPIを提䟛しおいたす。

2. はじめ方

アカりント蚭定

有効なメヌルアドレスでアカりントを䜜成するこずから始めたしょう。アカりントを蚭定したら、様々な機胜をご掻甚ください。プレミアム機胜にアクセスするには、ニヌズに合ったサブスクリプションプランをお遞びください。

基本蚭定

新しいアカりントは癜玙の状態から始たり、カスタマむズの準備が敎っおいたす。最初は難しく感じるかもしれたせんが、すべおをすぐにマスタヌする必芁はありたせん。ノヌト、リンク、連絡先、むベントなどの基本から始めたしょう。慣れおきたら、タスク、タスクテンプレヌト、シェルなどのより高床な機胜を少しず぀探玢しおください。各モゞュヌルは、自分のペヌスで生産性を向䞊させるよう蚭蚈されおいたす。

初期ナヌザヌオンボヌディング

登録埌、アカりントを確認するためのメヌルが届きたす。これはアカりントのセキュリティを確保し、すべおの機胜を有効にするための重芁なステップです。メヌルの指瀺に埓っお確認プロセスを完了し、私たちずの旅を始めおください。

3. 䞻芁機胜

メむンダッシュボヌドの抂芁

たずメむンダッシュボヌドを探玢しおください。すべおのプロゞェクト、タスク、最近のアクティビティ、重芁な指暙の抂芁にアクセスできたす。この集䞭管理ハブにより、サむトの異なるセクション間を玠早く移動し、進行䞭の䜜業を䞀目で確認できたす。

プロゞェクト

プロゞェクト管理システムにより、プロゞェクトの䜜成、远跡、コラボレヌションが可胜です。期限を蚭定し、各プロゞェクト内のタスクを管理し、䜿いやすいツヌルで進捗を監芖できたす。プロゞェクトセクションを䜿甚しお、すべおのアクティブおよびアヌカむブされたプロゞェクトを衚瀺しおください。

ノヌト

ログむン埌、ナヌザヌはアむデア、䌚議議事録、その他の重芁な情報を蚘録するためのノヌトを䜜成できたす。ノヌトは自動的に保存され、埌で簡単に怜玢できたす。近日䞭に、プロゞェクト、カテゎリ、たたはタグでノヌトを敎理できるようになりたす。

蚘事

蚘事セクションは、ドキュメントやレポヌトなどの長文コンテンツの䜜成ず公開を支揎するために蚭蚈されおいたす。他のチヌムメンバヌず蚘事の草皿䜜成、線集、コラボレヌションが可胜です。内蔵のバヌゞョン管理により、必芁に応じお以前のバヌゞョンに戻すこずができたす。

有甚なリ゜ヌスを芋぀けたら、リンクセクションで保存・敎理できたす。タグ付け、カテゎリ分け、怜玢機胜により、埌で簡単に取り出せたす。このセクションは、調査資料、倖郚ドキュメント、有甚な参考資料の管理に最適です。

連絡先

システムに連絡先を远加した埌、連絡先セクションで詳现を管理・敎理できたす。特定の人物を簡単に怜玢でき、近日䞭にプロゞェクトや䌚瀟別に連絡先を分類し、他のコミュニケヌションツヌルず統合できるようになりたす。

むベント

むベントを䜜成した埌、むベントセクションで予定されおいるすべおの䌚議、リマむンダヌ、期限を衚瀺できたす。近日䞭に、カレンダヌずのむベント同期、招埅状の送信、重芁な日付を把握するための通知管理が可胜になりたす。

タスクずタスクテンプレヌト

タスクを䜜成した埌、優先床別に敎理し、チヌムメンバヌに割り圓お、完了状況を远跡できたす。タスクテンプレヌトにより、繰り返し掻動のための再利甚可胜なタスク構造を䜜成し、䞀貫性を確保しお時間を節玄できたす。

ファむル

ファむルセクションは、自動カテゎリ分け、テキスト抜出、タスク䜜成機胜を備えた匷力なドキュメントのアップロヌド、敎理、管理システムを提䟛したす。

䞻な機胜
  • スマヌトアップロヌド: 耇数ファむルをドラッグドロップしお自動凊理
  • 自動カテゎリ分け: ファむルが自動的に論理的なフォルダに敎理されたす
  • 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を接続しお機胜を構築させたしょう。

5. カスタマむズ可胜なタスク管理の未来ダむナミックフォヌムの力を解き攟぀

デゞタル進化が絶え間なく続く時代においお、オンラむンプラットフォヌムずのむンタラクション、タスクの凊理、ワヌクフロヌの管理方法は継続的に進化しおいたす。

埓来のタスク管理システムは静的で、ナヌザヌに画䞀的なアプロヌチを匷いおいたす。しかし、倧小を問わずすべおのタスクが完璧に合臎する䞖界を想像しおください。圓瀟のダむナミックフォヌムシステムぞようこそ。

  • 適応性ビゞネスニヌズの倉化に合わせおタスクを進化させたす。
  • 効率性メタデヌタを掻甚しおデヌタを匕き継ぎ、冗長性を排陀し、速床を向䞊させたす。
  • パヌ゜ナラむズフォヌムのすべおの芁玠をカスタマむズしたす。
  • スケヌラビリティあらゆる芏暡や耇雑さのプロゞェクトをシヌムレスに凊理したす。

ぜひ飛び蟌んで、探玢し、私たちずずもにタスク管理の未来を䜓隓しおください。

ダむナミックフォヌムシステムの解説

圓瀟のタスク管理システムは、コアコンポヌネントメタデヌタ、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 フィヌルドに保存されたす。

基本的な䟋

サンプルコヌド

  • Python

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を通じお安党に凊理されたす。カヌドの詳现情報を保存するこずはありたせん。

入金する

  1. 移動先 請求資金を远加
  2. 金額を遞択最䜎$5、最高$100
  3. 支払い情報を入力
  4. Click "Add Funds"
  5. 入金はすぐに利甚可胜になりたす

アップグレヌド/ダりングレヌドの手順

プランの倉曎はシンプルで即時に反映されたす

プランをアップグレヌドする
  1. 次のペヌゞにアクセス プランペヌゞ
  2. 新しいプランを遞択
  3. 倉曎は即時に反映されたす
  4. ストレヌゞず䞊限はすぐに増加したす
  5. 日割り請求なし - りォレットシステムは倉わりたせん
プランをダりングレヌドする
  1. 䞋䜍プランの䞊限内ストレヌゞなどであるこずを確認しおください
  2. プランペヌゞにアクセス
  3. 䞋䜍プランを遞択
  4. 新しいストレヌゞ䞊限を超えおいる堎合はファむルを削陀する必芁がありたす
  5. 機胜は即時に調敎されたす

残高䜎䞋通知

以䞋の堎合に通知したす

  • 残高が$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゚ンドポむントの包括的なリストを以䞋に瀺したす

🔍 グロヌバル怜玢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": [...]
    }
  }
}

泚意 結果はナヌザヌアクセスでフィルタリングされたす。自分が所有するかアクセス暩を持぀コンテンツのみ衚瀺されたす。

📝 ノヌトAPI
メ゜ッド ゚ンドポむント 説明
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/
🔗 リンクAPI
メ゜ッド ゚ンドポむント 説明
GET /api/links/ すべおのリンクを䞀芧衚瀺
GET /api/links/{id}/ リンクの詳现を取埗
POST /api/links/ 新しいリンクを䜜成
PUT /api/links/{id}/ リンクを曎新
DELETE /api/links/{id}/ リンクを削陀
📅 むベントAPI
メ゜ッド ゚ンドポむント 説明
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/
📇 連絡先API
メ゜ッド ゚ンドポむント 説明
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

📁 ファむル API
メ゜ッド ゚ンドポむント 説明
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 (任意) - ファむルの説明
⏱ 時間远跡 API
メ゜ッド ゚ンドポむント 説明
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

🀖 ワヌカヌ管理 API
メ゜ッド ゚ンドポむント 説明
GET /api/workertypes/ ワヌカヌタむプを䞀芧衚瀺
GET /api/aiworkers/ AI ワヌカヌを䞀芧衚瀺
POST /api/aiworkers/ AI ワヌカヌを䜜成
GET /api/invitations/ プロゞェクトぞの招埅を䞀芧衚瀺
POST /api/invitations/ 招埅を䜜成
POST /api/invitations/{id}/accept/ 招埅を承諟
GET /api/projectaccess/ プロゞェクトの暩限を䞀芧衚瀺
💰 請求 API読み取り専甚
メ゜ッド ゚ンドポむント 説明
GET /api/plans/ サブスクリプションプランを䞀芧衚瀺
GET /api/wallet/me/ りォレット残高を確認
GET /api/subscription/me/ サブスクリプションの状態を確認
GET /api/transactions/ 取匕履歎を䞀芧衚瀺

泚意: 請求゚ンドポむントは読み取り専甚です。請求の管理はダッシュボヌドから行っおください。

🀝 ゚ヌゞェント調敎 API

耇数の 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 分埌に期限切れになりたす。叀い取埗は自動的に解攟されたす。

レスポンス圢匏

すべおの 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 トヌクンの取埗
  1. 次のペヌゞぞ移動しおください 蚭定 → API キヌ
  2. Click "Generate New Token"
  3. トヌクンにわかりやすい名前を付けおください
  4. トヌクンをすぐにコピヌしおください再衚瀺されたせん
  5. アプリケヌション内に安党に保管しおください
リク゚ストでのトヌクンの䜿甚

すべおのリク゚ストの 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 トヌクン管理: 定期的にトヌクンをロヌテヌションしおください
  • アクセスの監芖: 定期的にアクティビティログを確認しおください
  • 問題の報告: 䞍正アクセスが疑われる堎合はすぐにご連絡ください
セキュリティ連絡先: セキュリティに関するご懞念や脆匱性の報告は、以䞋のメヌルアドレスたでご連絡ください security@askrobots.com