Skicka dina skämt till GiggleTime
GiggleTime är en skämtsajt på 26 språk. Skriver du skämt, driver ett humorkonto eller har en samling kan du skicka dem till oss från din egen app eller ditt eget skript. Varje skämt läses av en människa innan det publiceras.
Så fungerar det
- Skapa ett gratis GiggleTime-konto, eller logga in.
- Berätta under Mina bidrag vad du vill skicka och ungefär hur många skämt.
- Vi läser varje förfrågan och svarar via mejl, oftast inom en eller två dagar.
- När du har godkänts skapar du din nyckel på samma sida. Den visas bara en gång, så spara den på ett säkert ställe.
- Skicka skämt med ett enkelt HTTPS-anrop. Varje skämt väntar på granskning, och du kan när som helst se dess status.
Så granskar vi skämt
Varje skämt, oavsett om det kommer från API:et eller formuläret på vår webbplats, läses av en människa innan det publiceras. De flesta granskas inom ett dygn.
Vi kontrollerar att det läses som ett skämt, att det är på det språk du valt och passar sin kategori, och att det inte redan finns på GiggleTime på något språk. Vi kan rätta ett stavfel eller flytta ett skämt till en bättre kategori.
Om vi inte kan använda ett skämt berättar vi alltid varför: skälet visas under Mina bidrag och i API:et. Godkända skämt publiceras på GiggleTime och kan läsas på alla våra språk.
Vad vi tar emot
- Skämt som du själv har skrivit, eller skämt som är fria att dela, som traditionella skämt och folklore.
- Oneliners, skämt med fråga och poäng, korta berättelser och knack-knack-skämt, på alla våra 26 språk.
- Skämt som du skrivit med lite hjälp av AI går bra om du har kontrollerat dem och de är bra. Vi tar inte emot skämt som massproducerats av AI.
- Inget material kopierat från andra komiker, böcker eller webbplatser, inget hat eller trakasserier, och inga länkar eller reklam.
- Markera vuxenhumor med NSFW-flaggan. Den döljs för besökare som inte har slagit på den.
Gränser
- Till en början upp till 20 skämt per 24 timmar och nyckel. Vi höjer gränsen för dem vars skämt vi ofta godkänner.
- Högst 10 skämt per minut.
- När vår granskningskö är full avvisas nya skämt en stund. Försök igen nästa dag.
API-referens
Alla anrop går till https://www.giggletime.app/api/v1/ och kräver din nyckel i Authorization-headern:
Authorization: Bearer gtj_your_key
Anrop
GET /api/v1/me | Dina gränser och hur många skämt du har skickat de senaste 24 timmarna. |
GET /api/v1/categories?language=en | Kategori-id:n och namn på det språket, språken och skämttyperna. |
POST /api/v1/jokes | Skickar ett skämt som JSON. |
GET /api/v1/jokes | Dina skämt, nyaste först, med sin status. Valfritt: limit (upp till 100) och before_id för nästa sida. |
Fält för att skicka ett skämt
language | Obligatoriskt. Språkkoden, till exempel en, bg eller es. |
category_id | Obligatoriskt. Ett kategori-id från listan nedan eller från /api/v1/categories. |
type | Obligatoriskt. one-liner, setup-punchline, story eller knock-knock. |
setup, punchline | För skämt med fråga och poäng: upp till 300 tecken per del. |
text | För alla andra typer: upp till 300 tecken, eller 2000 för berättelser. |
author | Valfritt. Vem skämtet tillskrivs, upp till 60 tecken. |
nsfw | Valfritt. true för vuxenhumor. |
Exempel
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": 7, "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": 7, "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: 7, 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
Ett mottaget skämt svarar 201 med sitt id. Det väntar tills vi har granskat det:
{"id": 1830, "status": "pending", "remaining_today": 19}
Fel svarar med en kod du kan agera på:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: nyckeln saknas, är fel eller har återkallats. |
403 | terms_required: logga in på webbplatsen och godkänn de aktuella villkoren. account_suspended |
409 | duplicate_joke: samma skämt finns redan på GiggleTime. |
429 | too_fast, daily_limit: vänta och försök igen senare. |
503 | review_queue_full: försök igen nästa dag. |
Status och skäl
I GET /api/v1/jokes är varje skämt pending (väntar), approved (godkänt, med sin url) eller rejected (avslaget, med en skälkod och skälet på skämtets språk):
duplicate | Inte godkänt: skämtet finns redan på GiggleTime. |
not_a_joke | Inte godkänt: det här läses inte som ett skämt. |
wrong_language | Inte godkänt: texten är inte på det angivna språket. |
offensive | Inte godkänt: det bryter mot våra innehållsregler. |
copied | Inte godkänt: det ser ut som en annan komikers material. |
quality | Inte godkänt: det passar inte på GiggleTime. |
Kategorier
7Diverse8Djur9Familj15Hälsa och Åldrande10Jobb6Jul5Kuslig12Mat och Dryck3Mörk4Ordvits16Pengar2Programmering13Relationer11Skola14Teknik17Vardagsliv
Språk
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 中文
Frågor
Kostar det något?
Nej. API:et är gratis.
Vem äger skämten jag skickar?
Du behåller de rättigheter du har. Genom att skicka ett skämt låter du GiggleTime publicera det, översätta det och visa det i våra appar, så som våra villkor beskriver. Användarvillkor
Kan jag ta bort ett skämt senare?
Ja. Skriv till oss så tar vi bort det. Kontakt
Vad händer om min nyckel läcker?
Skapa en ny nyckel under Mina bidrag. Den gamla slutar fungera direkt.
Jag vill hellre visa skämt på min egen sajt.
Prova då vår gratis widget med dagens skämt. Skämtwidget för din webbplats