• ガイド
  • イントロダクション

クイックスタート

以下のガイドでは、Appテンプレートを利用した、Newtでのコンテンツ管理を紹介します。
Appの追加から、APIでの取得まで順を追って説明します。

ステップ1: Appを追加する

「Appを追加」をクリックして「テンプレートから追加」を選択します。

Appを追加する

表示されるテンプレートの中から「Blog」を選択して、「このテンプレートを追加」をクリックします。
Appテンプレート

テンプレートが追加されると、「投稿データ」「カテゴリデータ」「著者データ」が追加されます。

quick-start03.jpg

ステップ2: APIでデータを取得する

※ ここからはエンジニアの方向けの内容となります。
続いて、コンテンツをAPI経由で取得します。ここではステップ1で追加した「投稿データ」を取得してみましょう。
APIのエンドポイントは以下のようになっているため、まずスペースUIDを確認します。

https://{spaceUid}.cdn.newt.so/v1/{appUid}/{modelUid}

スペースUIDは「スペース設定」から確認できます。

quick-start0402.jpgquick-start0503.jpg

上記の例だと、スペースUIDは sample-for-docs となります。
「Blog」テンプレートを追加した場合、App UIDは blog、「投稿データ」モデルUIDは article となるため、スペースUIDが sample-for-docs の場合は、エンドポイントは https://sample-for-docs.cdn.newt.so/v1/blog/article となります。

続いて、APIリクエストに必要なトークンを発行しましょう。
「スペース設定」から「APIキー」を選択して、Newt CDN APIのトークンを作成します。

quick-start06.jpg

名前と取得対象を決めて「作成」を押します。

quick-start07.jpg
準備が終わったら、curlコマンドを利用してリクエストを送ってみましょう。

// Mac環境の場合
curl -H "Authorization: Bearer {YOUR_TOKEN}" \
  -X GET "https://{spaceUid}.cdn.newt.so/v1/{appUid}/{modelUid}"

// Windows環境の場合
curl -H "Authorization: Bearer {YOUR_TOKEN}" ^
  -X GET "https://{spaceUid}.cdn.newt.so/v1/{appUid}/{modelUid}"

この例の場合だと、以下のようなリクエストとなります。

// Mac環境の場合
curl -H "Authorization: Bearer kp7szZL_J9hDgrJ93OBS87MlTdkAzRofz2-ptMfiDec" \
  -X GET "https://sample-for-docs.cdn.newt.so/v1/blog/article"

// Windows環境の場合
curl -H "Authorization: Bearer kp7szZL_J9hDgrJ93OBS87MlTdkAzRofz2-ptMfiDec" ^
  -X GET "https://sample-for-docs.cdn.newt.so/v1/blog/article"

以下のようなレスポンスが返ってくれば成功です！

{
  "skip": 0,
  "limit": 100,
  "total": 3,
  "items": [
    {
      "_id": "61a81914c2e08900180c8b72",
      "_sys": {
        "model": "61a72b706a92970018736154",
        "owner": "61974a0112d75b0018cb97be",
        "raw": {
          "createdAt": "2021-12-02T00:53:40.048Z",
          "firstPublishedAt": "2021-12-02T00:53:40.048Z",
          "publishedAt": "2021-12-02T05:20:25.318Z",
          "updatedAt": "2021-12-08T15:25:43.845Z"
        },
        "createdAt": "2021-12-02T00:53:40.048Z",
        "updatedAt": "2021-12-02T05:20:25.318Z"
      },
      "title": "Fictitiousをクイックにスタートする方法",
      "slug": "article-3",
      "categories": [...],
      ...
    },
    ...
  ]
}
Newt Made in Newt