[Ruby - Rails] SDK 적용방법 | 링크허브 개발가이드

[Ruby – Rails] SDK 적용방법

주소링크 연동서비스

SDK 적용방법

2017.11.13

본 개발가이드는 주소링크에서 제공하는 주소 API를 쉽고 빠르게 시스템에 연동할 수 있도록, 주소 API 예제를 통해 ‘개발환경 구성’ 방법을 상세히 안내드립니다.

Ruby V2.0.0 이상 지원
Ruby On Rails V4.0.0 기반으로 제작
API 호출과 응답에 사용되는 메시지 인코딩 방식은 “UTF-8 Character-Set” 적용

1. SDK 이용방법 안내

SDK를 이용하기 위해서는 주소링크 API 서비스 Gem 추가를 위한 ‘bundle install’ 과 통신전문 보안에 사용되는 ‘인증정보 설정’ 이 필요합니다. 다음의 설명에 따라 SDK를 이용하시기 바랍니다.

bundle install

예제 프로젝트에 주소링크 API 서비스 Gem 추가를 위해서 “Gemfile” 파일에 다음의 코드가 추가되어 있는지 확인하고 gem 라이브러리 설치를 위해 ‘bundle install’ 를 진행합니다. Gem 설치후 이후 rvm list에서 jusolink 와 linkhub Gem이 정상적으로 설치되었는지 확인합니다.

source 'https://rubygems.org'

# Bundle edge Rails instead: gem 'rails', github: 'rails/rails'
gem 'rails', '4.0.0'

# 주소링크 API Service
gem 'jusolink', '1.0.0'

source 'https://rubygems.org'

# Bundle edge Rails instead: gem 'rails', github: 'rails/rails'

gem 'rails', '4.0.0'

# 주소링크 API Service

gem 'jusolink', '1.0.0'

인증정보 설정

bundle install 완료 후 controller 파일에 링크아이디(LinkID)와 비밀키(SecretKey)를 주소링크 가입시 발급받은 링크아이디와 비밀키로 수정하면 인증정보 설정이 완료됩니다.

class JusolinkController < ApplicationController

  # 링크아이디
  LinkID = "TESTER"

  # 비밀키
  SecretKey = "SwWxqU+0TErBXy/9TVjIPEnI0VTUMMSQZtJf3Ed8q3I="

  # 주소링크 API Service 초기화
  JusoService = Jusolink.instance(
    JusolinkController::LinkID,
    JusolinkController::SecretKey
  )