# 대행사, 팀, API

대행사가 고객사 이름으로 Agilis에 광고하는 방법, 팀 역할·잔액·청구서의 작동 방식, Agilis REST API 사용법을 안내합니다.

**요약:** 대행사는 자체 법인명으로 한 번만 가입하고, **회원에게 보이는 표시 이름**에 각 고객사의 이름을 입력해 고객사를 대신해 광고합니다. 결제, 잔액 보유, 청구서 수령은 대행사가 합니다. 개발자는 광고 포털에서 발급한 API 키로 **Agilis REST API**(https://ads.agilis.dating)를 통해 혜택과 행사를 만들고 관리할 수 있습니다. 테스트 키는 무료이며, 테스트 키로 만든 광고는 회원에게 절대 표시되지 않습니다.

## 대행사

1. 대행사 자체 법인명으로 **대행사를 등록하세요**. → [등록 방법](https://www.agilis.dating/ko/business/guide/register)
2. 혜택이나 행사를 만들 때 **표시 이름**에 **회원에게 보이는 표시 이름**을 입력하세요. 회원에게는 대행사가 아닌 고객사 이름이 표시됩니다.
3. 각 고객사로부터 광고 대행 권한을 받아야 합니다. 광고 이용약관에 따라 이에 대한 책임은 대행사에 있습니다.

**결제 주체와 청구서 수령인**

- 대행사 계정에서 대행사의 결제 통화로 결제합니다.
- 대행사의 각 담당자는 자신의 잔액을 가지며 그 잔액에서 결제합니다. 업체 잔액은 그 합계입니다. → [잔액의 작동 방식](https://www.agilis.dating/ko/business/guide/pricing)
- 청구서와 성과는 대행사 명의로 제공되며 결제 1건당 청구서 1장이 발행되므로, 고객사별로 재청구하실 수 있습니다.
- 고객사별 지출을 구분하려면 고객사마다 혜택이나 행사를 따로 만들고, 해당 청구서를 기준으로 재청구하세요.

## 팀 역할

업체 관리자와 광고 담당자는 광고 포털에서, 개발자는 API로 작업합니다. 개발자는 광고 포털에서 혜택이나 행사를 만들 수 없지만, 자신의 API 키로 API를 통해 혜택과 행사를 만들고 게시하고 결제할 수 있습니다. 키 사용에 대한 책임은 귀사에 있습니다. 전체 표는 [팀 역할 및 권한](https://www.agilis.dating/ko/business/guide/getting-started)에서 확인하세요.

## Agilis REST API

- **기본 URL:** https://ads.agilis.dating
- **참조 문서:** www.agilis.dating/api-doc (cURL, Python, Node.js, PHP 예제와 API 도우미 제공)
- **기계 판독용 문서:** OpenAPI 3.1은 www.agilis.dating/openapi.json, Markdown은 www.agilis.dating/api-doc.md, AI 도구용 전체 텍스트는 www.agilis.dating/llms-full.txt
- **혜택:** 카테고리와 관심사 목록 조회, 혜택 생성 전 가격 산정, 혜택 생성·목록 조회·일시중지·재개·삭제, 혜택별 성과 조회
- **행사:** 행사 미리보기·게시·목록 조회·수정·일정 변경·취소·삭제, 행사별 성과 조회

### API 키 발급받기

1. 업체 관리자 또는 개발자로 광고 포털에 로그인합니다.
2. 페이지 상단의 스위치로 **테스트 모드** 또는 운영 모드를 선택합니다.
3. **API 키** → **새 키 만들기**로 이동해 이름을 입력하고, 원하시면 만료일도 지정합니다.
4. **키를 바로 복사하세요.** 키는 다시 확인할 수 없습니다.

테스트 키는 `pk_test_`(으)로, 운영 키는 `pk_live_`(으)로 시작합니다. 각 담당자는 모드별로 키를 최대 10개까지 보유할 수 있습니다. **키 교체**를 하면 키가 즉시 바뀌므로 먼저 시스템을 업데이트하세요. 키는 `x-api-key` 요청 헤더에 담아 보내세요: `x-api-key: pk_test_…`.

### 안전하게 개발하기

- `pk_test_` 키로 개발하고 테스트하세요. 테스트 혜택과 행사는 무료이며 회원에게 절대 표시되지 않습니다.
- 혜택을 만들기 전에 가격 견적 엔드포인트로 가격을 확인하세요.
- 키를 코드 저장소나 브라우저에 두지 말고, 서버에서 API를 호출하세요.

## 자주 묻는 질문

### 대행사 계정 하나로 여러 고객사를 관리할 수 있나요?

네. 대행사를 한 번만 등록하고, 혜택이나 행사마다 고객사 이름을 지정하세요.

### 고객사별로 청구서를 따로 받을 수 있나요?

청구서는 결제 1건당 1장씩 대행사 앞으로 발행됩니다. 이를 바탕으로 고객사에 재청구하세요.

### 샌드박스가 있나요?

네. `pk_test_` 키를 사용하는 테스트 모드가 완전한 샌드박스입니다. 비용이 청구되지 않으며 회원에게 아무것도 표시되지 않습니다.

### AI 코딩 도구를 연결할 수 있나요?

네. 사용하시는 도구에 www.agilis.dating/api-doc.md 또는 www.agilis.dating/openapi.json을 지정하세요.

Source: https://www.agilis.dating/ko/business/guide/agencies-and-api