Saltar al contenido

Obtener una publicación

GET/v1/posts/{id}

Devuelve una publicación con su texto, encuesta, imágenes y comunidad.

Solicitud

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

Parámetros

  • id

    rutaobligatorio

    Identificador del elemento, un UUID.

    texto

  • reveal

    consultaopcional

    Ponlo a 1 para incluir el texto de una publicación marcada como spoiler.

    texto

    Valores permitidos1

Respuesta

Una solicitud correcta responde 200 con este JSON:

  • idtexto (uuid)
  • slugtexto
  • communityobjeto
    • idtexto (uuid)
    • slugtexto
    • languagetexto
    • kindtexto
      Valores permitidosworkboarduser
    • nametexto
    • iconUrltexto (uri)puede ser null
    • themetexto
      Valores permitidosvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue o false
  • authorobjetopuede ser null
    • usernametexto
    • displayNametexto
    • avatarUrltexto (uri)puede ser null
  • authorFlairtextopuede ser null
  • kindtexto
    Valores permitidostextlinkimagepoll
  • titletextopuede ser null
  • excerpttextopuede ser null
  • flairobjetopuede ser null
    • idtexto (uuid)
    • labeltexto
    • tonetexto
      Valores permitidosneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
  • spoilerobjetopuede ser null
    • workTitletextopuede ser null
    • unitNumbernúmeropuede ser null

      Al menos 0

  • workobjetopuede ser null
    • idtexto (uuid)
    • titletexto
    • mediumtexto
      Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
    • slugtexto
    • unitNumbernúmeropuede ser null

      Al menos 0

  • isAdulttrue o false
  • isPinnedtrue o false
  • isLockedtrue o false
  • scorenúmero enteropuede ser null

    De -9007199254740991 a 9007199254740991

  • commentCountnúmero entero

    De 0 a 9007199254740991

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

      De 0 a 9007199254740991

  • linkobjetopuede ser null
    • urltexto (uri)
    • hosttexto
    • titletextopuede ser null
    • descriptiontextopuede ser null
    • imageobjetopuede ser null
      • urltexto (uri)
      • widthnúmero entero

        De 0 a 9007199254740991

      • heightnúmero entero

        De 0 a 9007199254740991

      • alttextopuede ser null
      • variantWidthslista de número entero

        De 0 a 9007199254740991

    • isPendingtrue o false
  • imageslista de objeto
    • urltexto (uri)
    • widthnúmero entero

      De 0 a 9007199254740991

    • heightnúmero entero

      De 0 a 9007199254740991

    • alttextopuede ser null
    • variantWidthslista de número entero

      De 0 a 9007199254740991

  • pollobjetopuede ser null
    • optionslista de objeto
      • idtexto (uuid)
      • labeltexto
      • voteCountnúmero enteropuede ser null

        De 0 a 9007199254740991

    • totalVotesnúmero entero

      De 0 a 9007199254740991

    • closesAttexto (date-time)
    • isClosedtrue o false
    • allowsMultipletrue o false
  • createdAttexto (date-time)
  • editedAttexto (date-time)puede ser null
  • bodyobjetopuede ser null
    • blockslista de una de varias formas
      1. Opción 1

        • typetexto
          Valores permitidosparagraph
        • childrenlista de una de varias formas
          1. Opción 1

            • typetexto
              Valores permitidostext
            • texttexto
            • markslista de cualquier valor
          2. Opción 2

            • typetexto
              Valores permitidoslink
            • hreftexto (uri)
            • childrenlista de cualquier valor
          3. Opción 3

            • typetexto
              Valores permitidosmention
            • usernametexto
          4. Opción 4

            • typetexto
              Valores permitidosspoiler
            • spoilerIdtexto
            • childrenlista de cualquier valorpuede ser null
          5. Opción 5

            • typetexto
              Valores permitidosbreak
      2. Opción 2

        • typetexto
          Valores permitidosheading
        • childrenlista de una de varias formas
          1. Opción 1

            • typetexto
              Valores permitidostext
            • texttexto
            • markslista de cualquier valor
          2. Opción 2

            • typetexto
              Valores permitidoslink
            • hreftexto (uri)
            • childrenlista de cualquier valor
          3. Opción 3

            • typetexto
              Valores permitidosmention
            • usernametexto
          4. Opción 4

            • typetexto
              Valores permitidosspoiler
            • spoilerIdtexto
            • childrenlista de cualquier valorpuede ser null
          5. Opción 5

            • typetexto
              Valores permitidosbreak
      3. Opción 3

        • typetexto
          Valores permitidosquote
        • childrenlista de RichTextBlock
      4. Opción 4

        • typetexto
          Valores permitidoslist
        • isOrderedtrue o false
        • itemslista de lista de RichTextBlock
      5. Opción 5

        • typetexto
          Valores permitidoscode
        • texttexto
  • isDeletedtrue o false

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores