Popüler gönderileri listele

GET/v1/posts

Bir dilin tüm topluluklarından gönderileri gündemdeki, yeni, en iyi ya da yükselen sırasıyla döndürür.

İstek

Shell

curl "https://api.nogitsu.com/v1/posts?language=en"

Parametreler

sort
sorguisteğe bağlı
Sonuçların sırası.
metin
İzin verilen değerlerhotnewtoprising
Varsayılan: hot
period
sorguisteğe bağlı
En iyi sıralaması için zaman penceresi.
metin
İzin verilen değerlerdayweekmonthyearall
Varsayılan: week
cursor
sorguisteğe bağlı
Önceki sayfadaki nextCursor değeri. İlk sayfa için verme.
metin
limit
sorguisteğe bağlı
Bir sayfada kaç öğe döneceği.
tam sayı
1 ile 25 arasıVarsayılan: 25
language
sorguzorunlu
Okunacak toplulukların dili; her dilin kendi toplulukları vardır.
metin
İzin verilen değerlerentrdefresptitruidjakozh

Yanıt

Başarılı istek bu JSON ile 200 döndürür:

itemsnesne listesi
- idmetin (uuid)
- slugmetin
- communitynesne
  idmetin (uuid)
  slugmetin
  languagemetin
  kindmetin
  İzin verilen değerlerworkboarduser
  namemetin
  iconUrlmetin (uri)null olabilir
  thememetin
  İzin verilen değerlervioletblueskycyanemeraldgreenyellowamberrosepink
  isSampletrue ya da false
- authornesnenull olabilir
  usernamemetin
  displayNamemetin
  avatarUrlmetin (uri)null olabilir
- authorFlairmetinnull olabilir
- kindmetin
  İzin verilen değerlertextlinkimagepoll
- titlemetinnull olabilir
- excerptmetinnull olabilir
- flairnesnenull olabilir
  idmetin (uuid)
  labelmetin
  tonemetin
  İzin verilen değerlerneutralaccentsuccesswarningdangervioletblueskycyanemeraldgreenyellowamberrosepink
- spoilernesnenull olabilir
  workTitlemetinnull olabilir
  unitNumbersayınull olabilir
  En az 0
- worknesnenull olabilir
  idmetin (uuid)
  titlemetin
  mediummetin
  İzin verilen değerleranimedonghuaanimationmangamanhwamanhuawebtoon
  slugmetin
  unitNumbersayınull olabilir
  En az 0
- isAdulttrue ya da false
- isPinnedtrue ya da false
- isLockedtrue ya da false
- scoretam sayınull olabilir
  -9007199254740991 ile 9007199254740991 arası
- commentCounttam sayı
  0 ile 9007199254740991 arası
- reactionsnesne listesi
  kindmetin
  İzin verilen değerlerlovelaughwowsadclapfirethinkangrypartycry
  counttam sayı
  0 ile 9007199254740991 arası
- linknesnenull olabilir
  urlmetin (uri)
  hostmetin
  titlemetinnull olabilir
  descriptionmetinnull olabilir
  imagenesnenull olabilir
  urlmetin (uri)
  widthtam sayı
  0 ile 9007199254740991 arası
  heighttam sayı
  0 ile 9007199254740991 arası
  altmetinnull olabilir
  variantWidthstam sayı listesi
  0 ile 9007199254740991 arası
  isPendingtrue ya da false
- imagesnesne listesi
  urlmetin (uri)
  widthtam sayı
  0 ile 9007199254740991 arası
  heighttam sayı
  0 ile 9007199254740991 arası
  altmetinnull olabilir
  variantWidthstam sayı listesi
  0 ile 9007199254740991 arası
- pollnesnenull olabilir
  optionsnesne listesi
  idmetin (uuid)
  labelmetin
  voteCounttam sayınull olabilir
  0 ile 9007199254740991 arası
  totalVotestam sayı
  0 ile 9007199254740991 arası
  closesAtmetin (date-time)
  isClosedtrue ya da false
  allowsMultipletrue ya da false
- createdAtmetin (date-time)
- editedAtmetin (date-time)null olabilir
nextCursormetinnull olabilir

Hatalar

Her işlem gibi bu işlem de geçersiz parametrede 400, bir şey bulunamadığında 404 ve çok fazla istek gönderdiğinde 429 döndürebilir. Tüm hatalar aynı biçimi paylaşır.

Hatalar hakkında oku