Home
Jack's Blog
Cancel

API문서의 가독성과 파편화

API 문서는 가독성이 좋아야 하며 파편화는 피하자는 생각이 최근에 들었고 관련해 적어본 글이다. 정보를 제공하는 모든 문서는 독자의 추가적인 의문을 적게 만들어야 한다. 만약 A 서비스를 연동하기 위해 A 서비스의 API 문서를 본다고 하자. 요청 파라미터, 응답 바디, 에러메세지 등이 어떠한지 충분할 설명이 있다면 추가적인 소통없이 연동을 진행...

멱등 API는 왜 필요할까

이번 프로젝트를 진행하면서 멱등 API에 대해서 고민했다. 멱등성이란 동일한 연산이 여러번 수행되도 결과가 항상 같은 것을 의미한다. 예를 들면 절대값 함수가 있다. abs(abs(3))처럼 abs() 연산을 여러번해도 값은 3으로 동일하다. 그렇다면 멱등 API의 의미는 무엇일까. 동일한 request-key를 가진 요청이 여러번 호출되더라도 로...

글을 쓴다는 것

오랜만에 적어본다. 글은 쓰는 맛이 있어야 계속 쓰는 것 같다. 어떤 일이든 그렇겠지만 재미있다면 그보다 강력한 동기는 없다. 안 쓰다보니 계속 안 쓰게 된다. 그래서 한 문장이라도 남겨 보고 싶어 다시 적어본다. 개발자로 일하며 드는 생각이나, 삶을 살아가며 떠오르는 생각들 조금씩 다시 적어보자.

채사장의 글

최근에 해커와 화가라는 책 속에서 어렴풋 알고 있는 것을 누군가 언어로 분명하게 말해주면 이렇듯 마음이 편안해진다.라는 구절을 읽었다. 이 문장을 읽고 내가 바로 떠오른 사람은 채사장 작가이다. 채사장 작가는 쉬운 문장으로 어려운 개념을 잘 설명해준다. 내가 살아가며 느끼는 것들은 머릿속에 둥둥 떠있다. 그 걸 글로 적거나 누군가에게 설명하는 건 ...

Harry Styles의 Love Of My Life

알고리즘이 틀어준 노래, Harry Styles의 Love Of My Life를 듣다가 목소리가 절절하고 멜로디가 좋아서 반복해서 들었다. 어떤 내용일까 찾아보니 누군가를 그리워하는 가사였다. 그때를 추억하며 누군가를 절절히 그리워하는 내용. 노래 중 이런 가사가 있다. not the same anymore 이제 함께 할 수 없는 사람과 추억이 ...

맞춤법 검사기 개발

최근에 블로그를 다시 시작하면서 필요했던 프로그램이 맞춤법 검사기였다. 글 작성하고 복사해서 맞춤법 검사기에 돌리고 틀린 것을 다시 수정하는 작업이 꽤나 귀찮았다. 맞춤법 API를 검색하다가 네이버 맞춤법 검사기를 이용해서 만든 라이브러리가 있었다. 감사하게도 깃허브에 코드가 공개되어 있어서 자바 프로그램으로 다시 작성했다. 파이썬 라이브러리를 그...

즐기는 개발자가 되고 싶다

대학교 졸업하고 시작했던 개발 공부는 재미보다는 생존을 위해 했다. 개발자로 커리어를 시작해야 한다는 압박감이 시간의 부족함을 매번 느끼게 했다. 빨리 배워서 취업해야 하는데..라는 생각을 많이 했다. 그러다보니 내가 배우는 개발 지식들은 미리 방향이 정해져있었다. 효율적인 커리큘럼과 취업에 도움되는 개발 지식들. 만약 내가 무언가를 만드는 개발의 ...

되고 싶은 개발자

최근 유닉스의 탄생과 해커, 광기의 랩소디라는 책을 읽고 있다. 내가 되고 싶은 개발자의 모습이 한 가득 담긴 책이었다. 필요하면 만드는 개발자들. 나는 어느 순간 주어진 회사 업무만 쳐내는 개발자가 된 것 같다. 이대로는 너무 아쉽다. 꿈꾸던 모습이 있는데, 그렇게 되지 못한다는 것은 슬픈 일이다. 필요하면 만들고, 주도적으로 학습하는 개발자가 되...

하나의 챕터를 마치고

글은 나를 표현하는 행위입니다. 컴퓨터 공학와 전혀 상관없는 전공을 졸업했다. 그리고 개발자로 커리어를 시작하기 위해 준비했던 시기가 막 끝났다. 이제는 개발자로서 성장하는 이야기가 담길 다른 챕터가 시작된다. 합격 소식을 주변 지인들에게 전했다. 다들 축하해주며 출근은 언제냐 물었다. 바로 다음주 월요일이라 전하니 대부분 왜이리 빨리 가냐며 아쉬...

다시 한번 거잠포구를 갔다

글은 나를 표현하는 행위입니다. 다시 한번 거잠포구를 갔다. 올해 새해를 보고 싶어 찾아 갔던 곳이다. 개발자를 준비하기로 했던 마음을 다잡기 위해서였다. 당시 코드스쿼드를 합격한 상황이었고 올 한 해 꾸준히 달려야겠다는 마음이 가득했다. 비록 날씨가 좋지 못해 새해는 제대로 보지 못했다. 그 때 들었던 생각을 정리한 글이 일출이 치트키는 아니다이다...

Trending Tags