특성과 제한 사항

항목

설명

API 횟수

  • 원링크 API를 사용하여 OneLink 링크를 생성, 편집 또는 삭제하는 속도 제한은 계정당 월 750만(UTC 시간대)입니다.
  • 7,500,000회를 초과한 에 이루어진 모든 요청은 처리되지 않고 링크가 생성되지 않으며, API 호출 시 "제한된 한계를 초과하였습니다" 메시지와 에러 상태 코드 429를 받게 됩니다.
  • 비율 제한의 사용량/남은 정도에 대한 정보는 원링크 API 대시보드에 표시됩니다.

링크 가시성

  • 이 API를 통해 작성된 링크는 앱스플라이어 대시보드의 원링크 커스텀 링크 목록에 나타나지 않습니다.
  • 모범 사례: 로컬 표에서 API 생성 링크를 저장하면 향후 목적에 따라 링크에 액세스할 수 있습니다. 

TTL 

  • 원링크 API를 통해 작성된 원링크 숏 URL에 대한 기본 TTL(Time to Live)은 31일입니다. 링크를 클릭할 때마다 31일씩 확장됩니다. TTL이 만료된 링크를 클릭해도 여전히 원링크 기본 설정에서 정의된 동작이 기본값으로 설정되지만, 어트리뷰션이 작동하지는 않습니다.
  • 최대 TTL은 31일 입니다. 31일을 초과하는 모든 TTL은 기본 TTL인 31일로 대체됩니다.
  • ​파라미터를 추가하여 기본 TTL을 변경할 수 있습니다. ttl={value} 및 몇 일, 시간 또는 분을 지정합니다. 예를 들어 ttl=7d , ttl=12h , 또는 ttl=10m .
  • 업데이트 요청을 전송하여 TTL을 지정할 수 있습니다. 모든 업데이트 요청은 TTL(기존 링크의 경우)을 요청 본문에 있는 특정한 TTL로 리셋합니다.
    • 이것은 TTL이 대체된다는 것을 의미합니다. 예를 들어 현재 TTL 29d인 링크의 경우 TTL 2d 요청을 업데이트하면 TTL = 2d(TTL = 31d가 아님)로 변경됩니다.
    • 요청 업데이트에 의해 잠재적으로 어트리뷰션 링크의 수명을 연장할 수 있습니다. 예를 들어, 현재 TTL 20d가 있지만 5일이 경과한 링크에 대해 TTL 31d를 사용하여 업데이트를 호출하는 경우, TTL은 업데이트 시간으로부터 31d일 것입니다.
  • 링크 TTL을 자동으로 확장하지 않으려면 링크에 파라미터를 renew_ttl=false 추가하십시오. 이 파라미터의 값은 부울값, 즉 true(기본값) 또는 false입니다.
  • 파라미터는 renew_ttl 실제 URL에 표시되지 않습니다.

특수 문자

API 작성 링크에 사용할 경우 ;, , !, @, #, ?, $, ^, :, &, ~, `, =, +, ’, >, <, / 문자를 인코딩해야 합니다.
이러한 문자를 인코딩하지 않으면 공백으로 대체됩니다.

페이로드

페이로드의 쿼리 문자열은 2,048자를 초과할 수 없습니다.

URL ID

URL ID(또는 숏링크 ID)를 편집하여 캠페인 오퍼링을 강조할 수 있습니다. 예: https://myapp.onelink.me/abc123/apples. URL ID는 50자를 초과할 수 없으며 문자와 숫자를 조합할 수 있습니다. 기본적으로 8자입니다.

일러두기:

  • 현재 ID가 이미 사용되고 있지 않은 경우에만 URL ID를 편집할 수 있습니다.
  • URL ID가 이미 사용 중이면 링크 작성이 실패하고 오류 응답(400)을 반환합니다. 사용자와 개발자가 이러한 이벤트에서 발생하는 상황을 결정하고 설정해야 합니다.
  • 실패한 호출은 여전히 월간 API 할당량에 반영됩니다.