API Contracts define the formal agreement between an API provider and its consumers, specifying how they interact, what data they exchange, and how to handle success or failure. Contracts describe API behavior, including request formats, HTTP methods, and expected responses. For example, the API contract for retrieving a Cash Card would specify that a GET request to /cashcards/{id} returns the card's details in JSON format if the request is successful (200 OK), or an error if not (e.g., 401 Unauthorized or 404 Not Found).

Why API Contracts Matter: API contracts help both the provider and consumer understand how to interact with each other and can be turned into automated tests to ensure everything works as expected. These contracts are essential in ensuring consistent API behavior.

JSON (JavaScript Object Notation) is a lightweight and widely-used data interchange format for APIs. JSON is human-readable, compact, and works well with most modern programming languages. It's preferred over XML for web-based APIs due to its simplicity and performance.

Key Points:

• API Contracts: Agreements between providers and consumers on how an API behaves.
• Request Example: A GET request to /cashcards/{id} returns JSON data like { "id": 99, "amount": 123.45 }.
• JSON: A lightweight, readable format commonly used in APIs.

• *API 계약(API Contracts)**은 API 제공자와 소비자 간의 상호작용 방식을 정의하는 공식적인 합의입니다. 이 계약은 요청 형식, HTTP 메서드, 예상 응답 등을 포함하여 API의 동작을 명확히 규정합니다. 예를 들어, Cash Card를 조회하는 API 계약에서는 /cashcards/{id}로 GET 요청을 보내면 JSON 형식으로 카드를 반환하며, 성공 시 200 OK, 오류 시 401 Unauthorized 또는 404 Not Found 상태 코드를 반환합니다.

API 계약의 중요성: API 계약은 제공자와 소비자가 서로 어떻게 상호작용해야 하는지를 명확히 하며, 자동화된 테스트로 쉽게 전환할 수 있어 안정적인 API 작동을 보장합니다.

• *JSON (JavaScript Object Notation)**은 경량의 데이터 교환 형식으로, 가독성이 좋고 대부분의 프로그래밍 언어와 호환됩니다. XML보다 간단하고 성능이 우수해 현대 API에서 많이 사용됩니다.

핵심 사항:

• API 계약: API 제공자와 소비자 간의 상호작용에 대한 합의.
• 요청 예시: /cashcards/{id}에 대한 GET 요청으로 { "id": 99, "amount": 123.45 } 같은 JSON 데이터를 반환.
• JSON: 가볍고 읽기 쉬운 API 데이터 형식.