sendgo-rails 1.4.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 +4 -4
- data/README.md +52 -2
- data/lib/sendgo/rails/version.rb +1 -1
- metadata +4 -4
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 90aca37aae9b5fde1bf76de27cc6af017fd123e61c35eb42eca61063ec5984e0
|
|
4
|
+
data.tar.gz: c8233f607116c07ffbb027a78b759e1d52ffa644e55be9db8091a64232cdf926
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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.
|
|
480
|
+
## 계정 API (1.6.0)
|
|
481
481
|
|
|
482
|
-
코어 1.
|
|
482
|
+
코어 1.6.0의 계정·조직·API 키·허용 IP 관리 12개 API를 사용할 수 있습니다.
|
|
483
483
|
발송용 키 없이 에이전트 토큰만으로 구성할 수 있습니다.
|
|
484
484
|
|
|
485
485
|
발송용 `accessKey`/`secretKey`가 없는 단계에서 사용하는 **별도 계정 클라이언트**입니다.
|
|
@@ -498,3 +498,53 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
|
|
|
498
498
|
# SENDGO_AGENT_TOKEN 또는 config.sendgo.agent_token을 설정합니다.
|
|
499
499
|
status = Sendgo::Rails.account_client.me
|
|
500
500
|
```
|
|
501
|
+
|
|
502
|
+
## 템플릿 폴더 (1.6.0)
|
|
503
|
+
|
|
504
|
+
기업 계정의 발송용 API 키와 `apiVersion=v2` 설정으로 사용하는 서버 전용 API입니다.
|
|
505
|
+
폴더는 알림톡·브랜드메시지가 공유하며, 목록의 `templateType`은 `notice` 또는 `brand`입니다.
|
|
506
|
+
목록은 `data.folders` 트리와 `total`, `uncategorised` 개수를 반환합니다.
|
|
507
|
+
`templateCount`는 하위 폴더를 제외한 해당 폴더의 템플릿 수입니다.
|
|
508
|
+
|
|
509
|
+
- 생성: `name`, 선택 `parentUuid`. 최대 5단계이며 같은 부모 아래 이름 중복은 409입니다.
|
|
510
|
+
- 이동: 동일 발신프로필의 `templateCodes` 1~100개. `folderUuid`는 필수이며 `null`이면 미분류로 이동합니다.
|
|
511
|
+
- 템플릿 목록: `folderUuid=none`은 미분류, UUID는 해당 폴더, 생략은 전체입니다.
|
|
512
|
+
- 템플릿 등록: 선택 필드 `folderUuid`로 폴더를 지정합니다. 기존 템플릿 수정 API 대신 폴더 이동 API를 사용하세요.
|
|
513
|
+
|
|
514
|
+
승인되지 않은 키의 `403 ACCESS_KEY_NOT_APPROVED`는 토큰 재발급·재시도 없이 반환합니다.
|
|
515
|
+
계정 API의 `autoApprove`는 서버 설정의 실제 승인 정책을 나타냅니다.
|
|
516
|
+
|
|
517
|
+
```ruby
|
|
518
|
+
Sendgo::Rails.client.template_folders.list(template_type: "notice")
|
|
519
|
+
```
|
|
520
|
+
|
|
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입니다.
|
data/lib/sendgo/rails/version.rb
CHANGED
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.
|
|
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-
|
|
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.
|
|
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.
|
|
26
|
+
version: '1.6'
|
|
27
27
|
- !ruby/object:Gem::Dependency
|
|
28
28
|
name: railties
|
|
29
29
|
requirement: !ruby/object:Gem::Requirement
|