أرسل نكاتك إلى GiggleTime

GiggleTime موقع نكات بـ 26 لغة. إذا كنت تكتب النكات أو تدير حسابًا فكاهيًا أو لديك مجموعة، يمكنك إرسالها إلينا من تطبيقك أو برنامجك النصي. يقرأ شخص كل نكتة قبل نشرها.

اقرأ مرجع واجهة البرمجة

كيف يعمل

أنشئ حسابًا مجانيًا على GiggleTime أو سجّل الدخول.
في صفحة مساهماتي، أخبرنا بما تود إرساله وكم نكتة تقريبًا.
نقرأ كل طلب ونرد بالبريد الإلكتروني، عادةً خلال يوم أو يومين.
بعد الموافقة، أنشئ مفتاحك في الصفحة نفسها. يُعرض مرة واحدة فقط، فاحفظه في مكان آمن.
أرسل النكات بطلب HTTPS بسيط. تنتظر كل نكتة المراجعة، ويمكنك معرفة حالتها في أي وقت.

كيف نراجع النكات

كل نكتة، سواء جاءت من واجهة البرمجة أو من النموذج على موقعنا، يقرؤها شخص قبل نشرها. وتُراجع معظمها خلال يوم.

نتحقق من أنها تُقرأ كنكتة، وأنها باللغة التي اخترتها وتناسب فئتها، وأنها غير موجودة على GiggleTime بأي لغة. قد نصحح خطأً مطبعيًا أو ننقل النكتة إلى فئة أنسب.

إذا لم نتمكن من استخدام نكتة، نخبرك دائمًا بالسبب: يظهر السبب في صفحة مساهماتي وفي واجهة البرمجة. تُنشر النكات المقبولة على GiggleTime ويمكن قراءتها بكل لغاتنا.

ما نقبله

نكات كتبتها بنفسك، أو نكات متاحة للمشاركة بحرية مثل النكات التقليدية والتراث الشعبي.
نكات من سطر واحد، ونكات السؤال والجواب، وقصص قصيرة، ونكات «طق طق» بأي من لغاتنا الـ 26.
النكات التي كتبتها بقليل من مساعدة الذكاء الاصطناعي مقبولة إذا راجعتها وكانت جيدة. لا نقبل النكات المولّدة بالذكاء الاصطناعي بالجملة.
لا مواد منسوخة من كوميديين آخرين أو كتب أو مواقع، ولا كراهية أو تحرش، ولا روابط أو إعلانات.
ضع علامة NSFW على فكاهة الكبار. تُخفى عن الزوار الذين لم يفعّلوها.

الحدود

في البداية حتى 20 نكتة خلال 24 ساعة لكل مفتاح. نرفع الحد لمن نقبل نكاتهم باستمرار.
10 نكات في الدقيقة كحد أقصى.
عندما تمتلئ قائمة المراجعة، تُرفض النكات الجديدة لبعض الوقت. يرجى المحاولة مجددًا في اليوم التالي.

مرجع واجهة البرمجة

تذهب كل الطلبات إلى https://www.giggletime.app/api/v1/ وتحتاج إلى مفتاحك في ترويسة Authorization:

Authorization: Bearer gtj_your_key

الاستدعاءات

`GET /api/v1/me`	حدودك وعدد النكات التي أرسلتها خلال آخر 24 ساعة.
`GET /api/v1/categories?language=en`	معرّفات الفئات وأسماؤها بتلك اللغة، واللغات وأنواع النكات.
`POST /api/v1/jokes`	يرسل نكتة واحدة بصيغة JSON.
`GET /api/v1/jokes`	نكاتك، الأحدث أولًا، مع حالتها. اختياري: limit (حتى 100) وbefore_id للصفحة التالية.

حقول إرسال نكتة

`language`	مطلوب. رمز اللغة، مثل en أو bg أو es.
`category_id`	مطلوب. معرّف فئة من القائمة أدناه أو من /api/v1/categories.
`type`	مطلوب. one-liner أو setup-punchline أو story أو knock-knock.
`setup`, `punchline`	لنكات السؤال والجواب: حتى 300 حرف لكل جزء.
`text`	لكل الأنواع الأخرى: حتى 300 حرف، أو 2000 للقصص.
`author`	اختياري. من تُنسب إليه النكتة، حتى 60 حرف.
`nsfw`	اختياري. true لفكاهة الكبار.

أمثلة

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": 2, "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": 2, "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: 2, 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}

تُرجع الأخطاء رمزًا يمكنك التصرف بناءً عليه:

`400`	`invalid_language`, `invalid_category`, `invalid_joke_type`, `missing_text`, `too_long`, `invalid_json`
`401`	`unauthorized`: المفتاح مفقود أو خاطئ أو ملغى.
`403`	`terms_required`: سجّل الدخول إلى الموقع ووافق على الشروط الحالية. `account_suspended`
`409`	`duplicate_joke`: النكتة نفسها موجودة بالفعل على GiggleTime.
`429`	`too_fast`, `daily_limit`: انتظر وحاول مجددًا لاحقًا.
`503`	`review_queue_full`: يرجى المحاولة مجددًا في اليوم التالي.

الحالات والأسباب

في GET /api/v1/jokes تكون كل نكتة pending (قيد الانتظار) أو approved (مقبولة، مع رابطها) أو rejected (مرفوضة، مع رمز السبب والسبب بلغة النكتة):

`duplicate`	لم تتم الموافقة: هذه النكتة موجودة بالفعل على GiggleTime.
`not_a_joke`	لم تتم الموافقة: هذا لا يبدو كنكتة.
`wrong_language`	لم تتم الموافقة: النص ليس باللغة المحددة.
`offensive`	لم تتم الموافقة: يخالف قواعد المحتوى لدينا.
`copied`	لم تتم الموافقة: يبدو أنه من مواد كوميدي آخر.
`quality`	لم تتم الموافقة: لا يناسب GiggleTime.

الفئات

2 البرمجة
14 التكنولوجيا
4 التورية
17 الحياة اليومية
15 الصحة والتقدم في السن
12 الطعام والشراب
9 العائلة
13 العلاقات
10 العمل
16 المال
11 المدرسة
3 النكات السوداء
8 حيوانات
6 عيد الميلاد
7 متنوع
5 مخيف

اللغات

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

أسئلة

هل له تكلفة؟

لا. واجهة البرمجة مجانية.

لمن تعود النكات التي أرسلها؟

تحتفظ بكل حقوقك. بإرسال نكتة تسمح لـ GiggleTime بنشرها وترجمتها وعرضها في تطبيقاتنا، كما تصف شروطنا. شروط الخدمة

هل يمكنني حذف نكتة لاحقًا؟

نعم. راسلنا وسنحذفها. اتصل بنا

ماذا لو تسرّب مفتاحي؟

أنشئ مفتاحًا جديدًا في صفحة مساهماتي. يتوقف القديم عن العمل فورًا.

أفضّل عرض النكات على موقعي.

جرّب إذن أداة نكتة اليوم المجانية. أداة نكات لموقعك

القائمة

اللغة

الفئات

إعدادات

كيف يعمل

كيف نراجع النكات

ما نقبله

الحدود

مرجع واجهة البرمجة

الاستدعاءات

حقول إرسال نكتة

أمثلة

الاستجابات

الحالات والأسباب

الفئات

اللغات

أسئلة

هل له تكلفة؟

لمن تعود النكات التي أرسلها؟

هل يمكنني حذف نكتة لاحقًا؟

ماذا لو تسرّب مفتاحي؟

أفضّل عرض النكات على موقعي.