我是一個產品API開發者
產品有 APP, 後台 , web 等三個方向,所以我的這個API的開發同時面向這三個不同的團隊。
APP Team 提到他們用那個DataModel的技術還是原因,總之不太希望我回傳回來的值是null
而昨天也有另外一個同事提到JSON 的spection 也提到,null 不應該回傳null, 而是 'null' (資料來源:https://www.json.org/json-en.html)
連true 或 false 都建議使用字串
不過這部分我就很好奇了?到底我們回傳null 是否合乎json 的spec?那這樣不是代表我們以前包含前人做的都是有問題的嗎 哈哈哈?
另外,一般來說我們看API 的時候都只有講到RESTful API的部分,還蠻少看到怎麼談API 內部應該如何規劃如何設計? 我應該如何精進自己?讓自己可以設計出很棒的API,滿足這三種不同面向的team?(當然,我覺得文件要寫清楚也是很需要的,所以希望答案不是強調說文件要寫好之類的,當然如果答案是寫好文件,那我也接受啦!)