オンラインステータスの取得

メソッド

GET

URL

https://typetalk.com/api/v1/accounts/status

スコープ

my

クエリパラメーター

名前 説明
accountIds (複数指定可) 文字列 アカウントID(トピックのメンバーのみ)

レスポンスの例

{
  "accounts": [
    {
      "account": {
        "id": 101,
        "name": "ahorowitz",
        "fullName": "AHorowitz",
        "suggestion": "AHorowitz",
        "imageUrl": "https://typetalk.com/accounts/101/profile_image.png?t=1403663549000",
        "isBot": false,
        "createdAt": "2014-06-25T02:32:29Z",
        "updatedAt": "2014-06-25T02:32:29Z"
      },
      "status": {
        "presence": "away",
        "web": null,
        "mobile": null
      }
    },
    {
      "account": {
        "id": 100,
        "name": "jessica",
        "fullName": "Jessica Fitzherbert",
        "suggestion": "Jessica Fitzherbert",
        "imageUrl": "https://typetalk.com/accounts/100/profile_image.png?t=1403577149000",
        "isBot": false,
        "createdAt": "2014-06-24T02:32:29Z",
        "updatedAt": "2014-06-24T02:32:29Z"
      },
      "status": {
        "presence": "away",
        "web": null,
        "mobile": null
      }
    }
  ]
}

レスポンスのフォーマットは全てJSONです。GETメソッドはETagに対応しているので、If-None-Match ヘッダを付けて送ると、変更がない場合は304を返します。日付のフォーマットは ISO 8601 で、UTC です。 (例 : 2014-01-09T06:20:08Z )