v1.35.0

[English]

We have added a new API endpoint, GET /v1/users/<username>/graphs/<graphID>/analyze, which allows you to have your graphs analyzed by AI and retrieve the results.

The overview and precautions are as follows.

• The AI analyzes the Pixel posted to the graph specified by and responds with the results in a string of up to approximately 1000 characters.
• Please pay attention to the following points.
  • The analysis will cover Pixel posts from the last year.
  • You cannot use this API if any of the following apply.
    • If allowAIProcessing is not set to true for the user.
      • PUT - /v1/users/
    • In the case where a valid thanks-code is not set for the user (If you are not a Pixela Supporter).
    • If the number of Pixel posts within the last year is less than 30.
  • The AI analysis results are reset once a day.
  • The language of the analysis results is determined based on the timezone setting configured in Graph.
    • PUT - /v1/users/<username>/graphs/<graphID>
  • You can obtain better analysis results by setting the description for the Graph .
    • PUT - /v1/users/<username>/graphs/<graphID>

Please also refer to the API documentation when using this service.

[Japanese]

あなたのグラフをAIに分析させ、その結果を取得できるAPIエンドポイント、GET /v1/users/<username>/graphs/<graphID>/analyze を新たに追加しました。

概要および注意事項は以下のとおりです。

• <graphID> で指定したグラフに投稿済みの Pixel を AI に分析させ、その結果を最大1000文字程度の文字列でレスポンスします。
• 以下のような点に注意してください。
  • 直近1年間に投稿された Pixel を分析対象とします。
  • 以下のいずれかに当てはまる場合、このAPIを利用することはできません。
    • User の allowAIProcessing に true が設定されていない場合。
      • PUT - /v1/users/
    • User に有効な thanks-code が設定されていない場合（あなたが Pixela Supporter でない場合）。
    • 直近1年間に投稿された Pixel の数が 30 に満たない場合。
  • AIによる分析結果は1日に1度リセットされます。
  • Graph に設定された timezone 設定を元に、分析結果の言語が決まります。
    • PUT - /v1/users/<username>/graphs/<graphID>
  • Graph の description を設定することで、よりよい分析結果を得ることができます。
    • PUT - /v1/users/<username>/graphs/<graphID>

ご利用にあたっては、APIドキュメントもご確認ください。

また、開発者の個人ブログでもこのリリースについて紹介しています。よろしければご覧ください。Pixela グラフに投稿済みの数値データをAIに分析させることができるようになりました！

v1.34.0

[English]
We have enabled the specification of a new property, description, for Graphs. For more details, please refer to the relevant API documentation below.

• POST /v1/users/<username>/graphs - Create a graph
• PUT /v1/users/v<username>/graphs/<graphID> - Update a graph

The configured description can be viewed by hovering over it on the screen displayed in the GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail , as shown below.

---

[Japanese]
Graph に対して新たなプロパティ description を指定できるようにしました。
詳細については、関連する以下のAPIドキュメントを参照してください。

• POST /v1/users/<username>/graphs - Create a graph
• PUT /v1/users/<username>/graphs/<graphID> - Update a graph

設定された description は、GET /v1/users/<username>/graphs/<graphID>.html - View a graph detail で表示される画面でマウスオーバーすることで、以下のように確認することができます。

v1.33.0

[English]
We have added the following two new API endpoints:

• PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/add
• PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/subtract

For details on each API, please refer to the linked API documentation.

These APIs will reject 25% of requests from users who are not Pixela Supporters (users with a valid thanks-code configured). For more details about Pixela Supporter, please refer to this Wiki Page.

[Japanese]
以下の2つのAPIエンドポイントを新しく追加しました。

• PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/add
• PUT - /v1/users/<username>/graphs/<graphID>/<yyyyMMdd>/subtract

各APIの詳細については、リンク先のAPIドキュメントをご確認ください。

これらのAPIは Pixela Supporter（有効な thanks-code が設定されているユーザー）以外のユーザーがリクエストした場合、25%の割合でリクエストがリジェクトされます。Pixela Supporter についての詳細はこちらの Wiki を参照してください。

v1.32.2

[English]
Improved the behavior when both the transparent and dark options are used in combination.

[Japanese]
transparent dark の両オプションを併用していた場合の挙動を改善しました。

v1.32.1

[English]
The following two APIs now support the transparent=true query parameter.
This allows you to make the background of a graph transparent.

• GET - /v1/users/{username}/graphs/{graphID}
• GET - /v1/users/{username}/graphs/{graphID}.html

---

[Japanese]
以下の2つのAPIにて、 transparent=true クエリパラメータを新たにサポートしました。
これを指定すると、グラフの背景を透明にできます。

• GET - /v1/users/{username}/graphs/{graphID}
• GET - /v1/users/{username}/graphs/{graphID}.html

v1.32.0

[English]
Added new API endpoint /v1/users/<username>/graphs/<graphID>/today.
Using this API, you can retrieve the Pixel corresponding to the requested date. You can also control whether or not a 404 error will occur if the corresponding Pixel is unregistered.
See the API documentation for details.

[Japanese]
新しいAPIエンドポイント /v1/users/<username>/graphs/<graphID>/today を追加しました。
リクエストした日に対応する Pixel を取得できます。また、該当のPixelが未登録の場合に 404 エラーとするかどうかをコントロールすることも可能です。
詳細は API ドキュメントを参照してください。

v1.31.0

[English]
Added a new property startOnMonday that can be specified for Graph.
The default value for this property is false; specify true if you want the graph to start on Monday.
See the API documentation for details.

[Japanese]
Graph に指定可能な新しいプロパティ startOnMonday を追加しました。
このプロパティの既定値は false で、そのグラフを月曜始まりにしたい場合には true を指定します。
詳細は API ドキュメントを参照してください。

v1.30.0

[English]
GET - /v1/users/<username>/graphs/<graphID> API has supported 2 new options.

• lessThan , greaterThan
• This option is used to draw only pixels that are less than or greater than the value specified by this parameter.
• These two params cannot be specified at the same time.
• In the future, we are considering making it possible to specify also GET - /v1/users/<username>/graphs/<graphID>.html API, but this is not supported at this time.

For more details. please see Pixela API docs.

[Japanese]
GET - /v1/users/<username>/graphs/<graphID> APIが、新たに2つのオプションをサポートしました。

• lessThan と greaterThan
• このパラメータで指定した値以下、もしくは値以上の Pixel のみを描画するためのオプションです。
• これら2つのパラメータは同時に指定することはできません。
• 将来的には、これらのパラメータを GET - /v1/users/<username>/graphs/<graphID>.html でも利用可能にすることを検討していますが、現時点では対応していません。

詳細はAPIドキュメントを参照してください。

v1.29.0

[English]
New API endpoint have been added!

• GET /v1/users/<username>/graphs/<graphID>/latest
  • This API can be used to retrieve the latest pixel from among the pixels registered in the graph specified by <graphID> .
  • Pixel with date that is later than the date of this API request will not be retrieved by this API.

[Japanese]
新しい API エンドポイントを追加しました。

• GET /v1/users/<username>/graphs/<graphID>/latest
  • この API を使うことで、 <graphID> で指定したグラフに登録されている Pixel のうち、最新の Pixel を取得できます。
  • このAPIをリクエストした日よりも未来の日付の Pixel はこのAPIでは取得できません。

v1.28.0

[English]
New API endpoint have been added!

• POST /v1/users/<username>/graphs/<graphID>/pixels
  • This API allows you to register multiple Pixels with a single request.
  • This API is only available for Pixela Supporter.
  • For more details, please see: POST /v1/users/<username>/graphs/<graphID>/pixels

[Japanese]
新しい API エンドポイントを追加しました。

• POST /v1/users/<username>/graphs/<graphID>/pixels
  • この API を使うことで、一度のリクエストで複数の Pixel を登録することができます。
  • この API は Pixela Supporter のみ利用可能です。
  • API の詳細に関しては POST /v1/users/<username>/graphs/<graphID>/pixels を参照してください。