sendgo-rails 1.5.0 → 1.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: cc412adcfe81399e2579d8cfdd15d04788ea48903720cde537570dc460fc5fc8
4
- data.tar.gz: 9e6f2b3fcf8668a96f69bac0495225e1d8cb8bd9b25af4bd780d19f2a1177149
3
+ metadata.gz: 90aca37aae9b5fde1bf76de27cc6af017fd123e61c35eb42eca61063ec5984e0
4
+ data.tar.gz: c8233f607116c07ffbb027a78b759e1d52ffa644e55be9db8091a64232cdf926
5
5
  SHA512:
6
- metadata.gz: 447561939b34c8f3664b0a4ebbb0a131460fbc807587200c9f9117ffda6f3275dcb6c8f367d32baf951f2401c124ae9af2b4c105faea7737ff7851f59df3dc6a
7
- data.tar.gz: ecaeaba889ff07b187b109b3260d92d30f6fb4472b0db383cbccd681a571930fc59f04adf4bbc0b6c3d87bc29717b9a90ede8b58e097fb2a2a41ace265095646
6
+ metadata.gz: 96e56ce2567266a13fce6807f17a09cc1ca9344af3a19b9600dd359db0c22d4bfa591355f55487f7b54fa5ff018499248504c2040cdcb8ac85a32d6748a30996
7
+ data.tar.gz: ec941d47d12c0f72dc7462a8abc9a616ea3f882688c6184fb7a1da02cf8303085f79eeb70062f0e91e43ff459a6fc7ab0cb09c66b1c0d95ae406a04a4d427b2b
data/README.md CHANGED
@@ -477,9 +477,9 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
477
477
 
478
478
  *키워드: 카카오 알림톡 Rails, 카카오 친구톡 Rails, SMS 발송 Rails, 알림톡 Rails gem, Rails 카카오 API 연동, Rails Railtie, Sendgo Rails SDK*
479
479
 
480
- ## 계정 API (1.5.0)
480
+ ## 계정 API (1.6.0)
481
481
 
482
- 코어 1.5.0의 계정·조직·API 키·허용 IP 관리 12개 API를 사용할 수 있습니다.
482
+ 코어 1.6.0의 계정·조직·API 키·허용 IP 관리 12개 API를 사용할 수 있습니다.
483
483
  발송용 키 없이 에이전트 토큰만으로 구성할 수 있습니다.
484
484
 
485
485
  발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
@@ -499,7 +499,7 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
499
499
  status = Sendgo::Rails.account_client.me
500
500
  ```
501
501
 
502
- ## 템플릿 폴더 (1.5.0)
502
+ ## 템플릿 폴더 (1.6.0)
503
503
 
504
504
  기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
505
505
  폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
@@ -518,4 +518,33 @@ status = Sendgo::Rails.account_client.me
518
518
  Sendgo::Rails.client.template_folders.list(template_type: "notice")
519
519
  ```
520
520
 
521
- 코어 1.5.0 이상이 필요합니다. 전체 메서드는 [코어 문서](https://github.com/send-go/ruby#템플릿-폴더-150)를 참고하세요.
521
+ 코어 1.6.0 이상이 필요합니다. 전체 메서드는 [코어 문서](https://github.com/send-go/ruby#템플릿-폴더-150)를 참고하세요.
522
+
523
+ ## 1.6 이메일 API와 브랜드 타기팅
524
+
525
+ 이메일은 서버 전용이며 클라이언트 설정에서 API 버전을 `v2`로 지정합니다.
526
+ 브랜드 타기팅은 `M`(친구+비친구), `N`(비친구), `I`(친구교집합),
527
+ `O`(친구만), `F`(동보)를 지원합니다. `O`는 SDK에서 바꾸지 않고 서버로 전달합니다.
528
+
529
+ 이메일 발송·견적·조회·취소, 발신자·도메인 인증, 자격증명, 수신함·원본 EML,
530
+ 템플릿·주소록·연락처·발신자 프로필·캠페인 API를 지원합니다.
531
+ 일반 API는 기존 앱 Bearer 인증을 사용합니다. `EmailService`의
532
+ `withCredentials` / `with_credentials` / `WithCredentials` / Go `NewEmailWithCredentials`는
533
+ 별도로 발급된 이메일 credential ID/password를 사용하며 `/api/v2/email-service`로 호출합니다.
534
+ 이 인증은 auth, 발송·견적·조회·취소와 도메인 API에만 사용할 수 있습니다.
535
+ 내부 email-gateway, 공개 서명 수신거부 URL은 SDK 관리 API가 아닙니다.
536
+
537
+ 단건 `to`는 이메일 주소 하나입니다. `send`에는 `idempotency_key`를 반드시 지정하고
538
+ 같은 발송의 재시도에는 같은 키를 재사용하세요. 캠페인 발송에는 견적 응답의
539
+ `quote_hash`와 `idempotency_key`가 필요합니다. SDK가 키를 임의 생성하거나
540
+ 네트워크 오류·429·5xx를 자동 재시도하지 않습니다. Bearer 401만 최대 한 번
541
+ 갱신하며, 이메일 권한 거부 403 및 Basic 인증 실패는 그대로 반환합니다.
542
+ 마케팅 발송에는 `sender_name`, `sender_address`, `sender_contact`도 필요합니다.
543
+ 첨부는 `attachments: [{name, type, content}]`이며 content는 base64입니다.
544
+
545
+ 응답은 서버 JSON 객체 또는 배열을 그대로 반환하며 204는 null/nil/None입니다.
546
+ 원본 EML은 바이트(PHP/Ruby는 바이트 문자열)로 반환합니다. Java/Go/.NET/Dart는
547
+ 여러 응답 형태를 담는 Object/any/object/dynamic을 사용합니다(.NET JSON은 JsonElement).
548
+ 모든 관리 요청 본문은 서버 필드명(snake_case)을 그대로 사용합니다.
549
+
550
+ 접근 방법: `Sendgo::Rails.client.email`. 코어 최소 버전은 1.6.0입니다.
@@ -1,6 +1,6 @@
1
1
  module Sendgo
2
2
  module Rails
3
3
  # sendgo-rails 젬 버전
4
- VERSION = "1.5.0"
4
+ VERSION = "1.6.0"
5
5
  end
6
6
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: sendgo-rails
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.5.0
4
+ version: 1.6.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Sendgo
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-09-23 00:00:00.000000000 Z
11
+ date: 2026-10-03 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: sendgo
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '1.5'
19
+ version: '1.6'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '1.5'
26
+ version: '1.6'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: railties
29
29
  requirement: !ruby/object:Gem::Requirement