sendgo-fastapi 1.0.0__tar.gz → 1.2.0__tar.gz

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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: sendgo-fastapi
3
- Version: 1.0.0
3
+ Version: 1.2.0
4
4
  Summary: Sendgo FastAPI 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS
5
5
  Author-email: Sendgo <dev@sendgo.io>
6
6
  License: MIT
@@ -26,7 +26,7 @@ Dynamic: license-file
26
26
 
27
27
  # sendgo-fastapi
28
28
 
29
- > **FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
29
+ > **FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
30
30
 
31
31
  [![PyPI](https://img.shields.io/pypi/v/sendgo-fastapi)](https://pypi.org/project/sendgo-fastapi/)
32
32
  [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -211,6 +211,19 @@ async def confirm(order_id: str, sendgo: SendgoDep):
211
211
 
212
212
  ### 친구톡
213
213
 
214
+ > ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
215
+ > 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
216
+ > 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
217
+ > 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
218
+ >
219
+ > 다음의 경우에는 **브랜드메시지**를 사용하세요.
220
+ > - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
221
+ > - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
222
+ > - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
223
+ >
224
+ > 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
225
+ > `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
226
+
214
227
  ```python
215
228
  # 텍스트형
216
229
  sendgo.friendtalk.send(
@@ -414,6 +427,41 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
414
427
 
415
428
  ---
416
429
 
430
+ ## 브랜드메시지 · 짧은 URL
431
+
432
+ 이 패키지는 코어(`sendgo-python`)의 클라이언트를 그대로 노출하므로, 코어에 있는 채널이
433
+ 모두 그대로 쓸 수 있습니다. 두 기능 모두 **v2 전용**입니다.
434
+
435
+ | 기능 | 접근 |
436
+ |------|------|
437
+ | 카카오 브랜드메시지 (친구톡의 후속 채널) | `sendgo.brand_message` |
438
+ | 짧은 URL (단축 + 클릭 반응 분석) | `sendgo.short_url` |
439
+
440
+ 브랜드메시지는 채널 친구가 아닌 수신자에게도 보낼 수 있고(`targeting` = `N`),
441
+ 수신 동의한 전체 채널 친구에게 동보 발송할 수도 있습니다(`targeting` = `F`).
442
+
443
+ 짧은 URL 은 메시지 본문의 링크를 줄이고 클릭 반응(일별 추이·디바이스·유입경로·국가)을
444
+ 집계합니다.
445
+
446
+ 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
447
+ [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
448
+
449
+ ## 변경 사항
450
+
451
+ ### 1.2.0 (2026-08-14)
452
+
453
+ - **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
454
+ 2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
455
+ 관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
456
+ - 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
457
+ 문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
458
+ - 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
459
+ - 짧은 URL 지원 (1.1.0 릴리스 누락분 포함).
460
+
461
+ ### 1.1.0 (2026-08-11)
462
+
463
+ - 브랜드메시지·짧은 URL 접근 방법 문서화 (코어를 그대로 노출)
464
+
417
465
  ## 라이선스
418
466
 
419
467
  MIT License © 2026 [Sendgo](https://sendgo.io)
@@ -1,6 +1,6 @@
1
1
  # sendgo-fastapi
2
2
 
3
- > **FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
3
+ > **FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
4
4
 
5
5
  [![PyPI](https://img.shields.io/pypi/v/sendgo-fastapi)](https://pypi.org/project/sendgo-fastapi/)
6
6
  [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -185,6 +185,19 @@ async def confirm(order_id: str, sendgo: SendgoDep):
185
185
 
186
186
  ### 친구톡
187
187
 
188
+ > ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
189
+ > 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
190
+ > 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
191
+ > 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
192
+ >
193
+ > 다음의 경우에는 **브랜드메시지**를 사용하세요.
194
+ > - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
195
+ > - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
196
+ > - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
197
+ >
198
+ > 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
199
+ > `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
200
+
188
201
  ```python
189
202
  # 텍스트형
190
203
  sendgo.friendtalk.send(
@@ -388,6 +401,41 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
388
401
 
389
402
  ---
390
403
 
404
+ ## 브랜드메시지 · 짧은 URL
405
+
406
+ 이 패키지는 코어(`sendgo-python`)의 클라이언트를 그대로 노출하므로, 코어에 있는 채널이
407
+ 모두 그대로 쓸 수 있습니다. 두 기능 모두 **v2 전용**입니다.
408
+
409
+ | 기능 | 접근 |
410
+ |------|------|
411
+ | 카카오 브랜드메시지 (친구톡의 후속 채널) | `sendgo.brand_message` |
412
+ | 짧은 URL (단축 + 클릭 반응 분석) | `sendgo.short_url` |
413
+
414
+ 브랜드메시지는 채널 친구가 아닌 수신자에게도 보낼 수 있고(`targeting` = `N`),
415
+ 수신 동의한 전체 채널 친구에게 동보 발송할 수도 있습니다(`targeting` = `F`).
416
+
417
+ 짧은 URL 은 메시지 본문의 링크를 줄이고 클릭 반응(일별 추이·디바이스·유입경로·국가)을
418
+ 집계합니다.
419
+
420
+ 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
421
+ [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
422
+
423
+ ## 변경 사항
424
+
425
+ ### 1.2.0 (2026-08-14)
426
+
427
+ - **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
428
+ 2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
429
+ 관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
430
+ - 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
431
+ 문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
432
+ - 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
433
+ - 짧은 URL 지원 (1.1.0 릴리스 누락분 포함).
434
+
435
+ ### 1.1.0 (2026-08-11)
436
+
437
+ - 브랜드메시지·짧은 URL 접근 방법 문서화 (코어를 그대로 노출)
438
+
391
439
  ## 라이선스
392
440
 
393
441
  MIT License © 2026 [Sendgo](https://sendgo.io)
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "sendgo-fastapi"
7
- version = "1.0.0"
7
+ version = "1.2.0"
8
8
  description = "Sendgo FastAPI 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS"
9
9
  readme = "README.md"
10
10
  license = {text = "MIT"}
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: sendgo-fastapi
3
- Version: 1.0.0
3
+ Version: 1.2.0
4
4
  Summary: Sendgo FastAPI 확장 — 카카오 알림톡/친구톡, SMS/LMS/MMS
5
5
  Author-email: Sendgo <dev@sendgo.io>
6
6
  License: MIT
@@ -26,7 +26,7 @@ Dynamic: license-file
26
26
 
27
27
  # sendgo-fastapi
28
28
 
29
- > **FastAPI에서 카카오 알림톡, 친구톡, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
29
+ > **FastAPI에서 카카오 알림톡, 브랜드메시지, SMS를 가장 쉽게 발송하는 공식 FastAPI 확장 패키지**
30
30
 
31
31
  [![PyPI](https://img.shields.io/pypi/v/sendgo-fastapi)](https://pypi.org/project/sendgo-fastapi/)
32
32
  [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python)](https://python.org)
@@ -211,6 +211,19 @@ async def confirm(order_id: str, sendgo: SendgoDep):
211
211
 
212
212
  ### 친구톡
213
213
 
214
+ > ⚠️ **Deprecated — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었습니다.**
215
+ > 2026-01-01 부터 친구톡 발송 요청은 카카오 측에서 **브랜드메시지(자유형)** 로 자동 대체 발송됩니다.
216
+ > 호출은 계속 성공하며, 자유 본문 타입(`FT`/`FI`/`FW`)을 개별 수신자에게 보내는 경로는
217
+ > 현재 이것뿐이므로 기존 코드를 당장 바꿀 필요는 없습니다.
218
+ >
219
+ > 다음의 경우에는 **브랜드메시지**를 사용하세요.
220
+ > - 템플릿 기반 리치 타입 (`FL`/`FC`/`FM`/`FP`/`FA`)
221
+ > - 채널 친구가 **아닌** 수신자 (`targeting` = `N` / `I`)
222
+ > - 수신 동의한 전체 채널 친구 동보 (`targeting` = `F`)
223
+ >
224
+ > 메시지 타입은 1:1 대응되며 변환은 서버가 처리합니다 — `FT`→`BT`, `FI`→`BI`, `FW`→`BW`,
225
+ > `FL`→`BL`, `FC`→`BC`, `FM`→`BM`, `FP`→`BP`, `FA`→`BA`.
226
+
214
227
  ```python
215
228
  # 텍스트형
216
229
  sendgo.friendtalk.send(
@@ -414,6 +427,41 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
414
427
 
415
428
  ---
416
429
 
430
+ ## 브랜드메시지 · 짧은 URL
431
+
432
+ 이 패키지는 코어(`sendgo-python`)의 클라이언트를 그대로 노출하므로, 코어에 있는 채널이
433
+ 모두 그대로 쓸 수 있습니다. 두 기능 모두 **v2 전용**입니다.
434
+
435
+ | 기능 | 접근 |
436
+ |------|------|
437
+ | 카카오 브랜드메시지 (친구톡의 후속 채널) | `sendgo.brand_message` |
438
+ | 짧은 URL (단축 + 클릭 반응 분석) | `sendgo.short_url` |
439
+
440
+ 브랜드메시지는 채널 친구가 아닌 수신자에게도 보낼 수 있고(`targeting` = `N`),
441
+ 수신 동의한 전체 채널 친구에게 동보 발송할 수도 있습니다(`targeting` = `F`).
442
+
443
+ 짧은 URL 은 메시지 본문의 링크를 줄이고 클릭 반응(일별 추이·디바이스·유입경로·국가)을
444
+ 집계합니다.
445
+
446
+ 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
447
+ [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
448
+
449
+ ## 변경 사항
450
+
451
+ ### 1.2.0 (2026-08-14)
452
+
453
+ - **친구톡 Deprecated 표기** — 친구톡은 카카오 정책에 따라 2025-12-31 종료되었고,
454
+ 2026-01-01 부터 발송 요청이 브랜드메시지(자유형)로 자동 대체 발송됩니다.
455
+ 관련 API 에 각 언어의 표준 deprecation 표기를 달았습니다.
456
+ - 자유 본문 타입(`FT`/`FI`/`FW`)의 개별 발송 경로는 아직 친구톡 API 뿐이라는 점을
457
+ 문서에 명시했습니다 — 브랜드메시지 API 는 그 조합에 `NOT_A_BRAND_MESSAGE` 를 반환합니다.
458
+ - 브랜드메시지 전환 안내와 메시지 타입 1:1 대응표를 README 에 추가했습니다.
459
+ - 짧은 URL 지원 (1.1.0 릴리스 누락분 포함).
460
+
461
+ ### 1.1.0 (2026-08-11)
462
+
463
+ - 브랜드메시지·짧은 URL 접근 방법 문서화 (코어를 그대로 노출)
464
+
417
465
  ## 라이선스
418
466
 
419
467
  MIT License © 2026 [Sendgo](https://sendgo.io)
File without changes
File without changes