사이트 관리 API & RSS 피드

기사 목록. 쿼리: q(제목/슬러그 검색) · status · category_id · page(기본 1) · per_page(기본 20, 최대 100).

{"ok":true, "total":2310, "page":1, "per_page":20,
 "articles":[{"id":"…","title":"…","slug":"…","status":"published","tier":"normal",
              "category":"뉴스","author":"홍길동","published_at":"2026-08-24T09:00:00", …}]}

기사 작성. title·slug는 필수, 나머지는 생략 시 기본값(초안·normal).

curl -X POST -H "Authorization: Bearer <토큰>" -H "Content-Type: application/json" \
  "$BASE/articles" -d '{
  "title": "새 기사 제목",
  "slug": "new-article-slug",
  "subtitle": "부제",
  "summary": "목록·RSS에 노출되는 요약",
  "body": "<p>본문 HTML</p>",
  "status": "draft",
  "category_id": "…",
  "author_id": "…",
  "thumb_url": "/storage/….jpg",
  "scheduled_at": "2026-08-25T09:00",
  "keywords": "손흥민, 토트넘, 프리미어리그",
  "series_ids": [], "related_ids": []
}'

응답 201: 저장된 기사 전체(article)를 돌려줍니다. 슬러그 중복이면 409.

keywords(기사 키워드/태그) — 문자열 "손흥민, 토트넘" 또는 배열 ["손흥민","토트넘"] 둘 다 받습니다. 기사 하단 태그와 사이트맵 <news:keywords>에 쓰입니다. 보내지 않으면(또는 빈 값이면) 발행 시점에 AI가 본문에서 4~8개를 자동 추출해 채웁니다 값을 보내면 그대로 저장하고 자동 추출은 하지 않습니다. 최대 8개까지 저장되며 앞뒤 공백·중복은 정리됩니다.

기사 상세 — 본문·연재/관련 링크·locales(언어별 번역 맵)까지 포함합니다.

부분 수정: JSON에 보낸 필드만 바뀌고 생략한 필드는 기존 값이 유지됩니다 (keywords도 동일 — 생략하면 기존 키워드가 그대로 남습니다).

curl -X PUT -H "Authorization: Bearer <토큰>" "$BASE/articles/{id}" \
  -d '{"status":"published"}'      # 발행 처리 — 다른 필드는 그대로

휴지통 이동(soft delete). 콘솔의 휴지통에서 복원할 수 있습니다.

curl -X PUT -H "Authorization: Bearer <토큰>" "$BASE/articles/{id}/locales/en" \
  -d '{"title":"English Title","summary":"…","body":"<p>…</p>","status":"published",
       "keywords":"Son Heung-min, Tottenham"}'

사이트에서 활성화되지 않은 언어 코드는 400으로 거부됩니다. 활성 언어 목록은 GET /locales로 확인하세요.

keywords는 그 언어 표기로 넣으세요(원본 키워드를 번역해 쓰지 않습니다). 생략하면 그 언어 본문에서 AI가 따로 추출합니다.

기자 등록. name만 필수 — 같은 이름의 활성 기자가 이미 있으면 새로 만들지 않고 그 id를 돌려줍니다("created": false). 기사 작성 전에 호출해 받은 id를 기사 author_id에 넣으면 바이라인·구조화데이터(author)에 기명 기자가 실립니다.

curl -X POST -H "Authorization: Bearer <토큰>" -H "Content-Type: application/json" \
  "$BASE/authors" -d '{
  "name": "홍길동",
  "email": "hong@example.com",
  "title": "기자",
  "bio": "짧은 소개(선택)",
  "profile_image_url": "/storage/….jpg",
  "locales": {
    "en": {"name": "Hong Gil-dong"},
    "ja": {"name": "ホン・ギルドン"}
  }
}'
# → {"ok":true, "id":"…", "created":true}   (이미 있으면 200 + created:false)

locales(선택)는 언어별 이름·직책(title)·소개(bio) 표기입니다 — 사이트에서 활성화한 언어 코드만 허용되고, 비운 필드는 기본값으로 폴백됩니다. "기자"·"편집장" 같은 일반 직책은 번역을 안 보내도 언어 페이지에서 자동 번역됩니다. 이미 있는 기자에게 번역만 나중에 보강하려면 같은 name으로 다시 호출하면 됩니다.

로그인 계정·권한 설정은 API로 만들지 않습니다 — 사이트 콘솔의 회원 관리에서 하세요.