Şakalarınızı GiggleTime'a gönderin
GiggleTime, 26 dilde bir şaka sitesidir. Şaka yazıyorsanız, bir mizah hesabı yönetiyorsanız ya da bir koleksiyonunuz varsa, bunları kendi uygulamanızdan veya betiğinizden bize gönderebilirsiniz. Her şaka yayına girmeden önce bir insan tarafından okunur.
Nasıl çalışır
- Ücretsiz bir GiggleTime hesabı oluşturun ya da giriş yapın.
- Gönderdiklerim sayfasında ne göndermek istediğinizi ve yaklaşık kaç şaka olduğunu yazın.
- Her isteği okuyup e-postayla yanıtlarız, genellikle bir iki gün içinde.
- Onaylandıktan sonra anahtarınızı aynı sayfada oluşturun. Yalnızca bir kez gösterilir, bu yüzden güvenli bir yerde saklayın.
- Şakaları basit bir HTTPS isteğiyle gönderin. Her biri incelemeyi bekler ve durumunu istediğiniz zaman görebilirsiniz.
Şakaları nasıl inceliyoruz
Her şaka, API'den ya da sitemizdeki formdan gelsin, yayımlanmadan önce bir insan tarafından okunur. Çoğu bir gün içinde incelenir.
Şaka gibi okunduğunu, seçtiğiniz dilde olduğunu ve kategorisine uyduğunu, ayrıca GiggleTime'da herhangi bir dilde zaten bulunmadığını kontrol ederiz. Bir yazım hatasını düzeltebilir ya da şakayı daha uygun bir kategoriye taşıyabiliriz.
Bir şakayı kullanamazsak size her zaman nedenini söyleriz: neden Gönderdiklerim sayfasında ve API'de görünür. Onaylanan şakalar GiggleTime'da yayımlanır ve tüm dillerimizde okunabilir.
Neleri kabul ediyoruz
- Kendi yazdığınız şakalar ya da geleneksel şakalar ve halk mizahı gibi serbestçe paylaşılabilen şakalar.
- Tek satırlık şakalar, soru-cevap şakaları, kısa hikâyeler ve tak tak şakaları, 26 dilimizin herhangi birinde.
- Biraz yapay zekâ yardımıyla yazdığınız şakalar, kontrol ettiyseniz ve iyiyse sorun değil. Yapay zekâyla toplu üretilmiş şakaları kabul etmiyoruz.
- Başka komedyenlerden, kitaplardan ya da sitelerden kopyalanmış malzeme yok, nefret ya da taciz yok, bağlantı ya da reklam yok.
- Yetişkin mizahını NSFW işaretiyle belirtin. Bunu açmamış ziyaretçilerden gizlenir.
Sınırlar
- Başlangıçta anahtar başına 24 saatte en fazla 20 şaka. Şakalarını düzenli olarak onayladığımız kişilerin sınırını artırırız.
- Dakikada en fazla 10 şaka.
- İnceleme kuyruğumuz dolduğunda yeni şakalar bir süre reddedilir. Lütfen ertesi gün tekrar deneyin.
API başvuru kılavuzu
Tüm istekler https://www.giggletime.app/api/v1/ adresine gider ve Authorization başlığında anahtarınızı gerektirir:
Authorization: Bearer gtj_your_key
Çağrılar
GET /api/v1/me | Sınırlarınız ve son 24 saatte kaç şaka gönderdiğiniz. |
GET /api/v1/categories?language=en | O dildeki kategori kimlikleri ve adları, diller ve şaka türleri. |
POST /api/v1/jokes | Bir şakayı JSON olarak gönderir. |
GET /api/v1/jokes | Şakalarınız, en yeniden başlayarak, durumlarıyla birlikte. İsteğe bağlı: limit (en fazla 100) ve sonraki sayfa için before_id. |
Şaka gönderme alanları
language | Zorunlu. Dil kodu, örneğin en, bg veya es. |
category_id | Zorunlu. Aşağıdaki listeden ya da /api/v1/categories adresinden bir kategori kimliği. |
type | Zorunlu. one-liner, setup-punchline, story veya knock-knock. |
setup, punchline | Soru-cevap şakalarında her bölüm için en fazla 300 karakter. |
text | Diğer tüm türler için: en fazla 300 karakter, hikâyeler için 2000. |
author | İsteğe bağlı. Şakanın kime ait gösterileceği, en fazla 60 karakter. |
nsfw | İsteğe bağlı. Yetişkin mizahı için true. |
Örnekler
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());
Yanıtlar
Alınan bir şaka 201 ve kimliğiyle yanıt verir. Biz inceleyene kadar beklemede kalır:
{"id": 1830, "status": "pending", "remaining_today": 19}
Hatalar, ne yapacağınızı gösteren bir kodla yanıt verir:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: anahtar eksik, yanlış ya da iptal edilmiş. |
403 | terms_required: sitede oturum açın ve güncel koşulları kabul edin. account_suspended |
409 | duplicate_joke: aynı şaka GiggleTime'da zaten var. |
429 | too_fast, daily_limit: bekleyip daha sonra tekrar deneyin. |
503 | review_queue_full: lütfen ertesi gün tekrar deneyin. |
Durumlar ve nedenler
GET /api/v1/jokes içinde her şaka pending (beklemede), approved (onaylandı, adresiyle) ya da rejected (reddedildi, bir neden kodu ve şakanın dilinde nedeniyle) durumundadır:
duplicate | Onaylanmadı: bu şaka zaten GiggleTime'da var. |
not_a_joke | Onaylanmadı: bu bir şaka gibi okunmuyor. |
wrong_language | Onaylanmadı: metin belirtilen dilde değil. |
offensive | Onaylanmadı: içerik kurallarımızı ihlal ediyor. |
copied | Onaylanmadı: başka bir komedyenin malzemesine benziyor. |
quality | Onaylanmadı: GiggleTime'a uygun değil. |
Kategoriler
9Aile17Günlük Yaşam8Hayvanlar3Karanlık4Kelime oyunu6Noel11Okul16Para2Programlama15Sağlık ve Yaşlanma14Teknoloji12Yiyecek ve İçecek7Çeşitli5Ürkütücü13İlişkiler10İş
Diller
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 中文
Sorular
Ücretli mi?
Hayır. API ücretsizdir.
Gönderdiğim şakalar kime ait?
Sahip olduğunuz tüm haklar sizde kalır. Bir şaka göndererek GiggleTime'ın onu yayımlamasına, çevirmesine ve uygulamalarımızda göstermesine, koşullarımızda açıklandığı gibi izin vermiş olursunuz. Hizmet Şartları
Bir şakayı sonradan kaldırabilir miyim?
Evet. Bize yazın, kaldıralım. İletişim
Anahtarım sızarsa ne olur?
Gönderdiklerim sayfasında yeni bir anahtar oluşturun. Eskisi hemen çalışmayı bırakır.
Şakaları kendi sitemde göstermeyi tercih ederim.
O zaman ücretsiz Günün Şakası bileşenimizi deneyin. Siteniz için fıkra widget'ı