JA talk:API v0.6

英語原文の改訂を反映する目安

英語原文2020年10月3日 (UTC) 15:25

ページを更新する準備として、英語版から「top」節すなわち題名下からPC版表示の目次直前まで、転写しました。皆さんのすでに終えられた更新以降の差分に当たるかと思います。

• 完了と仮定：英語版2017年6月26日（UTC: 日本時間同月27日）分まで。
• 直近の英語版は、2020年10月3日 (UTC) 15:25時点とする。
• 差分はこちら。

英語版の改訂箇所を反映できたらと考えます。 --Omotecho (talk) 21:32, 2 November 2020 (UTC)

見出しを修正　--Omotecho (talk) 23:51, 2 November 2020 (UTC)

目次の対比

詳細な内容の読み合わせの前に、目次のみ比べます。増分あり、削除もあります。

--Omotecho (talk) 23:22, 2 November 2020 (UTC)

たまに目次表を更新します。

• 原文の転写箇所除去、JA:API v0.6#全般情報の前書き済み。--Omotecho (talk) 23:51, 2 November 2020 (UTC)
• 表のページと見出しをリンク、〈日本語版目次〉（&oldid=2088026）、〈英語版目次〉。--Omotecho (talk) 07:43, 10 January 2021 (UTC)
• 目次表のtodo に青リンク。表のページにAPI v0.6 の英語原文を転写してあります。--Omotecho (talk) 21:12, 10 January 2021 (UTC)

目次表　

仮番	日本語版目次 更新元は2017年6月26日	英語版目次 2020年10月3日以降	備考 0{{todo|ほにゃらら}} 0→ {{done|ほにゃらら}}
1	#全般情報 1.1 URL + 認証 1.1.1 エラーコード 1.2 要素(Element) 1.3 変更セット(Changeset) 1.4 タグ(Tag) 1.5 文字列の最大長 1.6 確実なユーザーの識別 1.7 バージョン番号・楽観的ロック 1.8 XML 形式  翻訳　1.9 #JSON_フォーマット 1.10 2.9 正しい HTTP メソッドへの偽装	1 #General information 1.1 URL + authentication 1.1.1 Error codes 1.2 Elements 1.3 Changesets 1.4 Tags 1.5 Maximum string lengths 1.6 Reliably identifying users 1.7 Version numbers/optimistic locking 1.8 XML Format 1.9 JSON Format 1.10 Faking the correct HTTP methods	第1節は更新終わり。英語原文2020-10-03の版。Omotecho (talk) 18:13, 3 November 2020 (UTC)
2	2 #API 呼び出し	2 #API calls
2.1	* #雑記  翻訳 2.1. 利用可能な API バージョン 2.1.2. .1 機能: GET /api/capabilities 2.1.2.1. 1.1 レスポンス 2.1.2.2. 1.2 注意 2.1.3. 2 境界ボックス(Bounding box)での地図データ取得: GET /api/0.6/map 2.1.3.1. 2.1 エラーコード 2.1.4. 3 Retrieving permissions: GET /api/0.6/permissions 2.1.4.1. 3.1 Response 2.1.4.2. 3.2 Notes	* 2.1 #Miscellaneus 2.1.1 Available API versions: GET /api/versions 2.1.2 Capabilities: GET /api/capabilities 2.1.2.1 Response 2.1.2.2 Notes 2.1.3 Retrieving map data by bounding box: GET /api/0.6/map 2.1.3.1 Error codes 2.1.4 Retrieving permissions: GET /api/0.6/permissions 2.1.4.1 Response 2.1.4.2 Notes	2020−10−03
2.2	*#変更セット(changeset) 2.2.1 境界ボックスの計算 2.2.2 作成: PUT /api/0.6/changeset/create 2.2.2.1 レスポンス 2.2.2.2 エラーコード 2.2.2.3 注意 2.2.3 読み込み: GET /api/0.6/changeset/#id?include_discussion=true 2.2.3.1 パラメータ 2.2.3.2 レスポンス 2.2.3.3 エラーコード 2.2.3.4 注意 2.2.4 更新: PUT /api/0.6/changeset/#id 2.2.4.1 パラメータ 2.2.4.2 レスポンス 2.2.4.3 エラーコード 2.2.4.4 注意 2.2.5 閉じる: PUT /api/0.6/changeset/#id/close 2.2.5.1 パラメータ 2.2.5.2 レスポンス 2.2.5.3 エラーコード 2.2.6 ダウンロード: GET /api/0.6/changeset/#id/download 2.2.6.1 パラメータ 2.2.6.2 レスポンス 2.2.6.3 エラーコード 2.2.6.4 注意 2.2.7 廃止 JA:API v0.6#境界ボックスを拡張する:_POST_/api/0.6/changeset/#id/expand_bbox  削除 2020−10−03、以下同じ 2.2.7.1 パラメータ  削除 2.2.7.2 レスポンス  削除 2.2.7.3 エラーコード  削除 2.2.7.4 注意 2.2.8 問い合わせ: GET /api/0.6/changesets 2.2.8.1 パラメータ 2.2.8.2 レスポンス 2.2.8.3 エラーコード 2.2.8.4 注意 2.2.9 差分アップロード: POST /api/0.6/changeset/#id/upload 2.2.9.1 パラメータ 2.2.9.2 レスポンス 2.2.9.3 エラーコード 2.2.9.4 注意 2.2.10 変更セットのまとめ	* 2.2 #Changesets 2.2.1 Bounding box computation 2.2.2 Create: PUT /api/0.6/changeset/create 2.2.2.1 Response 2.2.2.2 Error codes 2.2.2.3 Notes 2.2.3 Read: GET /api/0.6/changeset/#id?include_discussion=true 2.2.3.1 Parameters 2.2.3.2 Response 2.2.3.3 Error codes 2.2.3.4 Notes 2.2.4 Update: PUT /api/0.6/changeset/#id 2.2.4.1 Parameters 2.2.4.2 Response 2.2.4.3 Error codes 2.2.4.4 Notes 2.2.5 Close: PUT /api/0.6/changeset/#id/close 2.2.5.1 Parameters 2.2.5.2 Response 2.2.5.3 Error codes 2.2.6 Download: GET /api/0.6/changeset/#id/download 2.2.6.1 Parameters 2.2.6.2 Response 2.2.6.3 Error codes 2.2.6.4 Notes 2.2.7 Expand Bounding Box: POST /api/0.6/changeset/#id/expand_bbox (deprecated, gone) 2.2.8 Query: GET /api/0.6/changesets 2.2.8.1 Parameters 2.2.8.2 Response 2.2.8.3 Error codes 2.2.8.4 Notes 2.2.9 Diff upload: POST /api/0.6/changeset/#id/upload 2.2.9.1 Parameters 2.2.9.2 Response 2.2.9.3 Error codes 2.2.9.4 Notes 2.2.10 Changeset summary	§2.2.7「境界ボックスを拡張する: POST……」は廃止、小見出しのみ残っています。
2.3	* #変更セットの議論 2.3.1 コメント: POST /api/0.6/changeset/#id/comment 2.3.1.1 パラメータ 2.3.1.2 エラーコード 2.3.2 購読: POST /api/0.6/changeset/#id/subscribe 2.3.2.1 エラーコード 2.3.3 購読停止: POST /api/0.6/changeset/#id/unsubscribe 2.3.3.1 エラーコード	* 2.3 #Changeset discussion 2.3.1 Comment: POST /api/0.6/changeset/#id/comment 2.3.1.1 Parameters 2.3.1.2 Error codes 2.3.2 Subscribe: POST /api/0.6/changeset/#id/subscribe 2.3.2.1 Error codes 2.3.3 Unsubscribe: POST /api/0.6/changeset/#id/unsubscribe 2.3.3.1 Error codes
2.4	#要素 2.4.1 作成: PUT /api/0.6/[node|way|relation]/create 2.4.1.1 レスポンス 2.4.1.2 エラーコード 2.4.1.3 注意 2.4.2 参照: GET /api/0.6/[node|way|relation]/#id 2.4.2.1 レスポンス 2.4.2.2 エラーコード 2.4.3 更新: PUT /api/0.6/[node|way|relation]/#id 2.4.3.1 レスポンス 2.4.3.2 エラーコード 2.4.3.3 注意 2.4.4 削除: DELETE /api/0.6/[node|way|relation]/#id 2.4.4.1 レスポンス 2.4.4.2 エラーコード 2.4.4.3 注意 2.4.5 履歴: GET /api/0.6/[node|way|relation]/#id/history 2.4.5.1 エラーコード 2.4.6 バージョン: GET /api/0.6/[node|way|relation]/#id/#version 2.4.6.1 エラーコード 2.4.7 複数取得: GET /api/0.6/[nodes|ways|relations] 2.4.7.1 パラメータ 2.4.7.2 エラーコード 2.4.8 要素に関するリレーション: GET /api/0.6/[node|way|relation]/#id/relations 2.4.8.1 注意 2.4.9 ノードに関するウェイ: GET /api/0.6/node/#id/ways 2.4.9.1 注意 2.4.10 全取得: GET /api/0.6/[way|relation]/#id/full 2.4.10.1 エラーコード 2.4.11 Redaction: POST /api/0.6/[node|way|relation]/#id/#version/redact?redaction=#redaction_id 2.4.11.1 Notes 2.4.11.2 Error Codes	* 2.4 #Elements 2.4.1 Create: PUT /api/0.6/[node|way|relation]/create 2.4.1.1 Response 2.4.1.2 Error codes 2.4.1.3 Notes 2.4.2 Read: GET /api/0.6/[node|way|relation]/#id 2.4.2.1 Example 2.4.2.2 Response 2.4.2.3 Error codes 2.4.3 Update: PUT /api/0.6/[node|way|relation]/#id 2.4.3.1 Response 2.4.3.2 Error codes 2.4.3.3 Notes 2.4.4 Delete: DELETE /api/0.6/[node|way|relation]/#id 2.4.4.1 Response 2.4.4.2 Error codes 2.4.4.3 Notes 2.4.5 History: GET /api/0.6/[node|way|relation]/#id/history 2.4.5.1 Error codes 2.4.6 Version: GET /api/0.6/[node|way|relation]/#id/#version 2.4.6.1 Error codes 2.4.7 Multi fetch: GET /api/0.6/[nodes|ways|relations]?#parameters 2.4.7.1 Parameters 2.4.7.2 Error codes 2.4.8 Relations for element: GET /api/0.6/[node|way|relation]/#id/relations 2.4.8.1 Notes 2.4.9 Ways for node: GET /api/0.6/node/#id/ways 2.4.9.1 Notes 2.4.10 Full: GET /api/0.6/[way|relation]/#id/full 2.4.10.1 Error codes 2.4.11 Redaction: POST /api/0.6/[node|way|relation]/#id/#version/redact?redaction=#redaction_id 2.4.11.1 Notes 2.4.11.2 Error Codes
2.5	*#GPS_トレース 2.5.1 GPS ポイントの取得 2.5.1.1 例  To do: 追加:*2.5.1.1.1:#例_Response 2.5.2 トレースのアップロード  To do: 追加:* 2.5.2.1:#Error_codes  To do: 追加:* 2.5.3:JA:API_v0.6#Update:_PUT_/api/0.6/gpx/#id  To do: 追加 :* 2.5.4 :JA:API_v0.6#Delete:_DELETE_/api/0.6/gpx/#id 2.5.5 3.5.3 トレースのメタデータダウンロード  To do: 追加 :* 2.5.6 :JA:API_v0.6#Download_Data:_GET_/api/0.6/gpx/#id/data  To do: 追加 :* 2.5.7 : JA:API v0.6#List:GET_/api/0.6/user/gpx_files	*2.5 GPS traces 2.5.1 Get GPS Points: Get /api/0.6/trackpoints?bbox=left,bottom,right,top&page=pageNumber 2.5.1.1 Examples 2.5.1.1.1 Response 2.5.2 Create: POST /api/0.6/gpx/create 2.5.2.1 Error codes 2.5.3 Update: PUT /api/0.6/gpx/#id 2.5.4 Delete: DELETE /api/0.6/gpx/#id 2.5.5 Download Metadata: GET /api/0.6/gpx/#id/details 2.5.6 Download Data: GET /api/0.6/gpx/#id/data 2.5.7 List: GET /api/0.6/user/gpx_files	2.5.1.1.1、2.5.2.1、2.5.4、2.5.6、2.5.7 英語版から原文の転写済み、20:17, 2021年1月7日 (UTC) （&oldid=2086631）の版
2.6	*#ユーザー情報に関するメソッド 2.6.1 ユーザの詳細  To do: 追加　2.6.2: JA:API_v0.6#Details_of_multiple_users 2.6.3. 2 ログインユーザの詳細 2.6.4. 3 ユーザー設定	*2.6 #Methods for user data 2.6.1 Details of a user 2.6.2 Details of multiple users 2.6.3 Details of the logged-in user 2.6.4 Preferences of the logged-in user	2.6.2 英語版から原文の転写済み、20:17, 2021年1月7日 (UTC) （&oldid=2086631）の版
2.7	*#地図メモ_API 2.7.1 境界ボックス内の地図メモデータの検索: GET /api/0.6/notes 2.7.1.1 エラーコード 2.7.2 メモの読取: GET /api/0.6/notes/#id 2.7.2.1 エラーコード 2.7.3 メモの作成: POST /api/0.6/notes 2.7.3.1 エラーコード 2.7.4 コメントの作成: Create: POST /api/0.6/notes/#id/comment 2.7.4.1 エラーコード 2.7.5 メモの解決: POST /api/0.6/notes/#id/close 2.7.5.1 エラーコード 2.7.6 メモの再開: POST /api/0.6/notes/#id/reopen 2.7.6.1 エラーコード 2.7.7 テキストとコメントからメモの検索: GET /api/0.6/notes/search 2.7.7.1 エラーコード  To do: 追加 2.7.8 : JA:API_v0.6#RSS_Feed:_GET_/api/0.6/notes/feed	* 2.7 #Map Notes API 2.7.1 Retrieving notes data by bounding box: GET /api/0.6/notes 2.7.1.1 Error codes 2.7.2 Read: GET /api/0.6/notes/#id 2.7.2.1 Error codes 2.7.3 Create a new note: Create: POST /api/0.6/notes 2.7.3.1 Error codes 2.7.4 Create a new comment: Create: POST /api/0.6/notes/#id/comment 2.7.4.1 Error codes 2.7.5 Close: POST /api/0.6/notes/#id/close 2.7.5.1 Error codes 2.7.6 Reopen: POST /api/0.6/notes/#id/reopen 2.7.6.1 Error codes 2.7.7 Search for notes: GET /api/0.6/notes/search 2.7.7.1 Error codes  To do: * 2.7.8: #RSS Feed: GET /api/0.6/notes/feed	2.7.8 英語版から原文の転写済み、20:17, 2021年1月7日 (UTC) （&oldid=2086631）の版
3	#APIを使うべきでない場合	3 When NOT to use the API
4	#より詳しく  追加　4.1 #脚注	4 Further reading 4.1 References	第4節は更新済み、訳出と「脚注」{{reflist}}追加。

バージョン番号を v.0.6 から更新しない経緯

そもそも初回に実装したとき、構文の更新版 (微細な改訂ごとに番号を増やす方式) という概念がまだ確立していませんでした。その結果、この API には更新番号をつけないまま進んできました。世間のアプリケーションには、更新がバージョン番号に正しく反映できていない事例を多く見かけることから、その後もバージョン番号を増やさないまま進行しています。

---

英語版（2020年終盤）で除去された説明を、記録として転写します。翻訳原文の特定版（&oldid=2043419）は、at 15:25, 3 October 2020 (UTC) by Mmdさんによる。 --Omotecho (talk) 13:20, 10 January 2021 (UTC)