有明のつれなく見えし別れより暁ばかりうきものはなし
Advent Calendar 2022 80日目1の記事です。
I'm looking forward to 12/25,2022
私のAdvent Calendar 2022 一覧。
はじめに
「データに関する記事を書こう!」と銘打たれたイベントが開催中です。
この記事は、 テーマ1 『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の応答が返ってきました
{"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
この記事では、 delika API Version 1をcurlでコールする方法を示しました。
Access Token
をどのように得るかがポイントだと考えます。
ドキュメントに書いてある通りと言えば、その通りです。
Access Token
は次の2ステップで取得します。
-
https://docs.delika.io/api/v1/get-auth.html にブラウザでアクセスしてSign inして、
Refresh token
を得る - 得た
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!