Recently Viewed Packs

Recently Viewed Packs API는 사용자가 최근에 조회한 스티커 팩 목록을 불러옵니다. 해당 API를 활용해 사용자가 보다 직관적으로 스티커를 브라우징 할 수 있게 해보세요.

Request URL

GET

https://messenger.stipop.io/v1/package/recent/:userId

Best Practices

사용자가 스티커 팩을 다운로드 할 시 다음 Download/Purchase Sticker API를 꼭 사용해 다운로드 기록을 남겨주세요. 사용자 스티커 다운로드 정보는 My Sticker Packs, Download/Purchase History 그리고 Recently Viewed Packs 기능을 사용할 때 필수적으로 필요합니다.
userId 파라미터에 다양한 사용자에 대해 같은 userId 값을 사용하지마세요. 해당 값은 지속적으로 모니터링이 되며 중복값이 사용 될 경우 API key가 비활성화 될 수 있습니다. userId 값은 아무 string 형태의 값이면 됩니다.
limit과 pageNumber 파라미터를 사용해 스티커 로딩 속도를 최적화하세요. 예를 들어 limit을 '30'으로 두고 pageNumber 1,2,3...을 적용해 한 페이지 (혹은 한 로딩)에 30개의 스티커를 보여주세요.
스티커 이미지 url에 dimension (d)을 추가해 이미지 사이즈 및 파일 크기를 최적화 할 수 있습니다. 다음과 같이 사용하실 수 있습니다: d=100x100 혹은 d=300x300 (단위: pixel). 권장드리는 기본 스티커 사이즈는 300px 이며 최대 크기는 700px 입니다.

Parameters

Request Headers
Required	Type	Description
apikey	string	발급받은 API 키 값: 스티팝 대시보드에서 새로운 API 키를 발급받을 수 있습니다.

Request Query Parameters
Required	Type	Description
userId	string	앱 사용자에게 부여되는 고유 값. userId는 아무 string 값이면 됩니다. 중요: 여러 사용자에게 동일한 userId를 사용하면 안됩니다.
Optional	Type	Description
limit	int	페이지 당 보여줄 스티커 수 제한. pageNumber를 사용해 스티커 뷰를 최적화하세요. 기본 값: 20 (최대: 50)
pageNumber	int	pageNumber를 사용해 한 페이지 당 limit개수의 스티커를 보여주세요.

Example Request

1
curl --location --request GET "https://messenger.stipop.io/v1/package/recent/9937?pageNumber=1&limit=20" --header "apikey:xxxxxxxxx"

Success Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
{
  header: {
    code: '0000',
    status: 'success',
    message: 'success',
  },
  body: {
    packageList: [
      {
        packageId: 2309,
        packageName: 'cada día',
        packageImg: 'https://img....70AAeHBn4N.png',
        packageCategory: 'Animation/Cartoon,Gag',
        packageKeywords: 'bonito,mono,bello,adorable,life,cute,lovely',
        packageAnimated: 'N',
        isNew: 'N',
        artistName: 'pinono',
        language: 'Spanish',
        isDownload: 'Y',
        isWish: 'N',
      },
      {
        packageId: 2473,
        packageName: '¿Cómo estás?',
        packageImg: 'https://img.....Ggdu7s3J15.gif',
        packageCategory: 'Phrases,Etc.',
        packageKeywords: '¿Cómoestás?,letra',
        packageAnimated: 'Y',
        isNew: 'N',
        artistName: 'annapig',
        language: 'Spanish',
        isDownload: 'Y',
        isWish: 'N',
      },
     ......
    ],
    "pageMap": {
      "pageNumber": 1,
      "onePageCountRow": 20,
      "totalCount": 2,
      "pageCount": 1,
      "groupCount": 1,
      "groupNumber": 0,
      "pageGroupCount": 10,
      "startPage": 1,
      "endPage": 1,
      "startRow": 0,
      "endRow": 20,
      "modNum": 2,
      "listStartNumber": 2
    }
  },
}

Response Format

Attributes
Name	Type	Description
packageId	int	스티커 팩 ID
packageName	string	스티커 팩 이름
packageImg	string	스티커 팩 메인 이미지
packageCategory	string	스티커 팩 카테고리
packageKeywords	string	스티커 팩 키워드
packageAnimated	string	스티커 팩 애니메이션 유무 (Y/N)
isNew	string	새로운 스티커 팩 (Y/N)
artistName	string	스티커 팩 작가 이름
language	string	스티커 팩 메인 언어
isDownload	string	스티커 팩 사용자 다운로드 여부 (Y/N)
isWish	string	스티커 팩 사용자 위시 리스트 여부 (Y/N)

Error Response

Error	Code	Description
non exist apikey	9000	사용된 API 키가 존재하지 않습니다.
server error	1000	서버에서 정보를 받을 수 없습니다.

이 페이지가 도움이 되셨나요?

도움이 필요하신가요? 문의주세요.

Back

Sticker StoreMAIN STICKER BANNER

Sticker StoreVIEW STICKER CATEGORY