toodledoapi @ ウィキ

トップページ

2012-06-11T15:14:29+09:00

**ToodeldoAPI@wikiへようこそ Developer's API Documentation : Version 2.0 の非公式日本語訳、要点のまとめを掲載しています。 http://api.toodledo.com/2/index.php 共同編集者を募集中です。youpsit2012＠gmail.comまでご連絡をお待ちしております。 *Developer's API Documentation : Version 2.0 ToodledoのAPIは、誰でも無料で利用することができます。　The Toodledo API is free to use for any developer who wants to extend our service. **Setup / General Information アプリケーションの登録、APIの働きについて　Register your application, and learn how the API works. -[[Register your App & Stats]] -[[Syncing & Rate Limiting]] -[[Connecting & Encoding]] **Authentication / Account Info 認証、アカウント情報の取得　Learn how to authenticate with the API and get account information. -[[Authentication]] -[[Account Info]] **User Defined Lists 4種類のユーザー定義リストがあり、これらは属性値をタスクに割り当てるのに使われます。 There are four different user defined lists that are used to assign values to tasks. Folders are usually the primary organizational structure of Toodledo users. Contexts can track resources that are required to complete a task. Goals are a big picture concepts that individual tasks can contribute towards. Locations are a user defined places on a map. -[[Folders API]] -[[Context API]] -[[Goals API]] -[[Locations API]] **Tasks タスクの閲覧、追加、変更、削除　Learn how to view, add, edit and delete tasks. -[[Tasks API]] **Notebook ノートの閲覧、追加、変更、削除　Learn how to view, add, edit and delete notebook entries. -[[Notebook API]] *ライブラリ maldworth / maDoHttpServices　https://github.com/maldworth/maDoHttpServices lant/toodledo-java　https://github.com/lant/toodledo-java/wiki ---- **まずはこちらをご覧ください。 -[[@wikiの基本操作>http://atwiki.jp/guide/category2.html]] -[[用途別のオススメ機能紹介>http://atwiki.jp/guide/category22.html]] -[[@wikiの設定/管理>http://atwiki.jp/guide/category6.html]] **分からないことは？ -[[@wiki ご利用ガイド>http://atwiki.jp/guide/]] -[[よくある質問>http://atwiki.jp/guide/category1.html]] -[[無料で会員登録できるSNS内の@wiki助け合いコミュニティ>http://sns.atfb.jp/view_community2.php?no=112]] -[[@wiki更新情報>http://www1.atwiki.jp/guide/pages/264.html]] -[[@wikiへのお問合せフォーム>http://atwiki.jp/helpdesk]] 等をご活用ください **@wiki助け合いコミュニティの掲示板スレッド一覧 #atfb_bbs_list(112) **その他お勧めサービスについて -[[大容量１Ｇ、PHP/CGI、MySQL、FTPが使える無料ホームページは@PAGES>>http://atpages.jp/]] -[[無料ブログ作成は@WORDをご利用ください>>http://atword.jp/]] -[[2ch型の無料掲示板は@chsをご利用ください>>http://atchs.jp/]] -[[フォーラム型の無料掲示板は@bbをご利用ください>>http://atbb.jp/]] -[[お絵かき掲示板は@paintをご利用ください>>http://atpaint.jp/]] -[[その他の無料掲示板は@bbsをご利用ください>>http://atbbs.jp/]] -[[無料ソーシャルプロフィールサービス @flabo(アットフラボ)>>http://sns.atfb.jp]] **おすすめ機能 -[[気になるニュースをチェック>http://atwiki.jp/guide/17_174_ja.html]] -[[関連するブログ一覧を表示>http://atwiki.jp/guide/17_161_ja.html]] **その他にもいろいろな機能満載！！ -[[@wikiプラグイン>http://atwiki.jp/guide/category17.html]] -[[@wiki便利ツール>http://atwiki.jp/guide/category32.html]] -[[@wiki構文>http://atwiki.jp/guide/category16.html]] -[[@wikiプラグイン一覧>http://www1.atwiki.jp/guide/pages/264.html]] -[[まとめサイト作成支援ツール>http://atwiki.jp/matome/]] **バグ・不具合を見つけたら？要望がある場合は？お手数ですが、メールでお問い合わせください。

Authentication

2012-06-11T02:06:23+09:00

*Developer's API Documentation : Authentication http://api.toodledo.com/2/account/index.php **認証認証するためにはまず、セッショントークンをリクエストしなければなりません。これはGETあるいはPOSTリクエストによって、token.php APIの終着点に対して行われます。リクエストは登録されたあなたのAppIDによって署名されていなければなりません。これにより誰もあなたのアプリケーションに成りすますことができなくなります。受け取ったセッショントークンは、ほかのすべてのAPIリクエストのために用いられるキーを生成するために利用されます。あなたはアプリケーションについて任意でいくつか詳しい情報を送ることもでき、これはあなたにとって有利に働くでしょう。こうした詳細は[[statistics page]]にて閲覧することができます。これにより、どんなデバイスであなたのアプリケーションが利用されているのかについて知ることができます。 -userid（必須）：十六進数の文字列で、あなたのアプリケーションを用いるユーザーをひとりひとり識別します。ユーザーはあなたにこれを直接与えることもできますし、account/lookupメソッドを用いることによって照会することもできます。 -appid（必須）：あなたのアプリケーションを識別するテキスト文字列です。 -vers（任意）：あなたのアプリケーションのバージョン番号を示すintegerです。 -devices（任意）：あなたのアプリケーションが実行されているデバイスやプラットフォームを識別するテキスト文字列です。 -os（任意）：あなたのアプリケーションが実行されているデバイスやプラットフォームの、オペレーティングシステムのバージョン番号を示すintegerです。 -sig（必須）：あなたのアプリケーションを有効化する署名です。useridのmd5 hashとあなたのApp Tokenを取得して生成されます。App Tokenはあなたがアプリケーションを登録した際に発行されています。　A signature to validate your application. Generated by taking the md5 hash of the userid and your App Token. The App Token was generated when you registered your app. (required) Generating the signature with PHP &nowiki(){$key = md5( $userid.$myAppToken );} Generating the signature with C &nowiki(){key = md5( userid+myAppToken );} Generating the signature with Obj-C &nowiki(){char *cStr = [[NSString stringWithFormat:@"%@%@",userid,myAppToken] UTF8String];} &nowiki(){unsigned char result[CC_MD5_DIGEST_LENGTH];} &nowiki(){CC_MD5(cStr, strlen(cStr), result);} &nowiki(){NSString *sig = [NSString stringWithFormat: @"%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X%02X", result[0], result[1], result[2], result[3], result[4], result[5], result[6], result[7], result[8], result[9], result[10], result[11], result[12], result[13], result[14], result[15]]; } **キーの生成 **アカウントの照会 **アカウントの取得 **エラーコード一覧 ----

Tasks API

2012-06-11T01:10:30+09:00

*Developer's API Documentation : Tasks http://api.toodledo.com/2/tasks/index.php **同期　Syncing 多くのサードパーティ製アプリケーションの主たる目的は、タスクの同期をすることです。この勧めに従えば、きれいで効率的にタスクを同期することができます。最重要事項の一つとしては、「タスク最終更新」（"lastedit_task"）または「タスク最終削除」（"lastdelete_task"）のタイムスタンプを用いることです。これはアカウント情報（"Account Info"）から返されるもので、アプリケーションがサーバーから差分を取得・更新・削除する前に、サーバー上で変更があったかどうかを知ることができます。たいていの場合は、同期してもサーバー上に変更はなく、何もする必要がないので、タイムスタンプを用いることによって処理量・時間を大きく削減することができます。図（本家サイトより拝借・加工。問題がある場合はご連絡ください） #ref(SyncFlowTasksJp.png) アプリケーションとToodledoとの同期においては、以下の7つのシナリオを扱えなければなりません。 +アプリケーションへのタスク追加 +アプリケーションでのタスク更新 +アプリケーションからのタスク削除 +Toodledoサーバへのタスク追加 +Toodledoサーバでのタスク更新 +Toodledoサーバからのタスク削除 +アプリケーションとサーバ双方でタスクが変更されているシナリオ1, 2, 3では、アプリケーションはタスクを追加・更新・削除するために、それぞれ /tasks/add.php, /tasks/edit.php, /tasks/delete.php のAPIを用いることになります。追加と削除の場合は事前チェックの必要はありませんが、更新をする前には差分を取得し、修正日の比較をすることにより、タスクのより新しい更新を上書きしてしまわないようにしなければなりません。シナリオ4, 5, 6では、アプリケーションはそれぞれ /tasks/get.php または /tasks/get_deleted.php のAPIを用いることになります。シナリオ7では、アプリケーションは修正日を比較し、双方で更新されているのかどうかを判断した後、ユーザーにどちらの版を残すかを尋ねます。すべてのシナリオは上のフローチャートに従うことで効率よく処理することができます。 **タスクの属性タスクにはいろいろ設定・取得できる項目があります。それらの属性の詳細を説明します。 |&bold(){id}|このタスクのサーバーID番号です。アカウントごとに一意であることが保証されていますが、アカウントが違えば同じID番号で違った内容のタスクになります。| |&bold(){title}|タスクの名前を表す文字列です。255文字まで。設定する際、& は %26 に、; は %3B にそれぞれエンコードしてください。| |&bold(){tag}|タスクにつけるタグです。コンマ , で区切られた文字列リストです。64文字まで。設定する際、& は %26 に、; は %3B にそれぞれエンコードしてください。| |&bold(){folder}|フォルダのID番号です。フォルダに登録しない場合はこの項目自体を書き漏らしておくか、0を設定してください。| |&bold(){context}|コンテクストのID番号です。フォルダに登録しない場合はこの項目自体を書き漏らしておくか、0を設定してください。| |&bold(){goal}|ゴールのID番号です。フォルダに登録しない場合はこの項目自体を書き漏らしておくか、0を設定してください。| |&bold(){location}|ロケーションのID番号です。フォルダに登録しない場合はこの項目自体を書き漏らしておくか、0を設定してください。| |&bold(){parent}|プロアカウント項目です。サブタスクへのアクセスに用いられます。サブタスクを作成するには、ここに親タスクの番号を設定します。デフォルトは0で、この場合は普通のタスクが作成されます。| |&bold(){children}|プロアカウント項目です。サブタスクへのアクセスに用いられます。このタスクが持っている子タスクの数を示します。サブタスクや、普通のタスクでは0となります。| |&bold(){order}|プロアカウント項目です。サブタスクへのアクセスに用いられます。これはintegerで、親タスク内での当該サブタスクの順番を示します。現在、これは読み取り専用としています。| |&bold(){duedate}|タスクの期限日についての、GMT unixのタイムスタンプです。このタイムスタンプのうち、時間の部分は関係ありません。サーバーから取得した際には、つねに正午に設定されます。| |&bold(){duedatemod}|[[due date modifier]]がどれなのか示すintegerです。| |~|0：この日までに（Due by）| |~|1：この日に（Due On：＝）| |~|2：この日以降に（Due After）| |~|3：オプション的（？）| |&bold(){startdate}|タスクの開始日についての、GMT unixのタイムスタンプです。このタイムスタンプのうち、時間の部分はつねに正午に設定されます。| |&bold(){duetime}|タスクの期限時間についての、GMT unixのタイムスタンプです。期限時間が設定されていなければ、0となります。期限日が設定されていないのに期限時間が設定されている場合、&u(){このタイムスタンプの日付}は1970年1月1日に設定されます。時間はfloating timesで記録されます。言い換えれば、10amとして設定されたものはそのタイムゾーンにおける10amです。このタイムスタンプをGMTの文字列に変換し、タイムゾーンに関わらず表示することもできます。| |&bold(){starttime}|タスクの開始時間についての、GMT unixのタイムスタンプです。開始時間が設定されていなければ、0となります。開始日が設定されていないのに開始時間が設定されている場合、&u(){このタイムスタンプの日付}は1970年1月1日に設定されます。時間はfloating timesで記録されます。言い換えれば、10amとして設定されたものはそのタイムゾーンにおける10amです。このタイムスタンプをGMTの文字列に変換し、タイムゾーンに関わらず表示することもできます。| |&bold(){remind}|duedateやduetimeのリマインダを送るまでの時間（分）をあらわすintegerです。リマインダがなければ0を設定します。設定値はリストに示される有効な数値に限られます（0, 1, 15, 30, 45, 60, 90, 120, 180, 240, 1440, 2880, 4320, 5760, 7200, 8640, 10080, 20160, 43200）。プロアカウントでなければ、0か60に限られます。無効な数値を入力すると、0でない近傍の数値に修正されます。| |&bold(){repeat}|タスクをどのように繰り返すかを示す文字列です。"Every 1 Week" や "On the 2nd Friday" です。詳しくは[[repeat format faq]]を参照してください。タスクがリスケジュールされた際は、新しい日付に移行します。記録を残すためには、タスクの完全なコピーをユーザーのリストに加えるようにしてください。ここの場合は、新しいタスクには別のID番号が与えられ、終了状態となります。繰り返しを解除するには、空の文字列を設定してください。| |&bold(){repeatfrom}|どのようにタスクが繰り返されるのかを示します。0であれば期限日を基準とし、1であれば終了日を基準として繰り返します。| |&bold(){status}|タスクの状態を示すintegerです。| |~|0：None　なし| |~|1：New Action　新しいアクション| |~|2：Active　アクティブ| |~|3：Planning　計画中| |~|4：Delegated　委託中| |~|5：Waiting　待機| |~|6：Hold　保留| |~|7：Postponed　延期| |~|8：Someday　いつか| |~|9：Canceled　中止| |~|10：Reference　照会| |&bold(){length}|終了までにかかる予想時間（分）を表すintegerです。| |&bold(){priority}|優先度を表すintegerです。| |~|-1：Negative　消極的| |~|0：Low　低| |~|1：Medium　中| |~|2：High　高| |~|3：Top　緊急| |&bold(){star}|タスクにスターがついているかどうかのboolean（0または1）です。| |&bold(){modified}|タスクが最後に修正された際のGMT UNIXタイムスタンプです。| |&bold(){completed}|タスクが終了した際のGMT UNIXタイムスタンプです。終了していなければ0です。Toodledoでは終了時刻は追っていないので、終了時刻は常に正午となります。| |&bold(){added}|タスクが追加された際のGMT UNIXタイムスタンプです。Toodledoでは追加時刻は追っていないので、追加時刻は常に正午となります。| |&bold(){timer}|タイマーにおいて、現在のセッションを含まずに、経過した時間（秒）を示す値です。　The value in the timer field indicates the number of seconds that have elapsed for the timer not including the current session.| |&bold(){timeron}|タイマーが起動している場合、ここにはタイマーが起動した最後の時間を示すUNIXタイムスタンプが保存されます。したがって、タイマーがまさに稼働中の場合、ユーザーには経過時間との差（timer欄）を計算して表示する必要があります。計算式は、Total Time=timer+(now-timeron) です。ただし、nowは現在日時のUNIXタイムスタンプです。| |&bold(){note}|32000バイトまでのtext stringです。設定する際、& は %26 に、; は %3B にそれぞれエンコードしてください。| |&bold(){meta}|255バイトまでのtext stringです。タスクのメタデータを保持します。Toodledoに適切な項目がないデータを同期するのに便利です。このデータはタスクIDごとに一意です。このデータはあなたのアプリケーションIDごとのプライベートなものです。ユーザーも他のアプリケーションIDも、あなたのアプリケーションがここに記述したデータを見ることはできません。実行の詳細により、meta項目を使用することでそれぞれのAPIを呼び出すのに余計に時間がかかることになります。したがって、必要なときのみ利用するようにしてください。　Because of an implementation detail, using the meta field introduces extra latency to each API call, so you should only use this field when necessary.| **タスクの取得 **タスクの追加 POSTにより tasks/add.php APIを呼び出すことにより、一度に50件までのタスクを追加することができます。titleは必須項目です。 |必須項目|title| |オプション|folder, context, goal, location, priority, status, star, duration, remind, starttime, duetime, completed, duedatemod, repeat, repeatFrom, tag, duedate, startdate, note, parent, meta| |（言及なし）|id, children, order, length, modified, added, timer, timeron| ref という特別な項目があります。これは英数字のID番号で、これを通すことによって同期後にモノを一致させるのを補助する目的で用いられます。There is also a special field called "ref" that you can use to pass through an alphanumeric id number to aid in matching things up after a sync. ref はタスクには保存されず、このコールにてエコーバックされるだけです。The "ref" field is not saved into the task, it is only echoed back to you on this call. タスクは、以下のようなJSONオブジェクトを生成し、POSTによってAPIに送信することで追加されます。改行文字は \n としてください。データは適切にURLで送信できるようにエンコードしてください（%XXという文字列は+という文字にエンコードされます：symbols replaced with their %XX equivalent and spaces encoded as +）。各行のそれぞれの要素がひとつのタスクオブジェクトとなります。効率のために、単に設定したい項目だけを送信してください。 #blockquote(){&html(http://api.toodledo.com/2/tasks/add.php?key=YourKey;) &html(tasks=[{"title"%3A"My Task"}%2C{"title"%3A"Another"%2C"star"%3A"1"%2C"ref"%3A"98765"}];) &html(fields=folder,star)} アクションが成功すると、追加されたタスクは追加された順に返されます。個々のタスクに何らかのエラーが生じた場合は、返されたタスクの内部にアウトプットされるので、どのアクションが失敗したのかを特定することができます。 #blockquote(){&html(JSON:) &html([{"id":"1234","title":"My Task","modified":1281990824,"completed":0,"folder":"0","star":"0"},) &html({"id":"1235","title":"Another","modified":1280877483,"completed":0,"folder":"0","star":"1","ref":"98765"}])} URLに "f=xml" を付加することによって、APIが返す際のフォーマットをxmlに指定することもできます。 #blockquote(){&html(http://api.toodledo.com/2/tasks/add.php?key=YourKey;) &html(tasks=[{"title"%3A"My Task"}%2C{"title"%3A"Another"%2C"star"%3A"1"%2C"ref"%3A"98765"}];) &html(fields=folder,star;f=xml)} #blockquote(){&html(XML: ) &nowiki(){} &nowiki(){ 　　} &nowiki(){ 　　　　1234} &nowiki(){ 　　　　My Task} &nowiki(){ 　　　　0} &nowiki(){ 　　　　1234567890} &nowiki(){ 　　　　} &nowiki(){ 　　　　0} &nowiki(){ 　　} &nowiki(){ 　　} &nowiki(){ 　　　　1235} &nowiki(){ 　　　　Another} &nowiki(){ 　　　　0} &nowiki(){ 　　　　1234567890} &nowiki(){ 　　　　} &nowiki(){ 　　　　1} &nowiki(){ 　　　　98765} &nowiki(){ 　　} &nowiki(){}} **タスクの更新 **タスクの削除 **削除されたタスクの取得 **エラーコード一覧 ----

メニュー

2012-06-10T23:43:27+09:00

**メニュー -[[トップページ]] -[[Register your App & Stats]] -[[Syncing & Rate Limiting]] -[[Connecting & Encoding]] -[[Authentication]] -[[Account Info]] -[[Folders API]] -[[Context API]] -[[Goals API]] -[[Locations API]] -[[Tasks API]] -[[Notebook API]] ---- -[[プラグイン紹介>プラグイン]] -[[まとめサイト作成支援ツール]] -[[メニュー]] -[[メニュー2]] ---- **リンク -[[@wiki>>http://atwiki.jp]] -[[@wikiご利用ガイド>>http://atwiki.jp/guide/]] **他のサービス -[[無料ホームページ作成>>http://atpages.jp]] -[[無料ブログ作成>>http://atword.jp]] -[[2ch型掲示板レンタル>>http://atchs.jp]] -[[無料掲示板レンタル>>http://atbbs.jp]] -[[お絵かきレンタル>>http://atpaint.jp/]] -[[無料ソーシャルプロフ>>http://sns.atfb.jp/]] // リンクを張るには "[" 2つで文字列を括ります。 // ">" の左側に文字、右側にURLを記述するとリンクになります //**更新履歴 //#recent(20) &link_editmenu(text=ここを編集)

Connecting & Encoding

2012-06-10T14:48:23+09:00

*Developer's API Documentation : Connecting & Encoding |文字コード|UTF-8| |GET・POST|両方可能| |SSL|アカウント取得、アカウント照会、トークン生成にて利用可能| |JSON|| |URLエンコーディング||

右メニュー

2012-06-10T14:03:29+09:00

**更新履歴 #recent(20) &link_editmenu2(text=ここを編集)

プラグイン/ニュース

2012-06-10T14:03:29+09:00

* ニュース @wikiのwikiモードでは #news(興味のある単語) と入力することで、あるキーワードに関連するニュース一覧を表示することができます詳しくはこちらをご覧ください。＝＞http://atwiki.jp/guide/17_174_ja.html ----- たとえば、#news(wiki)と入力すると以下のように表示されます。 #news(wiki)

まとめサイト作成支援ツール

2012-06-10T14:03:29+09:00

* まとめサイト作成支援ツールについて @wikiには[[まとめサイト作成を支援するツール>>http://atwiki.jp/matome/]]があります。また、 #matome_list と入力することで、注目の掲示板が一覧表示されます。利用例）#matome_listと入力すると下記のように表示されます #matome_list

プラグイン/編集履歴

2012-06-10T14:03:29+09:00

* 更新履歴 @wikiのwikiモードでは #recent(数字) と入力することで、wikiのページ更新履歴を表示することができます。詳しくはこちらをご覧ください。＝＞http://atwiki.jp/guide/17_117_ja.html ----- たとえば、#recent(20)と入力すると以下のように表示されます。 #recent(20)

プラグイン/アーカイブ

2012-06-10T14:03:29+09:00

* アーカイブ @wikiのwikiモードでは #archive_log() と入力することで、特定のウェブページを保存しておくことができます。詳しくはこちらをご覧ください。＝＞http://atwiki.jp/guide/25_171_ja.html ----- たとえば、#archive_log()と入力すると以下のように表示されます。保存したいURLとサイト名を入力して"アーカイブログ"をクリックしてみよう #archive_log()