스팀 앱 개발기 #171 - 개발 완료: 포스트 내역 구하는 SDS API 연동
개발 완료: 포스트 내역 구하는 SDS API 연동
이번 API 연동은 내용 정리에 애를 많이 먹었습니다. SDS API 문서에는 각 API와 그것의 파라메터, 응답 데이터 등에 대한 설명이 없기 때문입니다. Claude Code가 내용 정리를 해주지만, 오류가 없는지 확인이 필요했습니다.
content_history_api/getContentHistory 연동 정리
1. 엔드포인트
GET https://sds.steemworld.org/content_history_api/getContentHistory/{author}/{permlink}
| 경로 파라미터 | 의미 |
|---|---|
author | 저자 계정 |
permlink | 글의 주소 |
경로 파라미터가 이 둘뿐입니다. limit·offset·orderBy·orderDir이 아예 없습니다(뒤에 더 붙이면 404). 글의 전체 수정 이력이 한 번에, 시간 오름차순으로 옵니다. 보관 기간 설정(store_days)도 없어 2018년 글의 이력까지 조회됩니다.
용도: 포스트의 수정 전 내용 보여주기 + 수정 일시를 목록으로 보여주기.
공식 API를 쓰지 않은 이유: 대응 기능이 없습니다. 공식 API는 현재 글만 돌려주고 이전 개정판을 조회할 방법이 없습니다.
2. 응답 구조
성공 — 개정판 하나가 rows의 한 행입니다.
{"code":0,"result":{
"cols":{"time":0,"json_metadata":1,"title":2,"body":3},
"rows":[[1524481023,"{\"tags\":[\"kr\"],\"app\":\"steemit/0.1\"}","장례 잘마무리 되었다고 합니다","잘마무리 되었다고…"],
[1759138161,"{\"format\":\"markdown\",\"app\":\"steemit/0.2\"}",".","."]]}}
실패 — HTTP 200에 code: -1입니다.
{"code":-1,"error":"Link could not be found: invalid987654321/invalid987655321"}
없는 저자와 없는 permlink가 똑같이 보고됩니다. 응답만으로는 구분할 수 없습니다.
3. 반드시 알아야 할 동작 4가지
(1) 빈 값은 "값이 없다"는 뜻이 아닙니다
title과 json_metadata가 빈 문자열로 오는 행이 있습니다. 그 개정판에 제목이 없었다는 뜻이 아니라, 이 개정판이 그 필드의 값을 알려주지 않는다는 뜻입니다.
근거는 chainsmokerslav/python-04-39입니다. 개정판 3건 중 첫 행만 제목을 담고 있는데, 그 글의 현재 제목이 바로 그 제목입니다. 빈 값을 "제목 없음"으로 읽으면 존재하지 않았던 "제목 없는 글" 2건이 화면에 나옵니다.
→ 직전의 알려진 값을 이어받아야 합니다. 필드마다 독립적으로 이어받습니다(한 필드만 담고 다른 필드는 비어 있는 행이 있습니다).
왜 빈 값이 오는지(원래 안 보냈는지, SDS가 비웠는지)는 외부에서 알 수 없습니다. 하지만 어느 쪽이든 읽는 방법은 같습니다.
(2) 필드마다 다릅니다
글 190개 / 개정판 204건 조사 결과:
| 필드 | 빈 행 |
|---|---|
title | 11건 |
json_metadata | 1건 |
body | 0건 |
body는 항상 전문으로 옵니다. 그래서 body만 이어받기를 하지 않습니다. 한 필드의 동작을 다른 필드에 일반화하면 안 됩니다. 다만 이건 측정값이지 보장이 아니라서, 전제가 깨지면 테스트의 body.isNotEmpty() 단언이 잡습니다.
(3) SDS가 "image":{}를 넣습니다
이미지 없는 개정판의 json_metadata에 빈 배열이 아닌 빈 객체를 넣습니다. 공식 API에는 그 키 자체가 없습니다.
{"app":"steemitkorea/0.1","tags":["kr",...],"image":{}}
image를 List<String>?로 선언한 JSONMetadataDTO로 파싱하면 Gson이 객체 전체를 포기해 태그까지 잃습니다. 65cfcbd의 links/users와 같은 함정입니다. 그래서 필요한 두 필드(tags, app)만 선언한 ContentHistoryMetadataDTO를 별도로 뒀습니다.
(4) 시간은 Unix timestamp(초)이고 Gson이 Double로 받습니다
rows가 List<List<Any>>이므로 row[i] as? Double 후 toLong()으로 변환하고, 도메인에서는 yyyy-MM-dd HH:mm 로컬 시간 문자열로 넘깁니다.
4. 레이어별 구현
| 레이어 | 파일 | 하는 일 |
|---|---|---|
| data | model/content_history/GetContentHistoryResponseDTO.kt | GetContentHistoryResponseDTO / ContentHistoryResultDTO / ContentHistoryColsDTO / ContentHistoryDTO / ContentHistoryMetadataDTO. cols 인덱스 매핑, 이어받기, 시간 포맷 |
| data | retrofit/SteemWorldService.kt | getContentHistory(author, permlink): Response<…> |
| domain | model/ContentHistory.kt | time·title·body·tags·app (전부 가공 완료된 형태) |
| domain | repository/SteemWorldRepository.kt | readContentHistory(author, permlink): ApiResult<List<ContentHistory>> |
| data | repository/SteemWorldRepositoryImpl.kt | isSuccessful 와 body.code 이중 확인 + reversed() |
| domain | usecase/ReadContentHistoryUseCase.kt | invoke(author, permlink) |
| ui | ui/post/content/PostContentViewModel.kt | flowContentHistoryState: StateFlow<State<List<ContentHistory>>>, readContentHistory() |
cols가 빈 객체로 올 수 있어 기본 인덱스를 상수로 뒀습니다 — DEFAULT_TIME_INDEX=0, DEFAULT_JSON_METADATA_INDEX=1, DEFAULT_TITLE_INDEX=2, DEFAULT_BODY_INDEX=3.
정렬 뒤집기를 DTO가 아니라 Repository에서 하는 이유: 이어받기가 오름차순을 전제로 하므로, DTO에서 먼저 뒤집으면 이어받기가 거꾸로 돌아 전부 틀립니다. 두 단계를 분리했습니다.
ViewModel이 상태를 분리한 이유: 포스트는 화면 진입 시 읽지만 개정판은 요청받을 때만 읽으면 되고, 개정판 조회 실패가 포스트를 같이 내려버리면 안 됩니다.
DI는 수정이 필요 없었습니다. SteemWorldRepository 바인딩이 이미 있고 UseCase는 @Inject constructor입니다.
5. 화면이 의존하는 계약
- 최신순 — 첫 항목이 현재 글, 마지막 항목이 최초 발행 상태
- 개정판 1건 = 수정된 적 없는 글 — 그래서 빈 목록은 "수정 없음"이 아니라 "글을 못 읽음"입니다
- 모든 항목은 완전한 글 —
title·body가 비어 있지 않음 - 개정판 개수는 저자가 정하는 것이라 코드에서 제한할 수 없음
6. 테스트 (18건)
| 파일 | 케이스 |
|---|---|
SteemWorldServiceTest | getContentHistory_case1~6 — 행 형식, 무효 링크, 무효 permlink, 오름차순, 빈 title 존재 + 이어받기 후 전부 채워짐, 개정판 1건 |
SteemWorldRepositoryImplTest | readContentHistory_case1~5 — 성공, Failure 2종, 최신순, 개정판 1건 |
ReadContentHistoryUseCaseTest | readContentHistory_case1~6 — 위 + image:{} 글의 태그 보존 |
PostContentViewModelTest | readContentHistory — State.Empty → State.Success |
TestData의 고정 링크:
| 이름 | 값 | 목적 |
|---|---|---|
singleRevisionContentLink | dorian-mobileapp/170-sds-api | 수정 안 된 글 |
multipleRevisionsContentLink | chainsmokerslav/python-04-39 | 개정판 3건 + 빈 title |
contentLinkWithoutImages | dorian-lee/475 | image:{} 재현 |
invalidPermlinkContentLink | 유효 저자 + 없는 permlink | 오류 처리 |
invalidContentLink | 없는 저자 + 없는 permlink | 오류 처리 |
multipleRevisionsContentLink만 제3자 글입니다 — 본인 계정 최근 60건 중 개정판이 2건 이상인 글이 하나도 없어서 선택지가 없었습니다. 저자가 지우거나 다시 수정하면 깨지며, 그때는 개정판 2건 이상이고 빈 title 행이 있는 다른 글로 바꾸면 됩니다.
7. 남은 것
Step 9 (Compose 화면). 답글이 쓰는 ModalBottomSheet와 같은 구조를 따르면 됩니다.
먼저 정할 것: 개정판이 1건일 때 UI. 수정 이력이 있는 글은 드물어서(본인 계정 60건 중 0건) 진입점을 숨길지 "수정 없음"으로 보여줄지에 따라 화면 구조가 갈립니다.
GitHub Commit
보다 자세한 코드 또는 변경 내용은 아래 commit을 참고하세요.
지난 스팀 앱 개발기
- #170 - 작성 완료: SDS API 추가 연동을 위한 프롬프트 작성 방법
- #169 - 개발 완료: 포스트 리스트 로딩시 발생하는 오류 해결
- #168 - 작성 완료: iCloud 충돌 사본 차단
- #167 - 작성 완료: 문서 추가 정리
- #166 - 작성 완료: 문서 추가 정리
- #165 - 개발 완료: 지갑 화면에 보상 탭 도입 (저자 및 큐레이션 보상)
- #164 - 개발 완료: 저자/큐레이션 보상 내역 API 연동 (SDS API)
- #163 - 개발 완료: 지갑 화면에 탭 도입 (잔액, 보낸 목록, 받은 목록)
- #162 - 개발 완료: 패키지 관련 오류 수정
- #161 - 개발 완료: 피임대 중인 스팀 파워 목록 화면 구현
- #160 - 개발 완료: 스팀 파워 임대 목록 화면 구현
- #159 - 개발 완료: 포스트의 댓글 정렬 오류 수정
- #158 - 개발 완료: 추가 개선 6, 7, 8, 9
- #157 - 개발 완료: 추가 개선 4, 5
- #156 - 개발 완료: 추가 개선 1, 2, 3
- #155 - 개발 계획: 추가 개선 적용
- #154 - 개발 완료: 테스트 코드 개선
- #153 - 개발 완료: Architecture 개선 작업
- #152 - 개발 완료: 레거시 의존성 제거 작업 요약
- #151 - 개발 완료: Compose 마이그레이션 연장선
- #1 ~ #150
안녕하세요.
SteemitKorea팀에서 제공하는 'steemit-enhancer'를 사용해 주셔서 감사합니다. 개선 사항이 있으면 언제나 저에게 연락을 주시면 되고, 관심이 있으신 분들은 https://cafe.naver.com/steemitkorea/425 에서 받아보실 수 있습니다. 사용시 @응원해 가 포함이 되며, 악용시에는 모든 서비스에서 제외될 수 있음을 알려드립니다.
새로운 콘덴서(steemit 사이트)를 소개합니다.
https://steemitkorea.com 에서 보다 편리한 스팀잇 활동 부탁드립니다
안녕하세요.
이 글은 SteemitKorea팀(@ayogom)님께서 저자이신 @dorian-mobileapp님을 응원하는 글입니다.
소정의 보팅을 해드렸습니다 ^^ 항상 좋은글 부탁드립니다
SteemitKorea팀에서는 보다 즐거운 steemit 생활을 위해 노력하고 있습니다.
이 글은 다음날 다시 한번 포스팅을 통해 소개 될 예정입니다. 감사합니다!
새로운 콘덴서(steemit 사이트)를 소개합니다.
https://steemitkorea.com 에서 보다 편리한 스팀잇 활동 부탁드립니다
Upvoted! Thank you for supporting witness @jswit.