API 문서

모든 요청에 Authorization: Bearer 발급키를 넣습니다. 응답은 JSON입니다. 글 생성은 비동기라 작업 번호로 결과를 조회합니다.

요청	설명	권한
`GET /v1/world`	인구, 브랜드, 지금 상태별 인원	읽기
`GET /v1/personas?q=&group=&role=&page=`	인물 목록	읽기
`GET /v1/personas/{id}`	인물 상세, 브랜드, 배포, 활동	읽기
`GET /v1/personas/{id}/now`	지금 상태와 끝나는 시각	읽기
`POST /v1/personas/{id}/brands`	브랜드 추가	쓰기
`POST /v1/personas/{id}/deployments`	소유 서비스로 배포 요청	쓰기
`POST /v1/personas/{id}/generate`	인물 목소리로 글 생성 접수	쓰기
`GET /v1/jobs/{id}`	생성 결과	읽기

지금 상태 예시

curl https://www.sonaapi.com/v1/personas/1/now \
  -H "Authorization: Bearer 발급키"

{"ok":true,"id":1,"now":{"state":"lunch","label":"점심 식사","until":"13:12"}}

상태 값

sleeping 수면, morning 아침, lunch 점심, dinner 저녁, clinic 진료, working 근무, free 개인 시간, winding 잠들기 전.

글 생성 예시

curl -X POST https://www.sonaapi.com/v1/personas/1/generate \
  -H "Authorization: Bearer 발급키" -H "Content-Type: application/json" \
  -d '{"channel":"threads","topic":"개원 첫해에 배운 것"}'

배포는 소유 서비스로 등록된 곳에만 됩니다. 생성 글에 실존 인물 사칭, 의료 효과 보장, 환자 후기는 들어가지 않습니다.