앱 스킴 명세 개요

개요

이 문서에서는 빙글 앱(vingle-app)의 화면을 URL로 여는 방법을 정리한다.

URL 형식

<prefix><경로>[?<쿼리>]

prefix	용도
vingle://	앱 스킴. 알림 linkTo에는 이 prefix만 사용한다.
https://vingle.kr	유니버셜 링크. 앱 안에서 해석할 때는 vingle://와 같은 경로를 받는다.

예외처리 규칙

잘못된 경로 사용

이 문서에 정의되지 않은 경로를 사용할 시 Home으로 이동한다.

NOTE: Home으로 이동하는게 의도한 동작이 아닌 만큼 추후 문제가 된다면 별도의 Not Found 스크린을 만든다.

잘못된 파라미터 사용

다음의 경우 파라미터를 제외한다. 잘못된 파라미터를 사용했다고해서 앱에 오류를 발생시키지는 않는다.

• 정의한 타입을 사용하지 않은 경우
  • minPrice는 number 만 허용하는데, string을 사용한 경우
• 배열로 계약하지 않았는데, 여러 값을 보내는 경우: 마지막 값만 유효하다고 판단한다.
  • ex) params는 number만 허용할 때 vingle://path?params=1&params=2 시 params=2 로 해석

호환성

• 한글·공백은 URL 인코딩해도 되고 안 해도 된다.
  • keyword=픽유어즈와 keyword=%ED%94%BD%EC%9C%A0%EC%96%B4%EC%A6%88는 같다.
• 배열은 같은 키를 반복해도 되고 쉼표(,)로 이어도 된다. 둘을 섞어도 된다.
  • styleIds=1,2,3, styleIds=1&styleIds=2&styleIds=3, styleIds=1&styleIds=2,3은 모두 [1, 2, 3]으로 같다.