SEALO API 문서

사용자가 직접 쓴 한국어 글에서 말투(관찰·말투 항목 후보·안 쓰는 표현)를 추출합니다. 모든 관찰·항목에는 입력 원문에서 그대로 복사한 근거 인용이 붙고, 근거가 원문에 실재하지 않으면 서버가 해당 항목을 드롭합니다(생성 금지 게이트) — 응답의 dropped가 그 개수입니다.

내부적으로 복수의 추출 엔진을 정해진 순서로 시도하고, 앞선 엔진이 실패(미설정·오류·응답 파싱 실패)하면 다음으로 넘어갑니다. 생성 금지 게이트는 어느 엔진이 응답했든 동일하게 적용되므로 응답 형식과 생성 금지 게이트는 엔진에 무관하게 동일합니다 — 어느 엔진이 실제로 응답했는지는 클라이언트에 노출하지 않습니다.

요청 본문

요청 예시

curl -sS -X POST https://sealo.kr/api/style-extract \
  -H "Content-Type: application/json" \
  -d '{"text":"여기에 80자 이상의 직접 쓴 글을 넣습니다..."}'

응답 (200)

응답 예시

{
  "observations": [
    { "title": "한 문장에 한 가지 사실만 담아 짧게 끊어 씀",
      "evidence": "그래서 매번 처음부터 다시 씁니다." }
  ],
  "rules": [
    { "rule": "문장은 짧게 끊는다",
      "why": "글 전체가 단문 위주로 구성되어 있고, 본인이 그 습관을 명시적으로 드러낸다",
      "evidence": "문장도 짧게 끊어 쓰는 편인데 AI는 자꾸 길게 늘여 씁니다." }
  ],
  "avoids": [],
  "dropped": 0
}

에러

AI 초안을 사용자의 말투 항목으로 문장 단위로 다시 씁니다. 의미·주장·수치는 바꾸지 않고 말투만 바꿉니다. 바뀐 문장에 원문에 없던 숫자가 생기거나, 원문의 숫자가 빠지거나, 원문의 로마자 고유 표기가 사라지면 서버가 그 문장을 원문으로 되돌립니다(생성 금지 게이트, reverted_count). 원문에 없던 제목·목록 기호는 떼고 문장만 돌려줍니다. 조직 모드(mode:"org")에서는 회사 문서가 아직 0건이므로 수치·비교·전망 문장을 blank:true로 표시합니다 — 근거 없으면 비웁니다. 초안·결과는 저장되지 않습니다.

요청 본문

요청 예시

curl -sS -X POST https://sealo.kr/api/rewrite \
  -H "Content-Type: application/json" \
  -d '{"draft":"저희 팀은 남다른 방식으로 문제를 풉니다. 시장은 앞으로도 계속 성장할 전망입니다.",
       "rules":[{"id":1,"rule":"결론을 첫 문장에 둔다"},{"id":2,"rule":"숫자엔 단위를 붙인다"}],
       "mode":"personal"}'

응답 (200)

에러

이미 /api/rewrite로 다시 쓴 문장 목록을 5단 리포트 구조(한 줄 결론·핵심 3·본문 소제목·숫자·다음 할 일)로 재배열합니다. 새 내용을 만들지 않습니다 — 입력 문장을 고르고 순서만 바꿉니다. 각 항목은 입력 문장 중 하나를 그대로 인용한 evidence가 있어야 채택되고, 없으면 서버가 드롭합니다(생성 금지 게이트).

요청 본문

응답 (200)

에러

화이트리스트에 있는 이벤트만 기록합니다(확정 7 — 계측은 서버 기록이 정본). 전송 실패가 사용자 경험을 막지 않도록 설계돼 있어, 저장소 미연결 시에도 202로 무해 응답합니다. 화면에서는 data-ev 속성 한 개와 위임 리스너 한 개로 발화합니다. published_as_is는 edit_ratio 0(원래대로·직접 쓰기 0건) 상태에서 복사·내보내기 행동이 있을 때만 셉니다 — 되돌리거나 직접 채운 문장이 있으면 복사해도 세지 않습니다.

허용 이벤트

profile_created · taste_rule_edited · draft_submitted · transform_done · published_as_is · revision_loop

미리보기 화면의 profile_created는 stored:false 속성으로 옵니다 — 내 말투가 만들어진 시점이지 저장이 아닙니다. 서버 저장은 실서비스에서만.

transform_done(view:"editor")과 published_as_is는 changed_ratio 속성을 함께 싣습니다 — /api/rewrite가 돌려준 값 그대로입니다. 0~1 숫자나 null만 받고, 그 밖의 값은 키째 버립니다(없는 값을 0으로 세지 않게). 사용자가 게시 전에 고친 양(edit_ratio)과는 다른 값입니다.

taste_rule_edited는 origin 속성으로 어디서 고쳤는지 함께 옵니다 — inline(말투를 꺼낸 뒤 그 자리에서) · tab(「내 말투」에서). 이름은 여섯 가지 그대로이고 속성만 늘렸습니다.

요청 본문

응답

운영 화면(/admin)이 지표 한 줄을 읽어 가는 곳입니다. 이 문서의 다른 엔드포인트와 달리 GET만 받고, 열쇠말(ADMIN_TOKEN)이 맞아야 응답합니다. 계산은 전부 저장소 뷰에 있고 이 엔드포인트는 그 값을 그대로 돌려줍니다 — 여기서 숫자를 만들지 않습니다. 값이 null이면 아직 잴 것이 없다는 뜻이며 0.0이 아닙니다.

요청 헤더

응답 (200)

오류