Saada oma naljad GiggleTime'ile

Kuidas see töötab

1. Loo tasuta GiggleTime'i konto või logi sisse.
2. Kirjuta jaotises Minu esitatud naljad, mida tahaksid saata ja umbes kui palju nalju.
3. Loeme iga taotlust ja vastame e-kirjaga, tavaliselt päeva-paari jooksul.
4. Kui oled kinnitatud, loo samal lehel oma võti. Seda näidatakse ainult üks kord, nii et hoia seda kindlas kohas.
5. Saada nalju lihtsa HTTPS-päringuga. Iga nali ootab ülevaatust ja selle olekut saad igal ajal vaadata.

Kuidas me nalju üle vaatame

Iga nalja, olgu see API kaudu või meie veebilehe vormiga saadetud, loeb enne avaldamist inimene. Enamik vaadatakse üle ühe päeva jooksul.

Kontrollime, et see loeks naljana, et see on valitud keeles ja sobib oma kategooriasse ning et seda pole juba GiggleTime'is üheski keeles. Võime parandada trükivea või tõsta nalja sobivamasse kategooriasse.

Kui me nalja kasutada ei saa, ütleme alati, miks: põhjus on näha jaotises Minu esitatud naljad ja API-s. Kinnitatud naljad avaldatakse GiggleTime'is ja neid saab lugeda kõigis meie keeltes.

Mida me vastu võtame

• Naljad, mille oled ise kirjutanud, või vabalt jagatavad naljad, näiteks rahvanaljad ja folkloor.
• Ühelausenaljad, küsimuse ja vastusega naljad, lühikesed lood ja koputusnaljad mis tahes meie 26 keelest.
• Naljad, mille kirjutasid tehisaru veidi abiga, sobivad, kui oled need üle vaadanud ja need on head. Tehisaruga hulgi loodud nalju me vastu ei võta.
• Ei mingit teistelt koomikutelt, raamatutest või veebilehtedelt kopeeritud materjali, vihkamist ega ahistamist, ega linke või reklaami.
• Märgi täiskasvanute huumor NSFW-lipuga. See on peidetud külastajate eest, kes pole seda sisse lülitanud.

Piirangud

• Alguses kuni 20 nalja 24 tunni jooksul ühe võtme kohta. Neile, kelle nalju me korduvalt kinnitame, tõstame piirangut.
• Kõige rohkem 10 nalja minutis.
• Kui meie ülevaatuse järjekord on täis, lükatakse uued naljad mõneks ajaks tagasi. Proovi järgmisel päeval uuesti.

API viide

Kõik päringud lähevad aadressile https://www.giggletime.app/api/v1/ ja vajavad sinu võtit Authorization-päises:

Authorization: Bearer gtj_your_key

Päringud

Nalja saatmise väljad

Näited

curl

curl -X POST https://www.giggletime.app/api/v1/jokes \
  -H "Authorization: Bearer gtj_your_key" \
  -H "Content-Type: application/json" \
  -d '{"language": "en", "category_id": 17, "type": "setup-punchline",
       "setup": "Why did the scarecrow win an award?",
       "punchline": "He was outstanding in his field."}'

Python

import requests

r = requests.post("https://www.giggletime.app/api/v1/jokes",
    headers={"Authorization": "Bearer gtj_your_key"},
    json={"language": "en", "category_id": 17, "type": "one-liner",
          "text": "I told my wife she draws her eyebrows too high. She looked surprised."})
print(r.status_code, r.json())

JavaScript

const r = await fetch("https://www.giggletime.app/api/v1/jokes", {
  method: "POST",
  headers: { "Authorization": "Bearer gtj_your_key", "Content-Type": "application/json" },
  body: JSON.stringify({ language: "en", category_id: 17, type: "one-liner",
    text: "I'm reading a book about anti-gravity. It's impossible to put down." })
});
console.log(r.status, await r.json());

Vastused

Kättesaadud nali vastab koodiga 201 ja oma ID-ga. See ootab, kuni oleme selle üle vaadanud:

{"id": 1830, "status": "pending", "remaining_today": 19}

Vead vastavad koodiga, mille järgi saad tegutseda:

Olekud ja põhjused

GET /api/v1/jokes näitab iga nalja olekut: pending (ootel), approved (kinnitatud, koos aadressiga) või rejected (tagasi lükatud, koos koodi ja põhjusega nalja keeles):

Kategooriad

• 17 Igapäevaelu
• 6 Jõulud
• 11 Kool
• 8 Loomad
• 3 Must Huumor
• 7 Muu
• 9 Perekond
• 2 Programmeerimine
• 16 Raha
• 13 Suhted
• 4 Sõnamäng
• 14 Tehnoloogia
• 15 Tervis ja Vananemine
• 12 Toit ja Jook
• 10 Töö
• 5 Õudne

Keeled

ar العربية bg Български ca Català cs česky cy Cymraeg da dansk de Deutsch el Ελληνικά en English es español et eesti, eesti keel fr français hi हिन्दी, हिंदी id Bahasa Indonesia it Italiano ja 日本語 ka ქართული nl Nederlands, Vlaams pl polski pt Português ru Русский sv svenska tr Türkçe uk Українська vi Tiếng Việt zh 中文

Küsimused

Kas see maksab midagi?

Ei. API on tasuta.

Kellele kuuluvad naljad, mida saadan?

Sinu õigused jäävad sulle. Nalja saates lubad GiggleTime'il seda avaldada, tõlkida ja meie rakendustes näidata, nagu meie tingimused kirjeldavad. Kasutustingimused

Kas saan nalja hiljem eemaldada?

Jah. Kirjuta meile ja me eemaldame selle. Kontakt

Mis siis, kui mu võti lekib?

Loo jaotises Minu esitatud naljad uus võti. Vana lakkab kohe töötamast.

Näitaksin pigem nalju oma saidil.

Siis proovi meie tasuta päeva nalja vidinat. Naljavidin sinu veebilehele