გამოუგზავნეთ თქვენი ხუმრობები GiggleTime-ს

როგორ მუშაობს

1. შექმენით უფასო GiggleTime ანგარიში ან შედით.
2. გვერდზე „ჩემი გამოგზავნილები“ გვითხარით, რისი გაგზავნა გსურთ და დაახლოებით რამდენი ხუმრობის.
3. ვკითხულობთ ყველა მოთხოვნას და ვპასუხობთ ელფოსტით, ჩვეულებრივ ერთ-ორ დღეში.
4. დამტკიცების შემდეგ შექმენით გასაღები იმავე გვერდზე. ის მხოლოდ ერთხელ ჩანს, ამიტომ შეინახეთ უსაფრთხო ადგილას.
5. გაგზავნეთ ხუმრობები მარტივი HTTPS მოთხოვნით. თითოეული ელოდება განხილვას და მის სტატუსს ნებისმიერ დროს ნახავთ.

როგორ განვიხილავთ ხუმრობებს

ყოველ ხუმრობას, API-დან იქნება თუ ჩვენი საიტის ფორმიდან, გამოქვეყნებამდე ადამიანი კითხულობს. უმეტესობა ერთ დღეში განიხილება.

ვამოწმებთ, იკითხება თუ არა ის ხუმრობად, არის თუ არა არჩეულ ენაზე და შეესაბამება თუ არა კატეგორიას, და ხომ არ არის უკვე GiggleTime-ზე რომელიმე ენაზე. შეიძლება შევასწოროთ შეცდომა ან ხუმრობა უკეთეს კატეგორიაში გადავიტანოთ.

თუ ხუმრობას ვერ გამოვიყენებთ, ყოველთვის გეტყვით მიზეზს: ის ჩანს გვერდზე „ჩემი გამოგზავნილები“ და API-ში. დამტკიცებული ხუმრობები ქვეყნდება GiggleTime-ზე და იკითხება ჩვენს ყველა ენაზე.

რას ვიღებთ

• თქვენ მიერ დაწერილი ხუმრობები ან თავისუფლად გასაზიარებელი ხუმრობები, მაგალითად ხალხური ხუმრობები და ფოლკლორი.
• ერთწინადადებიანი ხუმრობები, კითხვა-პასუხის ხუმრობები, მოკლე ისტორიები და „კაკ-კაკ“ ხუმრობები ჩვენს 26 ენაზე.
• ხელოვნური ინტელექტის მცირე დახმარებით დაწერილი ხუმრობები მისაღებია, თუ შეამოწმეთ და კარგია. ხელოვნური ინტელექტით მასობრივად შექმნილ ხუმრობებს არ ვიღებთ.
• არანაირი მასალა, გადმოწერილი სხვა კომიკოსებისგან, წიგნებიდან ან საიტებიდან, არანაირი სიძულვილი ან შევიწროება, და არანაირი ბმული ან რეკლამა.
• მოზრდილთა იუმორი მონიშნეთ NSFW ნიშნით. ის დამალულია სტუმრებისთვის, რომლებსაც არ ჩაურთავთ.

შეზღუდვები

• თავიდან თითო გასაღებზე 24 საათში მაქსიმუმ 20 ხუმრობა. ლიმიტს ვზრდით მათთვის, ვისი ხუმრობებიც რეგულარულად მტკიცდება.
• წუთში მაქსიმუმ 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": 9, "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": 9, "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: 9, 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 (დამტკიცებული, თავისი ბმულით) ან rejected (უარყოფილი, მიზეზის კოდით და მიზეზით ხუმრობის ენაზე):

კატეგორიები

• 9 ოჯახი
• 2 პროგრამირება
• 12 საკვები და სასმელი
• 10 სამუშაო
• 5 საშიში
• 4 სიტყვათა თამაში
• 11 სკოლა
• 7 სხვადასხვა
• 14 ტექნოლოგია
• 13 ურთიერთობები
• 16 ფული
• 17 ყოველდღიური ცხოვრება
• 3 შავი იუმორი
• 6 შობა
• 8 ცხოველები
• 15 ჯანმრთელობა და დაბერება

ენები

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-ს აძლევთ უფლებას, გამოაქვეყნოს, თარგმნოს და აჩვენოს ის ჩვენს აპებში, როგორც ეს ჩვენს პირობებშია აღწერილი. მომსახურების პირობები

შემიძლია ხუმრობის მოგვიანებით წაშლა?

დიახ. მოგვწერეთ და წავშლით. კონტაქტი

რა მოხდება, თუ ჩემი გასაღები გაჟონავს?

შექმენით ახალი გასაღები გვერდზე „ჩემი გამოგზავნილები“. ძველი მაშინვე წყვეტს მუშაობას.

მირჩევნია ხუმრობები ჩემს საიტზე ვაჩვენო.

მაშინ სცადეთ ჩვენი უფასო „დღის ხუმრობის“ ვიჯეტი. ხუმრობების ვიჯეტი თქვენი საიტისთვის