Skip to Content
API 아키텍처 마스터링
book

API 아키텍처 마스터링

by James Gough, Daniel Bryant, Matthew Auburn
May 2025
Beginner to intermediate
288 pages
4h 24m
Korean
O'Reilly Media, Inc.
Content preview from API 아키텍처 마스터링

1장. API 설계, 빌드 및 지정

이 작품은 AI를 사용하여 번역되었습니다. 여러분의 피드백과 의견을 환영합니다: translation-feedback@oreilly.com

API를 설계하고 구축할 때 많은 옵션이 제공됩니다. 최신 기술과 프레임워크로 서비스를 구축하는 것은 매우 빠르지만 내구성 있는 접근 방식을 만들려면 신중한 생각과 고려가 필요합니다. 이 장에서는 사례 연구에서 생산자와 소비자 관계를 모델링하기 위해 REST와 RPC를 살펴봅니다.

표준이 어떻게 설계 결정을 단축하고 잠재적인 호환성 문제에서 벗어나는 데 도움이 되는지 알아보세요. OpenAPI 사양, 팀을 위한 실제 사용 방법, 버전 관리의 중요성에 대해 살펴봅니다.

RPC 기반 상호 작용은 스키마를 사용하여 지정되며, REST 접근 방식과 비교 및 대조하기 위해 gRPC를 살펴보겠습니다. REST와 gRPC를 모두 염두에 두고 거래소 모델링 방식에서 고려해야 할 다양한 요소를 살펴보겠습니다. 동일한 서비스에서 REST와 RPC API를 모두 제공할 수 있는지, 이것이 올바른 방법인지 살펴볼 것입니다.

사례 연구: 참석자 API 설계하기

소개에서 우리는 레거시 컨퍼런스 시스템을 마이그레이션하고 API 중심 아키텍처로 전환하기로 결정했습니다. 이러한 변화를 위한 첫 단계로 새로운 참석자 서비스를 만들어 일치하는 참석자 API를 노출할 것입니다. 또한 API의 좁은 정의를 제공했습니다. 효과적으로 설계하려면 생산자와 소비자 간의 교환, 더 중요한 것은 생산자와 소비자가 누구인지 더 넓게 고려해야 합니다. 생산자는 참석자 팀이 소유하고 있으며, 생산자는 참석자 팀에 속합니다. 이 팀은 두 가지 주요 관계를 유지합니다:

  • 참석자 팀은 생산자를 소유하고 기존 회의 팀은 소비자를 소유합니다. 이 두 팀 사이에는 긴밀한 관계가 있으며 구조의 변경이 쉽게 조율됩니다. 생산자/소비자 서비스 간의 강력한 응집력을 달성할 수 있습니다.

  • 참석자 팀은 생산자를, 외부 CFP 시스템 팀은 소비자를 소유하고 있습니다. 팀 간에 관계가 있지만 통합을 깨지 않도록 모든 변경 사항을 조정해야 합니다. 느슨한 연결이 필요하며 변경 사항을 깨는 것은 신중하게 관리해야 합니다.

이 장에서 참석자 API를 설계하고 구축하는 접근 방식을 비교하고 대조해 보겠습니다.

REST 소개

REST(표현 상태 전송) 는 일련의 아키텍처 제약 조건으로, 기본 전송 프로토콜로 HTTP를 사용하여 가장 일반적으로 적용됩니다. 로이 필딩의 논문 "아키텍처 스타일과 네트워크 기반 소프트웨어 아키텍처의 설계" 에서 REST에 대한 완전한 정의를 제공합니다. 실용적인 관점에서 볼 때 RESTful로 간주되려면 API가 다음을 보장해야 합니다:

  • 생산자와 소비자 간의 상호 작용은 생산자가 소비자가 상호 작용할 수 있는 리소스를 모델링하는 방식으로 모델링됩니다.

  • 생산자에서 소비자로의 요청은 상태가 저장되지 않으므로 생산자는 이전 요청의 세부 정보를 캐시하지 않습니다. 특정 리소스에 대한 요청 체인을 구축하려면 ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

AirBnbBlueOriginElectronic ArtsHomeDepotNasdaqRakutenTata Consultancy Services

QuotationMarkO’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.
Julian F.
Head of Cybersecurity
QuotationMarkI wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.
Addison B.
Field Engineer
QuotationMarkI’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.
Amir M.
Data Platform Tech Lead
QuotationMarkI'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.
Mark W.
Embedded Software Engineer

You might also like

MLOps 도입 가이드

MLOps 도입 가이드

데이터이쿠
자바스크립트 + 리액트 디자인 패턴

자바스크립트 + 리액트 디자인 패턴

애디 오스마니(Addy Osmani)

Publisher Resources

ISBN: 9798341653610