用Strapi 10分鐘就建好API(Strapi介紹-前篇)

來源: https://strapi.io/documentation/3.0.0-beta.x/getting-started/quick-start.html

前篇(快速入門)
中篇(概念架構介紹)
後篇(部署及設定)

Step 1. 在電腦上安裝Strapi

//cmd line
npm install strapi@beta -g

Step 2. 使用指令快速新建你的Strapi專案

(此快速建置的流程中，預設的資料庫為SQLite，可以在指令中另外選擇)

路徑: **/my-project

//cmd line
//my-project: 你的專案名稱
strapi new my-project --quickstart

成功後自動開啟註冊頁面

註冊一個最高層級使用者的帳號(此為開發模式，可以放心測試，帳號隨便註冊都可以)

註冊完成後就會看到admin儀表板頁面

Step 3. 建立和更新資料結構 Create a new Content Type

資料結構是擁有多個欄位以及資料的集合，接下來先新增Restaurant的資料結構試試看！

建立Restaurant的資料結構:

1. 新增資料結構:

• 點擊右上角的 +增加資料結構 的按鈕
• 在名稱中輸入 Restaurant
• 點擊 儲存
  

2. 儲存之後，馬上就可以新增欄位(Restaurant, Description)

點擊右上的新增欄位

首先設定餐廳的名稱

• 點擊字串
• 在基本設定中，名稱的輸入框輸入 Restaurant
• 在進階設定中，勾選必填欄位以及唯一欄位
• 點擊繼續
  
  
  

接著設定餐廳的描述

• 點擊文字
• 在基本設定中，名稱的輸入框輸入 Description
• 在進階設定中，勾選顯示視覺化編輯器(WYSIWYG)
• 點擊儲存

點擊右上角的儲存

建立Category的資料結構(返回建立和更新資料結構主頁面):

1. 新增資料結構:

• 點擊右上角的 +增加資料結構 的按鈕
• 在名稱中輸入 Category
• 點擊 儲存
  

2. 儲存之後，馬上就可以新增欄位(Category, 關聯)

點擊右上的新增欄位

首先設定Category的名稱

• 點擊字串
• 在基本設定中，名稱的輸入框輸入 Category
• 在進階設定中，勾選必填欄位以及唯一欄位
• 點擊繼續
  
  
  

接著設定Category的關聯

• 點擊關聯
• 在定義關係中，左邊的的輸入框輸入 restaurant，右邊的User-Permissions改為選擇Restaurant
• 中間很多條線的地方，選擇最右邊的圖示(多對多)，Categories 有而且屬於許多 Restaurants
• 點擊儲存

點擊右上角的儲存

Step 4. 為各個資料結構增添一點內容吧！

1. Restaurants: 點擊左上角的Restaurants

• 在Restaurant中輸入Strapi Restaurant
• 在Description中輸入Strapi restaurant is a cosy restaurant delivering one of the very fastest and nicest dining experiences in the world, combining nods to tradition with fierce modernity, warmth with daring.
• 點擊右上角的儲存

2. Categories: 點擊左上角的Categories

• 點擊右上角的建立新的Category

  • 在Category中輸入Convenient
  • 點擊右上角的儲存

• 再新增一筆！

  • 在Category中輸入Time Saving
  • 點擊右上角的儲存

• 將新增完的Categories，給Restaurant使用吧！

  • 點擊左上角回到Restaurant的頁面
  • 點選其中一筆Restaurant的資料，並編輯他
  • 在頁面右邊，Categories中，新增關聯 選擇你要與這筆資料關聯的category
  • 點擊右上角的儲存

Step 5. 設定 角色與權限

• 點擊左側擴充功能中的身份與權限
• 點擊Public
• 在權限區域中，將Restaurant以及Category的 find findOne 都勾選起來
• 點擊右上角的儲存

Step 6. 開心使用API~

專案的網址為 http://localhost:1337/

接著你可以在網址後面加上像是 /restaurants來使用restaurants的API

http://localhost:1337/restaurants

Image Not Showing Possible Reasons

• The image file may be corrupted
• The server hosting the image is unavailable
• The image path is incorrect
• The image format is not supported

Learn More →

使用graphQL需要另外安裝插件

//cmd line
strapi install graphql

http://localhost:1337/graphql

./extensions/graphql/config/settings.json

{
  "endpoint": "/graphql",
  "tracing": false,
  "shadowCRUD": true,
  "playgroundAlways": true,
  "depthLimit": 7,
  "amountLimit": 100
}