Klip API 문의 드립니다

안녕하세요.
Klip API를 NFT minting, escrow API 사용에 불편함 또는 문제점이 있어서 문의 드립니다.

  • card_id 를 가져오는데 어려움이 있다.
    • 카드 발급후에 card_id를 가져오려면, 다시 모든 카드 정보 API 로 조회하여 tx_hash 로 매칭하여 가져와야하여 불편합니다.
    • 카드 목록 조회가 아닌 카드를 tx_hash로 조회하거나 카드 발급시 card_id가 같이 오면 좋을 것 같네요.
  • 카드 목록 조회에서 nft_id를 사용하는데 어려움이 있다.
    • contract_address <> nft_id 매칭 정보를 직관적으로 제공해주는 데이터가 없는 것 같습니다. 발급시에는 contract_address를 이용하여 발급하는데 조회시에는 nft_id를 이용하여 조회하기 때문에 매칭이 필요할 것 같은데, API 문서를 보면 기계적으로 매칭할 수 있는 부분이 안보이는 것 같습니다.
  • 카드 mint + 에스크로까지 한번에 할 수 있는 API가 있나요?
    • 현재 카드를 발급하려면, 카드 mint → 정보 조회 → 에스크로 순서대로 호출해야되서 불편함이 있습니다. 있다면 좋을것 같습니다.
  • 문서의 많은 부분이 깃허브로 링크가 되어있어, 접근이 불가능합니다.
  • wallet/nft/{nft_id}/cards/{card_id} 처럼 카드 정보를 조회할 수 있는 API가 있나요?
    • 해당 카드가 누구 소유인지 알고 싶습니다.
  • API 타이밍 이슈
    • mint 결과로 나오는 tx_hash와 v2/wallet/receipt?tx_hash= API를 이용하여 카드 발급이 완료되기를 기다린후에 v2/wallet/nft/52?isAll=true API로 카드 목록을 조회하면 새로 발급된 카드가 목록에 없습니다. 처리 결과 조회 API를 에서 정상 응답을 받았으므로 목록조회 API에서도 새로운 카드를 포함한 응답을 반환해야 정상적인 상황 같습니다. 또는 캐시로 인하여 최신 목록을 주지 못하는 것 같은데, 캐시를 우회할 수 있는 방법이 있을까요?

감사합니다.

3개의 좋아요

liam 안녕하세요 ㅎㅎ 좋은 의견 많이 주셔서 감사합니다.

  • card_id를 얻기 어려운 부분은 개선 논의해보겠습니다
  • contract address 키로 매핑해주시는 부분 개선 논의해보겠습니다.
  • 말씀해주신대로 편할 것 같긴하지만, minting과 escrow가 독립된 로직이다보니 고민이 좀 필요하겠습니다.
  • 문서 링크가 깨졌다는 말씀이신 것 같은데, 혹시 docs.klipwallet.com에서 링크가 깨진 부분을 좀더 구체적으로 말씀해주시면 수정하겠습니다.
  • KAS API와 중복되어 현재 지원하지 않고 있습니다.
  • 블록에 담기는 시간, KAS에서 처리하는 시간 딜레이를 감안해주셔야할 것 같습니다. 3초간격 2회 정도 polling하는 방법이 현재 적용 가능하신 방법일 것 같습니다.

앞으로도 많은 의견 부탁드립니다!!

2개의 좋아요