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

{sendgo_python-1.3.0 → sendgo_python-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.3.0
+Version: 1.4.0
 Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -808,3 +808,30 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
+
+## 계정·조직·API 키 관리 (1.4.0)
+
+발송용 `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
+import os
+from sendgo import AccountClient
+account = AccountClient(agent_token=os.environ['SENDGO_AGENT_TOKEN'])
+result = account.me()
+account.select_organization('team-uuid')
+issued = account.create_api_key({'name': '서버 연동'})
+```
+
+지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
+
+키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.

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

@@ -781,3 +781,30 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
+
+## 계정·조직·API 키 관리 (1.4.0)
+
+발송용 `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
+import os
+from sendgo import AccountClient
+account = AccountClient(agent_token=os.environ['SENDGO_AGENT_TOKEN'])
+result = account.me()
+account.select_organization('team-uuid')
+issued = account.create_api_key({'name': '서버 연동'})
+```
+
+지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
+
+키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sendgo-python"
-version = "1.3.0"
+version = "1.4.0"
 description = "Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS"
 readme = "README.md"
 license = {text = "MIT"}

{sendgo_python-1.3.0 → sendgo_python-1.4.0}/sendgo/__init__.py

@@ -18,6 +18,7 @@ Sendgo Python SDK — 카카오 알림톡/친구톡, SMS/LMS/MMS
     )
 """
 
+from .account import AccountClient
 from .brand_message import BrandMessageService
 from .brand_template import BrandTemplateService
 from .kakao_image import (
@@ -40,6 +41,7 @@ from .client import Sendgo
 from .exceptions import SendgoError
 
 __all__ = [
+    "AccountClient",
     "Sendgo",
     "SendgoError",
     "BrandMessageService",

sendgo_python-1.4.0/sendgo/account.py

@@ -0,0 +1,77 @@
+from __future__ import annotations
+
+from urllib.parse import quote
+import requests
+from .exceptions import SendgoError
+
+
+class AccountClient:
+    """서버 전용 계정 API. 에이전트 토큰은 자동 갱신하지 않는다."""
+
+    def __init__(self, *, agent_token: str, base_url: str = "https://sendgo.io") -> None:
+        if not agent_token or not agent_token.strip():
+            raise ValueError("Sendgo: agent_token은 필수입니다.")
+        self._agent_token = agent_token
+        self._base_url = base_url.rstrip("/")
+
+    def me(self) -> dict:
+        """계정 상태와 다음 단계 조회."""
+        return self._request("GET", f"")
+
+    def organizations(self) -> dict:
+        """조직 목록 조회."""
+        return self._request("GET", f"organizations")
+
+    def select_organization(self, organization_id: str | None) -> dict:
+        """조직 선택. null은 개인 계정."""
+        return self._request("POST", f"organizations/select", {'organizationId': organization_id})
+
+    def api_keys(self) -> dict:
+        """현재 조직의 API 키 목록."""
+        return self._request("GET", f"api-keys")
+
+    def create_api_key(self, params: dict) -> dict:
+        """API 키 발급. secretKey는 이 응답에서만 반환."""
+        return self._request("POST", f"api-keys", params)
+
+    def api_key(self, api_key_id: str) -> dict:
+        """API 키 상세 조회."""
+        return self._request("GET", f"api-keys/{quote(api_key_id, safe='')}")
+
+    def update_api_key(self, api_key_id: str, name: str) -> dict:
+        """API 키 이름 변경."""
+        return self._request("PATCH", f"api-keys/{quote(api_key_id, safe='')}", {'name': name})
+
+    def delete_api_key(self, api_key_id: str) -> dict:
+        """API 키 폐기."""
+        return self._request("DELETE", f"api-keys/{quote(api_key_id, safe='')}")
+
+    def issue_token(self, api_key_id: str) -> dict:
+        """승인된 API 키의 발송용 토큰 발급."""
+        return self._request("POST", f"api-keys/{quote(api_key_id, safe='')}/token", {})
+
+    def allowed_ips(self, api_key_id: str) -> dict:
+        """허용 IP 목록과 호출자 IP 조회."""
+        return self._request("GET", f"api-keys/{quote(api_key_id, safe='')}/allowed-ips")
+
+    def add_allowed_ip(self, api_key_id: str, params: dict) -> dict:
+        """허용 IP 추가. ip와 선택적 description 사용."""
+        return self._request("POST", f"api-keys/{quote(api_key_id, safe='')}/allowed-ips", params)
+
+    def delete_allowed_ip(self, api_key_id: str, ip_id: str) -> dict:
+        """허용 IP 삭제."""
+        return self._request("DELETE", f"api-keys/{quote(api_key_id, safe='')}/allowed-ips/{quote(ip_id, safe='')}")
+
+    def _request(self, method: str, path: str, body: dict | None = None) -> dict:
+        response = requests.request(
+            method, f"{self._base_url}/api/v2/account" + (f"/{path}" if path else ""),
+            headers={"Authorization": f"Bearer {self._agent_token}", "Accept": "application/json"},
+            json=body, timeout=15, allow_redirects=False,
+        )
+        try:
+            data = response.json() if response.content else {}
+        except ValueError:
+            data = {}
+        if not 200 <= response.status_code < 300:
+            raise SendgoError.from_response(response.status_code, data, path or "account", "v2")
+        return data

{sendgo_python-1.3.0 → sendgo_python-1.4.0}/sendgo/client.py

@@ -66,9 +66,13 @@ class Sendgo:
 
         # ------------------------------------------------------ 관리 API (v2)
         # 콘솔에서만 되던 등록·심사. 발송과 달리 대부분 즉시 완료되지 않는다 —
-        # 등록 성공은 "접수됨"이지 "사용 가능"이 아니다.
-        # 카카오 채널 등록의 인증번호와 휴대폰 발신번호의 본인인증은 사람이
-        # 개입해야 하므로 API 로 대체되지 않는다.
+        # 등록 성공은 "접수됨"이지 "사용 가능"이 아니다. 결과는 웹훅으로 받는다.
+        #
+        # 사람이 개입하는 지점은 카카오 채널 인증번호 하나뿐이고, 그마저도
+        # 여러분 화면에서 끝난다 — request_token() 이 채널 관리자 휴대폰으로
+        # SMS 를 보내고, 사용자가 입력한 코드를 create() 가 받는다. 휴대폰
+        # 발신번호는 PASS 대신 신분증 사본을 첨부해 접수하면 sendgo 가 대신
+        # 심사한다.
         self.kakao_senders       = KakaoSenderService(http)
         self.notice_templates    = NoticeTemplateService(http)
         self.brand_templates     = BrandTemplateService(http)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sendgo-python
-Version: 1.3.0
+Version: 1.4.0
 Summary: Sendgo Python SDK — 카카오 알림톡/브랜드메시지, SMS/LMS/MMS
 Author-email: Sendgo <dev@sendgo.io>
 License: MIT
@@ -808,3 +808,30 @@ MIT License © 2026 [Sendgo](https://sendgo.io)
 ---
 
 *키워드: 카카오 알림톡 Python, 카카오 친구톡 Django, SMS 발송 FastAPI, 알림톡 SDK pip, Python 카카오 API 연동, Django 문자 발송, FastAPI 알림톡, Celery 알림톡 비동기, Sendgo Python SDK*
+
+## 계정·조직·API 키 관리 (1.4.0)
+
+발송용 `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
+import os
+from sendgo import AccountClient
+account = AccountClient(agent_token=os.environ['SENDGO_AGENT_TOKEN'])
+result = account.me()
+account.select_organization('team-uuid')
+issued = account.create_api_key({'name': '서버 연동'})
+```
+
+지원 메서드: `me`, `organizations`, `select_organization`, `api_keys`, `create_api_key`, `api_key`, `update_api_key`, `delete_api_key`, `issue_token`, `allowed_ips`, `add_allowed_ip`, `delete_allowed_ip`.
+
+키 생성 인자는 `name`, 선택적 `ipAddresses: [{ip, description}]`이며, 허용 IP 추가 인자는 `ip`, 선택적 `description`입니다. 키·IP 식별자는 응답의 `id`(UUID)를 사용합니다.

{sendgo_python-1.3.0 → sendgo_python-1.4.0}/sendgo_python.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ README.md
 pyproject.toml
 sendgo/__init__.py
 sendgo/_payload.py
+sendgo/account.py
 sendgo/alimtalk.py
 sendgo/brand_message.py
 sendgo/brand_template.py