http

07
6月

HTTP API: 該如何管理一份很大的OpenAPI document?

OpenAPI的document文件可以變得非常大一份,特別是當你有好幾百個routes的時候, 這時候單一份的yaml檔管理起來可能會非常頭大,這篇文章將分享在這種情況下, 我是如何將一份大的檔案拆分成許多小的檔案,易於管理。 OpenAPI Specification OpenAPI也被稱為Swagger,是一個用來描述你的API的標準,可以根據這個標準來撰寫你的文件, 我想你應該很熟悉了,如果還不熟的, 可以先看看官方的說明: OpenAPI specification。 我如何拆分檔案 使用JSON格式 官網上的範例文件都是使用yaml,而我偏好使用JSON,
3 min read
14
4月
Pagination 是什麼?API 分頁設計完整指南

Pagination 是什麼?API 分頁設計完整指南

Pagination(分頁)是什麼?為什麼 API 需要分頁?完整介紹 Offset、Cursor 兩種分頁做法的差異與實作方式,讓你的 REST API 回應更快、體驗更好。
2 min read
09
4月

如何開始開發你的API: API first principle and OpenAPI

開發API應該要使用怎樣的流程,先定義好介面有哪些好處,以及可以使用哪些工具呢?(OpenAPI 3.0)
2 min read
18
3月

[Golang] 4種發起HTTP請求的方式

這篇文章將介紹如何使用golang作為http client,來發起http request,將介紹以下4種做法: * http.Get * http.Post * http.PostForm * http.NewRequest 一個HTTP Request message不外乎就是method、url、headers跟body,如果對於HTTP message還不熟悉的,
3 min read
01
11月
104人力網站爬蟲: 如何只用shell script來抓取資料

104人力網站爬蟲: 如何只用shell script來抓取資料

想要抓取網路上的資料,大家可能都會想到python爬蟲,但有時並不需要那麼麻煩, linux command line tool就有許多好用的工具, 今天以104人力網站的為例,示範如何只使用shell script,就可以開始抓取資料! 前言 這邊假設大家已經有網路爬蟲的基本概念了,一般大家寫爬蟲最多人用的就是python, 流程就是到目標網站上操作,並且一邊觀察chrome dev tool,將http requests用python的requests套件重現,
5 min read
14
10月

RESTful API: How to design paths and identify resources

繼上篇文章RESTful API簡介: 什麼是RESTful? 以及為何需要它?後, 我們知道了RESTful API是resource based的,今天講著重討論該如何設計resource,也就是HTTP URL中path的部分。 Resource based 每個URL都應該對應到一個或多個資源,使用那些使用者與你的服務互動時會需要用到的資源(名詞), 並使用HTTP Method來表明你想要對資源的操作(動詞),比如說你是一個網誌服務,
3 min read
27
9月
RESTful API簡介: 什麼是RESTful? 以及為何需要它?

RESTful API簡介: 什麼是RESTful? 以及為何需要它?

在web開發裡,API是幾乎無所不在,而其中最常見的應該就是基於HTTP協議的RESTful API, 這篇簡介跟討論到底什麼是RESTful,為何有它的出現? 這是RESTful API一系列文章中的一篇,想了解更多關於RESTful API及HTTP的,可以看這篇目錄: Introduction 首先,什麼是RESTful,可以說它是一種慣例,一個關於HTTP API如何設計的style, 慣例就是並沒有任何的強制性,但當大家都遵守的慣例時,特立獨行的邊緣人可能就會被排擠,
3 min read
13
9月
URL簡介: URL是什麼,由哪些部分組成?

URL簡介: URL是什麼,由哪些部分組成?

這篇文章將會介紹什麼是URL,為何會需要它,以及它是由哪些部分組成的。 什麼是URL 想像你在一座大城市裡,你搭上一部計程車,想要去你朋友家、你小孩的幼兒園、或是去某某旅館, 你必須告訴司機地址; 如果你想聯絡到某人的話,會使用電話號碼; 在政府眼裡每個人有身分證字號。 就像如此,每個東西都有它獨特的識別方法,而且是被大家所公認的,也就是你一說,大家就知道你在說什麼, 知道你所指的是哪個東西,而在網路上,
2 min read
05
9月

HTTP headers 簡介: 一些常用的headers

在HTTP協議中,headers對於每個request,response提供了一些額外的資訊,基本上他們就是只是一對key value pair,由冒號(:)隔開, 今天會看看HTTP協議的格式,header在其中的位置,以及介紹一些常用的header們。 HTTP messages HTTP是一個text based的傳輸協議,general的HTTP request message如下: <method&
5 min read
22
8月

Introduction to HTTP Response Status Codes: How to use them correctly?

這篇文章會介紹在HTTP協議中,Response status code的作用,有哪些codes以及該如何去使用他們? 這是RESTful API一系列文章中的一篇,想了解更多關於RESTful API及HTTP的,可以看這篇目錄: RESTful API Design — A practical guide Client Server Model HTTP是一個Client-Server的架構,
3 min read