SaaS APIAgency API
Agency API
에이전시 셀프서비스 API
Agency API
에이전시 운영자가 하위 기업을 관리하는 API입니다.
Base URL: /agency 또는 /ai/agency
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 필요 |
| 인증 방식 | JWT Bearer Token |
| 권한 | ROLE_AGENCY |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
GET | /public/tenant-config | 도메인 기반 테넌트 설정 조회 | 불필요 |
PATCH | /agency/me/branding | 에이전시 로고·파비콘 URL 저장 | 필요 |
POST | /agency/branding/logo | 에이전시 로고 파일 업로드 | 필요 |
POST | /agency/branding/favicon | 에이전시 파비콘 파일 업로드(180x180 PNG 변환) | 필요 |
POST | /admin/agency/branding/favicon | 어드민이 에이전시 지정 화면에서 파비콘 업로드 | 필요 |
POST | /admin/agency/{id}/domain/provision | 에이전시 도메인 연결 비동기 job 시작 | 필요 |
GET | /admin/agency/{id}/domain/status | 에이전시 도메인 연결 job 상태 조회 | 필요 |
POST | /admin/agency/{id}/domain/jobs/{jobId}/retry | 실패한 도메인 연결 job 재시도 | 필요 |
GET | /admin/agency/domain/unassigned-zones | Cloud DNS에는 있지만 서비스에 할당되지 않은 zone 조회 | 필요 |
POST | /agency/me/clients | 하위 기업 추가 | 필요 |
DELETE | /agency/me/clients/{id} | 하위 기업 삭제 | 필요 |
PATCH | /agency/me/clients/{id} | 하위 기업 설정 변경(가격 노출·알림 토글) | 필요 |
PATCH | /admin/agency/{id}/clients/{clientId} | 어드민이 하위 기업 설정 변경 | 필요 |
POST | /agency/me/campaigns/{campaignNo}/assign-client | 캠페인을 하위 기업에 할당 | 필요 |
테넌트 설정 조회
GET /public/tenant-config
브랜딩/로고·파비콘
PATCH /agency/me/branding · POST /agency/branding/logo · POST /agency/branding/favicon
파비콘 업로드 (어드민)
POST /admin/agency/branding/favicon
도메인 연결 Job
POST /admin/agency/{id}/domain/provision
캠페인 하위기업 할당
POST /agency/me/campaigns/{campaignNo}/assign-client
하위 기업 추가
POST /agency/me/clients
하위 기업 설정 변경
PATCH /agency/me/clients/{id} · 가격 노출 토글