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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-fastapi
-Version: 1.3.0
+Version: 1.4.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.3
+Requires-Dist: sendgo-python>=1.4
 Requires-Dist: fastapi>=0.110
 Requires-Dist: pydantic-settings>=2.0
 Dynamic: license-file
@@ -582,3 +582,28 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 FastAPI, 카카오 친구톡 FastAPI, SMS 발송 FastAPI, 알림톡 FastAPI 패키지, FastAPI 카카오 API 연동, FastAPI 의존성 주입, Sendgo FastAPI SDK*
+
+## 계정 API (1.4.0)
+
+코어 1.4.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는 차단됩니다.
+에이전트 토큰과 키는 브라우저·모바일 앱에 포함하거나 응답·로그에 출력하지 않습니다.
+
+```python
+from sendgo_fastapi import AccountDep
+# SENDGO_AGENT_TOKEN 환경변수를 설정합니다.
+@app.get('/internal/sendgo-status')
+def status(account: AccountDep):
+    return account.me()
+```

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

@@ -556,3 +556,28 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 FastAPI, 카카오 친구톡 FastAPI, SMS 발송 FastAPI, 알림톡 FastAPI 패키지, FastAPI 카카오 API 연동, FastAPI 의존성 주입, Sendgo FastAPI SDK*
+
+## 계정 API (1.4.0)
+
+코어 1.4.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는 차단됩니다.
+에이전트 토큰과 키는 브라우저·모바일 앱에 포함하거나 응답·로그에 출력하지 않습니다.
+
+```python
+from sendgo_fastapi import AccountDep
+# SENDGO_AGENT_TOKEN 환경변수를 설정합니다.
+@app.get('/internal/sendgo-status')
+def status(account: AccountDep):
+    return account.me()
+```

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sendgo-fastapi"
-version = "1.3.0"
+version = "1.4.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.3",
+    "sendgo-python>=1.4",
     "fastapi>=0.110",
     "pydantic-settings>=2.0",
 ]

{sendgo_fastapi-1.3.0 → sendgo_fastapi-1.4.0}/sendgo_fastapi/__init__.py

@@ -19,8 +19,14 @@ FastAPI 애플리케이션에서 Sendgo 코어(`sendgo-python`)를 손쉽게 사
         return {"success": True}
 """
 
-from .dependencies import SendgoDep, get_sendgo, init_sendgo
+from .dependencies import SendgoDep, get_sendgo, init_sendgo, AccountDep, get_account
 from .settings import SendgoSettings
 
-__all__ = ["SendgoSettings", "get_sendgo", "SendgoDep", "init_sendgo"]
-__version__ = "1.0.0"
+from sendgo import AccountClient
+
+__all__ = ["AccountDep", "get_account", "AccountClient", "SendgoSettings", "get_sendgo", "SendgoDep", "init_sendgo"]
+try:
+    from importlib.metadata import PackageNotFoundError, version
+    __version__ = version("sendgo-fastapi")
+except PackageNotFoundError:
+    __version__ = "0.0.0.dev0"

{sendgo_fastapi-1.3.0 → sendgo_fastapi-1.4.0}/sendgo_fastapi/dependencies.py

@@ -14,7 +14,7 @@ from functools import lru_cache
 from typing import Annotated, Optional
 
 from fastapi import Depends, FastAPI, Request
-from sendgo import Sendgo
+from sendgo import Sendgo, AccountClient
 
 from .settings import SendgoSettings
 
@@ -73,3 +73,16 @@ def init_sendgo(app: FastAPI, settings: SendgoSettings | None = None) -> Sendgo:
 
 # 라우트에서 `sendgo: SendgoDep` 형태로 주입받기 위한 타입 별칭
 SendgoDep = Annotated[Sendgo, Depends(get_sendgo)]
+
+
+# 계정 API 설정은 발송용 필수 키를 요구하는 SendgoSettings와 독립적입니다.
+def get_account() -> AccountClient:
+    """SENDGO_AGENT_TOKEN과 SENDGO_BASE_URL로 계정 클라이언트를 만듭니다."""
+    import os
+    return AccountClient(
+        agent_token=os.environ.get("SENDGO_AGENT_TOKEN", ""),
+        base_url=os.environ.get("SENDGO_BASE_URL", "https://sendgo.io"),
+    )
+
+
+AccountDep = Annotated[AccountClient, Depends(get_account)]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-fastapi
-Version: 1.3.0
+Version: 1.4.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.3
+Requires-Dist: sendgo-python>=1.4
 Requires-Dist: fastapi>=0.110
 Requires-Dist: pydantic-settings>=2.0
 Dynamic: license-file
@@ -582,3 +582,28 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 FastAPI, 카카오 친구톡 FastAPI, SMS 발송 FastAPI, 알림톡 FastAPI 패키지, FastAPI 카카오 API 연동, FastAPI 의존성 주입, Sendgo FastAPI SDK*
+
+## 계정 API (1.4.0)
+
+코어 1.4.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는 차단됩니다.
+에이전트 토큰과 키는 브라우저·모바일 앱에 포함하거나 응답·로그에 출력하지 않습니다.
+
+```python
+from sendgo_fastapi import AccountDep
+# SENDGO_AGENT_TOKEN 환경변수를 설정합니다.
+@app.get('/internal/sendgo-status')
+def status(account: AccountDep):
+    return account.me()
+```

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

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