Posílejte své vtipy na GiggleTime

Jak to funguje

1. Vytvořte si bezplatný účet GiggleTime, nebo se přihlaste.
2. V Mých příspěvcích nám napište, co chcete posílat a zhruba kolik vtipů.
3. Každou žádost si přečteme a odpovíme e-mailem, obvykle do jednoho až dvou dnů.
4. Po schválení si na stejné stránce vytvořte klíč. Zobrazí se jen jednou, proto ho uložte na bezpečné místo.
5. Posílejte vtipy jednoduchým požadavkem HTTPS. Každý čeká na kontrolu a jeho stav můžete kdykoli zjistit.

Jak vtipy kontrolujeme

Každý vtip, ať přijde přes API, nebo formulářem na našem webu, si před zveřejněním přečte člověk. Většinu zkontrolujeme do jednoho dne.

Kontrolujeme, že působí jako vtip, že je ve zvoleném jazyce a hodí se do své kategorie a že už na GiggleTime není v žádném jazyce. Můžeme opravit překlep nebo přesunout vtip do vhodnější kategorie.

Když vtip použít nemůžeme, vždy vám řekneme proč: důvod najdete v Mých příspěvcích a v API. Schválené vtipy zveřejníme na GiggleTime a dají se číst ve všech našich jazycích.

Co přijímáme

• Vtipy, které jste napsali sami, nebo vtipy, které lze volně sdílet, třeba lidové vtipy a folklor.
• Krátké vtipy, vtipy s otázkou a pointou, krátké příběhy a vtipy typu ťuk ťuk v kterémkoli z našich 26 jazyků.
• Vtipy, které jste napsali s trochou pomoci AI, jsou v pořádku, pokud jste je zkontrolovali a jsou dobré. Hromadně generované vtipy z AI nepřijímáme.
• Žádný materiál zkopírovaný od jiných komiků, z knih nebo webů, žádná nenávist ani obtěžování a žádné odkazy či reklama.
• Humor pro dospělé označte příznakem NSFW. Je skrytý návštěvníkům, kteří si ho nezapnuli.

Limity

• Zpočátku až 20 vtipů za 24 hodin na klíč. Těm, jejichž vtipy pravidelně schvalujeme, limit zvýšíme.
• Nejvýš 10 vtipů za minutu.
• Když je naše fronta ke kontrole plná, nové vtipy se na chvíli odmítají. Zkuste to prosím další den.

Dokumentace API

Všechny požadavky jdou na https://www.giggletime.app/api/v1/ a potřebují váš klíč v hlavičce Authorization:

Authorization: Bearer gtj_your_key

Volání

Pole pro odeslání vtipu

Příklady

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": 12, "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": 12, "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: 12, 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());

Odpovědi

Přijatý vtip odpoví kódem 201 a svým ID. Čeká, dokud ho nezkontrolujeme:

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

Chyby odpovídají kódem, podle kterého můžete jednat:

Stavy a důvody

V GET /api/v1/jokes je každý vtip pending (čeká), approved (schválený, s adresou url) nebo rejected (zamítnutý, s kódem a důvodem v jazyce vtipu):

Kategorie

• 12 Jídlo a pití
• 17 Každodenní život
• 16 Peníze
• 2 Programování
• 10 Práce
• 9 Rodina
• 7 Různé
• 4 Slovní hříčka
• 5 Strašidelný
• 14 Technologie
• 13 Vztahy
• 6 Vánoce
• 15 Zdraví a stárnutí
• 8 Zvířata
• 3 Černý
• 11 Škola

Jazyky

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 中文

Otázky

Stojí to něco?

Ne. API je zdarma.

Komu patří vtipy, které posílám?

Ponecháváte si všechna práva, která máte. Odesláním vtipu dovolujete GiggleTime ho zveřejnit, přeložit a ukazovat v našich aplikacích, jak popisují naše podmínky. Podmínky použití

Můžu vtip později odstranit?

Ano. Napište nám a odstraníme ho. Kontakt

Co když můj klíč unikne?

Vytvořte nový klíč v Mých příspěvcích. Starý okamžitě přestane fungovat.

Raději bych vtipy ukazoval na vlastním webu.

Pak vyzkoušejte náš bezplatný widget s vtipem dne. Widget s vtipy pro váš web