일반적으로 디스플레이에 사용되는 숫자, 가격, 날짜 등의 특정 정보들은 저장된 데이터를 가져와서 실제로 디스플레이 할 때 조금 더 정제된(포멧팅된) 형태로 변환해 사용하게 됩니다.
예를 들어서 상품 가격 필드의 10000이라는 숫자(Number) 값은 저장하거나 결제 서비스와 연동될때는 유의미한 형태의 데이터이지만, 한국의 사용자에게 더 편리한 형태로 디스플레이하기 위해서는 "10,000원"이라는 문자열 형태가 더 적합한 데이터이며, 프랑스의 사용자에게는 "€7,89"와 같이 유로화로 변환되고 ","를 소수점 구분자로 사용한 형태가 더 적합한 데이터일 것입니다.
클레이풀의 API는 단순히 날것의 정보를 저장하고 가져오는 것 뿐만 아니라, 자주 변환해서 쓰이는 정보들을 필요에 따라 바로 사용할 수 있는 변환된 형태로 가져올 수 있는 자동 데이터 포멧팅 기능을 기본적으로 제공합니다.
클레이풀의 API들 중 정보를 가져오는 형태의 API들(주로 GET)을 사용할때는, 변환되지 않은 로우 데이터(Raw Data)를 가져올지 포멧팅된 데이터(Formatted Data)를 가져올지를 선택할 수 있습니다.
로우 데이터는 변환되지 않은 날것 상태의 데이터를 뜻하며 API 사용시 URL 쿼리스트링을 이용해서 특정 리소스를 로우 데이터로 가져올 수 있습니다.
예를 들어서 상품 리스트를 로우 데이터로 가져오려는 경우 raw 옵션을 이용해서 가져올 수 있습니다.
https://dev.clayful.io/examples/request-raw-data.html
로우 데이터의 경우 변환 과정이 없기 때문에 포멧팅된 데이터를 가져올 때 보다 조금 더 빠르게 가져올 수 있습니다.