Надсилайте свої жарти в GiggleTime

Як це працює

1. Створіть безкоштовний обліковий запис GiggleTime або увійдіть.
2. У розділі «Мої матеріали» розкажіть, що ви хочете надсилати й приблизно скільки жартів.
3. Ми читаємо кожен запит і відповідаємо електронною поштою, зазвичай протягом одного-двох днів.
4. Після схвалення створіть ключ на тій самій сторінці. Його показують лише один раз, тож зберігайте його в надійному місці.
5. Надсилайте жарти простим HTTPS-запитом. Кожен чекає на перевірку, а його статус можна дізнатися будь-коли.

Як ми перевіряємо жарти

Кожен жарт, чи надійшов він через API, чи через форму на сайті, перед публікацією читає людина. Більшість перевіряємо протягом дня.

Ми перевіряємо, що це справді жарт, що він обраною вами мовою і пасує до категорії, і що його ще немає на GiggleTime жодною мовою. Можемо виправити друкарську помилку або перенести жарт у кращу категорію.

Якщо ми не можемо використати жарт, ми завжди пояснюємо чому: причину видно в розділі «Мої матеріали» та в API. Схвалені жарти публікуються на GiggleTime, і їх можна читати всіма нашими мовами.

Що ми приймаємо

• Жарти, які ви написали самі, або жарти, якими можна вільно ділитися, як-от народні жарти й фольклор.
• Короткі жарти, жарти із запитанням і відповіддю, короткі історії та жарти «тук-тук» будь-якою з наших 26 мов.
• Жарти, написані з невеликою допомогою ШІ, підходять, якщо ви їх перевірили і вони добрі. Масово згенеровані ШІ жарти ми не приймаємо.
• Жодних матеріалів, скопійованих в інших коміків, із книжок чи сайтів, жодної ненависті й цькування, жодних посилань і реклами.
• Позначайте гумор для дорослих прапорцем NSFW. Він прихований від відвідувачів, які його не ввімкнули.

Обмеження

• Спочатку до 20 жартів за 24 години на один ключ. Тим, чиї жарти ми регулярно схвалюємо, підвищуємо ліміт.
• Не більше 10 жартів на хвилину.
• Коли наша черга на перевірку заповнена, нові жарти якийсь час не приймаються. Спробуйте знову наступного дня.

Довідник API

Усі запити надсилаються на https://www.giggletime.app/api/v1/ і потребують вашого ключа в заголовку Authorization:

Authorization: Bearer gtj_your_key

Запити

Поля для надсилання жарту

Приклади

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());

Відповіді

Отриманий жарт відповідає кодом 201 і своїм id. Він чекає, доки ми його не перевіримо:

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

Помилки повертають код, з якого зрозуміло, що робити:

Статуси й причини

У GET /api/v1/jokes кожен жарт має статус pending (чекає), approved (схвалено, з адресою url) або rejected (відхилено, з кодом і причиною мовою жарту):

Категорії

• 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

Мови

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

Запитання

Це платно?

Ні. API безкоштовний.

Кому належать жарти, які я надсилаю?

Усі ваші права залишаються за вами. Надсилаючи жарт, ви дозволяєте GiggleTime публікувати, перекладати й показувати його в наших застосунках, як описано в наших умовах. Умови служби

Чи можна згодом прибрати жарт?

Так. Напишіть нам, і ми його приберемо. Контакт

Що, як мій ключ потрапить у чужі руки?

Створіть новий ключ у розділі «Мої матеріали». Старий одразу перестане працювати.

Я краще показуватиму жарти на своєму сайті.

Тоді спробуйте наш безкоштовний віджет «Жарт дня». Віджет із жартами для вашого сайту