개발가이드

짤키 API 서비스는 짤과 관련된 다양한 서비스를 제공합니다.
API KEY와 관련된 사항은 문의하기를 이용해주세요.

[grade]
4: 청소년괌람불가까지 포함
3: 15세 이용가까지 포함
2: 12세 이용가까지 포함
1: 전체이용가만 포함

HOST
api.jjalkey.com
PATH
GET /v1/search
DESCRIPTION
검색어가 일치하는 태그를 가진 짤을 가지고 온다.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
REQUIRED
q: string
검색할 태그.
grade: integer
등급
limit: integer (int32)
최대 불러올 결과 개수.
(default : 30, max : 50)
offset: integer (int32)
결과 오프셋.
(default : 0)
user_name: string
유저별 고유값 (최대 30자)
Example
YOUR_API_KEY
안녕
4

25


5

35223

Code Examples

https://api.jjalkey.com/v1/search?api_key=YOUR_API_KEY&q=안녕&limit=3&offset=0&user_name=35223

Result 

{
  "data":[
      {
         "url":"https://media.jjalkey.com/media/1503068720267-33422c306a.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068720267-33422c306a.gif",
         "width":"300",
         "height":"225",
         "size":"1022728"
      },
      {
         "url":"https://media.jjalkey.com/media/1503068069013-95fe545813.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068069013-95fe545813.gif",
         "width":"455",
         "height":"260",
         "size":"942967"
      },
      {
         "url":"https://media.jjalkey.com/media/1503068069013-739763900d.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068069013-739763900d.gif",
         "width":"500",
         "height":"213",
         "size":"471631"
      }
  ]
}

Random

HOST
api.jjalkey.com
PATH
GET /v1/random
DESCRIPTION
짤을 랜덤하게 가지고 온다.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
s: integer (int32)
랜덤 seed
(default : 17)
grade: integer
등급
limit: integer (int32)
최대 불러올 결과 개수.
(default : 20, max : 50)
offset: integer (int32)
결과 오프셋.
(default : 0)
Example
YOUR_API_KEY

17

4

25


5

Code Examples

https://api.jjalkey.com/v1/random?api_key=YOUR_API_KEY&limit=5&offset=0&s=17

Result 

{
  "data":[
      {
         "url":"https://media.jjalkey.com/media/1495453304-471fb9c416.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1495453304-471fb9c416.gif",
         "width":"480",
         "height":"480",
         "size":"2199143"
      },
      {
         "url":"https://media.jjalkey.com/media/1500006255784-7fdc1a630c.jpg",
         "thumb":"https://media.jjalkey.com/thumb2/1500006255784-7fdc1a630c.jpg",
         "width":"225",
         "height":"224",
         "size":"6936"
      },
      {
         "url":"https://media.jjalkey.com/media/1495453317-ea210f0c21.jpg",
         "thumb":"https://media.jjalkey.com/thumb2/1495453317-ea210f0c21.jpg",
         "width":"800",
         "height":"600",
         "size":"249534"
      }
      {
         "url":"https://media.jjalkey.com/media/1495453301-ac67a112be.jpg",
         "thumb":"https://media.jjalkey.com/thumb2/1495453301-ac67a112be.jpg",
         "width":"400",
         "height":"268",
         "size":"12428"
      }
      {
         "url":"https://media.jjalkey.com/media/1495453321-6fcf8531b6.jpg",
         "thumb":"https://media.jjalkey.com/thumb2/1495453321-6fcf8531b6.jpg",
         "width":"420",
         "height":"484",
         "size":"74466"
      }
  ]
}

HOST
api.jjalkey.com
PATH
GET /v1/trending
DESCRIPTION
인기 짤들을 순위대로 가지고 온다.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
grade: integer
등급
limit: integer (int32)
최대 불러올 결과 개수.
(default : 30, max : 50)
offset: integer (int32)
결과 오프셋.
(default : 0)
Example
YOUR_API_KEY
4

25


5

Code Examples

https://api.jjalkey.com/v1/trending?api_key=YOUR_API_KEY&limit=3&offset=4

Result 

{
  "data":[
      {
         "url":"https://media.jjalkey.com/media/1503068720267-33422c306a.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068720267-33422c306a.gif",
         "width":"300",
         "height":"225",
         "size":"1022728"
      },
      {
         "url":"https://media.jjalkey.com/media/1503068069013-95fe545813.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068069013-95fe545813.gif",
         "width":"455",
         "height":"260",
         "size":"942967"
      },
      {
         "url":"https://media.jjalkey.com/media/1503068069013-739763900d.gif",
         "thumb":"https://media.jjalkey.com/thumb2/1503068069013-739763900d.gif",
         "width":"500",
         "height":"213",
         "size":"471631"
      }
  ]
}

Tags

HOST
api.jjalkey.com
PATH
GET /v1/tags
DESCRIPTION
인기 태그들을 순위대로 가지고 온다. 해당 태그의 랜덤 짤도 함께 가지고 온다.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
grade: integer
등급
limit: integer (int32)
최대 불러올 결과 개수.
(default : 20, max : 50)
offset: integer (int32)
결과 오프셋.
(default : 0)
Example
YOUR_API_KEY
4

25


5

Code Examples

https://api.jjalkey.com/v1/tags?api_key=YOUR_API_KEY&limit=3&offset=0

Result 

{
  "data":[
      {
         "tag":"안녕",
         "meme":{
            "url":"https://media.jjalkey.com/media/1495453318-5d5364118d.jpg",
            "thumb":"https://media.jjalkey.com/thumb2/1495453318-5d5364118d.jpg",
            "width":"639",
            "height":"459",
            "size":"115641"
         }
      },
      {
         "tag":"아니",
         "meme":{
            "url":"https://media.jjalkey.com/media/1495453314-6551d6f6a5.jpg",
            "thumb":"https://media.jjalkey.com/thumb2/1495453314-6551d6f6a5.jpg",
            "width":"1080",
            "height":"639",
            "size":"392056"
         }
      },
      {
         "tag":"화남",
         "meme":{
            "url":"https://media.jjalkey.com/media/1495453311-f2aa69692a.jpg",
            "thumb":"https://media.jjalkey.com/thumb2/1495453311-f2aa69692a.jpg",
            "width":"494",
            "height":"279",
            "size":"20657"
         }
      }
  ]
}

Autocomplete

HOST
api.jjalkey.com
PATH
GET /v1/autocomplete
DESCRIPTION
검색한 태그의 자동완성 결과를 가지고 온다.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
REQUIRED
q: string
검색할 태그.
limit: integer (int32)
최대 불러올 결과 개수.
(default : 20, max : 50)
offset: integer (int32)
결과 오프셋.
(default : 0)
Example
YOUR_API_KEY
안

25


5

Code Examples

https://api.jjalkey.com/v1/autocomplete?api_key=YOUR_API_KEY&q=안&limit=10&offset=0

Result 

{
  "data":[
      "안녕",
      "안돼",
      "안알랴줌",
      "안물",
      "안쓰럽",
      "안궁",
      "안철수",
      "안심",
      "안들림"
  ]
}

UsedMeme

HOST
api.jjalkey.com
PATH
GET /v1/usedMeme
DESCRIPTION
짤 사용 기록.
Request Parameters
REQUIRED
api_key: string
짤키 API Key
REQUIRED
image_name: string
사용된 이미지 이름
REQUIRED
user_name: string
유저별 고유값 (최대 30자)
Example
YOUR_API_KEY
1495453318-5d5364118d.jpg
35223

Code Examples

https://api.jjalkey.com/v1/usedMeme?api_key=YOUR_API_KEY&image_name=1495453318-5d5364118d.jpg&user_name=35223

Result 

{
  "result": "true"
}