Envia els teus acudits a GiggleTime
GiggleTime és un web d'acudits en 26 idiomes. Si escrius acudits, portes un compte d'humor o tens una col·lecció, ens els pots enviar des de la teva pròpia app o script. Cada acudit el llegeix una persona abans de publicar-se.
Com funciona
- Crea un compte gratuït de GiggleTime o inicia la sessió.
- A Les meves aportacions, explica'ns què t'agradaria enviar i, aproximadament, quants acudits.
- Llegim cada sol·licitud i responem per correu, normalment en un o dos dies.
- Un cop aprovat, crea la teva clau a la mateixa pàgina. Només es mostra una vegada, així que guarda-la en un lloc segur.
- Envia acudits amb una simple petició HTTPS. Cadascun espera revisió i en pots consultar l'estat quan vulguis.
Com revisem els acudits
Cada acudit, vingui de l'API o del formulari del nostre web, el llegeix una persona abans de publicar-se. La majoria es revisen en un dia.
Comprovem que es llegeixi com un acudit, que sigui en l'idioma que has triat i encaixi en la seva categoria, i que no sigui ja a GiggleTime en cap idioma. Pot ser que corregim una errada o passem un acudit a una categoria millor.
Si no podem fer servir un acudit, sempre et diem per què: el motiu apareix a Les meves aportacions i a l'API. Els acudits aprovats es publiquen a GiggleTime i es poden llegir en tots els nostres idiomes.
Què acceptem
- Acudits que has escrit tu, o acudits de lliure ús, com els acudits tradicionals i el folklore.
- Acudits d'una línia, de pregunta i resposta, històries curtes i acudits de toc toc, en qualsevol dels nostres 26 idiomes.
- Els acudits que has escrit amb una mica d'ajuda de la IA estan bé si els has revisat i són bons. No acceptem acudits generats per IA en massa.
- Res de material copiat d'altres humoristes, llibres o webs, res d'odi ni assetjament, i sense enllaços ni publicitat.
- Marca l'humor per a adults amb l'opció NSFW. S'amaga als visitants que no l'han activada.
Límits
- Al principi, fins a 20 acudits en 24 hores per clau. Apugem el límit a qui veu aprovats els seus acudits amb regularitat.
- Com a màxim 10 acudits per minut.
- Quan la nostra cua de revisió és plena, els acudits nous es rebutgen durant una estona. Torna-ho a provar l'endemà.
Referència de l'API
Totes les peticions van a https://www.giggletime.app/api/v1/ i necessiten la teva clau a la capçalera Authorization:
Authorization: Bearer gtj_your_key
Crides
GET /api/v1/me | Els teus límits i quants acudits has enviat les últimes 24 hores. |
GET /api/v1/categories?language=en | Ids i noms de les categories en aquest idioma, els idiomes i els tipus d'acudit. |
POST /api/v1/jokes | Envia un acudit en JSON. |
GET /api/v1/jokes | Els teus acudits, els més nous primer, amb el seu estat. Opcional: limit (fins a 100) i before_id per a la pàgina següent. |
Camps per enviar un acudit
language | Obligatori. El codi de l'idioma, per exemple en, bg o es. |
category_id | Obligatori. Un id de categoria de la llista de sota o de /api/v1/categories. |
type | Obligatori. one-liner, setup-punchline, story o knock-knock. |
setup, punchline | Per als acudits de pregunta i resposta, fins a 300 caràcters cada part. |
text | Per a la resta de tipus: fins a 300 caràcters, o 2000 per a les històries. |
author | Opcional. A qui s'atribueix l'acudit, fins a 60 caràcters. |
nsfw | Opcional. true per a humor per a adults. |
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());
Respostes
Un acudit rebut respon 201 amb el seu id. Queda pendent fins que el revisem:
{"id": 1830, "status": "pending", "remaining_today": 19}
Els errors responen amb un codi amb què pots actuar:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: la clau falta, és incorrecta o s'ha revocat. |
403 | terms_required: inicia la sessió al web i accepta les condicions vigents. account_suspended |
409 | duplicate_joke: el mateix acudit ja és a GiggleTime. |
429 | too_fast, daily_limit: espera i torna-ho a provar més tard. |
503 | review_queue_full: torna-ho a provar l'endemà. |
Estats i motius
A GET /api/v1/jokes cada acudit és pending (pendent), approved (aprovat, amb el seu url) o rejected (rebutjat, amb un codi i el motiu en l'idioma de l'acudit):
duplicate | No aprovat: aquest acudit ja és a GiggleTime. |
not_a_joke | No aprovat: això no sembla un acudit. |
wrong_language | No aprovat: el text no és en l'idioma indicat. |
offensive | No aprovat: incompleix les nostres normes de contingut. |
copied | No aprovat: sembla material d'un altre humorista. |
quality | No aprovat: no encaixa a GiggleTime. |
Categories
8Animals16Diners7Diversos11Escola5Espantós9Família10Feina3Fosc4Joc de paraules12Menjar i Beguda6Nadal2Programació13Relacions15Salut i Envelliment14Tecnologia17Vida Quotidiana
Idiomes
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 中文
Preguntes
Costa alguna cosa?
No. L'API és gratuïta.
De qui són els acudits que envio?
Conserves els drets que tinguis. En enviar un acudit permets que GiggleTime el publiqui, el tradueixi i el mostri a les nostres apps, tal com descriuen les nostres condicions. Termes de servei
Puc retirar un acudit més endavant?
Sí. Escriu-nos i el retirarem. Contacte
I si es filtra la meva clau?
Crea una clau nova a Les meves aportacions. L'antiga deixa de funcionar de seguida.
Prefereixo mostrar acudits al meu propi web.
Llavors prova el nostre giny gratuït de l'acudit del dia. Giny d'acudits per al teu web