개발자 문서
API 동작
경로와 권한의 전체 목록
기본 경로는 /api/v1입니다. 아래 메서드·경로·권한은 OpenAPI 문서에서 생성했습니다. 실제 계정과 SDK 생성 결과는 검증 중입니다.
발행 전 검사 요청 형식
curl -X POST 'https://<서비스-도메인>/api/v1/posts/validate' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"content":"새 소식을 전합니다.","accountIds":["<ACCOUNT_ID>"]}'| 메서드 | 경로 | 동작 | 권한 |
|---|---|---|---|
| GET | /api/v1/accounts | 연결된 채널 목록 | accounts:read |
| DELETE | /api/v1/accounts/{id} | 채널 연결 해제 (기록은 남김) | accounts:write |
| GET | /api/v1/platforms | 채널 규격 (레지스트리) | accounts:read |
| POST | /api/v1/posts/validate | 미리 검사 (올리지 않음) | posts:read |
| POST | /api/v1/posts | 발행·예약·임시 저장. `Idempotency-Key` 헤더 권장 | posts:write |
| GET | /api/v1/posts | 발행 기록 | posts:read |
| GET | /api/v1/posts/{id} | 발행 결과 (채널별 상태·2단계 지표 포함) | posts:read |
| PATCH | /api/v1/posts/{id} | 예약·임시 글 수정 | posts:write |
| DELETE | /api/v1/posts/{id} | 삭제 (예약·임시는 완전 삭제, 발행된 글은 채널에서 지우고 `cancelled`) | posts:write |
| POST | /api/v1/posts/{id}/metrics/refresh | 연결된 발행 글의 지표 수동 새로고침 (2단계) | posts:read |
| POST | /api/v1/posts/{id}/publish | 예약·임시 글 지금 발행 | posts:write |
| POST | /api/v1/posts/{id}/retry | 실패한 채널만 재시도 | posts:write |
| POST | /api/v1/media/presign | 업로드 주소 발급 (`fileName`, `contentType`, `bytes`) | posts:write |
| POST | /api/v1/media/{id}/complete | 업로드 완료 확인 | posts:write |
| POST | /api/v1/media/from-url | URL로 가져오기 | posts:write |
| DELETE | /api/v1/media/{id} | 안 쓰는 미디어 삭제 | posts:write |
| GET | /api/v1/quota | 이번 달 남은 발행 수, 채널별 하루 한도 | posts:read |
| GET | /api/v1/queue-slots | 반복 큐 슬롯 규칙 목록 (2단계) | posts:read |
| POST | /api/v1/queue-slots | 반복 큐 슬롯 규칙 만들기 (2단계) | posts:write |
| PATCH | /api/v1/queue-slots/{id} | 요일·시각·기간·일시 중지 변경 (2단계) | posts:write |
| DELETE | /api/v1/queue-slots/{id} | 반복 규칙 폐기 (2단계) | posts:write |
| GET | /api/v1/webhooks | 고객 웹훅 구독 목록 (2단계) | webhooks:read |
| POST | /api/v1/webhooks | 고객 웹훅 구독 등록 (2단계) | webhooks:write |
| PATCH | /api/v1/webhooks/{id} | 주소·이벤트·상태 변경/비밀값 교체 (2단계) | webhooks:write |
| DELETE | /api/v1/webhooks/{id} | 구독 폐기 (2단계) | webhooks:write |
| GET | /api/v1/webhooks/{id}/deliveries | 구독의 전달·시도 기록 (2단계) | webhooks:read |
| POST | /api/v1/webhooks/{id}/deliveries/{deliveryId}/retry | 실패 전달 수동 재전송 (2단계) | webhooks:write |
| GET | /api/v1/automations/instagram-dm-backfills/preview | 소유 미디어 과거 댓글 한 페이지 미리보기 (외부 발송 차단) | automations:read |
| GET | /api/v1/automations/instagram-dm-backfills | 최근 과거 댓글 준비 작업 목록 | automations:read |
| POST | /api/v1/automations/instagram-dm-backfills | 과거 댓글 준비 명시적 요청 (외부 발송 차단) | automations:write |
| GET | /api/v1/automations/instagram-dm-backfills/{id} | 준비 작업 집계·순서별 결과 조회 | automations:read |
| PATCH | /api/v1/automations/instagram-dm-backfills/{id} | 다음 페이지 준비·중지·재개 | automations:write |
| GET | /api/v1/automations/instagram-dm-rules | Instagram 댓글→DM 규칙 목록 (2단계) | automations:read |
| POST | /api/v1/automations/instagram-dm-rules | 초안 규칙 만들기 (2단계) | automations:write |
| GET | /api/v1/automations/instagram-dm-runs | Instagram 댓글→DM 실행 결과 (2단계) | automations:read |
| PATCH | /api/v1/automations/instagram-dm-rules/{id} | 규칙 내용·상태 변경 또는 폐기 (2단계) | automations:write |
| GET | /api/v1/accounts/{id}/media/{mediaId}/comments | 소유 Instagram 게시물의 최상위 댓글 한 페이지 (2단계) | comments:read |
| POST | /api/v1/accounts/{id}/media/{mediaId}/comments/{commentId}/actions | 수동 답글·숨김·숨김 해제 의도 (2단계) | comments:write |
| GET | /api/v1/comment-actions/{id} | 수동 댓글 작업 결과 (2단계) | comments:read |