API 엔드포인트가 뭐야 — API로 들어가는 창구 주소

API 엔드포인트는 API에 요청을 보낼 때 찾아가는 구체적인 주소로, 기능마다 창구가 하나씩 있습니다.

2026년 7월 기준으로, AI에게 코드를 부탁하면 결과물에 /api/users 같은 주소가 심심찮게 등장합니다.

이 글을 읽으면 그 주소가 무슨 뜻인지, 왜 API 하나에 여러 개가 달려 있는지 감이 잡힙니다.

API가 하나의 큰 건물이라면, 엔드포인트는 그 건물 안의 개별 창구 주소입니다. 회원 업무는 회원 창구, 주문 업무는 주문 창구로 나뉘듯, 기능마다 주소가 따로 있습니다.

API를 한 줄로 복습하면

API는 프로그램끼리 정해진 방식으로 대화하도록 연결해 주는 규칙입니다.
쉽게 말하면 "이렇게 요청하면 이렇게 답해 줄게"라고 미리 약속해 둔 창구 같은 것입니다.
이 창구가 있어야 내 앱이 다른 서비스의 데이터를 가져오거나 기능을 빌려 쓸 수 있습니다.
API 자체가 처음이라면 먼저 읽고 오면 이 글이 훨씬 쉽게 읽힙니다.

엔드포인트는 결국 '창구 주소'입니다

API가 건물이라면, 엔드포인트는 그 안에서 특정 업무를 처리하는 창구 하나하나입니다.
건물 정문 주소만 알면 어디로 가야 할지 모르니, 창구마다 번호와 위치가 필요합니다.
웹에서 이 창구 위치는 URL 경로로 표시됩니다.

예를 들어 https://example.com/api/users에서 뒤에 붙은 /api/users 부분이 바로 회원 정보를 다루는 창구입니다.

즉 엔드포인트는 "이 주소로 요청을 보내면 이 기능이 응답한다"고 정해진 접속 지점입니다.

API 하나에 창구가 여러 개인 이유

은행 한 곳에 예금 창구, 대출 창구, 외환 창구가 따로 있는 것과 같습니다.
하나의 API 안에서도 다루는 업무가 다르면 창구를 나눠 둡니다.
회원을 조회하는 창구, 주문을 넣는 창구, 결제를 처리하는 창구가 각각 다른 주소를 가집니다.
이렇게 나눠 두면 요청을 보내는 쪽도 "무슨 업무를 원하는지"를 주소만으로 분명히 전달할 수 있습니다.

/api/users	회원 정보를 조회하거나 등록하는 창구
/api/orders	주문을 넣고 확인하는 창구
/api/payments	결제를 처리하는 창구

같은 창구에도 요청 방법이 나뉩니다

창구에 가서 "조회하러 왔다"와 "새로 등록하러 왔다"는 서로 다른 업무입니다.
엔드포인트도 마찬가지로, 같은 주소에 요청 방법을 함께 붙여 뜻을 구분합니다.
대표적으로 GET은 정보를 조회할 때, POST는 새 정보를 만들 때 씁니다.
그래서 아래처럼 방법과 주소를 같이 적으면 "회원 목록을 조회한다"는 뜻이 됩니다.

GET  /api/users   → 회원 목록 조회
POST /api/users   → 새 회원 등록

여기서는 이 정도만 알아도 충분하고, GET·POST의 세부 종류는 다음 기회에 따로 다루겠습니다.

그래서 AI랑 무슨 상관인가

AI에게 코드를 부탁하면 결과물에 fetch("/api/...") 같은 줄이 자주 들어갑니다.

이때 /api/ 뒤에 붙은 경로가 바로 "어느 창구를 부르는가"를 뜻합니다.

주소만 봐도 이 코드가 회원을 부르는지 주문을 부르는지 읽을 수 있습니다.
ChatGPT나 Claude 같은 AI 서비스를 코드로 붙일 때도 마찬가지로 정해진 엔드포인트로 요청을 보냅니다.
개인적으로는, 엔드포인트 개념 하나만 잡아도 AI가 준 코드가 훨씬 덜 무섭게 느껴진다고 봅니다.

정리하면

엔드포인트는 API라는 건물에서 업무별로 나뉜 창구 주소입니다.
기능마다 주소가 따로 있고, 같은 주소라도 GET·POST 같은 요청 방법으로 하는 일이 갈립니다.

AI가 준 코드에서 /api/ 뒤를 읽는 습관만 들여도 코드의 흐름이 훨씬 또렷해집니다.

---

자주 묻는 질문

엔드포인트와 API URL은 같은 말인가요?

거의 같은 맥락에서 쓰이지만, 정확히는 조금 다릅니다.
API URL은 건물 전체 주소에 가깝고, 엔드포인트는 그 안의 특정 창구까지 콕 집은 주소입니다.

/api/users처럼 기능이 붙은 경로가 엔드포인트라고 보면 편합니다.

엔드포인트 주소는 제가 마음대로 정하나요?

내가 서버를 직접 만든다면 경로를 정할 수 있습니다.
하지만 남의 API를 가져다 쓸 때는 그 서비스가 정해 둔 엔드포인트를 그대로 따라야 합니다.
주소를 잘못 적으면 "그런 창구는 없다"는 뜻의 오류가 돌아옵니다.
 
 

참고한 자료

API와 요청 방식의 기본 개념은 MDN 웹 문서(developer.mozilla.org)의 HTTP·API 관련 한국어 설명을 참고해 정리했습니다.