Pular para o conteúdo

Obter um post

GET/v1/posts/{id}

Retorna um post com seu texto, enquete, imagens e comunidade.

Requisição

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

Parâmetros

  • id

    caminhoobrigatório

    ID do item, um UUID.

    texto

  • reveal

    consultaopcional

    Defina como 1 para incluir o texto de um post marcado como spoiler.

    texto

    Valores permitidos1

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

  • idtexto (uuid)
  • slugtexto
  • communityobjeto
    • idtexto (uuid)
    • slugtexto
    • languagetexto
    • kindtexto
      Valores permitidosworkboarduser
    • nametexto
    • iconUrltexto (uri)pode ser null
    • themetexto
      Valores permitidosvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue ou false
  • authorobjetopode ser null
    • usernametexto
    • displayNametexto
    • avatarUrltexto (uri)pode ser null
  • authorFlairtextopode ser null
  • kindtexto
    Valores permitidostextlinkimagepoll
  • titletextopode ser null
  • excerpttextopode ser null
  • flairobjetopode ser null
    • idtexto (uuid)
    • labeltexto
    • tonetexto
      Valores permitidosneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
  • spoilerobjetopode ser null
    • workTitletextopode ser null
    • unitNumbernúmeropode ser null

      No mínimo 0

  • workobjetopode ser null
    • idtexto (uuid)
    • titletexto
    • mediumtexto
      Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
    • slugtexto
    • unitNumbernúmeropode ser null

      No mínimo 0

  • isAdulttrue ou false
  • isPinnedtrue ou false
  • isLockedtrue ou false
  • scorenúmero inteiropode ser null

    De -9007199254740991 a 9007199254740991

  • commentCountnúmero inteiro

    De 0 a 9007199254740991

  • reactionslista de objeto
    • kindtexto
      Valores permitidoslovelaughwowsadclapfirethinkangrypartycry
    • countnúmero inteiro

      De 0 a 9007199254740991

  • linkobjetopode ser null
    • urltexto (uri)
    • hosttexto
    • titletextopode ser null
    • descriptiontextopode ser null
    • imageobjetopode ser null
      • urltexto (uri)
      • widthnúmero inteiro

        De 0 a 9007199254740991

      • heightnúmero inteiro

        De 0 a 9007199254740991

      • alttextopode ser null
      • variantWidthslista de número inteiro

        De 0 a 9007199254740991

    • isPendingtrue ou false
  • imageslista de objeto
    • urltexto (uri)
    • widthnúmero inteiro

      De 0 a 9007199254740991

    • heightnúmero inteiro

      De 0 a 9007199254740991

    • alttextopode ser null
    • variantWidthslista de número inteiro

      De 0 a 9007199254740991

  • pollobjetopode ser null
    • optionslista de objeto
      • idtexto (uuid)
      • labeltexto
      • voteCountnúmero inteiropode ser null

        De 0 a 9007199254740991

    • totalVotesnúmero inteiro

      De 0 a 9007199254740991

    • closesAttexto (date-time)
    • isClosedtrue ou false
    • allowsMultipletrue ou false
  • createdAttexto (date-time)
  • editedAttexto (date-time)pode ser null
  • bodyobjetopode ser null
    • blockslista de um de vários formatos
      1. Opção 1

        • typetexto
          Valores permitidosparagraph
        • childrenlista de um de vários formatos
          1. Opção 1

            • typetexto
              Valores permitidostext
            • texttexto
            • markslista de qualquer valor
          2. Opção 2

            • typetexto
              Valores permitidoslink
            • hreftexto (uri)
            • childrenlista de qualquer valor
          3. Opção 3

            • typetexto
              Valores permitidosmention
            • usernametexto
          4. Opção 4

            • typetexto
              Valores permitidosspoiler
            • spoilerIdtexto
            • childrenlista de qualquer valorpode ser null
          5. Opção 5

            • typetexto
              Valores permitidosbreak
      2. Opção 2

        • typetexto
          Valores permitidosheading
        • childrenlista de um de vários formatos
          1. Opção 1

            • typetexto
              Valores permitidostext
            • texttexto
            • markslista de qualquer valor
          2. Opção 2

            • typetexto
              Valores permitidoslink
            • hreftexto (uri)
            • childrenlista de qualquer valor
          3. Opção 3

            • typetexto
              Valores permitidosmention
            • usernametexto
          4. Opção 4

            • typetexto
              Valores permitidosspoiler
            • spoilerIdtexto
            • childrenlista de qualquer valorpode ser null
          5. Opção 5

            • typetexto
              Valores permitidosbreak
      3. Opção 3

        • typetexto
          Valores permitidosquote
        • childrenlista de RichTextBlock
      4. Opção 4

        • typetexto
          Valores permitidoslist
        • isOrderedtrue ou false
        • itemslista de lista de RichTextBlock
      5. Opção 5

        • typetexto
          Valores permitidoscode
        • texttexto
  • isDeletedtrue ou false

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros