Wysyłaj swoje dowcipy do GiggleTime

Jak to działa

1. Załóż darmowe konto GiggleTime albo się zaloguj.
2. W Moich zgłoszeniach napisz, co chcesz wysyłać i mniej więcej ile dowcipów.
3. Czytamy każdą prośbę i odpowiadamy e-mailem, zwykle w ciągu jednego lub dwóch dni.
4. Po zatwierdzeniu utwórz klucz na tej samej stronie. Jest pokazywany tylko raz, więc przechowuj go w bezpiecznym miejscu.
5. Wysyłaj dowcipy prostym zapytaniem HTTPS. Każdy czeka na sprawdzenie, a jego status możesz sprawdzić w dowolnej chwili.

Jak sprawdzamy dowcipy

Każdy dowcip, czy z API, czy z formularza na naszej stronie, czyta człowiek przed publikacją. Większość sprawdzamy w ciągu doby.

Sprawdzamy, czy brzmi jak dowcip, czy jest w wybranym języku i pasuje do kategorii, oraz czy nie ma go już na GiggleTime w żadnym języku. Możemy poprawić literówkę albo przenieść dowcip do lepszej kategorii.

Jeśli nie możemy użyć dowcipu, zawsze mówimy dlaczego: powód widać w Moich zgłoszeniach i w API. Zatwierdzone dowcipy publikujemy na GiggleTime i można je czytać we wszystkich naszych językach.

Co przyjmujemy

• Dowcipy, które napisałeś sam, albo takie, które można swobodnie udostępniać, jak dowcipy ludowe i folklor.
• Krótkie dowcipy, dowcipy z pytaniem i puentą, krótkie historyjki i dowcipy „puk, puk” w każdym z naszych 26 języków.
• Dowcipy napisane z niewielką pomocą AI są w porządku, jeśli je sprawdziłeś i są dobre. Nie przyjmujemy dowcipów masowo generowanych przez AI.
• Bez materiałów skopiowanych od innych komików, z książek czy stron, bez nienawiści i nękania, i bez linków czy reklam.
• Oznaczaj humor dla dorosłych flagą NSFW. Jest ukryty przed odwiedzającymi, którzy go nie włączyli.

Limity

• Na początek do 20 dowcipów na 24 godziny na klucz. Podnosimy limit osobom, których dowcipy regularnie zatwierdzamy.
• Najwyżej 10 dowcipów na minutę.
• Gdy nasza kolejka do sprawdzenia jest pełna, nowe dowcipy są przez jakiś czas odrzucane. Spróbuj ponownie następnego dnia.

Dokumentacja API

Wszystkie zapytania trafiają na https://www.giggletime.app/api/v1/ i wymagają twojego klucza w nagłówku Authorization:

Authorization: Bearer gtj_your_key

Wywołania

Pola przy wysyłaniu dowcipu

Przykłady

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

Odpowiedzi

Odebrany dowcip odpowiada kodem 201 i swoim id. Czeka, dopóki go nie sprawdzimy:

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

Błędy odpowiadają kodem, na który możesz zareagować:

Statusy i powody

W GET /api/v1/jokes każdy dowcip ma status pending (czeka), approved (zatwierdzony, z adresem url) albo rejected (odrzucony, z kodem i powodem w języku dowcipu):

Kategorie

• 8 Animals
• 6 Christmas
• 3 Dark
• 17 Everyday Life
• 9 Family
• 12 Food & Drink
• 15 Health & Aging
• 7 Misc
• 16 Money
• 2 Programming
• 4 Pun
• 13 Relationships
• 11 School
• 5 Spooky
• 14 Technology
• 10 Work

Języki

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

Pytania

Czy to coś kosztuje?

Nie. API jest darmowe.

Do kogo należą dowcipy, które wysyłam?

Zachowujesz wszystkie swoje prawa. Wysyłając dowcip, pozwalasz GiggleTime go publikować, tłumaczyć i pokazywać w naszych aplikacjach, jak opisuje to nasz regulamin. Regulamin

Czy mogę później usunąć dowcip?

Tak. Napisz do nas, a go usuniemy. Kontakt

Co, jeśli mój klucz wycieknie?

Utwórz nowy klucz w Moich zgłoszeniach. Stary od razu przestaje działać.

Wolę pokazywać dowcipy na własnej stronie.

Wypróbuj więc nasz darmowy widżet z dowcipem dnia. Widżet z dowcipami na Twoją stronę