GiggleTime voor Android
Gratis in Google Play
Download de app
GiggleTime GiggleTime
Menu
Ga voor Premium Dien een grap in Comedians Over Veelgestelde vragen Contact Comedian toevoegen
Download de app
Volg ons

Juridisch
Privacybeleid Gebruiksvoorwaarden Cookiebeleid Terugbetalings- en annuleringsbeleid Toeschrijvingen
Log in
Taal
Categorieën
Instellingen
Taal Nederlands, Vlaams
Veilige modus
Willekeurige grappen automatisch afspelen
Meldingen

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.

Naar de API-referentie

Zo werkt het

  1. Maak een gratis GiggleTime-account aan of log in.
  2. Vertel ons bij Mijn inzendingen wat je wilt sturen en ongeveer hoeveel moppen.
  3. We lezen elk verzoek en antwoorden per e-mail, meestal binnen een of twee dagen.
  4. Zodra je bent goedgekeurd, maak je op dezelfde pagina je sleutel aan. Hij wordt maar één keer getoond, dus bewaar hem goed.
  5. 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/meJe limieten en hoeveel moppen je de afgelopen 24 uur hebt gestuurd.
GET /api/v1/categories?language=enCategorie-id's en -namen in die taal, de talen en de soorten moppen.
POST /api/v1/jokesStuurt één mop als JSON.
GET /api/v1/jokesJe moppen, nieuwste eerst, met hun status. Optioneel: limit (tot 100) en before_id voor de volgende pagina.

Velden voor het versturen van een mop

languageVerplicht. De taalcode, bijvoorbeeld en, bg of es.
category_idVerplicht. Een categorie-id uit de lijst hieronder of uit /api/v1/categories.
typeVerplicht. one-liner, setup-punchline, story of knock-knock.
setup, punchlineVoor moppen met vraag en clou: tot 300 tekens per deel.
textVoor alle andere soorten: tot 300 tekens, of 2000 voor verhalen.
authorOptioneel. Aan wie de mop wordt toegeschreven, tot 60 tekens.
nsfwOptioneel. 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:

400invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json
401unauthorized: de sleutel ontbreekt, is onjuist of is ingetrokken.
403terms_required: log in op de website en accepteer de huidige voorwaarden. account_suspended
409duplicate_joke: dezelfde mop staat al op GiggleTime.
429too_fast, daily_limit: wacht en probeer het later opnieuw.
503review_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):

duplicateNiet goedgekeurd: deze mop staat al op GiggleTime.
not_a_jokeNiet goedgekeurd: dit leest niet als een mop.
wrong_languageNiet goedgekeurd: de tekst is niet in de opgegeven taal.
offensiveNiet goedgekeurd: hij overtreedt onze inhoudsregels.
copiedNiet goedgekeurd: dit lijkt materiaal van een andere comedian.
qualityNiet goedgekeurd: hij past niet bij GiggleTime.

Categorieën

  • 8 Animals
  • 6 Christmas
  • 3 Dark
  • 17 Everyday Life
  • 9 Family
  • 12 Food & Drink
  • 15 Health & Aging
  • 7 Misc
  • 16 Money
  • 2 Programming
  • 4 Pun
  • 13 Relationships
  • 11 School
  • 5 Spooky
  • 14 Technology
  • 10 Work

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