Invia le tue barzellette a GiggleTime

Come funziona

1. Crea un account GiggleTime gratuito o accedi.
2. In I miei contributi, dicci cosa vorresti inviare e, più o meno, quante barzellette.
3. Leggiamo ogni richiesta e rispondiamo via email, di solito entro un giorno o due.
4. Una volta approvato, crea la tua chiave nella stessa pagina. Viene mostrata una sola volta, quindi conservala in un posto sicuro.
5. Invia barzellette con una semplice richiesta HTTPS. Ognuna attende il controllo e puoi verificarne lo stato in qualsiasi momento.

Come controlliamo le barzellette

Ogni barzelletta, che arrivi dall'API o dal modulo del nostro sito, viene letta da una persona prima della pubblicazione. La maggior parte viene controllata entro un giorno.

Controlliamo che si legga come una barzelletta, che sia nella lingua scelta e adatta alla sua categoria, e che non sia già su GiggleTime in nessuna lingua. Potremmo correggere un refuso o spostarla in una categoria migliore.

Se non possiamo usare una barzelletta, ti diciamo sempre perché: il motivo compare in I miei contributi e nell'API. Le barzellette approvate vengono pubblicate su GiggleTime e si possono leggere in tutte le nostre lingue.

Cosa accettiamo

• Barzellette scritte da te, o liberamente condivisibili, come le barzellette tradizionali e il folklore.
• Battute brevi, barzellette domanda e risposta, storielle e barzellette toc toc, in qualsiasi delle nostre 26 lingue.
• Le barzellette scritte con un po' di aiuto dall'IA vanno bene se le hai controllate e sono buone. Non accettiamo barzellette generate in massa dall'IA.
• Niente materiale copiato da altri comici, libri o siti, niente odio o molestie, e niente link o pubblicità.
• Segna l'umorismo per adulti con l'opzione NSFW. È nascosto ai visitatori che non l'hanno attivato.

Limiti

• All'inizio, fino a 20 barzellette in 24 ore per chiave. Alziamo il limite per chi vede approvate le sue barzellette con regolarità.
• Al massimo 10 barzellette al minuto.
• Quando la nostra coda di controllo è piena, le nuove barzellette vengono rifiutate per un po'. Riprova il giorno dopo.

Riferimento API

Tutte le richieste vanno a https://www.giggletime.app/api/v1/ e richiedono la tua chiave nell'intestazione Authorization:

Authorization: Bearer gtj_your_key

Chiamate

Campi per inviare una barzelletta

Esempi

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

Risposte

Una barzelletta ricevuta risponde 201 con il suo id. Resta in attesa finché non la controlliamo:

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

Gli errori rispondono con un codice su cui puoi agire:

Stati e motivi

In GET /api/v1/jokes ogni barzelletta è pending (in attesa), approved (approvata, con il suo url) o rejected (rifiutata, con un codice e il motivo nella lingua della barzelletta):

Categorie

• 8 Animali
• 12 Cibo e Bevande
• 9 Famiglia
• 4 Gioco di parole
• 10 Lavoro
• 6 Natale
• 3 Oscuro
• 2 Programmazione
• 13 Relazioni
• 15 Salute ed Età
• 11 Scuola
• 16 Soldi
• 5 Spettrale
• 14 Tecnologia
• 7 Vari
• 17 Vita Quotidiana

Lingue

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

Domande

Costa qualcosa?

No. L'API è gratuita.

Di chi sono le barzellette che invio?

Mantieni tutti i diritti che hai. Inviando una barzelletta permetti a GiggleTime di pubblicarla, tradurla e mostrarla nelle nostre app, come descritto nei nostri termini. Termini di servizio

Posso rimuovere una barzelletta in seguito?

Sì. Scrivici e la toglieremo. Contatti

E se la mia chiave finisce in mani sbagliate?

Crea una nuova chiave in I miei contributi. La vecchia smette subito di funzionare.

Preferisco mostrare barzellette sul mio sito.

Allora prova il nostro widget gratuito della barzelletta del giorno. Widget di barzellette per il tuo sito