👤
User
Pixela のユーザーアカウントに相当するものです。Pixela を使うためには、まず
User
を登録する必要があります。関連API
- POST - /v1/users
User
を新たに登録するためのAPIです。
- PUT - /v1/users/<username>
- 登録済みの
User
を更新するためのAPIです。
- DELETE - /v1/users/<username>
- 登録済みの
User
を削除するためのAPIです。
特徴
User
には、以下のようなプロパティがあります。token
username
agreeTermsOfService
notMinor
thanksCode
token
そのユーザーアカウントに対するパスワードのようなものです。そのユーザーアカウントとして様々なAPIを利用する際に、そのリクエストヘッダに
X-USER-TOKEN
をキーに token
を指定する必要があります。username
ユーザー名です。Pixela のグラフなどを表示させる際に、URLの一部としても使われます。既に使用されているものと同じものを指定して
User
を登録することはできません。また、後から変更することはできません。agreeTermsOfService
notMinor
利用者が未成年ではないことを
yes
no
で指定します。あなたが未成年の場合、Pixela を利用することはできません。thanksCode
thanks-code
と呼ばれるレジストレーションコードを設定できるプロパティです。このプロパティに有効な thanks-code
を設定すると、すべての機能の制限が解除されます。詳しくは Pixela を支援する特典として限定機能を利用可能にする - Pixela サポータープログラム を参照してください。仕様
- Userを削除すると、それに紐付くグラフなどのすべての情報も削除されます。
留意事項
- あなたが Pixela の API をあなたのサービスに組み込むなどして、第三者に Pixela の
User
を登録させる場合、利用規約の同意と未成年ではないことの確認はその第三者に対して行うようにしてください。
- 複数の
User
を登録しても構いません。複数のUser
に対してひとつのthanks-code
を登録することができます。 - あなたの組織内の
User
でthanks-code
を共有したい場合、ロゴ/アイコンスポンサーのメンバーシップレベルを選択して支援登録してください。詳しくは ロゴやアイコンをトップページに掲載する を参照してください。