LoginSignup
3
0

More than 1 year has passed since last update.

delika API Version 1 をcurlで呼び出してみる

Last updated at Posted at 2022-03-22

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

Advent Calendar 2022 80日目1の記事です。
I'm looking forward to 12/25,2022 :santa::santa_tone1::santa_tone2::santa_tone3::santa_tone4::santa_tone5:
私の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の応答が返ってきました :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は次の2ステップで取得します。

  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!

  1. @kaizen_nagoya さんの「「@e99h2121 アドベントカレンダーではありますまいか Advent Calendar 2020」の改訂版ではありますまいか Advent Calendar 2022 1日目 Most Breakthrough Generator」から着想を得て、模倣いたしました。

3
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0