API&SDK

다 개발된 판매 기능을, 어떤 개발 환경에서나

클레이풀 API&SDK는 개발 환경에 제약 없이 사용할 수 있는 판매 플랫폼 구축용 API 솔루션입니다. 상품 · 고객 · 카트 · 주문 · 결제 및 배송까지, 구매 기능을 필요로 하는 플랫폼 구현에 이미 다 개발된 판매 기능을 간단히 연동해 사용해보세요.

API&SDK는

이런 분들을 위해 제작되었습니다

  • 다 구현된 판매 기능을

    다 구현된 관리자 페이지와 판매 기능을 연동해, 판매 플랫폼을 처음부터 개발하지 마세요.

  • 플랫폼 환경에 제약 없이

    웹사이트와 모바일 앱, 플랫폼 환경과 개발 언어에 제약 없이 판매 기능을 연동해 사용해보세요.

  • 플랫폼 서비스를 위한

    일반적인 쇼핑몰 뿐만 아니라, 판매 기능을 필요로하는 플랫폼에 특화된 기능을 제공합니다.

  • 운영 중인 서비스에 구매 기능을

    기존 운영 중인 서비스의 회원 정보와 연동해, 카트 · 주문 등의 구매 기능을 제공해보세요.

300여개의 다 개발된 판매 기능을

개발 언어에 관계 없이

JavaScript SDK

JavaScript SDK를 이용해 복잡한 서버 개발 없이 판매 기능을 연동해보세요. 브라우저에 임포트해 웹사이트를 개발하거나, React Native 기반 모바일 앱 개발에 사용할 수 있습니다.

코드 예시 보기
Clayful.config({
  client: '<api-access-token>'
});

var Product = Clayful.Product;

Product.list({
  query: { page: 1 }
}, function(err, result) {

  if (err) {
    // Error case
    console.log(err.code);
  }

  var products = result.data;

  console.log(products);

});
                

Node.js SDK

Node.js 기반 서버에 판매 기능을 추가해보세요. Koa, Express, Hapi.js 등의 프레임워크에도 연동해 사용할 수 있습니다.

코드 예시 보기
const Clayful = require('clayful');
const Product = Clayful.Product;

Clayful.config({
  client: '<api-access-token>'
});

Product.list({
  query: { page: 1 }
}, (err, result) => {

  if (err) {
    // Error case
    console.log(err.code);
  }

  const products = result.data;

  console.log(products);

});
                

PHP SDK

PHP 기반 서버에 판매 기능을 추가해보세요. Laravel, CodeIgniter 등의 프레임워크, 워드프레스에 판매 기능을 연동해 사용할 수 있습니다.

코드 예시 보기
<?php
use Clayful\Clayful;
use Clayful\Product;

Clayful::config(array(
  'client' => '<api-access-token>'
));

try {

  $result = Product::query(array(
    'query' => array('page' => 1)
  ));

  $products = $result->data;

  print_r($products);

} catch (Exception $e) {

  // Error case
  echo $e->code;

}
                

Python SDK

Python 기반 서버에 판매 기능을 추가해보세요. Django, Flask 등의 프레임워크에 판매 기능을 연동해 사용할 수 있습니다.

코드 예시 보기
from clayful import Clayful

Product = Clayful.Product

Clayful.config({
  'client': '<api-access-token>'
})

try:

  result = Product.list({
    'query': { 'page': 1 }
  })

  products = result.data

  print(products)

except Exception as e:

  # Error case
  print(e.code)
                

Ruby SDK

Ruby 기반 서버에 판매 기능을 추가해보세요. Rails, Hanami 등의 프레임워크에 판매 기능을 연동해 사용할 수 있습니다.

코드 예시 보기
require 'clayful'

Product = Clayful::Product

Clayful.config({
  'client' => '<api-access-token>'
})

begin

  result = Product.list({
    'query' => { 'page' => 1 }
  })

  products = result.data

  puts products

rescue Exception => e

  # Error case
  puts e.code

end
                

RESTful API

그 외 개발 환경에서 HTTPS 기반의 API를 이용해 판매 기능을 연동해 사용할 수 있습니다.

코드 예시 보기
GET /v1/products HTTP/1.1
Host: api.clayful.io
Accept: application/json
Accept-Encoding: gzip
Authorization: Bearer <api-access-token>
                

API&SDK 무작정 따라하기

#1. 연동 준비하기

클레이풀에 가입한 후 스토어를 생성하고, 스토어의 관리자 페이지에서 플랫폼에 사용할 연동 클라이언트를 생성한 뒤 인증 토큰을 생성해주세요.

#2. 언어별 SDK 설치하기

사용 중인 개발 언어에 따라 제공되는 공식 SDK를 패키지 매니저, CDN 혹은 클레이풀의 GitHub을 통해서 설치한 뒤 임포트 해 주세요.

#3. API 호출하기

연동 클라이언트 인증 토큰을 SDK에 설정하고, 제공되는 함수를 호출해 바로 사용할 수 있는 상품 목록의 JSON 정보를 불러와보세요.

💬 API&SDK에 대해 궁금하신 점이 있으신가요?

현재 기획/개발하시려는 플랫폼에 사용은 가능한지... 기능 요건은 맞을지 고민되시나요?

상담을 요청하시면 솔루션 도입부터 이용까지 자세한 상담을 도와드리겠습니다.

SDK가 지원되지 않는 개발 언어에서는 API를 사용할 수 없나요?

현재 SDK가 제공되지 않는 프로그래밍 언어에서 클레이풀을 사용하시려는 경우에는 각 개발 언어에서 제공되는 HTTP 요청 함수 및 라이브러리를 통해서 클레이풀의 API를 연동하실 수 있습니다. 약 사용하시는 언어에 직접 라이브러리를 개발해서 사용하시려는 경우에 리소스나 도움이 필요하시다면 고객 센터를 통해 부담 없이 연락해주세요. 개발에 사용할 수 있는 정보들을 공유해드리도록 하겠습니다.

PG사를 통한 주문 결제는 클레이풀의 API를 통해서 개발해야 하나요?

주문 금액 결제에 대한 부분은 클레이풀의 API를 통해 이루어지는 것은 아니며, 결제사의 API 혹은 모듈을 통해 직접 연동하셔야 합니다. 하지만 현재 클레이풀에서는 아임포트를 통해서 주문 금액 결제부를 연동하는 경우, 클레이풀의 API를 통해 아임포트의 결제 내역을 검증하고 주문 상태에 동기화하는 API를 제공하고 있습니다. 만약 그 외의 커스텀 결제 수단을 직접적으로 연동하고 싶으시다면, 결제 통화/금액에 대한 검증과 결제 금액 정보를 주문에 반영하는 로직을 직접 개발하시면 클레이풀에 연동해 이용하실 수 있습니다.

Frequently Asked Questions

자주 물어보시는 질문들을 정리해보았습니다.