사용하려는 서비스의 URL을 구성하려면 다음 구조를 따라야 합니다:

웹 서비스를 그룹화하는 기본 URL입니다:

여기에는 먼저 해당 서비스가 가리키는 세그먼트를 추가하고, 그 다음에는 해당 쿼리를 정의하는 선택적 매개변수를 추가해야 합니다. 첫 번째 매개변수는 물음표(?), 등호(=), 그리고 매개변수 값 순서로 작성해야 합니다. 두 번째 매개변수부터는 물음표 대신 앰퍼샌드(&) 기호를 사용해야 합니다.

예시:

구조

봉투

모든 응답은 ‘envelope’(봉투, 포장)라고 불리는 구조 안에 담겨 있습니다. 이는 각 응답이 상호작용할 수 있는 미리 정의된 구조를 가지고 있음을 의미합니다.

{
  "Service": "서비스 이름",
  "Version": "서비스 버전",
  "TransactionId": "영문과 숫자로 구성된 트랜잭션 식별자",
  "Status": {
    "Code": "응답 코드",
    "Value": "응답 값"
  },
  "Data": {}
}

상태

핵심 상태 서비스 응답에 대한 정보를 얻기 위해 사용됩니다. 모든 과정이 정상적으로 진행되었다면, 응답은 속성에서 코드 200 또는 201입니다. 하지만 오류가 발생할 수도 있으며, 이 경우 다음과 같은 응답이 반환됩니다:

{
  "Status": {
    "Code": "401",
    "Value": "Unauthorized"
  }
}

인증

이 사이트에서 제공하는 웹 서비스를 이용하려면, 접근 인증 방식이 기본 방식이며, 이를 위해 MasterBase® 계정을 통해 발급받은 API 인증 정보(사용자 이름 및 비밀번호)를 사용해야 합니다.

이러한 기능의 사용은 서비스 이용 시 선택한 언어에 따라 달라지며, 이는 해당 서비스를 이용하는 사용자의 책임입니다.