Contents

組織一覧を取得する

参加している組織一覧を取得します。

メソッド

GET

URL

https://typetalk.com/api/v1/spaces

スコープ

my

クエリパラメーター

名前説明
excludesGuest (任意)真偽値true の場合、あなたがゲストの組織は含まれません。

レスポンスの例

{
  "mySpaces": [
    {
      "space": {
        "key": "abcdefghij",
        "name": "Joe Tech Inc.",
        "enabled": true,
        "imageUrl": "https://apps.nulab.com/spaces/abcdefghij/photo/large"
      },
      "myRole": "ADMIN",
      "isPaymentAdmin": true,
      "myPlan": {
        "plan": {
          "key": "typetalk.free",
          "name": "Free Plan",
          "limitNumberOfUsers": 10,
          "limitTotalAttachmentSize": 1073741824
        },
        "enabled": true,
        "trial": null,
        "numberOfUsers": 6,
        "totalAttachmentSize": 0,
        "createdAt": "2016-01-10T02:32:29Z",
        "updatedAt": "2016-12-21T10:12:18Z"
      }
    },
    {
      "space": {
        "key": "0123456789",
        "name": "Nu team",
        "enabled": true,
        "imageUrl": "https://apps.nulab.com/spaces/0123456789/photo/large"
      },
      "myRole": "USER",
      "isPaymentAdmin": false,
      "myPlan": {
        "plan": {
          "key": "typetalk.starter",
          "name": "Starter Plan",
          "limitNumberOfUsers": 10,
          "limitTotalAttachmentSize": 10737418240
        },
        "enabled": true,
        "trial": {
          "endDate": "2017-01-04",
          "daysLeft": 15
        },
        "numberOfUsers": 2,
        "totalAttachmentSize": 0,
        "createdAt": "2016-12-06T01:11:43Z",
        "updatedAt": "2016-12-21T01:11:43Z"
      }
    }
  ]
}

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