Изпращайте шегите си към 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": 13, "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": 13, "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: 13, 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": 1830, "status": "pending", "remaining_today": 19}

Грешките отговарят с код, по който можете да действате:

Състояния и причини

В GET /api/v1/jokes всяка шега е pending (чака), approved (одобрена, с адреса си) или rejected (отхвърлена, с код и причина на езика на шегата):

Категории

• 13 Взаимоотношения
• 17 Ежедневието
• 8 Животни
• 15 Здраве и стареене
• 4 Игра на думи
• 6 Коледа
• 16 Пари
• 2 Програмиране
• 10 Работа
• 7 Разни
• 9 Семейство
• 5 Страшен
• 14 Технологии
• 3 Тъмен
• 11 Училище
• 12 Храна и напитки

Езици

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 да я публикува, превежда и показва в нашите приложения, както описват нашите условия. Условия за ползване

Мога ли да махна шега по-късно?

Да. Пишете ни и ще я премахнем. Контакти

Ами ако ключът ми изтече?

Създайте нов ключ в „Моите добавени“. Старият спира да работи веднага.

Предпочитам да показвам шеги на собствения си сайт.

Тогава опитайте безплатната ни джаджа „Шега на деня“. Джаджа с вицове за вашия сайт