The Minitab Connect API

Minitab Connect 버전 3 API는 외부 소스에서 연결하는 것이 그 어느 때보다 쉬워졌습니다. API 호출 생성 Minitab Connect 에 더 단순하고 직관적인 접근법을 적용하면 모든 수준의 숙련도가 접근할 수 있습니다.

API 요청 개요

각 엔드포인트는 공유 값과 고유 값을 포함하는 특정 속성 목록을 가지고 있으며, API 버전 3 검색 요청을 사용해 검색할 수 있습니다. 엔드포인트의 속성 목록을 받으려면, 간단한 API 버전 3 요청을 작성하세요. API 버전 3의 엔드포인트 속성 요청은 기본 URL, 엔드포인트, API 키 세 가지 기본 정보만 필요합니다.

참고

단일 사용자는 초당 20회, 분당 1,000회 이상으로 API 요청을 할 수 없습니다. Connect 구독 중인 모든 사용자는 초당 200건, 분당 10,000건을 초과할 수 없습니다.

기본 URL

기본 URL은 특정 API 요청과 상관없이 동일합니다. 기본 URL을 결정하려면, 로그인 Minitab Connect할 때 사용하는 URL을 복사하면 됩니다. 예를 들어, https://connect.minitab.com 를 사용해 에 접근 Minitab Connect한다면, 모든 API 요청의 기본 URL은 https://connect.minitab.com/api/3/입니다.

종착점

요청이 상호작용하려는 객체 또는 객체 집합을 나타냅니다. 위 예시에서 '예제 API 요청'의 엔드포인트는 'Source'입니다. 이로 인해 API 요청이 '소스' 데이터 객체를 조작하도록 특별히 설계된 액션으로 제한됩니다.

예를 들어, https의 엔드포인트 : connect.minitab.com/Source/?apikey=12478781287471824&action=search&arg=[{"name":"Campaigns"}] 는 '출처'입니다. 이로 인해 API 요청으로 할 수 있는 일이 '소스' 데이터 객체를 조작하도록 특별히 설계된 액션으로 제한됩니다.

엔드포인트 GUID

엔드포인트 GUID는 . 내 Minitab Connect특정 데이터 객체를 나타내는 고유 식별자입니다. GUID는 고유한 문자열로 구성되며, 때때로 '키(Key)'라고도 불립니다. GUID Minitab Connect를 찾으려면 원하는 객체의 모달을 편집 엽니다. 엔드포인트 GUID가 모든 API 요청에 필수는 아닙니다. 예를 들어, 검색 작업을 수행하는 API 요청은 엔드포인트 GUID를 누락합니다.

API 키

이 API 요청 부분은 시스템에 해당 요청이 지정된 사용자와 동일한 권한으로 처리되어야 함을 알립니다. 이 부분은 항상 GUID로 표현됩니다. API 키는 특정 사용자 Minitab Connect와 연관된 고유한 문자열입니다. GUID를 찾으려면 먼저 시스템에 로그인하세요. 다음으로 버튼을 열 사용자 어

오른쪽 계정 설정상단에서 선택하세요. 사용 가능한 API 키 목록과 새로운 키를 생성할 수 있는 기능이 나열되어 있습니다. (이 예시에서는 더미 API 키가 보안 목적으로 사용됩니다)

인증

시스템에 지정된 사용자와 동일한 권한으로 요청이 처리되어야 한다고 알립니다. 인증은 API 키로 표현됩니다. API 키는 도구 내 기능에 접근하기 위해 생성되는 고유한 문자 문자열입니다. API 키를 생성하려면 버튼을 열어 사용자

오른쪽 계정 설정상단에서 선택하세요. 자세한 내용은 API 토큰 생성(으)로 이동하십시오.

작업

지정된 엔드포인트에 대해 어떤 행동을 취할지 지정합니다. 행동은 보통 다음과 같이 분류됩니다:

득점자들: 게터 액션은 시스템에서 데이터를 추출하는 데 사용됩니다. 각 끝점은 고유한 게터 집합을 가지고 있습니다. 게터를 사용하려면 올바른 형식이 다음과 같습니다: action= 여기서 는 원하는 게터의 이름으로 대체됩니다.
세터: 세터 액션은 시스템에 데이터를 가져오거나 데이터 객체의 속성을 설정하거나 변경하는 데 사용됩니다. 각 끝에는 고유한 세터 세트가 있습니다. 세터를 사용하려면 올바른 포맷이 있습니다: action=&arg= 이며, 여기서 는 원하는 세터의 이름으로 대체되고 는 설정할 값입니다.
행동: 액션은 게터의 특성을 충족하지 않는 데이터 객체의 프로세스, 특징 또는 명령에 사용됩니다. 행동의 한 예는 테이블에 필드를 추가하는 것입니다. 각 행동마다 요구사항이 다릅니다. 예를 들어, 어떤 행동은 인수가 필요 없으며 getter와 같은 형식으로 구성되어 있습니다. 다른 동작들은 논항이 세터처럼 형식화되어야 합니다.
검색: 검색은 특정 매개변수 집합을 충족하는 엔드포인트에서 데이터를 얻기 위해 사용됩니다. 검색은 무한한 수의 검색어를 가질 수 있으며 배열로 형식화됩니다. 예를 들어: action=search&args=[{"fname":"John","lname":"Smith"}] 는 [ "fname" (이름)이 "John" 이고 "lname" (성)이 "Smith"인 경우에만 기록을 반환합니다. 검색어는 키와 값 구조에 맞고 쉼표로 구분되어 있으면 얼마든지 사용할 수 있습니다.
참고
API 검색 요청에 값을 추가할 때는 텍스트 문자열이 따옴표 안에 있어야 합니다.

여러 동작을 포함하는 API 요청을 할 수 있습니다. 이를 위해 각 행동을 앰퍼샌드('&')로 구분하세요. 예를 들어, ID가 15인 사용자의 이름, 중간 이름, 성을 변경해야 합니다. 요청은 다음과 같습니다:

https://connect.minitab.com/api/3/User/15?apikey=45a3d34982e&action0=setFName&arg0=John&action1=setMName&arg1=D&action2=setLName&arg2=Smith

이 요청은 ID가 15인 사용자의 이름은 "John", 중간 이름은 "D" , 성을 "Smith" 로 설정합니다.

참고

단일 API 요청에서 여러 액션을 사용할 경우, 액션은 반드시 증가해야 합니다. 첫 번째 행동과 논증은 0 또는 1을 덧붙일 수 있습니다. 각 추가 행동 그룹은 1배씩 증가해야 합니다.

엔드포인트의 모든 작업을 반환하기 위한 API 요청

언제든지 특정 엔드포인트에서 사용 가능한 모든 작업 목록을 반환하는 API 요청을 할 수 있습니다. 요청은 다음과 같습니다:

https://connect.minitab.com/api/3/[endpoint]/?apikey=[apikey]

엔드포인트 를 특정 엔드포인트로 교체하고, apikey 를 실제 API 키로 교체하세요. 엔드포인트의 모든 액션과 모든 속성을 포함하는 JSON 객체가 반환됩니다.

현재 종착 및 설명

언제든지 모든 엔드포인트 목록을 반환하는 API 요청을 할 수 있습니다. 요청은 다음과 같습니다:

https://connect.minitab.com/api/3/?apikey=[apikey]

apikey 를 실제 API 키로 교체하세요. 모든 사용 가능한 엔드포인트 목록을 포함하는 JSON 객체가 반환됩니다. 현재 사용 가능한 종점들은 다음과 같습니다:

AutoImportConf: 자동 가져오기 구성 (자동 가져오기 마법사 Minitab Connect로 정의됨)를 생성, 읽기, 상호작용하세요.
블롭: 'file' 필드 타입 Minitab Connect으로 저장된 파일을 저장하고 가져와요.
비즈니스룰: 비즈니스 규칙을 만들고, 보고, 상호작용하세요.
비즈니스룰그룹: 비즈니스 규칙 그룹을 생성, 조회, 상호작용하세요.
비즈니스룰트리거: API 요청이 새로운 비즈니스 규칙 트리거를 생성하거나 기존 비즈니스 규칙 트리거를 읽기, 수정, 삭제 또는 실행할 수 있도록 허용합니다.
연결: API 요청이 새로운 연결을 생성하거나 기존 연결을 읽고, 수정하며, 삭제할 수 있도록 합니다.
고객: API 요청이 새로운 고객을 생성하거나 기존 고객을 읽고, 수정하며, 삭제할 수 있도록 허용합니다.
대시보드: API 요청이 새로운 대시보드를 생성하거나 기존 대시보드를 읽기, 수정 또는 삭제할 수 있도록 허용합니다.
DashboardElement: API 요청이 새로운 대시보드 요소를 생성할 수 있도록 허용합니다. 또한 기존 대시보드 요소를 읽거나 수정하거나 삭제할 수 있습니다.
에러 로그: 오류 기록을 읽어보세요.
필드 포맷: API 요청이 시스템 정의 필드 형식과 상호작용할 수 있도록 허용합니다. 예를 들어, 텍스트 필드는 URL 형식을 가질 수 있습니다.
필드 타입: API 요청이 새로운 커스텀 필드를 생성하거나 기존 커스텀 필드를 읽거나 수정하거나 삭제할 수 있게 합니다.
필드타입트리거: API 요청이 새로운 필드 유형 트리거를 생성하거나 기존 필드 유형 트리거를 읽기, 수정, 삭제 또는 실행할 수 있도록 합니다.
FileImporterLocations: 파일을 가져오는 스케줄러가 사용하는 위치를 새로 만들거나 읽거나 상호작용하세요.
플로우: 플로우와의 상호작용을 가능하게 합니다. 플로우를 생성, 수정, 삭제할 수 있습니다. 버전 3 API를 통해 플로우 데이터를 가져오고 수동으로 플로우를 실행할 수 있습니다.
형태: 새 폼을 만들고, 기존 폼을 수정하거나 삭제하세요. API를 통해 폼 데이터를 조회할 수 있습니다.
폼 요소: API 요청이 새로운 폼 요소를 생성할 수 있게 합니다. 또한 기존 폼 요소를 읽거나 수정하거나 삭제할 수 있습니다.
작업: 새로운 일자리를 창출하세요.
KVStore: 키값 저장을 위해서요. 엔드포인트는 키-값 쌍을 생성, 수정, 읽기, 삭제할 수 있게 합니다.
매시업: 내부 시스템 사용을 위해서입니다.
퍼포먼스 로그: 성과 기록을 읽어보세요.
플러그인: API 요청이 기존 플러그인을 수정하고 플러그인 데이터를 읽을 수 있게 합니다(사용 가능한 플러그인 목록 포함).
프로필로그: 프로파일러의 역사를 읽어보세요.
SavedAPI: 컨트롤 저장 내보내기.
출처: 소스(표)와 상호작용하세요. 새로운 테이블을 생성할 수 있습니다. 기존 테이블은 수정, 읽기 또는 삭제할 수 있습니다.
소스차트: 차트를 생성, 읽기, 수정 또는 삭제할 수 있습니다.
출처 조건부: 테이블의 조건부 서식을 생성, 수정 또는 삭제하세요.
출처연결(SourceConnection): 테이블에 연결된 소스 연결을 읽거나 수정하세요.
SourceExportOption: 저장된 내보내기 커넥터 설정을 생성하고, 읽고, 상호작용하세요.
소스필드: 테이블 필드를 생성, 수정 또는 삭제할 수 있습니다.
소스인터페이스: 테이블 데이터와 상호작용하세요. 데이터 행을 삽입, 업데이트, 삭제, 내보내기, 읽기.
출처조인: 조인드를 사용하세요. 이는 매시업 테이블을 생성하거나 편집할 때 표시되는 "add join" 대화 창과 일치합니다. 거기서 생성된 각 항목은 고유한 ID를 가진 단일 "조인"이 있습니다.
출처 주석: 표 노트를 생성, 읽기, 수정 또는 삭제하세요.
출처 프로필: 프로파일러가 만든 프로필을 생성, 읽기, 또는 상호작용하세요.
출처 통계 기록: 표의 과거 통계(크기, 기록 등)를 읽어보세요.
소스템플릿: 테이블 템플릿을 만들거나, 읽거나, 수정하세요.
출처 유형: 폴더와 상호작용하세요. 새 폴더를 생성할 수 있습니다. 기존 폴더는 수정, 읽기 또는 삭제할 수 있습니다.
출처: 조회수와 상호작용하세요. 새로운 뷰를 생성할 수 있습니다. 기존 뷰는 수정, 읽기 또는 삭제할 수 있습니다.
통계: 고객 통계를 생성, 읽기, 수정 또는 삭제할 수 있습니다.
테마: 주제를 만들고, 읽고, 수정하거나 삭제하세요. (폼, 대시보드, UI).
트리인포: 트리 임포터가 내부적으로 사용합니다. 시스템 사용만 가능합니다.
사용자: 사용자와 상호작용하세요. API 요청이 사용자를 생성, 읽기, 수정 또는 삭제할 수 있도록 허용합니다.
사용자 유형: 시스템 거버넌스를 위해 사용자 그룹을 생성, 읽기, 수정 또는 삭제할 수 있습니다.
버전 관리: 테이블의 HBase 버전 관리 설정을 생성하거나 수정하세요. 이 엔드포인트에는 HBase로 데이터를 푸시하거나 가져오는 방법도 포함되어 있습니다.
작업 영역: 컬렉션(이전에는 작업 공간으로 알려짐)과 상호작용하세요. API 요청을 통해 컬렉션을 생성, 읽기, 수정 또는 삭제할 수 있습니다.
WorkspaceElement: 컬렉션 내에서 테이블, 폼, 대시보드와 같은 요소를 생성, 읽기, 수정 또는 삭제할 수 있습니다.