본문으로 건너뛰기

게시물 조회

GET/v1/posts/{id}

게시물을 본문, 투표, 이미지, 커뮤니티와 함께 반환해요.

요청

Shell
curl -g "https://api.nogitsu.com/v1/posts/{id}"

매개변수

  • id

    경로필수

    항목의 ID(UUID).

    텍스트

  • reveal

    쿼리선택

    1로 설정하면 스포일러로 표시된 게시물의 본문을 포함해요.

    텍스트

    허용되는 값1

응답

요청이 성공하면 다음 JSON과 함께 200으로 응답해요.

  • id텍스트 (uuid)
  • slug텍스트
  • community객체
    • id텍스트 (uuid)
    • slug텍스트
    • language텍스트
    • kind텍스트
      허용되는 값workboarduser
    • name텍스트
    • iconUrl텍스트 (uri)null일 수 있음
    • theme텍스트
      허용되는 값violetblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue 또는 false
  • author객체null일 수 있음
    • username텍스트
    • displayName텍스트
    • avatarUrl텍스트 (uri)null일 수 있음
  • authorFlair텍스트null일 수 있음
  • kind텍스트
    허용되는 값textlinkimagepoll
  • title텍스트null일 수 있음
  • excerpt텍스트null일 수 있음
  • flair객체null일 수 있음
    • id텍스트 (uuid)
    • label텍스트
    • tone텍스트
      허용되는 값neutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
  • spoiler객체null일 수 있음
    • workTitle텍스트null일 수 있음
    • unitNumber숫자null일 수 있음

      0 이상

  • work객체null일 수 있음
    • id텍스트 (uuid)
    • title텍스트
    • medium텍스트
      허용되는 값animedonghuaanimationmangamanhwamanhuawebtoon
    • slug텍스트
    • unitNumber숫자null일 수 있음

      0 이상

  • isAdulttrue 또는 false
  • isPinnedtrue 또는 false
  • isLockedtrue 또는 false
  • score정수null일 수 있음

    -9007199254740991부터 9007199254740991까지

  • commentCount정수

    0부터 9007199254740991까지

  • reactions객체 목록
    • kind텍스트
      허용되는 값lovelaughwowsadclapfirethinkangrypartycry
    • count정수

      0부터 9007199254740991까지

  • link객체null일 수 있음
    • url텍스트 (uri)
    • host텍스트
    • title텍스트null일 수 있음
    • description텍스트null일 수 있음
    • image객체null일 수 있음
      • url텍스트 (uri)
      • width정수

        0부터 9007199254740991까지

      • height정수

        0부터 9007199254740991까지

      • alt텍스트null일 수 있음
      • variantWidths정수 목록

        0부터 9007199254740991까지

    • isPendingtrue 또는 false
  • images객체 목록
    • url텍스트 (uri)
    • width정수

      0부터 9007199254740991까지

    • height정수

      0부터 9007199254740991까지

    • alt텍스트null일 수 있음
    • variantWidths정수 목록

      0부터 9007199254740991까지

  • poll객체null일 수 있음
    • options객체 목록
      • id텍스트 (uuid)
      • label텍스트
      • voteCount정수null일 수 있음

        0부터 9007199254740991까지

    • totalVotes정수

      0부터 9007199254740991까지

    • closesAt텍스트 (date-time)
    • isClosedtrue 또는 false
    • allowsMultipletrue 또는 false
  • createdAt텍스트 (date-time)
  • editedAt텍스트 (date-time)null일 수 있음
  • body객체null일 수 있음
    • blocks여러 형식 중 하나 목록
      1. 옵션 1

        • type텍스트
          허용되는 값paragraph
        • children여러 형식 중 하나 목록
          1. 옵션 1

            • type텍스트
              허용되는 값text
            • text텍스트
            • marks모든 값 목록
          2. 옵션 2

            • type텍스트
              허용되는 값link
            • href텍스트 (uri)
            • children모든 값 목록
          3. 옵션 3

            • type텍스트
              허용되는 값mention
            • username텍스트
          4. 옵션 4

            • type텍스트
              허용되는 값spoiler
            • spoilerId텍스트
            • children모든 값 목록null일 수 있음
          5. 옵션 5

            • type텍스트
              허용되는 값break
      2. 옵션 2

        • type텍스트
          허용되는 값heading
        • children여러 형식 중 하나 목록
          1. 옵션 1

            • type텍스트
              허용되는 값text
            • text텍스트
            • marks모든 값 목록
          2. 옵션 2

            • type텍스트
              허용되는 값link
            • href텍스트 (uri)
            • children모든 값 목록
          3. 옵션 3

            • type텍스트
              허용되는 값mention
            • username텍스트
          4. 옵션 4

            • type텍스트
              허용되는 값spoiler
            • spoilerId텍스트
            • children모든 값 목록null일 수 있음
          5. 옵션 5

            • type텍스트
              허용되는 값break
      3. 옵션 3

        • type텍스트
          허용되는 값quote
        • childrenRichTextBlock 목록
      4. 옵션 4

        • type텍스트
          허용되는 값list
        • isOrderedtrue 또는 false
        • itemsRichTextBlock 목록 목록
      5. 옵션 5

        • type텍스트
          허용되는 값code
        • text텍스트
  • isDeletedtrue 또는 false

오류

다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기