애플리케이션
애플리케이션은 개발자로서 Wink의 모든 기능에 접근할 수 있게 해줍니다. 동일한 데이터에 접근할 수 있을 뿐만 아니라 Wink의 기능을 확장할 수도 있습니다. Wink의 OAuth2 서버를 사용하여 Google이나 Facebook을 사용하는 것과 같은 방식으로 여행 사이트를 인증할 수 있습니다. 이렇게 하면 Wink의 기능을 자체 웹사이트나 애플리케이션에 확장할 수 있습니다.
- 계정에서 작업할 계정을 선택합니다.
- 계정 카드 하단의
Actions를 클릭하고계정 관리를 선택합니다. - 다음 페이지에서
Applications탭을 클릭합니다. - 이 섹션에 모든 애플리케이션이 나열됩니다.
- 기존 앱을 편집하거나 새 앱을 생성합니다.
앱 생성
섹션 제목: “앱 생성”생성된 앱의 비밀 키에 접근할 수 없으므로 직접 앱을 생성해야 합니다.
클라이언트 유형
섹션 제목: “클라이언트 유형”애플리케이션을 생성할 때 앱이 인증하는 방식을 결정하는 클라이언트 유형을 선택합니다:
- SPA (싱글 페이지 애플리케이션) — PKCE가 포함된 OAuth2 권한 부여 코드 흐름을 사용하는 브라우저 기반 프런트엔드 애플리케이션용입니다. 웹 앱에서 가장 일반적인 유형입니다.
- MACHINE_2_MACHINE — 클라이언트 자격 증명을 사용하여 직접 인증하는 서버 간 통합용입니다. 백엔드 서비스가 사용자 없이 Wink API를 호출해야 할 때 사용합니다.
애플리케이션 생성 단계는 다음과 같습니다:
- 앱 페이지에서
새 애플리케이션 생성버튼을 클릭합니다. - 이름 앱 이름을 지정합니다. 예: Cool App
- 클라이언트 유형 웹 앱은
SPA, 서버 통합은MACHINE_2_MACHINE을 선택합니다. - 엔터티 이름 기존 계정 중 하나와 앱을 연결합니다. 예: Cool Account
- 리디렉션 URI 최소 하나의 리디렉션 URI가 필요합니다. 인증 성공 후 리디렉션 도메인을 검증하는 데 사용됩니다. 예: https://www.cool-site.com
- 로그아웃 후 리디렉션 URI (선택 사항) 로그아웃 후 사용자를 리디렉션할 URL입니다. 세션 종료 후 사용자가 알 수 있는 페이지에 도착하도록 합니다.
- 계속하려면
저장버튼을 클릭합니다.
애플리케이션 목록으로 리디렉션됩니다. 새 앱이 목록에 표시되며 앱 비밀 키는 이때만 볼 수 있습니다. 반드시 복사하여 안전한 곳에 보관하세요.
앱 업데이트
섹션 제목: “앱 업데이트”리디렉션 URI가 변경되거나 URI를 추가/제거하려면 앱을 업데이트해야 합니다.
기존 앱을 업데이트하려면 다음을 수행하세요:
- 업데이트할 앱의
Actions링크를 클릭합니다. Actions아래의업데이트버튼을 클릭합니다.- 앱을 수정합니다.
- 계속하려면
저장버튼을 클릭합니다.
애플리케이션 목록으로 리디렉션됩니다.
앱 삭제
섹션 제목: “앱 삭제”더 이상 사용하지 않는 앱은 삭제할 수 있습니다.
앱을 삭제하려면 다음을 수행하세요:
- 삭제할 앱의
Actions링크를 클릭합니다. Actions아래의삭제버튼을 클릭합니다.- 삭제 확인을 위해
확인버튼을 클릭합니다.
애플리케이션 목록으로 리디렉션됩니다.