Kite的筆記
0%

發表於 更新於 分類於
2k 4 分鐘

網路位址轉譯（Network Address Translation, NAT）可以改變封包的傳送端 IP 位址與接收端 IP 位址，減少真實 IP 的使用量，也可以將私有 IP（內部 IP）改變成真實 IP（外部 IP）再傳送到網際網路，只需要向網際網路服務供應商，例如：中華電信（2412-TW）申請一個真實 IP，就可以將公司內部所有的電腦連接到網際網路了，因此 NAT 伺服器是最重要的防火牆成員，也是一種「封包過濾器（Packet filter）」。

  • Cisco設備中，NAT會被應用在Cisco路由器上
閱讀全文 »

發表於 更新於 分類於
129 1 分鐘

Imperva 透過動態學習網頁Web服務的行為來保護這些應用，包括 XML檔、元件、屬性、架構、變數和簡單物件連結協定(SOAP)。Imperva將識別並阻止任何嘗試竄改正常Web服務的行為，還會抵禦應用程式中常見的威脅，如SQL注入、XSS、CSRF等。

image

發表於 更新於 分類於
366 1 分鐘

1. 課程理念及自我介紹

image

  • CCIE
  • CCNP
  • CCNA Cisco Certified Network Associate
  • CCENT
閱讀全文 »

發表於 更新於 分類於 ，
530 1 分鐘

1. 好處

1.1. 解耦了前後端的工作人員

讓前端和後端分別交給更擅長的人來做，細化了工種，可以更加的專精。前端人員來關心使用者體驗、UI設計、互動渲染；後端人員更關注業務邏輯、效能保障、安全等方面。在專案進度方面，前後端可以並行開發，而互不影響，加快了整體的專案進度。

閱讀全文 »

發表於 更新於 分類於
6k 11 分鐘

1. 前言

這項技術是由originally drafted by Yehuda Katz in May of 2013 提出的。一個概念或技術的出現往往都有它的目的與精神，整理如下

  • Its original goal was to create a communication model based around defined interactions,rather than leaning on per-application “ad-hoc” code

ad-hoc：「特設的、特定目的的、即席的、臨時的、將就的、專案的」

  • 官網

JSON:API is a specification for how a client should request that resources be fetched or modified, and how a server should respond to those requests.
JSON:API is designed to minimize both the number of requests and the amount of data transmitted between clients and servers. This efficiency is achieved without compromising readability, flexibility, or discoverability.

  • will 保哥

JSON 幾乎成為 Web 業界的標準傳輸格式，不過由於 JSON 的格式非常彈性，不少人光是為了爭辯 JSON 到底該長得怎樣而吵半天，我也好幾次被客戶「自訂」的 JSON 格式打敗，不但缺發一致性，更有前後版本相容性的問題，身為前端攻城獅的你能不在乎嗎？！
現在有了 JSON API 這份標準規格，可以幫助你**增加效率 (減少溝通)**、套用工具支援 (或現有函式庫)、並且讓你專注在你的應用程式開發上，不再為了 JSON 的長相而煩惱！
目前實作 JSON API 的函式庫很多了，有支援 ASP.NET WebAPI, Json.NET, 與 Entity Framework 的 JSONAPI . NET，其他還有 PHP, node.js, Ruby, Python, Go 都有相對應的 Server/Client 實作出現，使用上非常方便！

  • 自己的結語

    JSON APIs 的資料結構 很像是RMDBS 與SQL 的另一種形式呈現。

2. Client & Server Responsibilities

在client 跟server 都有一些職責在，大家都必須在 header 中聲明application/vnd.api+json

而JSON API 已經在IANA機構完成註冊囉，它的MIME 類型就是application/vnd.api+json

3. Document Structure

3.1. Top Level

MUST

  • data
  • errors
  • meta

MAY

  • jsonapi
  • links
  • included

Primary data MUST be either:

  • single resource object,resource identifier object, or null
  • an array of resource objects

Primary data MUST have type and id

可以想像成是資料表與資料的ID

3.2. Resource Objects

3.2.1. Identification

每一個RO(Resource Objects) 都必須要有id,type，且必須是字串

3.2.2. Fields

attributes ,relationships 在這邊統稱fields

3.2.3. Attributes

表達資料的資訊，可以想像是我們在資料表欄位

3.2.4. Relationships

MUST contain at least one

links

  • self

    1
    2
    3
    4
    5
    6
    7
    8
    9
    "relationships": {
      "author": {
        "links": {
          "self": "http://example.com/articles/1/relationships/author",
          "related": "http://example.com/articles/1/author"
        },
        "data": { "type": "people", "id": "9" }
      }
    }

    relationships 下的 links->self 可以想像是依據文章編號1的作者，再反推找到所有文章?

  • related

    1
    2
    3
    4
    5
    6
    7
    8
    9
    "relationships": {
      "author": {
        "links": {
          "self": "http://example.com/articles/1/relationships/author",
          "related": "http://example.com/articles/1/author"
        },
        "data": { "type": "people", "id": "9" }
      }
    }

    取得文章編號1的作者資訊?

data

此關聯資源的資料，一樣必須包含type,id

meta

3.4. Resource Linkage

3.5. JSON:API Object

1
2
3
4
5
{
  "jsonapi": {
    "version": "1.0"
  }
}

3.6. Compound Documents

To reduce the number of HTTP requests, servers MAY allow responses that include related resources along with the requested primary resources. Such responses are called “compound documents.

試著解釋以下文檔

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
{
  "data": [{
    "type": "articles",
    "id": "1",
    "attributes": {
      "title": "JSON:API paints my bikeshed!"
    },
    "links": {
      "self": "http://example.com/articles/1"
    },
    "relationships": {
      "author": {
        "links": {
          "self": "http://example.com/articles/1/relationships/author",
          "related": "http://example.com/articles/1/author"
        },
        "data": { "type": "people", "id": "9" }
      },
      "comments": {
        "links": {
          "self": "http://example.com/articles/1/relationships/comments",
          "related": "http://example.com/articles/1/comments"
        },
        "data": [
          { "type": "comments", "id": "5" },
          { "type": "comments", "id": "12" }
        ]
      }
    }
  }],
  "included": [{
    "type": "people",
    "id": "9",
    "attributes": {
      "first-name": "Dan",
      "last-name": "Gebhardt",
      "twitter": "dgeb"
    },
    "links": {
      "self": "http://example.com/people/9"
    }
  }, {
    "type": "comments",
    "id": "5",
    "attributes": {
      "body": "First!"
    },
    "relationships": {
      "author": {
        "data": { "type": "people", "id": "2" }
      }
    },
    "links": {
      "self": "http://example.com/comments/5"
    }
  }, {
    "type": "comments",
    "id": "12",
    "attributes": {
      "body": "I like XML better"
    },
    "relationships": {
      "author": {
        "data": { "type": "people", "id": "9" }
      }
    },
    "links": {
      "self": "http://example.com/comments/12"
    }
  }]
}

4. 參考資料

  1. JSON APIs en
  2. JSON APIs cn
  3. 聊聊 Spring HATEOAS
  4. 你的REST不是REST？
  5. 重新認識HTTP請求方法
  6. soap-vs-rest-vs-json
  7. Headless CMS: REST vs JSON:API vs GraphQL
  8. How Does JSON:API Compare To REST and GraphQL?
  9. SOAP vs REST vs JSON - a 2020 comparison
  10. REST 與JSON API 比較
  11. JSON API Server
  12. JSON API Client
  13. JsonApiDotNetCore
  14. JSONAPI 與 REST

發表於 更新於 分類於
7.5k 14 分鐘

1. 什麼是 API?

應用程式介面（英語：Application Programming Interface)

想像API是服務員，你來到了餐廳，看了菜單(API Doc)，點了你想要的項目(Request)。經過廚師的努力(Server)，服務員將菜端出來(response)給你。

閱讀全文 »