sendgo-rails 1.3.0 → 1.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 95e1374d1b5f84fa58732630066ebabf4d29bd75cee705cef5e6398b1a3c8ab1
-  data.tar.gz: f4f36a5d8a21c9da987fb19f53cf3eb5ce8a521bcc22c45c6183a12aeeca5cce
+  metadata.gz: cc412adcfe81399e2579d8cfdd15d04788ea48903720cde537570dc460fc5fc8
+  data.tar.gz: 9e6f2b3fcf8668a96f69bac0495225e1d8cb8bd9b25af4bd780d19f2a1177149
 SHA512:
-  metadata.gz: 448c5b0dedf51f6570ae14f02ba3f13d04aa97872f58e2616bbdc62bb93bb0818e244597cd11fcfa7dd90fb36b88fdf3e0f58cfdf580822373865bb53f590557
-  data.tar.gz: c0796b9defc6863f42ff8fc4a391d07c5337eb48834ad57a45f1dc7a570002b4e5002101b0a5a18ef368693a8856303a4b9a8acf00f9021957eb429d95ee87d0
+  metadata.gz: 447561939b34c8f3664b0a4ebbb0a131460fbc807587200c9f9117ffda6f3275dcb6c8f367d32baf951f2401c124ae9af2b4c105faea7737ff7851f59df3dc6a
+  data.tar.gz: ecaeaba889ff07b187b109b3260d92d30f6fb4472b0db383cbccd681a571930fc59f04adf4bbc0b6c3d87bc29717b9a90ede8b58e097fb2a2a41ace265095646

data/README.md

@@ -476,3 +476,46 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 Rails, 카카오 친구톡 Rails, SMS 발송 Rails, 알림톡 Rails gem, Rails 카카오 API 연동, Rails Railtie, Sendgo Rails SDK*
+
+## 계정 API (1.5.0)
+
+코어 1.5.0의 계정·조직·API 키·허용 IP 관리 12개 API를 사용할 수 있습니다.
+발송용 키 없이 에이전트 토큰만으로 구성할 수 있습니다.
+
+발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
+콘솔에서 발급받은 에이전트 토큰(`SENDGO_AGENT_TOKEN`)으로 `/api/v2/account`를 호출합니다.
+계정 조회에는 `account:read`, 키·허용 IP 변경에는 `keys:write` 권한이 필요합니다.
+토큰 만료나 권한 부족(401/403)은 그대로 예외로 반환하며 자동 갱신·재시도하지 않습니다.
+
+조직 선택은 서버에 저장되는 **사용자 계정의 현재 조직**을 바꿉니다. 같은 사용자로
+여러 조직의 설정을 동시에 변경하지 마세요. 개인 계정으로 돌아가려면 조직 ID에
+`null`(Python `None`, Ruby `nil`, Go `nil`) 또는 `personal`을 전달합니다.
+키 발급 응답의 `data.apiKey.secretKey`는 한 번만 반환되므로 서버의 비밀 저장소에 보관하세요.
+허용 IP가 하나라도 등록되면 목록 밖의 IP는 차단됩니다.
+에이전트 토큰과 키는 브라우저·모바일 앱에 포함하거나 응답·로그에 출력하지 않습니다.
+
+```ruby
+# SENDGO_AGENT_TOKEN 또는 config.sendgo.agent_token을 설정합니다.
+status = Sendgo::Rails.account_client.me
+```
+
+## 템플릿 폴더 (1.5.0)
+
+기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
+폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
+목록은 `data.folders` 트리와 `total`, `uncategorised` 개수를 반환합니다.
+`templateCount`는 하위 폴더를 제외한 해당 폴더의 템플릿 수입니다.
+
+- 생성: `name`, 선택 `parentUuid`. 최대 5단계이며 같은 부모 아래 이름 중복은 409입니다.
+- 이동: 동일 발신프로필의 `templateCodes` 1~100개. `folderUuid`는 필수이며 `null`이면 미분류로 이동합니다.
+- 템플릿 목록: `folderUuid=none`은 미분류, UUID는 해당 폴더, 생략은 전체입니다.
+- 템플릿 등록: 선택 필드 `folderUuid`로 폴더를 지정합니다. 기존 템플릿 수정 API 대신 폴더 이동 API를 사용하세요.
+
+승인되지 않은 키의 `403 ACCESS_KEY_NOT_APPROVED`는 토큰 재발급·재시도 없이 반환합니다.
+계정 API의 `autoApprove`는 서버 설정의 실제 승인 정책을 나타냅니다.
+
+```ruby
+Sendgo::Rails.client.template_folders.list(template_type: "notice")
+```
+
+코어 1.5.0 이상이 필요합니다. 전체 메서드는 [코어 문서](https://github.com/send-go/ruby#템플릿-폴더-150)를 참고하세요.

data/lib/sendgo/rails/version.rb

@@ -1,6 +1,6 @@
 module Sendgo
   module Rails
     # sendgo-rails 젬 버전
-    VERSION = "1.3.0"
+    VERSION = "1.5.0"
   end
 end

data/lib/sendgo/rails.rb

@@ -33,6 +33,14 @@ module Sendgo
         @client ||= build_client
       end
 
+      # 발송용 키 없이 계정 클라이언트를 만듭니다.
+      def account_client
+        Sendgo::AccountClient.new(
+          agent_token: config_value(:agent_token, "SENDGO_AGENT_TOKEN"),
+          base_url: config_value(:url, "SENDGO_URL") || "https://sendgo.io"
+        )
+      end
+
       # 메모이즈된 클라이언트를 초기화한다. (주로 테스트에서 사용)
       #
       # @return [void]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sendgo-rails
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Sendgo
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-11 00:00:00.000000000 Z
+date: 2026-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sendgo
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.3'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement