Square API 시작하기

Square API를 사용하기 쉽습니다. 먼저 개발자 포털에 로그인합니다. Square API 사이트 에서 개발자 포털에 넣습니다.



로그인하면 애플리케이션 대시보드가 ​​표시됩니다. 처음에는 New Application을 클릭합니다.



새 애플리케이션을 사용할 수 있으면 자격 증명으로 애플리케이션 ID와 개인 액세스 토큰이 표시됩니다. 이것은 모두 중요한 정보이므로 취급에주의하십시오.



동시에 샌드박스용 애플리케이션 ID와 액세스 토큰도 생성됩니다. 이 샌드박스라고 하는 환경은 API의 테스트 환경이 됩니다. 여기서 결제를 했다고 해도 과금되는 것은 아니기 때문에 API를 시험해 보기에 딱 맞는 환경입니다. 이 샌드박스는 v2에만 제공되므로 주의하십시오.

먼저 이 샌드박스 환경을 사용하여 API를 호출해 봅시다. 이번에는 Ruby를 사용합니다.

개발자 문서에 따르면 unirest이라는 라이브러리를 사용하는 것이 좋습니다. unirest는 HTTP 액세스를 용이하게 해주는 라이브러리로, Ruby뿐만 아니라 Python/Node/PHP/Java/Objective-C/.NET/Windows 8등에서 이용할 수 있게 되어 있습니다. 공통적인 사용성이므로, 다른 언어로 환승했을 때에도 곧바로 잘 다룰 수 있을 것입니다.

먼저 unirest를 설치합니다. 명령줄에서 수행합니다.

$ gem install unirest

그리고 테스트 코드는 다음과 같습니다. YOUR_SANDBOX_ACCESS_TOKEN 라고 쓰여진 부분은 샌드 박스 환경의 액세스 토큰을 기술해 주세요.

require 'unirest'

access_token = 'YOUR_SANDBOX_ACCESS_TOKEN'

response = Unirest.get 'https://connect.squareup.com/v2/locations', 
  headers: {
    'Accept': 'application/json',
    'Authorization': 'Bearer ' + access_token
  }

puts response.body

위 내용을 squre.rb로 저장합니다.

이번에는 Location API을 시도합니다. 이것은 점포 등의 거점 정보를 얻을 수 있는 API입니다.

실행하면 아래와 같이 결과가 표시됩니다.

$ ruby squre.rb 
{
  "locations"=>[
    {
      "id"=>"CBASEJqRSQmT1vVfMXar4RcrtCcgAQ",
      "name"=>"ヤマモト 東京",
      "address"=>{
        "address_line_1"=>"中　１丁目",
        "locality"=>"東京都",
        "administrative_district_level_1"=>"国立市",
        "postal_code"=>"186-0004",
        "country"=>"JP"
      },
      "timezone"=>"Asia/Tokyo",
      "capabilities"=>[
        "CREDIT_CARD_PROCESSING"
      ],
      "status"=>"ACTIVE"
    }
  ]
}

거점의 하나인 야마모토 도쿄(이것은 샌드박스 환경이므로 데모 데이터입니다)의 데이터를 얻을 수 있었습니다.

이렇게 API를 사용하면 Square에서 쉽게 데이터를 검색하거나 반대로 데이터 등록도 할 수 있도록되어 있습니다. 문서는 Square Connect API Documentation 에 있으므로 구현시에는 꼭 읽어 주세요.