HTTP 상태 코드 HTTP 상태 코드(HTTP Status Code)는 서버가 요청 처리 결과를 3자리 숫자로 알려주는 신호입니다. 2xx 성공, 3xx 리다이렉트, 4xx 클라이언트 오류, 5xx 서버 오류로 크게 나뉘며 RFC 9110에 정의돼 있습니다.
TTFT (Time to First Token) TTFT (Time to First Token)는 사용자가 요청을 보낸 순간부터 첫 번째 토큰이 돌아오기까지 걸리는 시간입니다. LLM API의 응답 체감 속도를 결정하는 가장 중요한 지표예요.
REST API REST API는 HTTP 메소드(GET/POST/PUT/DELETE)와 리소스 지향 URL을 조합해 설계한 웹 API 스타일입니다. Roy Fielding이 2000년 박사학위 논문에서 정의한 REST(Representational State Transfer) 아키텍처 원칙을 따릅니다.
API 키 API 키(API Key)는 API 호출자가 누구인지, 어느 계정에 과금할지를 식별하기 위한 비밀 문자열입니다. 보통 HTTP 헤더(x-api-key, Authorization: Bearer …)에 실려서 요청마다 함께 전송됩니다.
JSON JSON (JavaScript Object Notation)은 키-값 쌍과 배열로 데이터를 표현하는 텍스트 기반 포맷입니다. 사람이 읽기 쉽고 기계가 파싱하기 쉬워서, 현대 웹 API의 사실상 표준 교환 포맷으로 자리잡았습니다.
HTTP POST 요청 HTTP POST 요청은 클라이언트가 서버에 데이터를 “제출”해 새로운 리소스를 만들거나 처리를 요청하는 HTTP 메소드입니다. GET이 URL만으로 데이터를 가져온다면, POST는 body에 JSON·form 같은 payload를 실어 보낼 수 있습니다.
Raw HTTP Raw HTTP는 SDK나 래퍼 없이 HTTP 프로토콜 그대로 요청을 조립해서 보내는 방식입니다. curl, requests, fetch 같은 도구로 메소드·URL·헤더·바디를 직접 세팅하는 거라, API가 실제로 어떻게 동작하는지 투명하게 보입니다.
SDK (Software Development Kit) SDK (Software Development Kit)는 특정 플랫폼이나 API를 쉽게 쓰게 해주는 언어별 라이브러리·도구 묶음입니다. HTTP 요청 직접 조립, 인증 헤더 세팅, 재시도, 에러 매핑 같은 반복 작업을 함수 한 줄 호출로 줄여줍니다.
SSE (Server-Sent Events) SSE (Server-Sent Events)는 서버가 한 개의 HTTP 연결을 유지하면서 클라이언트로 이벤트를 연속 푸시하는 프로토콜입니다. WebSocket처럼 양방향이 아니라 서버→클라이언트 한 방향 스트림이에요.