有明のつれなく見えし別れより暁ばかりうきものはなし

Advent Calendar 2022 80日目¹の記事です。
I'm looking forward to 12/25,2022 👁 :santa:
👁 :santa_tone1:
👁 :santa_tone2:
👁 :santa_tone3:
👁 :santa_tone4:
👁 :santa_tone5:

私のAdvent Calendar 2022 一覧。

はじめに

「データに関する記事を書こう！」と銘打たれたイベントが開催中です。

この記事は、 テーマ１　『delikaを使った記事を書こう！』 の参加記事です。
delika API Version 1を使用してみます。

自分自身で書きました「delikaのSign upをして、ダミーデータQiitadelikaDummyでクエリ実行する」の後続記事です。

前提

delikaのSign upを済ませておいてください。

Sign upがまだの方は、右上のSign upボタンからSign upをしてください。
「さっそくつかってみよう ーー Sign up」が参考になるかもしれません。

delika API Version 1

delika API Version 1の公式ページはこちらです。

この記事ではTokenを入手して、Tokenが必要なAPIの呼び出しをします。
curlを使います。

Token

APIを利用するには、HTTPヘッダに適切なTokenを設定する必要があります。
Tokenを正しく設定できていないと、 {"Status":{"Code":401,"Message":"apim auth failed"}} とAPI呼び出しが失敗します。

それではTokenを得てみましょう

Refresh token を得る

Visit: https://api.delika.io/v1/auth
ブラウザでアクセスしてください。
Sign inすると、45日間有効なRefresh tokenを得ることができます。

POST /v1/auth/token

さきほど得たRefresh tokenをパラメータに指定します。

curl -XPOST \
-H "Content-Type: application/json" \
-d '{"RefreshToken":"Refresh token"} \
https://api.delika.io/v1/auth/token

GET /v1/account/{AccountName}/datasets

GET /v1/account/{AccountName}/datasetsをコールしてみます。
AccountNameには例えば以下を指定します。

AccountName = qiita_delika_article_campaign
AccountName = connecto-data

curl \
-H "Authorization: bearer <YOUR_TOKEN>" \
https://api.delika.io/v1/account/connecto-data/datasets

ステータスコード200の応答が返ってきました 👁 :tada:
👁 :tada:
👁 :tada:

{"Status":{"Code":200,"Message":"Found 2 datasets."},"Data":{"DatasetCount":2,"DatasetList":[{"AccountName":"connecto-data","DatasetName":"ds-skills"},{"AccountName":"connecto-data","DatasetName":"survey"}]}}

ノウハウ

以下の応答が返ってくることがあります。

{"Status":{"Code":401,"Message":"apim auth failed"}}

HTTPヘッダーに"Authorization: bearer <YOUR_TOKEN>"を入れましょう。

Wrapping up 👁 :lgtm:
👁 :lgtm:
👁 :lgtm:
👁 :lgtm:
👁 :lgtm:

この記事では、 delika API Version 1をcurlでコールする方法を示しました。
Access Tokenをどのように得るかがポイントだと考えます。
ドキュメントに書いてある通りと言えば、その通りです。

Access Tokenは次の２ステップで取得します。

1. https://docs.delika.io/api/v1/get-auth.html にブラウザでアクセスしてSign inして、Refresh tokenを得る
2. 得たRefresh tokenを使って、 POST /v1/auth/token を行う（詳細は記事本文をご参照ください）

delikaを楽しんでいきたいとおもいます！

以上です。

I organize autoracex.
And I take part in NervesJP, fukuoka.ex, EDI, tokyo.ex, Pelemay.
I hope someday you'll join us.

We Are The Alchemists, my friends!