or
or
By clicking below, you agree to our terms of service.
New to HackMD? Sign up
Syntax | Example | Reference | |
---|---|---|---|
# Header | Header | 基本排版 | |
- Unordered List |
|
||
1. Ordered List |
|
||
- [ ] Todo List |
|
||
> Blockquote | Blockquote |
||
**Bold font** | Bold font | ||
*Italics font* | Italics font | ||
~~Strikethrough~~ | |||
19^th^ | 19th | ||
H~2~O | H2O | ||
++Inserted text++ | Inserted text | ||
==Marked text== | Marked text | ||
[link text](https:// "title") | Link | ||
 | Image | ||
`Code` | Code |
在筆記中貼入程式碼 | |
```javascript var i = 0; ``` |
|
||
:smile: | ![]() |
Emoji list | |
{%youtube youtube_id %} | Externals | ||
$L^aT_eX$ | LaTeX | ||
:::info This is a alert area. ::: |
This is a alert area. |
On a scale of 0-10, how likely is it that you would recommend HackMD to your friends, family or business associates?
Please give us some advice and help us improve HackMD.
Do you want to remove this version name and description?
Syncing
xxxxxxxxxx
Wikidata 入門筆記 3 - API與工具
tags:
Wikidata
Style - Wikidata
(以書本模式瀏覽)
如果你只是想要撰寫 bot,可以跳過這篇
關於工具
Wikidata:Tools 有很多工具可以玩,不過大多年久失修
開發者可以在 GitHub 找到一些不錯的套件,例如 這個CLI工具
我們也正在開發 Golang 寫成的 client 以及能將 SPARQL Query 圖像化的網頁服務,如果你有興趣參與,歡迎聯絡 Wikidata Taiwan 社群
先備知識
因為 API 偏向開發者需要知道的
所以以下假設你知道:
了解以下的東西可能有助於理解接下來介紹的 API,但非必要
概觀
參考連結:Wikidata:Data access
以下我們將介紹四種方法
Special:EntityData
透過 special page 提供的介面取得格式化的資料
例如 李梅樹(Q700797) 的 json檔
Wikibase API
Wikibase 是支撐 wikidata 的套件
他提供了許多 API 來存取資料
SPARQL query
Query service 除了前面提過的 GUI 介面以外
也提供了 API 端口
完整 dump
將整個 wikidata 資料庫載下來
Linked Data interface
你可以透過特定 URL 直接下載各種格式的資料
wikidata 提供了這個 namespace 作為端口:
\(\quad\) https://www.wikidata.org/wiki/Special:EntityData
HTTP GET
GET 參數:
例如 地球(Q2) 的 json 檔:
instance of (P31) 的 turtle 檔:
revision 是指定版本號用的
你可以在左側的「永久連結(Permanent Link)」或是編輯紀錄裡找到指定版本的永久連結
並在網址列找到 oldid 的值
例如 學生計算機年會(Q19851407) 最早版本的永久連結是
\(\qquad\) https://www.wikidata.org/w/index.php?title=Q19851407&oldid=214218139
其中 oldid 為 214218139
使用起來大概長這樣:
再簡單一點
Q 或 L 開頭的 entity 有更簡短的作法
只要加上
/id.format
就行了以 李梅樹(Q700797) 為例:
\(\qquad\) https://www.wikidata.org/wiki/Special:EntityData/Q70797.json
或是用:https://www.wikidata.org/entity/Q70797.json
它會重新導向到 Special:EntityData 那個連結
Wikibase API
MediaWiki API
MediaWiki 提供了海量的 API
所有 Wikimedia 的網站都以
/w/api.php
做為 API 端口例如:
如果沒有傳送任何參數(例如直接用上面的 URL)
會看到 help 頁面
Wikibase
Wikidata 仰賴 Wikibase(一個 MediaWiki 的 extension)
比對一下 Wikipedia 和 Wikidata 的 api 頁面
可以發現 Wikidata 的頁面多出了一些以
wb
為前綴的 api這些就是 Wikibase 的 api
API 使用範例
以下以兩個實用 API 作為範例
wbgetentities
這個 API 能取得一個或多個 entity 的資料
\(\qquad\) api.php?action=wbgetentities&ids=Q42
\(\qquad\) api.php?action=wbgetentities&ids=Q42|P17
\(\qquad\) api.php?action=wbgetentities&ids=Q42|P17&format=json
wbsearchentities
這個 API 能用文字搜尋 entity
實作 - query
工具安裝 - openssl
以 debian/ubuntu 為例
輸入
sudo apt install openssl
來安裝 openssl不想用 terminal?
你也可以用瀏覽器直接 GET
以下的範例只要把 Host 和 Path 接起來,貼到瀏覽器的網址列就行了
不過這樣你可能沒辦法指定 Accept 的格式
SPARQL Query (1) - 透過 Query Service
Query 的時候你有兩種選擇
一種是用
/w/api.php
提供的 API一種是用 Query Service 提供的服務
以下先介紹 Query Service 的部分
準備好要 Query 的 SPARQL code
↗ Open in Query
為了方便看整個結果,Limit 調得比較小
在 Query Service 裡打開 code

/sparql?query=
後面這段是 Encode 過的 query code可以看到他是使用 GET 進行 query 的
接下來要寫一個 GET 請求
HTTP GET 的請求內容大概會長這樣
雖然我們這裡是用 https,但是 http header 的部分還是一樣的
加密是底下 (TLS) 做的事情
第一行就是請求方法、路徑、HTTP 版本
從第二行開始是各種欄位
格式大致長這樣:
<欄位>: <值1>,<值2>
Host 是必須欄位,填入伺服器的域名
Accept 表示 Client 端能解讀什麼格式的內容,供 server 端參考
目前我們只會用到這兩個欄位
接著來製作 header
基本上就是把剛才那段網址中,網域後的部分整個放到路徑
Host 這裡只需要網域,不要填
https://
或是後面(斜線後)的路徑Accept 部分目前有幾種支援的格式
可以參考 這裡
最後可以來 Query 了
在的 terminal 裡輸入
接著成功連線後輸入 header
成功的話可以看到 Reply header 和內容
json 的內容會長像這樣:
CSV 的內容:
實作 - Search Entities
Search Entities
例如想用關鍵字搜尋項目
wbsearchentities 這個 api 可以幫我們
同樣的先用 openssl 連上 www.wikidata.org:443
傳送請求:
這次格式的指定變成用 GET 的參數傳了

在那張 海量 API 表格底下可以找到 format 支援的內容
完整 dump
Wikidata:Database download