Kirim lelucon Anda ke GiggleTime
GiggleTime adalah situs lelucon dalam 26 bahasa. Jika Anda menulis lelucon, mengelola akun humor, atau punya koleksi, Anda bisa mengirimkannya kepada kami dari aplikasi atau skrip Anda sendiri. Setiap lelucon dibaca manusia sebelum tayang.
Cara kerjanya
- Buat akun GiggleTime gratis, atau masuk.
- Di Kiriman Saya, beri tahu kami apa yang ingin Anda kirim dan kira-kira berapa banyak lelucon.
- Kami membaca setiap permintaan dan membalas lewat email, biasanya dalam satu atau dua hari.
- Setelah disetujui, buat kunci Anda di halaman yang sama. Kunci hanya ditampilkan sekali, jadi simpan di tempat yang aman.
- Kirim lelucon dengan permintaan HTTPS sederhana. Setiap lelucon menunggu peninjauan, dan Anda bisa melihat statusnya kapan saja.
Cara kami meninjau lelucon
Setiap lelucon, baik dari API maupun dari formulir di situs kami, dibaca oleh manusia sebelum diterbitkan. Sebagian besar ditinjau dalam sehari.
Kami memeriksa bahwa isinya terbaca sebagai lelucon, dalam bahasa yang Anda pilih dan sesuai kategorinya, serta belum ada di GiggleTime dalam bahasa apa pun. Kami mungkin memperbaiki salah ketik atau memindahkan lelucon ke kategori yang lebih tepat.
Jika kami tidak bisa memakai sebuah lelucon, kami selalu memberi tahu alasannya: alasan itu muncul di Kiriman Saya dan di API. Lelucon yang disetujui diterbitkan di GiggleTime dan bisa dibaca dalam semua bahasa kami.
Apa yang kami terima
- Lelucon yang Anda tulis sendiri, atau lelucon yang bebas dibagikan, seperti lelucon tradisional dan cerita rakyat.
- Lelucon satu baris, lelucon tanya-jawab, cerita pendek, dan lelucon tok-tok, dalam salah satu dari 26 bahasa kami.
- Lelucon yang Anda tulis dengan sedikit bantuan AI boleh, asal sudah Anda periksa dan memang bagus. Kami tidak menerima lelucon buatan AI secara massal.
- Tanpa materi yang disalin dari komedian lain, buku atau situs web, tanpa kebencian atau pelecehan, dan tanpa tautan atau iklan.
- Tandai humor dewasa dengan tanda NSFW. Humor itu disembunyikan dari pengunjung yang belum mengaktifkannya.
Batas
- Pada awalnya hingga 20 lelucon dalam 24 jam per kunci. Kami menaikkan batas bagi kontributor yang leluconnya terus kami setujui.
- Paling banyak 10 lelucon per menit.
- Saat antrean peninjauan kami penuh, lelucon baru ditolak untuk sementara. Silakan coba lagi keesokan harinya.
Referensi API
Semua permintaan dikirim ke https://www.giggletime.app/api/v1/ dan memerlukan kunci Anda di header Authorization:
Authorization: Bearer gtj_your_key
Panggilan
GET /api/v1/me | Batas Anda, dan berapa lelucon yang Anda kirim dalam 24 jam terakhir. |
GET /api/v1/categories?language=en | Id dan nama kategori dalam bahasa itu, daftar bahasa, dan jenis lelucon. |
POST /api/v1/jokes | Mengirim satu lelucon sebagai JSON. |
GET /api/v1/jokes | Lelucon Anda, yang terbaru lebih dulu, beserta statusnya. Opsional: limit (hingga 100) dan before_id untuk halaman berikutnya. |
Kolom untuk mengirim lelucon
language | Wajib. Kode bahasa, misalnya en, bg atau es. |
category_id | Wajib. Id kategori dari daftar di bawah atau dari /api/v1/categories. |
type | Wajib. one-liner, setup-punchline, story atau knock-knock. |
setup, punchline | Untuk lelucon tanya-jawab, hingga 300 karakter untuk setiap bagian. |
text | Untuk jenis lainnya: hingga 300 karakter, atau 2000 untuk cerita. |
author | Opsional. Kepada siapa lelucon dikreditkan, hingga 60 karakter. |
nsfw | Opsional. true untuk humor dewasa. |
Contoh
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());
Respons
Lelucon yang diterima menjawab 201 beserta id-nya. Lelucon itu menunggu sampai kami meninjaunya:
{"id": 1830, "status": "pending", "remaining_today": 19}
Kesalahan menjawab dengan kode yang bisa Anda tindak lanjuti:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: kunci tidak ada, salah, atau sudah dicabut. |
403 | terms_required: masuk ke situs web dan setujui ketentuan terbaru. account_suspended |
409 | duplicate_joke: lelucon yang sama sudah ada di GiggleTime. |
429 | too_fast, daily_limit: tunggu dan coba lagi nanti. |
503 | review_queue_full: silakan coba lagi keesokan harinya. |
Status dan alasan
Di GET /api/v1/jokes setiap lelucon berstatus pending (menunggu), approved (disetujui, dengan url-nya) atau rejected (ditolak, dengan kode alasan dan alasannya dalam bahasa lelucon itu):
duplicate | Tidak disetujui: lelucon ini sudah ada di GiggleTime. |
not_a_joke | Tidak disetujui: ini tidak terbaca sebagai lelucon. |
wrong_language | Tidak disetujui: teksnya tidak dalam bahasa yang disebutkan. |
offensive | Tidak disetujui: melanggar pedoman konten kami. |
copied | Tidak disetujui: ini tampak seperti materi komedian lain. |
quality | Tidak disetujui: tidak cocok untuk GiggleTime. |
Kategori
8Animals6Christmas3Dark17Everyday Life9Family12Food & Drink15Health & Aging7Misc16Money2Programming4Pun13Relationships11School5Spooky14Technology10Work
Bahasa
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 中文
Pertanyaan
Apakah berbayar?
Tidak. API ini gratis.
Siapa pemilik lelucon yang saya kirim?
Anda tetap memegang semua hak yang Anda miliki. Dengan mengirim lelucon, Anda mengizinkan GiggleTime menerbitkan, menerjemahkan, dan menampilkannya di aplikasi kami, seperti dijelaskan dalam ketentuan kami. Ketentuan Layanan
Bisakah saya menghapus lelucon nanti?
Bisa. Hubungi kami dan kami akan menghapusnya. Kontak
Bagaimana jika kunci saya bocor?
Buat kunci baru di Kiriman Saya. Kunci lama langsung berhenti berfungsi.
Saya lebih suka menampilkan lelucon di situs saya sendiri.
Kalau begitu, coba widget lelucon hari ini kami yang gratis. Widget lelucon untuk situs Anda