Send dine vittigheder til GiggleTime
GiggleTime er en vittighedsside på 26 sprog. Skriver du vittigheder, har du en humorprofil eller en samling, kan du sende dem til os fra din egen app eller dit eget script. Hver vittighed bliver læst af et menneske, før den går online.
Sådan virker det
- Opret en gratis GiggleTime-konto, eller log ind.
- Fortæl os under Mine bidrag, hvad du gerne vil sende, og cirka hvor mange vittigheder.
- Vi læser hver anmodning og svarer pr. e-mail, som regel inden for en dag eller to.
- Når du er godkendt, opretter du din nøgle på samme side. Den vises kun én gang, så gem den et sikkert sted.
- Send vittigheder med en enkel HTTPS-forespørgsel. Hver venter på gennemgang, og du kan altid se dens status.
Sådan gennemgår vi vittigheder
Hver vittighed, uanset om den kommer fra API'et eller formularen på vores hjemmeside, bliver læst af et menneske, før den udgives. De fleste gennemgås inden for et døgn.
Vi tjekker, at den læses som en vittighed, at den er på det valgte sprog og passer til sin kategori, og at den ikke allerede findes på GiggleTime på noget sprog. Vi retter måske en tastefejl eller flytter en vittighed til en bedre kategori.
Hvis vi ikke kan bruge en vittighed, fortæller vi dig altid hvorfor: årsagen står under Mine bidrag og i API'et. Godkendte vittigheder udgives på GiggleTime og kan læses på alle vores sprog.
Hvad vi tager imod
- Vittigheder, du selv har skrevet, eller vittigheder, der er frie at dele, som traditionelle vittigheder og folklore.
- Onelinere, vittigheder med spørgsmål og pointe, korte historier og banke-banke-vittigheder på alle vores 26 sprog.
- Vittigheder, du har skrevet med lidt hjælp fra AI, er fine, hvis du har tjekket dem, og de er gode. Vi tager ikke imod vittigheder, der er masseproduceret af AI.
- Intet materiale kopieret fra andre komikere, bøger eller hjemmesider, intet had eller chikane, og ingen links eller reklamer.
- Markér voksenhumor med NSFW-flaget. Den er skjult for besøgende, der ikke har slået den til.
Grænser
- I starten op til 20 vittigheder på 24 timer pr. nøgle. Vi hæver grænsen for dem, hvis vittigheder vi jævnligt godkender.
- Højst 10 vittigheder i minuttet.
- Når vores gennemgangskø er fuld, afvises nye vittigheder i et stykke tid. Prøv igen næste dag.
API-reference
Alle forespørgsler går til https://www.giggletime.app/api/v1/ og kræver din nøgle i Authorization-headeren:
Authorization: Bearer gtj_your_key
Kald
GET /api/v1/me | Dine grænser, og hvor mange vittigheder du har sendt de seneste 24 timer. |
GET /api/v1/categories?language=en | Kategori-id'er og -navne på det sprog, sprogene og vittighedstyperne. |
POST /api/v1/jokes | Sender én vittighed som JSON. |
GET /api/v1/jokes | Dine vittigheder, nyeste først, med deres status. Valgfrit: limit (op til 100) og before_id til næste side. |
Felter til at sende en vittighed
language | Påkrævet. Sprogkoden, for eksempel en, bg eller es. |
category_id | Påkrævet. Et kategori-id fra listen nedenfor eller fra /api/v1/categories. |
type | Påkrævet. one-liner, setup-punchline, story eller knock-knock. |
setup, punchline | For vittigheder med spørgsmål og pointe: op til 300 tegn for hver del. |
text | For alle andre typer: op til 300 tegn, eller 2000 for historier. |
author | Valgfrit. Hvem vittigheden tilskrives, op til 60 tegn. |
nsfw | Valgfrit. true for voksenhumor. |
Eksempler
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": 10, "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": 10, "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: 10, 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());
Svar
En modtaget vittighed svarer 201 med sit id. Den afventer, indtil vi har gennemgået den:
{"id": 1830, "status": "pending", "remaining_today": 19}
Fejl svarer med en kode, du kan handle på:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: nøglen mangler, er forkert eller er tilbagekaldt. |
403 | terms_required: log ind på hjemmesiden, og acceptér de gældende vilkår. account_suspended |
409 | duplicate_joke: den samme vittighed findes allerede på GiggleTime. |
429 | too_fast, daily_limit: vent, og prøv igen senere. |
503 | review_queue_full: prøv igen næste dag. |
Status og årsager
I GET /api/v1/jokes er hver vittighed pending (afventer), approved (godkendt, med sin url) eller rejected (afvist, med en årsagskode og årsagen på vittighedens sprog):
duplicate | Ikke godkendt: denne vittighed er allerede på GiggleTime. |
not_a_joke | Ikke godkendt: det her læses ikke som en vittighed. |
wrong_language | Ikke godkendt: teksten er ikke på det angivne sprog. |
offensive | Ikke godkendt: den bryder vores retningslinjer for indhold. |
copied | Ikke godkendt: det ligner en anden komikers materiale. |
quality | Ikke godkendt: den passer ikke til GiggleTime. |
Kategorier
10Arbejde7Diverse8Dyr9Familie13Forhold17Hverdagsliv6Jul12Mad og Drikke3Mørk4Ordspil16Penge2Programmering11Skole15Sundhed og Aldring14Teknologi5Uhyggelig
Sprog
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 中文
Spørgsmål
Koster det noget?
Nej. API'et er gratis.
Hvem ejer de vittigheder, jeg sender?
Du beholder de rettigheder, du har. Når du sender en vittighed, giver du GiggleTime lov til at udgive den, oversætte den og vise den i vores apps, som vores vilkår beskriver. Servicevilkår
Kan jeg få fjernet en vittighed senere?
Ja. Skriv til os, så fjerner vi den. Kontakt
Hvad hvis min nøgle slipper ud?
Opret en ny nøgle under Mine bidrag. Den gamle holder op med at virke med det samme.
Jeg vil hellere vise vittigheder på min egen side.
Så prøv vores gratis widget med dagens vittighed. Vitse-widget til dit website