access_token
)을 받습니다. 이 토큰은 로그인 후 24시간이 지나면 만료되며 이 경우 재발급받아야 합니다.access_token
을 Klip Partners에 보내고 이미지 업로드를 요청합니다.mint_info.json
파일, 로그인 시 받은 access_token
을 Klip Partners에 보내고 카드 발행을 요청합니다. 업로드한 카드 이미지를 사용합니다. EOA를 가진 사용자라면 누구나 카드를 발행받을 수 있습니다.mint_info.json
예시는 아래와 같습니다. 이 파일에는 카드 이미지 URL 주소와 카드 발행에 필요한 정보가 담겨 있습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.sendable
이 TRUE이면 카드를 발행받은 사람은 발행받은 카드를 Klip에서 다른 사람에게 전송 가능합니다.send_friend_only
가 TRUE이면 카드를 발행받은 사람은 발행받은 카드를 Klip에서 카카오톡 친구에게만 전송 가능합니다.hashtags
배열의 원소 개수는 최대 10개입니다. 각 원소는 최대 100글자입니다.external_link
를 지정하면 Klip 외부 브라우저로 연결되는 URL 주소를 넣을 수 있습니다. 최대 255자까지 가능합니다.qr_code
로 사용할 이미지는 가로 400px 이상이고 상하좌우 여백이 없는 것을 권장합니다.bar_code
로 사용할 이미지는 가로 400px 이상이고 상하좌우 여백이 없는 것을 권장합니다.attributes
는 카드의 고유한 속성을 trait_type/value
형태로 가지는 object
들의 배열입니다.mint_info.json
파일, 로그인 시 받은 access_token
을 Klip Partners에 보내고 카드 발행을 요청합니다. Klip 회원의 실명과 전화번호를 사용하여 Klip 회원에게만 카드를 발행합니다.mint_info.json
예시는 아래와 같습니다. 이 파일에는 카드 이미지 URL 주소와 카드 발행에 필요한 정보가 담겨 있습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.to_person
은 카드를 발행받을 사용자 [실명, 전화번호] 배열들이 담긴 2차원 배열입니다.to_person
에 원소 1개짜리 배열을 전달하면 1명에게만 발행합니다.to_person
에 넣을 수 있는 [실명, 전화번호] 개수는 API 호출 1회당 최대 200개입니다.to_person
파라미터에 전달한 실명과 전화번호로 가입한 Klip 회원이 없다면 발행에 실패합니다.sendable
이 TRUE이면 카드를 발행받은 사람은 발행받은 카드를 Klip에서 다른 사람에게 전송 가능합니다.send_friend_only
가 TRUE이면 카드를 발행받은 사람은 발행받은 카드를 Klip에서 카카오톡 친구에게만 전송 가능합니다.hashtags
배열의 원소 개수는 최대 10개입니다. 각 원소는 최대 100글자입니다.external_link
를 지정하면 Klip 외부 브라우저로 연결되는 URL 주소를 넣을 수 있습니다. 최대 255자까지 가능합니다.qr_code
로 사용할 이미지는 가로 400px 이상이고 상하좌우 여백이 없는 것을 권장합니다.bar_code
로 사용할 이미지는 가로 400px 이상이고 상하좌우 여백이 없는 것을 권장합니다.attributes
는 카드의 고유한 속성을 trait_type/value
형태로 가지는 object
들의 배열입니다.to_person
에 입력한 회원 중 1명이라도 카드를 정상적으로 발행받았다면 요청이 정상 처리된 것으로 나타납니다.animation_url
필드를 설정하기 위해서는 카드 동영상을 먼저 업로드해야 합니다. Upload NFT Resource로 카드 동영상 파일, 로그인 시 받은 access_token
을 Klip Partners에 보내고 동영상 업로드를 요청합니다.access_token
을 보내고 BApp별 카드 정보 조회를 요청합니다.bapps
에서 bapp은 Klip 파트너사가 서비스하는 BApp입니다.cards
에서 card는 이 BApp에서 쓰이는 Klip 카드입니다. BApp에는 카드 1종류가 들어있습니다.nft_id
란 이 card를 블록체인 상에 만드는 스마트 컨트랙트의 ID입니다.card_uri
는 카드 메타데이터가 담긴 JSON 파일이 있는 URL입니다.name
, description
, image
, background_color
, attributes
등 카드를 발행할 때 정의한 카드 기본 정보입니다.bapps.next_cursor
로 나머지 카드 정보를 받습니다.
나머지 BApp 정보를 받으려면 Query 파라미터 cursor
에 이전 호출에서 받은 bapps.next_cursor
를 넣고 API를 다시 호출합니다.bapps[0].cards
배열을 보면 카드 생성/업데이트 시간, 카드 소유자 주소, 카드를 보내준 사람 주소, 카드 발행 트랜잭션 해시 등 각 카드에 관한 상세 정보를 확인할 수 있습니다.bapps.next_cursor
값을 받습니다.
나머지 BApp 정보를 조회하려면 bapps.next_cursor
값을 Query 파라미터 cursor
에 전달하고 API를 다시 호출해야 합니다.nft_id
가 있습니다. Get Card Information으로 Path 파라미터 nft_id
, 로그인 시 받은 access_token
을 Klip Partners에 보내고 BApp별로 카드 정보를 조회합니다.cards
에서 card는 이 bapp에서 쓰이는 Klip 카드입니다. bapp에는 카드 1종류가 들어있습니다.cursor
또는 isAll
둘 중 하나만 사용해야 합니다(isAll
이 false
이면 cursor
를 사용할 수 있습니다).cursor
를 사용하면 Pagination을 사용합니다.next_cursor
로 나머지 카드 정보를 받습니다.cursor
에 이전 호출에서 받은 next_cursor
를 넣고 API를 다시 호출합니다.cards.next_cursor
값이 존재하므로 이 계정은 conan 카드를 100개 이상 가지고 있습니다.
한 번에 조회할 카드 개수가 100개를 초과한다면 1회 호출 시 카드 100개 정보만 받고 cards.next_cursor
값을 받습니다.
나머지 카드 정보를 조회하려면 cards.next_cursor
값을 Query 파라미터 cursor
에 전달하고 API를 다시 호출해야 합니다.cards.next_cursor
값을 받습니다.
그리고 동일한 API를 다시 호출할 때 cards.next_cursor
값을 Query 파라미터 cursor
로 사용하면 나머지 50개의 정보를 받습니다.cards.next_cursor
값과 로그인 시 받은 access_token
을 Klip Partners에 보내고 나머지 카드 정보 조회를 요청합니다.bapps[i].cards_next_cursor
를 Query 파라미터 cursor
로 사용해 Get Card Information을 호출합니다.access_token
을 보내고 BApp별 카드 정보 조회를 요청해야 합니다.cursor
에 bapps[0].cards_next_cursor
값인 gKvkL1lPYv1P93dpE...
를 전달해 Get Card Information을 호출해야 합니다.gKvkL1lPYv1P93dpE...
과 로그인 시 받은 access_token
을 Klip Partners에 보내고 BApp1 나머지 카드 50개 정보 수신을 요청합니다.cursor
에 bapps[1].cards_next_cursor
값인 Xrzed2Ot9LeEor...
을 전달해 Get Card Information을 호출해야 합니다. Get Card Information으로 Xrzed2Ot9LeEor...
과 로그인 시 받은 access_token
을 Klip Partners에 보내고 BApp2 나머지 카드 100개 정보 수신을 요청합니다.isAll
, Path 파라미터 nft_id
, 로그인 시 받은 access_token
을 Klip Partners에 보내고 모든 카드 정보를 요청합니다.cursor
또는 isAll
둘 중 하나만 사용해야 합니다(isAll
이 false
이면 cursor
를 사용할 수 있습니다).access_token
, send_info.json
파일, 전송할 BApp 카드의 nft_id
와 card_id
(Path 파라미터)를 보내고 현재 계정 EOA 주소에 있는 카드를 다른 사람의 EOA 주소로 전송하도록 요청합니다.send_info.json
파일 예시는 아래와 같습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.card_name
을 입력해야 받는 사람에게 카드 이름이 정상 표시됩니다.access_token
, send_info.json
파일, 전송할 BApp 카드의 nft_id
와 card_id
(Path 파라미터)를 보내고 현재 계정 EOA 주소에 있는 카드를 다른 사람에게 전송하도록 요청합니다.send_info.json
파일 예시는 아래와 같습니다.pin
, 카드를 받는 사람이 Klip 회원에 가입 시 사용한 실명과 전화번호가 담겨 있습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.to_person
파라미터에 전달한 실명과 전화번호로 가입한 Klip 회원이 없다면 전송에 실패합니다.fail_count
0을 받습니다.card_name
을 입력해야 받는 사람에게 카드 이름이 정상 표시됩니다.approve.json
파일 예시는 아래와 같습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.pin
확인에 실패한 경우 fail_count
에 0보다 큰 값을 받습니다.approve
필드에 true
값을 받습니다.escrow_info.json
파일 예시는 아래와 같습니다.pin
은 트랜잭션 서명에 개인 키 대신 사용됩니다.fail_count
0을 받습니다.cancel_info.json
파일 예시는 아래와 같습니다.