Envoyez vos blagues à GiggleTime

Comment ça marche

1. Créez un compte GiggleTime gratuit ou connectez-vous.
2. Dans Mes soumissions, dites-nous ce que vous aimeriez envoyer et environ combien de blagues.
3. Nous lisons chaque demande et répondons par e-mail, généralement en un ou deux jours.
4. Une fois approuvé, créez votre clé sur la même page. Elle n'est affichée qu'une fois : conservez-la en lieu sûr.
5. Envoyez des blagues avec une simple requête HTTPS. Chacune attend d'être relue, et vous pouvez consulter son statut à tout moment.

Comment nous relisons les blagues

Chaque blague, qu'elle vienne de l'API ou du formulaire de notre site, est lue par une personne avant d'être publiée. La plupart sont relues en un jour.

Nous vérifions qu'elle se lit comme une blague, qu'elle est dans la langue choisie et correspond à sa catégorie, et qu'elle n'est pas déjà sur GiggleTime dans une autre langue. Nous pouvons corriger une coquille ou déplacer une blague vers une meilleure catégorie.

Si nous ne pouvons pas utiliser une blague, nous vous disons toujours pourquoi : la raison apparaît dans Mes soumissions et dans l'API. Les blagues approuvées sont publiées sur GiggleTime et lisibles dans toutes nos langues.

Ce que nous acceptons

• Des blagues que vous avez écrites vous-même, ou libres de partage, comme les blagues traditionnelles et le folklore.
• Blagues en une ligne, question-réponse, petites histoires et blagues toc-toc, dans n'importe laquelle de nos 26 langues.
• Les blagues écrites avec un peu d'aide de l'IA sont acceptées si vous les avez vérifiées et qu'elles sont bonnes. Nous n'acceptons pas les blagues générées en masse par l'IA.
• Pas de textes copiés d'autres humoristes, de livres ou de sites, pas de haine ni de harcèlement, ni de liens ou de publicité.
• Signalez l'humour pour adultes avec l'option NSFW. Il est masqué pour les visiteurs qui ne l'ont pas activé.

Limites

• Au début, jusqu'à 20 blagues par 24 heures et par clé. Nous augmentons la limite pour ceux dont nous approuvons régulièrement les blagues.
• Au maximum 10 blagues par minute.
• Quand notre file de relecture est pleine, les nouvelles blagues sont refusées pendant un moment. Réessayez le lendemain.

Référence de l'API

Toutes les requêtes vont à https://www.giggletime.app/api/v1/ et demandent votre clé dans l'en-tête Authorization :

Authorization: Bearer gtj_your_key

Appels

Champs pour envoyer une blague

Exemples

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());

Réponses

Une blague reçue répond 201 avec son identifiant. Elle reste en attente jusqu'à ce que nous l'ayons relue :

{"id": 1830, "status": "pending", "remaining_today": 19}

Les erreurs répondent avec un code sur lequel vous pouvez agir :

Statuts et raisons

Dans GET /api/v1/jokes, chaque blague est pending (en attente), approved (approuvée, avec son url) ou rejected (refusée, avec un code et la raison dans la langue de la blague) :

Catégories

• 8 Animaux
• 16 Argent
• 7 Divers
• 5 Effrayant
• 9 Famille
• 3 Humour Noir
• 4 Jeu de Mots
• 12 Nourriture et Boisson
• 6 Noël
• 2 Programmation
• 13 Relations
• 15 Santé et Vieillissement
• 14 Technologie
• 10 Travail
• 17 Vie Quotidienne
• 11 École

Langues

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

Questions

Est-ce payant ?

Non. L'API est gratuite.

À qui appartiennent les blagues que j'envoie ?

Vous gardez tous vos droits. En envoyant une blague, vous autorisez GiggleTime à la publier, la traduire et l'afficher dans nos applications, comme le décrivent nos conditions. Conditions d'utilisation

Puis-je retirer une blague plus tard ?

Oui. Écrivez-nous et nous la retirerons. Contact

Et si ma clé fuite ?

Créez une nouvelle clé dans Mes soumissions. L'ancienne cesse aussitôt de fonctionner.

Je préfère afficher des blagues sur mon propre site.

Essayez alors notre widget gratuit de la blague du jour. Widget de blagues pour votre site