Motimate: 공개 API v1에서 v2로 업그레이드하려면 어떻게 해야 하나요?

보다 유연하고 유용한 서비스를 제공하는 새로운 공개 API v2 (PAPI v2)가 출시되었습니다 ✨.

새로운 기능은 무엇인가요?

PAPI v2를 사용하면 더 많은 엔드포인트에서 더 넓은 범위의 데이터에 액세스할 수 있습니다. 특히 이제 더 많은 데이터를 외부로 내보낼 수 있을 뿐만 아니라 API를 통해 모티스페이스를 더 잘 제어할 수 있게 됩니다.

어떻게 해야 하나요?

아직 없습니다. 당분간은 새 버전을 출시하여 관심 있는 사람들이 사용할 수 있도록 했습니다. 현재로서는 누구에게도 변경 사항을 강요하지 않습니다. 아래에서 예상 일정과 모든 사용자가 업그레이드를 위한 조치를 취할 것으로 예상되는 시기에 대해 자세히 알아보세요(이 일정은 아직 잠정적인 것일 뿐입니다).

완전히 업그레이드하지 않고 v2를 테스트하려면 어떻게 해야 하나요?

기술적으로 v1과 통합된 상태에서 PAPI v2를 사용하기 시작하려면 HTTP 헤더( motimate-public-api-version 을 v2.

v2로 영구적으로 이전할 준비가 되면 지원팀에 알려 주시면 백엔드에서 이 헤더가 더 이상 사용되지 않도록 구성해 드립니다.

베타 버전일 때 v2를 테스트한 경우에는 베타 버전에서 변경된 사항이 없으므로 변경할 필요가 없습니다.

v2로 업그레이드하려면 기존 v1 구현에 큰 변경이 필요한가요?

주로 사용자, 그룹 및 포지션 엔드포인트 사용에 대한 작은 조정이 이루어지므로 PAPI v2로 전환하는 데 큰 변경은 필요하지 않습니다. 즉, 컨설턴트에서 타사 개발자를 사용하는 고객은 당연히 통합을 업데이트하고 테스트하는 데 시간이 필요합니다.

인증과 관련하여 변경되는 사항은 무엇인가요?

이미 PAPI v1을 사용 중인 경우, 24시간 인증 토큰을 얻기 위해 처음 API 액세스를 요청할 때 모티메이트 팀으로부터 받은 것과 동일한 자격 증명을 계속 사용하게 됩니다.

v1은 더 이상 사용되지 않나요? 타임라인은 어떻게 되나요?

우선 PAPI v2를 간단히 출시하고 사용자가 업그레이드하여 사용할 수 있도록 했습니다. 

조만간 공지를 통해 v1을 더 이상 지원하지 않을 것임을 알리고, 그 시점부터 모든 사용자가 v2로 전환할 수 있도록 6개월의 전환 기간을 허용할 예정입니다. 이는 잠정적인 계획으로 변경될 수 있다는 점에 유의하세요.