sendgo-fastapi 1.2.1__tar.gz → 1.3.0__tar.gz

{sendgo_fastapi-1.2.1/sendgo_fastapi.egg-info → sendgo_fastapi-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-fastapi
-Version: 1.2.1
+Version: 1.3.0
 Summary: Sendgo FastAPI 확장 — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sendgo-python>=1.0
+Requires-Dist: sendgo-python>=1.3
 Requires-Dist: fastapi>=0.110
 Requires-Dist: pydantic-settings>=2.0
 Dynamic: license-file
@@ -446,8 +446,114 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
 [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
 
+## 관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
+
+코어(`sendgo-python`)의 관리 서비스가 주입받은 클라이언트에 그대로 붙어
+있습니다. 콘솔에서만 되던 등록·심사를 라우트에서 처리할 수 있습니다.
+
+| 접근 | 하는 일 | 계정 |
+| --- | --- | --- |
+| `.kakao_senders` | 카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
+| `.notice_templates` | 알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
+| `.brand_templates` | 브랜드메시지 템플릿 CRUD, 동기화, 가져오기 | 기업 |
+| `.sender_registration` | 발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
+| `.message_templates` | 문자 상용구 템플릿 CRUD | 개인·기업 |
+| `.kakao_images` | 카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
+| `.rejected_numbers` | 수신거부(080) 번호 조회 | 개인·기업 |
+| `.webhook` | 이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
+
+> **sendgo.io 콘솔에 들어올 일이 없습니다.** 휴대폰 발신번호는 PASS 대신
+> 신분증 사본을 받아 sendgo 운영자가 대신 심사합니다. 사람이 개입하는 지점은
+> 카카오 채널 인증번호 하나뿐이고, 그것도 여러분 화면에서 입력받으면 됩니다.
+> 심사가 붙는 것들은 비동기라 웹훅으로 결과를 받으세요.
+
+```python
+from fastapi import APIRouter, BackgroundTasks, HTTPException, UploadFile
+from sendgo import SendgoError
+from sendgo_fastapi import SendgoDep
+
+router = APIRouter(prefix="/onboarding")
+
+
+@router.post("/channel/code")
+async def request_channel_code(yellow_id: str, phone: str, sendgo: SendgoDep):
+    """1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다."""
+    return sendgo.kakao_senders.request_token(yellow_id, phone)
+
+
+@router.post("/channel")
+async def register_channel(yellow_id: str, phone: str, code: str, sendgo: SendgoDep):
+    """2단계 — 사용자가 입력한 인증번호로 발신프로필 생성."""
+    created = sendgo.kakao_senders.create(
+        token=code,
+        yellow_id=yellow_id,
+        phone_number=phone,
+        category_code="001001",
+    )
+    return created["data"]["sender"]
+
+
+@router.post("/templates")
+async def provision_template(kakao_sender_key: str, sendgo: SendgoDep):
+    try:
+        created = sendgo.notice_templates.create(
+            kakao_sender_key=kakao_sender_key,
+            template_name="주문 접수 안내",
+            template_content="#{name}님, 주문 #{orderNo}이 접수되었습니다.",
+            template_message_type="BA",
+            template_emphasize_type="NONE",
+            category_code="001001",
+            message_purpose="order_delivery",
+            legal_basis="transaction",
+            benefit_origin="none",
+            expiry_type="none",
+        )
+    except SendgoError as exc:
+        # POLICY_VALIDATION_FAILED 면 errors["reasons"] 에 한국어 사유가 담긴다
+        raise HTTPException(status_code=422, detail=exc.errors) from exc
+
+    code = created["data"]["template"]["templateCode"]
+    sendgo.notice_templates.request_inspection(code)
+
+    return {"templateCode": code, "inspectionStatus": "REQ"}
+
+
+@router.post("/senders")
+async def register_sender(alias: str, phone: str, csu: UploadFile, sendgo: SendgoDep):
+    """발신번호 등록 신청. 접수만 되고(PENDING) 운영자 승인 후 쓸 수 있다."""
+    return sendgo.sender_registration.create(
+        sender_alias=alias,
+        sender_number_type="team_main",
+        phone_e164=phone,
+        files={"csuCertificate": (csu.filename, csu.file, csu.content_type)},
+    )
+```
+
+검수 결과는 비동기입니다. `BackgroundTasks` 나 별도 스케줄러에서
+`notice_templates.sync(code)` 를 돌려 `inspectionStatus` 가 `APR` 이 되는지
+확인하세요 — 요청 핸들러 안에서 기다리면 안 됩니다.
+
+전체 파라미터는 [sendgo-python README](https://github.com/send-go/python) 를 참고하세요.
+
+---
+
 ## 변경 사항
 
+### 1.3.0 (2026-09-11)
+
+- **관리 API 노출** — 코어 1.3.0 의 `kakao_senders` · `notice_templates` ·
+  `brand_templates` · `sender_registration` · `message_templates` 를
+  `SendgoDep` 으로 주입받은 클라이언트에서 그대로 쓸 수 있습니다.
+  콘솔에서만 되던 채널 등록, 알림톡 템플릿 검수 요청, 발신번호 심사 접수를
+  라우트에서 처리합니다. `UploadFile` 을 그대로 서류로 넘길 수 있습니다.
+- `sendgo-python` 을 `>=1.3` 으로 올렸습니다.
+- **이벤트 웹훅** 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단,
+  브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로
+  검증합니다(SDK 에 검증 헬퍼 포함).
+- **카카오 이미지 업로드** 추가 — 브랜드메시지 템플릿의 `imageUrl` 은 카카오가
+  호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
+- **수신거부(080) 조회** 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
+
 ### 1.2.1 (2026-08-14)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.

{sendgo_fastapi-1.2.1 → sendgo_fastapi-1.3.0}/README.md

@@ -420,8 +420,114 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
 [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
 
+## 관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
+
+코어(`sendgo-python`)의 관리 서비스가 주입받은 클라이언트에 그대로 붙어
+있습니다. 콘솔에서만 되던 등록·심사를 라우트에서 처리할 수 있습니다.
+
+| 접근 | 하는 일 | 계정 |
+| --- | --- | --- |
+| `.kakao_senders` | 카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
+| `.notice_templates` | 알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
+| `.brand_templates` | 브랜드메시지 템플릿 CRUD, 동기화, 가져오기 | 기업 |
+| `.sender_registration` | 발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
+| `.message_templates` | 문자 상용구 템플릿 CRUD | 개인·기업 |
+| `.kakao_images` | 카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
+| `.rejected_numbers` | 수신거부(080) 번호 조회 | 개인·기업 |
+| `.webhook` | 이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
+
+> **sendgo.io 콘솔에 들어올 일이 없습니다.** 휴대폰 발신번호는 PASS 대신
+> 신분증 사본을 받아 sendgo 운영자가 대신 심사합니다. 사람이 개입하는 지점은
+> 카카오 채널 인증번호 하나뿐이고, 그것도 여러분 화면에서 입력받으면 됩니다.
+> 심사가 붙는 것들은 비동기라 웹훅으로 결과를 받으세요.
+
+```python
+from fastapi import APIRouter, BackgroundTasks, HTTPException, UploadFile
+from sendgo import SendgoError
+from sendgo_fastapi import SendgoDep
+
+router = APIRouter(prefix="/onboarding")
+
+
+@router.post("/channel/code")
+async def request_channel_code(yellow_id: str, phone: str, sendgo: SendgoDep):
+    """1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다."""
+    return sendgo.kakao_senders.request_token(yellow_id, phone)
+
+
+@router.post("/channel")
+async def register_channel(yellow_id: str, phone: str, code: str, sendgo: SendgoDep):
+    """2단계 — 사용자가 입력한 인증번호로 발신프로필 생성."""
+    created = sendgo.kakao_senders.create(
+        token=code,
+        yellow_id=yellow_id,
+        phone_number=phone,
+        category_code="001001",
+    )
+    return created["data"]["sender"]
+
+
+@router.post("/templates")
+async def provision_template(kakao_sender_key: str, sendgo: SendgoDep):
+    try:
+        created = sendgo.notice_templates.create(
+            kakao_sender_key=kakao_sender_key,
+            template_name="주문 접수 안내",
+            template_content="#{name}님, 주문 #{orderNo}이 접수되었습니다.",
+            template_message_type="BA",
+            template_emphasize_type="NONE",
+            category_code="001001",
+            message_purpose="order_delivery",
+            legal_basis="transaction",
+            benefit_origin="none",
+            expiry_type="none",
+        )
+    except SendgoError as exc:
+        # POLICY_VALIDATION_FAILED 면 errors["reasons"] 에 한국어 사유가 담긴다
+        raise HTTPException(status_code=422, detail=exc.errors) from exc
+
+    code = created["data"]["template"]["templateCode"]
+    sendgo.notice_templates.request_inspection(code)
+
+    return {"templateCode": code, "inspectionStatus": "REQ"}
+
+
+@router.post("/senders")
+async def register_sender(alias: str, phone: str, csu: UploadFile, sendgo: SendgoDep):
+    """발신번호 등록 신청. 접수만 되고(PENDING) 운영자 승인 후 쓸 수 있다."""
+    return sendgo.sender_registration.create(
+        sender_alias=alias,
+        sender_number_type="team_main",
+        phone_e164=phone,
+        files={"csuCertificate": (csu.filename, csu.file, csu.content_type)},
+    )
+```
+
+검수 결과는 비동기입니다. `BackgroundTasks` 나 별도 스케줄러에서
+`notice_templates.sync(code)` 를 돌려 `inspectionStatus` 가 `APR` 이 되는지
+확인하세요 — 요청 핸들러 안에서 기다리면 안 됩니다.
+
+전체 파라미터는 [sendgo-python README](https://github.com/send-go/python) 를 참고하세요.
+
+---
+
 ## 변경 사항
 
+### 1.3.0 (2026-09-11)
+
+- **관리 API 노출** — 코어 1.3.0 의 `kakao_senders` · `notice_templates` ·
+  `brand_templates` · `sender_registration` · `message_templates` 를
+  `SendgoDep` 으로 주입받은 클라이언트에서 그대로 쓸 수 있습니다.
+  콘솔에서만 되던 채널 등록, 알림톡 템플릿 검수 요청, 발신번호 심사 접수를
+  라우트에서 처리합니다. `UploadFile` 을 그대로 서류로 넘길 수 있습니다.
+- `sendgo-python` 을 `>=1.3` 으로 올렸습니다.
+- **이벤트 웹훅** 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단,
+  브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로
+  검증합니다(SDK 에 검증 헬퍼 포함).
+- **카카오 이미지 업로드** 추가 — 브랜드메시지 템플릿의 `imageUrl` 은 카카오가
+  호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
+- **수신거부(080) 조회** 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
+
 ### 1.2.1 (2026-08-14)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.

{sendgo_fastapi-1.2.1 → sendgo_fastapi-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sendgo-fastapi"
-version = "1.2.1"
+version = "1.3.0"
 description = "Sendgo FastAPI 확장 — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS"
 readme = "README.md"
 license = {text = "MIT"}
@@ -23,7 +23,7 @@ classifiers = [
 ]
 requires-python = ">=3.10"
 dependencies = [
-    "sendgo-python>=1.0",
+    "sendgo-python>=1.3",
     "fastapi>=0.110",
     "pydantic-settings>=2.0",
 ]

{sendgo_fastapi-1.2.1 → sendgo_fastapi-1.3.0/sendgo_fastapi.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-fastapi
-Version: 1.2.1
+Version: 1.3.0
 Summary: Sendgo FastAPI 확장 — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: sendgo-python>=1.0
+Requires-Dist: sendgo-python>=1.3
 Requires-Dist: fastapi>=0.110
 Requires-Dist: pydantic-settings>=2.0
 Dynamic: license-file
@@ -446,8 +446,114 @@ A. `app.dependency_overrides[get_sendgo] = lambda: mock_client`로 의존성을
 사용 예시와 파라미터는 [코어 README](https://github.com/send-go) 와
 [SDK 가이드](https://sendgo.io/ko/sdk) 를 참고하세요.
 
+## 관리 API — 채널·템플릿·발신번호 등록 (v2 전용)
+
+코어(`sendgo-python`)의 관리 서비스가 주입받은 클라이언트에 그대로 붙어
+있습니다. 콘솔에서만 되던 등록·심사를 라우트에서 처리할 수 있습니다.
+
+| 접근 | 하는 일 | 계정 |
+| --- | --- | --- |
+| `.kakao_senders` | 카카오 채널 인증·등록·동기화, 브랜드메시지 M/N 신청 | 기업 |
+| `.notice_templates` | 알림톡 템플릿 CRUD, 검수 요청·취소, 승인 취소, 휴면 해제 | 기업 |
+| `.brand_templates` | 브랜드메시지 템플릿 CRUD, 동기화, 가져오기 | 기업 |
+| `.sender_registration` | 발신번호 등록 신청, 중복 확인, 유형 안내 | 개인·기업 |
+| `.message_templates` | 문자 상용구 템플릿 CRUD | 개인·기업 |
+| `.kakao_images` | 카카오 이미지 업로드 — 템플릿용 URL 발급 | 기업 |
+| `.rejected_numbers` | 수신거부(080) 번호 조회 | 개인·기업 |
+| `.webhook` | 이벤트 웹훅 구독 — 심사 결과 수신 | 개인·기업 |
+
+> **sendgo.io 콘솔에 들어올 일이 없습니다.** 휴대폰 발신번호는 PASS 대신
+> 신분증 사본을 받아 sendgo 운영자가 대신 심사합니다. 사람이 개입하는 지점은
+> 카카오 채널 인증번호 하나뿐이고, 그것도 여러분 화면에서 입력받으면 됩니다.
+> 심사가 붙는 것들은 비동기라 웹훅으로 결과를 받으세요.
+
+```python
+from fastapi import APIRouter, BackgroundTasks, HTTPException, UploadFile
+from sendgo import SendgoError
+from sendgo_fastapi import SendgoDep
+
+router = APIRouter(prefix="/onboarding")
+
+
+@router.post("/channel/code")
+async def request_channel_code(yellow_id: str, phone: str, sendgo: SendgoDep):
+    """1단계 — 카카오가 관리자 휴대폰으로 인증번호를 SMS 발송한다."""
+    return sendgo.kakao_senders.request_token(yellow_id, phone)
+
+
+@router.post("/channel")
+async def register_channel(yellow_id: str, phone: str, code: str, sendgo: SendgoDep):
+    """2단계 — 사용자가 입력한 인증번호로 발신프로필 생성."""
+    created = sendgo.kakao_senders.create(
+        token=code,
+        yellow_id=yellow_id,
+        phone_number=phone,
+        category_code="001001",
+    )
+    return created["data"]["sender"]
+
+
+@router.post("/templates")
+async def provision_template(kakao_sender_key: str, sendgo: SendgoDep):
+    try:
+        created = sendgo.notice_templates.create(
+            kakao_sender_key=kakao_sender_key,
+            template_name="주문 접수 안내",
+            template_content="#{name}님, 주문 #{orderNo}이 접수되었습니다.",
+            template_message_type="BA",
+            template_emphasize_type="NONE",
+            category_code="001001",
+            message_purpose="order_delivery",
+            legal_basis="transaction",
+            benefit_origin="none",
+            expiry_type="none",
+        )
+    except SendgoError as exc:
+        # POLICY_VALIDATION_FAILED 면 errors["reasons"] 에 한국어 사유가 담긴다
+        raise HTTPException(status_code=422, detail=exc.errors) from exc
+
+    code = created["data"]["template"]["templateCode"]
+    sendgo.notice_templates.request_inspection(code)
+
+    return {"templateCode": code, "inspectionStatus": "REQ"}
+
+
+@router.post("/senders")
+async def register_sender(alias: str, phone: str, csu: UploadFile, sendgo: SendgoDep):
+    """발신번호 등록 신청. 접수만 되고(PENDING) 운영자 승인 후 쓸 수 있다."""
+    return sendgo.sender_registration.create(
+        sender_alias=alias,
+        sender_number_type="team_main",
+        phone_e164=phone,
+        files={"csuCertificate": (csu.filename, csu.file, csu.content_type)},
+    )
+```
+
+검수 결과는 비동기입니다. `BackgroundTasks` 나 별도 스케줄러에서
+`notice_templates.sync(code)` 를 돌려 `inspectionStatus` 가 `APR` 이 되는지
+확인하세요 — 요청 핸들러 안에서 기다리면 안 됩니다.
+
+전체 파라미터는 [sendgo-python README](https://github.com/send-go/python) 를 참고하세요.
+
+---
+
 ## 변경 사항
 
+### 1.3.0 (2026-09-11)
+
+- **관리 API 노출** — 코어 1.3.0 의 `kakao_senders` · `notice_templates` ·
+  `brand_templates` · `sender_registration` · `message_templates` 를
+  `SendgoDep` 으로 주입받은 클라이언트에서 그대로 쓸 수 있습니다.
+  콘솔에서만 되던 채널 등록, 알림톡 템플릿 검수 요청, 발신번호 심사 접수를
+  라우트에서 처리합니다. `UploadFile` 을 그대로 서류로 넘길 수 있습니다.
+- `sendgo-python` 을 `>=1.3` 으로 올렸습니다.
+- **이벤트 웹훅** 추가 — 발신번호 승인, 알림톡 검수 결과, 채널 차단,
+  브랜드메시지 타겟팅 결과를 구독해 받습니다. 서명은 받은 원본 바이트로
+  검증합니다(SDK 에 검증 헬퍼 포함).
+- **카카오 이미지 업로드** 추가 — 브랜드메시지 템플릿의 `imageUrl` 은 카카오가
+  호스팅하는 URL 이어야 하는데, 그 URL 을 얻는 길이 콘솔에만 있었습니다.
+- **수신거부(080) 조회** 추가 — 자기 DB 의 수신 상태를 맞출 수 있습니다.
+
 ### 1.2.1 (2026-08-14)
 
 - 레지스트리 목록에 노출되는 패키지 설명에서 친구톡을 브랜드메시지로 교체했습니다.

{sendgo_fastapi-1.2.1 → sendgo_fastapi-1.3.0}/sendgo_fastapi.egg-info/requires.txt

@@ -1,3 +1,3 @@
-sendgo-python>=1.0
+sendgo-python>=1.3
 fastapi>=0.110
 pydantic-settings>=2.0