NFT Farm은 고유 디지털 자산(이하 "NFT") 중앙화 거래 플랫폼입니다.
NFT Farm은 간편하게 앱 및 NFT를 등록할 수 있도록 HTTP API를 지원하며 이 문서에서는 API에 대한 명세와 사용방법을 제공합니다.
연동 관련 질문 및 오류사항은 develop@itam.games 로 문의 부탁드립니다.

NFT Farm의 REST API는 JWT형식을 사용하여 인증합니다.
JWT의 Payload는 다음과 같습니다.

accessKey

• 발급된 Access Key

params

• 파라미터를 SHA512로 해시한 값을 base64로 인코딩한 값
• 모든 파라미터(path, query, body)를 오름차순으로 정렬 후 querystring으로 변환시켜 해시

서명된 토큰은 HTTP Header의 Authorization 필드에 넣어서 요청합니다.
같은 요청을 여러 번 하더라도 Replay attack 대응을 위해 특정 시간 뒤 만료되므로 요청마다 서명하는 것을 권장합니다.

NFT 수정 요청을 하는 인증 생성 예제 코드입니다.

const jwt = require('jsonwebtoken');
const crypto = require('crypto');
const uuidv4 = require("uuid/v4");

const path = {
  nftId: '<NFT Id>'
};
const body = {
  activateExchange: true,
  nonce: uuidv4()
};

const parameters = {...path, ...body};
const sortedKeys = Object.keys(parameters).sort();
const querystring = sortedKeys.map(key => `${key}=${parameters[key]}`).join('&');
const hashedQuerystring = crypto.createHash('sha512').update(querystring).digest('base64');

const jwtPayload = {
  accessKey: '<Access Key>',
  params: hashedQuerystring
};

const token = jwt.sign(jwtPayload, '<Secret Key>');

// HTTP Header Authorization value
const result = `Bearer ${token}`;

지원 준비 중입니다.

인앱 서비스가 별도 플랫폼(구글, 애플, 별도 URL, Steam 등)의 회원가입 절차를 따를 경우 NFT Farm 회원과 연동을 진행해야 합니다. NFT Farm 에서는 유저의 블록체인 지갑을 별도 개발 없이 서비스에게 제공함으로써 개발의 편리함을 제공합니다.
각 인앱마다 회원을 별도 관리하며 NFT Farm 회원가입 또는 기존 유저의 인앱 연동은 별도로 진행합니다.