Stuur je moppen naar GiggleTime
GiggleTime is een moppensite in 26 talen. Schrijf je moppen, beheer je een humoraccount of heb je een verzameling, dan kun je ze vanuit je eigen app of script naar ons sturen. Elke mop wordt door een mens gelezen voordat hij online komt.
Zo werkt het
- Maak een gratis GiggleTime-account aan of log in.
- Vertel ons bij Mijn inzendingen wat je wilt sturen en ongeveer hoeveel moppen.
- We lezen elk verzoek en antwoorden per e-mail, meestal binnen een of twee dagen.
- Zodra je bent goedgekeurd, maak je op dezelfde pagina je sleutel aan. Hij wordt maar één keer getoond, dus bewaar hem goed.
- Stuur moppen met een eenvoudig HTTPS-verzoek. Elke mop wacht op beoordeling en je kunt de status altijd bekijken.
Zo bekijken we moppen
Elke mop, via de API of via het formulier op onze website, wordt door een mens gelezen voordat hij verschijnt. De meeste worden binnen een dag bekeken.
We kijken of hij leest als een mop, of hij in de gekozen taal is en bij zijn categorie past, en of hij niet al in een andere taal op GiggleTime staat. Soms verbeteren we een typfout of zetten we een mop in een betere categorie.
Als we een mop niet kunnen gebruiken, vertellen we je altijd waarom: de reden staat bij Mijn inzendingen en in de API. Goedgekeurde moppen verschijnen op GiggleTime en zijn in al onze talen te lezen.
Wat we aannemen
- Moppen die je zelf hebt geschreven, of moppen die vrij gedeeld mogen worden, zoals traditionele moppen en folklore.
- Oneliners, moppen met vraag en clou, korte verhalen en klop-klopmoppen, in elk van onze 26 talen.
- Moppen die je met wat hulp van AI hebt geschreven zijn prima als je ze hebt nagekeken en ze goed zijn. Moppen die in bulk door AI zijn gemaakt nemen we niet aan.
- Geen materiaal dat is overgenomen van andere comedians, boeken of websites, geen haat of intimidatie, en geen links of reclame.
- Markeer humor voor volwassenen met de NSFW-vlag. Die is verborgen voor bezoekers die hem niet hebben aangezet.
Limieten
- In het begin tot 20 moppen per 24 uur per sleutel. Voor wie we regelmatig moppen goedkeuren, verhogen we de limiet.
- Hoogstens 10 moppen per minuut.
- Als onze beoordelingswachtrij vol is, worden nieuwe moppen een tijdje geweigerd. Probeer het de volgende dag opnieuw.
API-referentie
Alle verzoeken gaan naar https://www.giggletime.app/api/v1/ en hebben je sleutel nodig in de Authorization-header:
Authorization: Bearer gtj_your_key
Aanroepen
GET /api/v1/me | Je limieten en hoeveel moppen je de afgelopen 24 uur hebt gestuurd. |
GET /api/v1/categories?language=en | Categorie-id's en -namen in die taal, de talen en de soorten moppen. |
POST /api/v1/jokes | Stuurt één mop als JSON. |
GET /api/v1/jokes | Je moppen, nieuwste eerst, met hun status. Optioneel: limit (tot 100) en before_id voor de volgende pagina. |
Velden voor het versturen van een mop
language | Verplicht. De taalcode, bijvoorbeeld en, bg of es. |
category_id | Verplicht. Een categorie-id uit de lijst hieronder of uit /api/v1/categories. |
type | Verplicht. one-liner, setup-punchline, story of knock-knock. |
setup, punchline | Voor moppen met vraag en clou: tot 300 tekens per deel. |
text | Voor alle andere soorten: tot 300 tekens, of 2000 voor verhalen. |
author | Optioneel. Aan wie de mop wordt toegeschreven, tot 60 tekens. |
nsfw | Optioneel. true voor humor voor volwassenen. |
Voorbeelden
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());
Antwoorden
Een ontvangen mop antwoordt met 201 en zijn id. Hij blijft in afwachting tot we hem hebben bekeken:
{"id": 1830, "status": "pending", "remaining_today": 19}
Fouten antwoorden met een code waarmee je verder kunt:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: de sleutel ontbreekt, is onjuist of is ingetrokken. |
403 | terms_required: log in op de website en accepteer de huidige voorwaarden. account_suspended |
409 | duplicate_joke: dezelfde mop staat al op GiggleTime. |
429 | too_fast, daily_limit: wacht en probeer het later opnieuw. |
503 | review_queue_full: probeer het de volgende dag opnieuw. |
Statussen en redenen
In GET /api/v1/jokes is elke mop pending (in afwachting), approved (goedgekeurd, met zijn url) of rejected (afgewezen, met een redencode en de reden in de taal van de mop):
duplicate | Niet goedgekeurd: deze mop staat al op GiggleTime. |
not_a_joke | Niet goedgekeurd: dit leest niet als een mop. |
wrong_language | Niet goedgekeurd: de tekst is niet in de opgegeven taal. |
offensive | Niet goedgekeurd: hij overtreedt onze inhoudsregels. |
copied | Niet goedgekeurd: dit lijkt materiaal van een andere comedian. |
quality | Niet goedgekeurd: hij past niet bij GiggleTime. |
Categorieën
8Animals6Christmas3Dark17Everyday Life9Family12Food & Drink15Health & Aging7Misc16Money2Programming4Pun13Relationships11School5Spooky14Technology10Work
Talen
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 中文
Vragen
Kost het iets?
Nee. De API is gratis.
Van wie zijn de moppen die ik stuur?
Je houdt alle rechten die je hebt. Door een mop te sturen sta je GiggleTime toe hem te publiceren, te vertalen en in onze apps te tonen, zoals onze voorwaarden beschrijven. Gebruiksvoorwaarden
Kan ik een mop later laten weghalen?
Ja. Schrijf ons en we halen hem weg. Contact
Wat als mijn sleutel uitlekt?
Maak een nieuwe sleutel aan bij Mijn inzendingen. De oude werkt meteen niet meer.
Ik toon liever moppen op mijn eigen site.
Probeer dan onze gratis widget met de mop van de dag. Moppenwidget voor je website