모티메이트: 모티메이트 퍼블릭 API는 어떻게 사용하나요?

퍼블릭 API를 사용하여 사용자 통합 및 데이터 소스와의 동기화를 자동화하고, 다른 멋진 서비스에 모티밋을 연결하세요 🔀.

공개 API는 모티메이트에서 데이터를 업데이트하고 관리하는 데 사용할 수 있는 일련의 서비스입니다. 이는 OpenAPI라는 표준 방식으로 문서화되어 있으며, 개발자가 서비스형 소프트웨어에 프로그래밍 방식으로 액세스할 수 있도록 지원합니다. 이 API는 SCIM 및 CSV보다 더 광범위한 지원을 제공하지만, 이를 사용하려면 통합 서비스 또는 소프트웨어 로봇이 필요합니다.

PAPI v2의 출시로 다음과 같은 엔드포인트를 사용하여 MotiSpace에서 데이터를 그 어느 때보다 쉽게 내보낼 수 있습니다:

• /모티스/프로그레스
• /모티스/챕터_완성
• /posts 및
• /인사이트/학습/보고서_요청

데이터 모델

퍼블릭 API는 사용자 프로비저닝 및 펄스 게시물을 자동화하는 모델을 제공합니다. 이러한 데이터 모델이 있습니다:

• 사용자 모델: 이 모델을 사용하여 사용자 계정에 대한 정보를 읽고, 쓰고, 업데이트할 수 있습니다. 여기에는 연락처 정보, 액세스 역할 및 모티 관리를 위한 그룹 할당이 포함될 수 있습니다. 사용자에게 하나 이상의 포지션이 있는 경우 이 엔드포인트에서도 이를 설정할 수 있습니다.
   
• 그룹 모델: 이 모델을 사용하면 사용자 그룹을 읽고, 쓰고, 할당할 수 있습니다. 이러한 그룹은 조직에 맞게 트리 구조로 구성하여 학습 과제를 간소화할 수도 있습니다. 
  
  중요: 그룹 수준은 현재 속성 종류를 사용하여 정의됩니다. 현물의 가치는 조직마다 다를 수 있습니다. 조직 관리자가 쉽게 변경할 수도 있습니다. API 연동을 설정할 때 그룹 레벨에 대한 영구적인 종류 이름 목록을 정의하여 종류 이름이 변경될 경우 API 연동에서 발생할 수 있는 오류를 방지하는 것이 좋습니다.
   
• 포지션 모델: 이 모델을 사용하면 사용자 계정을 할당할 수 있는 위치를 읽고 쓸 수 있습니다.
   
• 게시물: 게시물: 이 기능을 사용하여 게시물을 작성하고 Pulse에 게시할 수 있습니다. 이 작업은 파일 서비스와 함께 이미지를 업로드하는 데 사용할 수 있습니다.
   
• 파일: 이 서비스는 펄스 게시물에 이미지를 업로드하는 데 사용됩니다. 이미지의 크기 제한은 40MB, 동영상은 100MB, 문서는 100MB입니다.
   
• 인사이트: 이 서비스는 사용자 지정 보고서를 생성하고 링크를 얻는 데 사용됩니다. 보고서 템플릿은 '인사이트'의 '보고서 생성' 기능을 사용하여 모티메이트 플랫폼에서 미리 생성해야 합니다.

인증

OAuth 토큰 엔드포인트는 액세스 토큰을 만드는 데 사용됩니다. support@motimateapp.com 으로 문의하여 client_id 및 client_secret을 받으세요.

이러한 세부 정보를 받으면 프로그래밍 방식으로 토큰을 생성하거나 Postman과 같은 플랫폼을 통해 토큰을 생성할 수 있습니다. API 호출을 보내기만 하면 됩니다. POST /oauth/tokens 엔드포인트에 client_id와 모티메이트 지원팀에서 받은 client_secret 자격 증명을 JSON 본문으로 보내면 됩니다.

API는 24시간 동안 유효한 고유 토큰으로 응답합니다. 필요한 만큼의 토큰을 생성할 수 있습니다. 토큰은 다른 모든 엔드포인트에 대한 요청에서 권한 부여 헤더에 무기명 토큰으로 전달되어야 합니다("Bearer"+[your_token]).

예시
"무기명 eyJhbkyFjHk0oIY6ghkkgRI1NiJ9.eyJ0b23Lo7G5jk7mJkYzdiZD"
 

다음을 사용할 수 있습니다. GET /me 엔드포인트 를 사용하여 액세스 토큰을 확인할 수 있습니다. 이는 액세스 토큰을 보관할 키스토어가 있고 트랜잭션 호출을 호출하지 않고도 작동하는지 확인하려는 경우에 유용합니다.