요약: 대행사는 자체 법인명으로 한 번만 가입하고, 회원에게 보이는 표시 이름에 각 고객사의 이름을 입력해 고객사를 대신해 광고합니다. 결제, 잔액 보유, 청구서 수령은 대행사가 합니다. 개발자는 광고 포털에서 발급한 API 키로 Agilis REST API(https://ads.agilis.dating)를 통해 혜택과 행사를 만들고 관리할 수 있습니다. 테스트 키는 무료이며, 테스트 키로 만든 광고는 회원에게 절대 표시되지 않습니다.
대행사
- 대행사 자체 법인명으로 대행사를 등록하세요. → 등록 방법
- 혜택이나 행사를 만들 때 표시 이름에 회원에게 보이는 표시 이름을 입력하세요. 회원에게는 대행사가 아닌 고객사 이름이 표시됩니다.
- 각 고객사로부터 광고 대행 권한을 받아야 합니다. 광고 이용약관에 따라 이에 대한 책임은 대행사에 있습니다.
결제 주체와 청구서 수령인
- 대행사 계정에서 대행사의 결제 통화로 결제합니다.
- 대행사의 각 담당자는 자신의 잔액을 가지며 그 잔액에서 결제합니다. 업체 잔액은 그 합계입니다. → 잔액의 작동 방식
- 청구서와 성과는 대행사 명의로 제공되며 결제 1건당 청구서 1장이 발행되므로, 고객사별로 재청구하실 수 있습니다.
- 고객사별 지출을 구분하려면 고객사마다 혜택이나 행사를 따로 만들고, 해당 청구서를 기준으로 재청구하세요.
팀 역할
업체 관리자와 광고 담당자는 광고 포털에서, 개발자는 API로 작업합니다. 개발자는 광고 포털에서 혜택이나 행사를 만들 수 없지만, 자신의 API 키로 API를 통해 혜택과 행사를 만들고 게시하고 결제할 수 있습니다. 키 사용에 대한 책임은 귀사에 있습니다. 전체 표는 팀 역할 및 권한에서 확인하세요.
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 키 발급받기
- 업체 관리자 또는 개발자로 광고 포털에 로그인합니다.
- 페이지 상단의 스위치로 테스트 모드 또는 운영 모드를 선택합니다.
- API 키 → 새 키 만들기로 이동해 이름을 입력하고, 원하시면 만료일도 지정합니다.
- 키를 바로 복사하세요. 키는 다시 확인할 수 없습니다.
테스트 키는 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을 지정하세요.
