개발 경험 기록/기타2 직접 만나 본 하이럼의 법칙: 자체 제작 라이브러리의 의도치 않은 사용례와 그 해결 까지 소프트웨어 개발자라면 누구나 API를 설계하거나 라이브러리를 만들 때 사용자들이 우리의 의도대로 코드를 사용해주길 바랍니다.하지만 현실은 그렇게 단순하지 않죠.사용자가 많아질수록 우리가 예상하지 못한 방식으로 우리의 코드가 사용됩니다.이것이 바로 '하이럼의 법칙(Hyrum's Law)'의 핵심입니다.최근 제가 개발한 BridgeApi 라이브러리를 통해 하이럼의 법칙을 직접 경험하게 되었고, 이를 어떻게 인식하고 해결했는지 공유하고자 합니다.하이럼의 법칙이란?충분히 많은 수의 API 사용자가 있다면, 당신이 계약서에서 무엇을 약속했는지는 중요하지 않다. 당신의 시스템에서 관찰 가능한 모든 동작은 누군가에 의해 의존될 것이다.— 하이럼 라이트(Hyrum Wright)간단히 말해, 하이럼의 법칙은 사용자들이 .. 2025. 4. 6. 꼬리가 몸통을 흔든다 - RESTful 한 API 설계의 숨겨진 이점에 관한 글 - 꼬리가 몸통을 흔들다(WAG THE DOG) - 서양 속담RESTful API를 이야기할 때 우리는 주로 클라이언트 측면의 이점을 이야기합니다.직관적인 URL 구조, HTTP 메서드의 의미론적 사용, 명확한 리소스 중심 설계 등이 API 사용자들에게 주는 이점을 강조하죠.하지만 오늘은 다른 관점에서 RESTful API를 바라보고자 합니다.API를 설계하고 개발하는 우리들에게 RESTful API가 어떤 가치를 주는지, 어떻게 우리의 도메인 이해를 돕는지 이야기해보려 합니다.이는 제가 최대한 RESTful한 API를 작성해보려고 하는 과정에서, RESTful API 설계가 단순히 클라이언트에게 좋은 인터페이스를 제공하는 것 뿐 만 아니라, API를 개발하는 개발자에게 비즈니스 도메인에 대한 이해, 구조화.. 2024. 12. 12. 이전 1 다음 728x90