협업의 시대, 우리는 어떤 API를 만들고 있을까?

현대 소프트웨어 개발은 개인의 작업이 아니라 많은 소프트웨어 엔지니어가 협업하여 결과물을 만들어 낸다. 협업에 있어서 중요한 것은 이들 간의 '신뢰할 수 있는 API'를 구축하는 것이다. API는 서로 다른 소프트웨어가 상호작용하는 연결점으로, 이를 설계하는 것은 협업의 핵심이자 신뢰성 있는 서비스를 제공하는 데 중요하다. API를 만들 때 테크 스펙과 함께 API 명세 작성을 가장 먼저 해야 한다. 이는 해야 할 일을 명확히 정의하고, 협업 시 발생하는 커뮤니케이션 비용을 줄여주는 역할을 한다. 그러나 시간이 지나면서 API 명세에 구현 내용 반영이 제대로 이루어지지 않아 오류가 발생하는 경우가 있다. 이를 해결하기 위한 세 가지 방안이 있다. 첫째, API 명세를 기반으로 코드를 생성하여 명세와 코드 사이의 차이를 없애기 둘째, GraphQL을 활용해 서버에서 실시간으로 쿼리 가능한 스키마 정보를 확인하고 필요한 데이터를 조회하기 셋째, 계약 테스트를 통해 API 소비자와 공급자 간의 규약이 정상적으로 지켜지는지 검증하기 어떤 방법을 선택하든 중요한 것은 API 명세를 'Single Source of Truth'로 취급하며 협업해야 한다. https://www.youtube.com/watch?v=BjvVfUQtsOs

401C 우린 같은곳을 바라보고 있을까요? - 박용권

www.youtube.com

401C 우린 같은곳을 바라보고 있을까요? - 박용권

다음 내용이 궁금하다면?

또는

이미 회원이신가요?

2023년 8월 2일 오전 12:41

댓글 0

    함께 읽은 게시물

    비개발자도 Cursor AI로 결제 가능한 웹 서비스 만들기 🚀

    6

    ... 더 보기

    비개발자도 Cursor AI로 결제 가능한 웹 서비스 만들기 🚀 (6차. 25.06.21, 25.06.28) - Learning by Doing

    Latpeed

    비개발자도 Cursor AI로 결제 가능한 웹 서비스 만들기 🚀 (6차. 25.06.21, 25.06.28) - Learning by Doing

    부족함에 대한 태도

    직장에서 다른 사람을 힘들게 하는 유형에도 여러 가지가 있는데, 그중 하나가 바로 완벽주의자다. 물론, 완벽을 추구하는 것이 나쁜 것은 아니다. 오히려 권장되기도 한다. 문제는 부족함을 대하는 태도에서 나온다. 완벽에 너무 집착한 나머지 부족함을 용납하지 못하는 정도가 되면 주변 사람들이 힘들어진다.

    ... 더 보기

    서버엔지니어의 시대적 고민

    ... 더 보기

    개발자 교양 팟캐스트

    A

    ... 더 보기

    무너지고 있는 프론트엔드, 백엔드 직군의 경계에 대한 고찰

    AI 기술이 우리 일상과 산업 전반에 스며들면서 소프트웨어 개발 환경 역시 큰 변화의 물결을 맞이하고 있다. 특히 코딩을 돕는 AI 에이전트의 등장은 개발 생산성에 대한 큰 변화를 만들고 있다. 나 역시 이러한 변화를 체감하며, 나에게 익숙한 소프트웨어 개발의 대표적인 두 축인 프론트엔드와 백엔드 영역에서 AI 기술이 미치는 영향과 그로 인해 변화하는 소프트웨어 엔지니어의 역할에 대해 개인적인 생각을 정리해 본다.

    ... 더 보기

     • 

    저장 35 • 조회 4,628


    🌎 해외에서 일하면 뭐가 좋을까요❓

    외국어를 사용해서? 돈을 더 많이 벌어서? 새로운 기회가 많아서? 글로벌 경력을 쌓을 수 있어서?

    ... 더 보기