Aller au contenu

Obtenir une publication

GET/v1/posts/{id}

Renvoie une publication avec son texte, son sondage, ses images et sa communauté.

Requête

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

Paramètres

  • id

    cheminobligatoire

    Identifiant de l’élément, un UUID.

    texte

  • reveal

    requêtefacultatif

    Définissez-le sur 1 pour inclure le texte d’une publication marquée comme spoiler.

    texte

    Valeurs autorisées1

Réponse

Une requête réussie répond 200 avec ce JSON :

  • idtexte (uuid)
  • slugtexte
  • communityobjet
    • idtexte (uuid)
    • slugtexte
    • languagetexte
    • kindtexte
      Valeurs autoriséesworkboarduser
    • nametexte
    • iconUrltexte (uri)peut être null
    • themetexte
      Valeurs autoriséesvioletblueskycyanemeraldgreenyellowamberrosepink
    • isSampletrue ou false
  • authorobjetpeut être null
    • usernametexte
    • displayNametexte
    • avatarUrltexte (uri)peut être null
  • authorFlairtextepeut être null
  • kindtexte
    Valeurs autoriséestextlinkimagepoll
  • titletextepeut être null
  • excerpttextepeut être null
  • flairobjetpeut être null
    • idtexte (uuid)
    • labeltexte
    • tonetexte
      Valeurs autoriséesneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
  • spoilerobjetpeut être null
    • workTitletextepeut être null
    • unitNumbernombrepeut être null

      Au moins 0

  • workobjetpeut être null
    • idtexte (uuid)
    • titletexte
    • mediumtexte
      Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
    • slugtexte
    • unitNumbernombrepeut être null

      Au moins 0

  • isAdulttrue ou false
  • isPinnedtrue ou false
  • isLockedtrue ou false
  • scorenombre entierpeut être null

    De -9007199254740991 à 9007199254740991

  • commentCountnombre entier

    De 0 à 9007199254740991

  • reactionsliste de objet
    • kindtexte
      Valeurs autoriséeslovelaughwowsadclapfirethinkangrypartycry
    • countnombre entier

      De 0 à 9007199254740991

  • linkobjetpeut être null
    • urltexte (uri)
    • hosttexte
    • titletextepeut être null
    • descriptiontextepeut être null
    • imageobjetpeut être null
      • urltexte (uri)
      • widthnombre entier

        De 0 à 9007199254740991

      • heightnombre entier

        De 0 à 9007199254740991

      • alttextepeut être null
      • variantWidthsliste de nombre entier

        De 0 à 9007199254740991

    • isPendingtrue ou false
  • imagesliste de objet
    • urltexte (uri)
    • widthnombre entier

      De 0 à 9007199254740991

    • heightnombre entier

      De 0 à 9007199254740991

    • alttextepeut être null
    • variantWidthsliste de nombre entier

      De 0 à 9007199254740991

  • pollobjetpeut être null
    • optionsliste de objet
      • idtexte (uuid)
      • labeltexte
      • voteCountnombre entierpeut être null

        De 0 à 9007199254740991

    • totalVotesnombre entier

      De 0 à 9007199254740991

    • closesAttexte (date-time)
    • isClosedtrue ou false
    • allowsMultipletrue ou false
  • createdAttexte (date-time)
  • editedAttexte (date-time)peut être null
  • bodyobjetpeut être null
    • blocksliste de l’une de plusieurs formes
      1. Option 1

        • typetexte
          Valeurs autoriséesparagraph
        • childrenliste de l’une de plusieurs formes
          1. Option 1

            • typetexte
              Valeurs autoriséestext
            • texttexte
            • marksliste de n’importe quelle valeur
          2. Option 2

            • typetexte
              Valeurs autoriséeslink
            • hreftexte (uri)
            • childrenliste de n’importe quelle valeur
          3. Option 3

            • typetexte
              Valeurs autoriséesmention
            • usernametexte
          4. Option 4

            • typetexte
              Valeurs autoriséesspoiler
            • spoilerIdtexte
            • childrenliste de n’importe quelle valeurpeut être null
          5. Option 5

            • typetexte
              Valeurs autoriséesbreak
      2. Option 2

        • typetexte
          Valeurs autoriséesheading
        • childrenliste de l’une de plusieurs formes
          1. Option 1

            • typetexte
              Valeurs autoriséestext
            • texttexte
            • marksliste de n’importe quelle valeur
          2. Option 2

            • typetexte
              Valeurs autoriséeslink
            • hreftexte (uri)
            • childrenliste de n’importe quelle valeur
          3. Option 3

            • typetexte
              Valeurs autoriséesmention
            • usernametexte
          4. Option 4

            • typetexte
              Valeurs autoriséesspoiler
            • spoilerIdtexte
            • childrenliste de n’importe quelle valeurpeut être null
          5. Option 5

            • typetexte
              Valeurs autoriséesbreak
      3. Option 3

        • typetexte
          Valeurs autoriséesquote
        • childrenliste de RichTextBlock
      4. Option 4

        • typetexte
          Valeurs autoriséeslist
        • isOrderedtrue ou false
        • itemsliste de liste de RichTextBlock
      5. Option 5

        • typetexte
          Valeurs autoriséescode
        • texttexte
  • isDeletedtrue ou false

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs