Twooter API Guide

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 179

{
  "member" : {
    "id" : 123,
    "handle" : "twooter_123",
    "nickname" : "테이블 청소 마스터",
    "avatarPath" : "testpath",
    "email" : "user@example.com"
  }
}

POST /api/auth/signin HTTP/1.1
Content-Type: application/json
Content-Length: 64
Host: localhost:8080

{
  "handle" : "twooter_123",
  "password" : "StrongP@ssw0rd!"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 238

{
  "accessToken" : "<ACCESS_TOKEN>",
  "refreshToken" : "<REFRESH_TOKEN>",
  "member" : {
    "id" : 123,
    "handle" : "twooter_123",
    "nickname" : "twooter_123",
    "avatarPath" : "testpath",
    "email" : "user@example.com"
  }
}

POST /api/auth/reissue HTTP/1.1
Content-Type: application/json
Content-Length: 40
Host: localhost:8080

{
  "refreshToken" : "<REFRESH_TOKEN>"
}

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 84

{
  "accessToken" : "<NEW_ACCESS_TOKEN>",
  "refreshToken" : "<NEW_REFRESH_TOKEN>"
}

POST /api/auth/logout HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 34

{
  "userHandle" : "user_handle"
}

POST /api/members/follow HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Length: 26
Host: localhost:8080

{
  "targetMemberId" : 1
}

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 66

{
  "targetMemberId" : 1,
  "followedAt" : "2025-05-05T10:10:00"
}

DELETE /api/members/follow/1 HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 75

{
  "targetMemberId" : 1,
  "unfollowedAt" : "2025-06-13T13:36:18.687462"
}

GET /api/members/1/followers?cursor=dXNlcjpVMDYxTkZUVDI%3D&limit=10 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 779

{
  "members" : [ {
    "id" : 1,
    "handle" : "cameraman",
    "nickname" : "카메라맨",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "카메라맨의 바이오",
    "followsMe" : false,
    "followingByMe" : false
  }, {
    "id" : 2,
    "handle" : "movie_journalist",
    "nickname" : "영화 상영 기자",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "영화 상영 기자의 바이오",
    "followsMe" : false,
    "followingByMe" : false
  }, {
    "id" : 3,
    "handle" : "movie_critic",
    "nickname" : "영화 평론가",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "영화 평론가의 바이오",
    "followsMe" : false,
    "followingByMe" : true
  } ],
  "metadata" : {
    "nextCursor" : null,
    "hasNext" : false
  }
}

GET /api/members/1/followings?cursor=dXNlcjpVMDYxTkZUVDI%3D&limit=10 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 779

{
  "members" : [ {
    "id" : 1,
    "handle" : "cameraman",
    "nickname" : "카메라맨",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "카메라맨의 바이오",
    "followsMe" : false,
    "followingByMe" : false
  }, {
    "id" : 2,
    "handle" : "movie_journalist",
    "nickname" : "영화 상영 기자",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "영화 상영 기자의 바이오",
    "followsMe" : false,
    "followingByMe" : false
  }, {
    "id" : 3,
    "handle" : "movie_critic",
    "nickname" : "영화 평론가",
    "avatarPath" : "test_avatar_path.jpg",
    "bio" : "영화 평론가의 바이오",
    "followsMe" : false,
    "followingByMe" : true
  } ],
  "metadata" : {
    "nextCursor" : null,
    "hasNext" : false
  }
}

GET /api/timeline/home?cursor=dXNlcjpVMDYxTkZUVDI%3D&limit=10 HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1884

{
  "timeline" : [ {
    "type" : "post",
    "createdAt" : "2025-05-05T00:00:00",
    "post" : {
      "id" : 1,
      "author" : {
        "id" : 1,
        "handle" : "table_cleaner",
        "nickname" : "테이블 청소 마스터",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
      },
      "content" : "새 책상을 정리하다가 유용해 보이는 오래된 자료를 발견해서 이메일로 보냅니다.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 101,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 102,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T00:00:00",
      "liked" : true,
      "reposted" : true,
      "deleted" : false
    }
  }, {
    "type" : "repost",
    "createdAt" : "2025-05-05T05:05:00",
    "post" : {
      "id" : 2,
      "author" : {
        "id" : 2,
        "handle" : "table_specialist",
        "nickname" : "친절한 책상 정리 전문가",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar2"
      },
      "content" : "비고: 누가 남긴 자료인지 모르겠네요.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 103,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 104,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T10:10:00",
      "liked" : true,
      "reposted" : false,
      "deleted" : false
    },
    "repostBy" : {
      "id" : 1,
      "handle" : "table_cleaner",
      "nickname" : "테이블 청소 마스터",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
    }
  } ],
  "metadata" : {
    "nextCursor" : "dGVhbTpDMDYxRkE1UEI=",
    "hasNext" : true
  }
}

GET /api/timeline/me?cursor=dXNlcjpVMDYxTkZUVDI%3D&limit=10 HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1884

{
  "timeline" : [ {
    "type" : "post",
    "createdAt" : "2025-05-05T00:00:00",
    "post" : {
      "id" : 1,
      "author" : {
        "id" : 1,
        "handle" : "table_cleaner",
        "nickname" : "테이블 청소 마스터",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
      },
      "content" : "새 책상을 정리하다가 유용해 보이는 오래된 자료를 발견해서 이메일로 보냅니다.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 101,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 102,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T00:00:00",
      "liked" : true,
      "reposted" : true,
      "deleted" : false
    }
  }, {
    "type" : "repost",
    "createdAt" : "2025-05-05T05:05:00",
    "post" : {
      "id" : 2,
      "author" : {
        "id" : 2,
        "handle" : "table_specialist",
        "nickname" : "친절한 책상 정리 전문가",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar2"
      },
      "content" : "비고: 누가 남긴 자료인지 모르겠네요.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 103,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 104,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T10:10:00",
      "liked" : true,
      "reposted" : false,
      "deleted" : false
    },
    "repostBy" : {
      "id" : 1,
      "handle" : "table_cleaner",
      "nickname" : "테이블 청소 마스터",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
    }
  } ],
  "metadata" : {
    "nextCursor" : "dGVhbTpDMDYxRkE1UEI=",
    "hasNext" : true
  }
}

GET /api/timeline/user/1?cursor=dXNlcjpVMDYxTkZUVDI%3D&limit=10 HTTP/1.1
Content-Type: application/json
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1884

{
  "timeline" : [ {
    "type" : "post",
    "createdAt" : "2025-05-05T00:00:00",
    "post" : {
      "id" : 1,
      "author" : {
        "id" : 1,
        "handle" : "table_cleaner",
        "nickname" : "테이블 청소 마스터",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
      },
      "content" : "새 책상을 정리하다가 유용해 보이는 오래된 자료를 발견해서 이메일로 보냅니다.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 101,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 102,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T00:00:00",
      "liked" : true,
      "reposted" : true,
      "deleted" : false
    }
  }, {
    "type" : "repost",
    "createdAt" : "2025-05-05T05:05:00",
    "post" : {
      "id" : 2,
      "author" : {
        "id" : 2,
        "handle" : "table_specialist",
        "nickname" : "친절한 책상 정리 전문가",
        "avatarPath" : "https://cdn.twooter.xyz/media/avatar2"
      },
      "content" : "비고: 누가 남긴 자료인지 모르겠네요.",
      "likeCount" : 15,
      "repostCount" : 3,
      "mediaEntities" : [ {
        "mediaId" : 103,
        "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
      }, {
        "mediaId" : 104,
        "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
      } ],
      "createdAt" : "2025-05-05T10:10:00",
      "liked" : true,
      "reposted" : false,
      "deleted" : false
    },
    "repostBy" : {
      "id" : 1,
      "handle" : "table_cleaner",
      "nickname" : "테이블 청소 마스터",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar1"
    }
  } ],
  "metadata" : {
    "nextCursor" : "dGVhbTpDMDYxRkE1UEI=",
    "hasNext" : true
  }
}

POST /api/posts HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Length: 190
Host: localhost:8080

{
  "content" : "트우터에 올릴 새로운 포스트 내용입니다. #첫글 #환영",
  "media" : [ "https://cdn.twooter.xyz/media/101.jpg", "https://cdn.twooter.xyz/media/102.jpg" ]
}

HTTP/1.1 201 Created
Location: http://localhost:8080/api/posts
Content-Type: application/json
Content-Length: 533

{
  "id" : 1,
  "content" : "트우터에 올릴 새로운 포스트 내용입니다. #첫글 #환영",
  "author" : {
    "id" : 123,
    "handle" : "table_cleaner",
    "nickname" : "테이블 청소 마스터",
    "avatarPath" : "https://cdn.twooter.xyz/media/avatar",
    "email" : "test@test.com"
  },
  "media" : [ {
    "mediaId" : 101,
    "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
  }, {
    "mediaId" : 102,
    "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
  } ],
  "createdAt" : "2025-05-05T00:00:00"
}

GET /api/posts/1 HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 649

{
  "id" : 1,
  "author" : {
    "id" : 123,
    "handle" : "table_cleaner",
    "nickname" : "테이블 청소 마스터",
    "avatarPath" : "https://cdn.twooter.xyz/media/avatar"
  },
  "content" : "새 책상을 정리하다가 유용해 보이는 오래된 자료를 발견해서 이메일로 보냅니다.",
  "likeCount" : 15,
  "repostCount" : 3,
  "mediaEntities" : [ {
    "mediaId" : 101,
    "mediaUrl" : "https://cdn.twooter.xyz/media/101.jpg"
  }, {
    "mediaId" : 102,
    "mediaUrl" : "https://cdn.twooter.xyz/media/102.jpg"
  } ],
  "createdAt" : "2025-05-05T00:00:00",
  "liked" : true,
  "reposted" : false,
  "deleted" : false
}

PATCH /api/posts/1/like HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 38

{
  "postId" : 1,
  "isLiked" : true
}

POST /api/posts/1/repost HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080
Content-Type: application/x-www-form-urlencoded

HTTP/1.1 201 Created
Location: http://localhost:8080/api/posts/1/repost
Content-Type: application/json
Content-Length: 84

{
  "repostId" : 1,
  "originalPostId" : 2,
  "repostedAt" : "2025-05-05T00:00:00"
}

POST /api/posts/replies HTTP/1.1
Content-Type: application/json
Authorization: Bearer <ACCESS_TOKEN>
Content-Length: 118
Host: localhost:8080

{
  "content" : "답글 내용입니다.",
  "media" : [ "https://cdn.twooter.xyz/media/201.jpg" ],
  "parentId" : 1
}

HTTP/1.1 201 Created
Location: http://localhost:8080/api/posts/replies
Content-Type: application/json
Content-Length: 417

{
  "id" : 2,
  "content" : "답글 내용입니다.",
  "author" : {
    "id" : 123,
    "handle" : "table_cleaner",
    "nickname" : "테이블 청소 마스터",
    "avatarPath" : "https://cdn.twooter.xyz/media/avatar",
    "email" : "test@test.com"
  },
  "media" : [ {
    "mediaId" : 201,
    "mediaUrl" : "https://cdn.twooter.xyz/media/201.jpg"
  } ],
  "createdAt" : "2025-05-05T00:00:00",
  "parentId" : 1
}

GET /api/posts/1/replies HTTP/1.1
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 1785

{
  "posts" : [ {
    "id" : 2,
    "author" : {
      "id" : 456,
      "handle" : "reply_author_2",
      "nickname" : "답글 작성자",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar_reply.jpg"
    },
    "content" : "이것은 포스트 1에 대한 답글입니다. 답글 ID: 2",
    "likeCount" : 7,
    "repostCount" : 2,
    "mediaEntities" : [ {
      "mediaId" : 202,
      "mediaUrl" : "https://cdn.twooter.xyz/media/reply_2.jpg"
    } ],
    "createdAt" : "2025-05-05T00:02:00",
    "liked" : true,
    "reposted" : false,
    "deleted" : false
  }, {
    "id" : 3,
    "author" : {
      "id" : 456,
      "handle" : "reply_author_3",
      "nickname" : "답글 작성자",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar_reply.jpg"
    },
    "content" : "이것은 포스트 1에 대한 답글입니다. 답글 ID: 3",
    "likeCount" : 8,
    "repostCount" : 2,
    "mediaEntities" : [ {
      "mediaId" : 203,
      "mediaUrl" : "https://cdn.twooter.xyz/media/reply_3.jpg"
    } ],
    "createdAt" : "2025-05-05T00:03:00",
    "liked" : false,
    "reposted" : false,
    "deleted" : false
  }, {
    "id" : 4,
    "author" : {
      "id" : 456,
      "handle" : "reply_author_4",
      "nickname" : "답글 작성자",
      "avatarPath" : "https://cdn.twooter.xyz/media/avatar_reply.jpg"
    },
    "content" : "이것은 포스트 1에 대한 답글입니다. 답글 ID: 4",
    "likeCount" : 9,
    "repostCount" : 2,
    "mediaEntities" : [ {
      "mediaId" : 204,
      "mediaUrl" : "https://cdn.twooter.xyz/media/reply_4.jpg"
    } ],
    "createdAt" : "2025-05-05T00:04:00",
    "liked" : true,
    "reposted" : false,
    "deleted" : false
  } ],
  "metadata" : {
    "nextCursor" : "dGVhbTpDMDYxRkE1UEI=",
    "hasNext" : true
  }
}

GET /api/media/upload-url?filename=test.jpg&contentType=image%2Fjpeg HTTP/1.1
Authorization: Bearer <ACCESS_TOKEN>
Host: localhost:8080

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 89

{
  "url" : "https://storage.googleapis.com/your-bucket/media/abc123.jpg?signature=..."
}