Anfonwch eich jôcs i GiggleTime

Sut mae'n gweithio

1. Crëwch gyfrif GiggleTime am ddim, neu mewngofnodwch.
2. Yn Fy Nghyflwyniadau, dywedwch wrthym beth hoffech ei anfon a thua faint o jôcs.
3. Rydyn ni'n darllen pob cais ac yn ateb drwy e-bost, fel arfer o fewn diwrnod neu ddau.
4. Unwaith y cewch eich cymeradwyo, crëwch eich allwedd ar yr un dudalen. Dim ond unwaith y caiff ei dangos, felly cadwch hi'n ddiogel.
5. Anfonwch jôcs gyda chais HTTPS syml. Mae pob un yn aros am adolygiad, a gallwch weld ei statws unrhyw bryd.

Sut rydyn ni'n adolygu jôcs

Mae person yn darllen pob jôc, boed o'r API neu o'r ffurflen ar ein gwefan, cyn ei chyhoeddi. Caiff y rhan fwyaf eu hadolygu o fewn diwrnod.

Rydyn ni'n gwirio ei bod yn darllen fel jôc, ei bod yn yr iaith a ddewisoch ac yn gweddu i'w chategori, a'i bod heb fod ar GiggleTime eisoes mewn unrhyw iaith. Efallai y byddwn yn cywiro gwall teipio neu'n symud jôc i gategori gwell.

Os na allwn ddefnyddio jôc, byddwn bob amser yn dweud pam: mae'r rheswm i'w weld yn Fy Nghyflwyniadau ac yn yr API. Caiff jôcs wedi'u cymeradwyo eu cyhoeddi ar GiggleTime a gellir eu darllen yn ein holl ieithoedd.

Beth rydyn ni'n ei dderbyn

• Jôcs a ysgrifennoch eich hun, neu jôcs sy'n rhydd i'w rhannu, fel jôcs traddodiadol a llên gwerin.
• Jôcs un llinell, jôcs cwestiwn ac ateb, straeon byrion a jôcs cnoc cnoc, mewn unrhyw un o'n 26 iaith.
• Mae jôcs a ysgrifennoch gydag ychydig o help gan AI yn iawn os ydych wedi'u gwirio a'u bod yn dda. Dydyn ni ddim yn derbyn jôcs wedi'u cynhyrchu gan AI mewn swmp.
• Dim deunydd wedi'i gopïo gan gomedïwyr eraill, o lyfrau neu wefannau, dim casineb nac aflonyddu, a dim dolenni na hysbysebion.
• Marciwch hiwmor i oedolion gyda'r faner NSFW. Mae'n gudd rhag ymwelwyr sydd heb ei throi ymlaen.

Terfynau

• Ar y dechrau, hyd at 20 jôc mewn 24 awr fesul allwedd. Rydyn ni'n codi'r terfyn i'r rhai rydyn ni'n cymeradwyo eu jôcs yn gyson.
• Dim mwy na 10 jôc y funud.
• Pan fydd ein ciw adolygu'n llawn, caiff jôcs newydd eu gwrthod am ychydig. Rhowch gynnig arall y diwrnod wedyn.

Cyfeirnod yr API

Mae pob cais yn mynd i https://www.giggletime.app/api/v1/ ac angen eich allwedd ym mhennawd Authorization:

Authorization: Bearer gtj_your_key

Galwadau

Meysydd ar gyfer anfon jôc

Enghreifftiau

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());

Ymatebion

Mae jôc sydd wedi'i derbyn yn ateb 201 gyda'i rhif. Mae'n aros nes i ni ei hadolygu:

{"id": 1830, "status": "pending", "remaining_today": 19}

Mae gwallau'n ateb gyda chod y gallwch weithredu arno:

Statws a rhesymau

Yn GET /api/v1/jokes mae pob jôc yn pending (yn aros), approved (wedi'i chymeradwyo, gyda'i url) neu rejected (wedi'i gwrthod, gyda chod rheswm a'r rheswm yn iaith y jôc):

Categorïau

• 7 Amrywiol
• 8 Anifeiliaid
• 16 Arian
• 12 Bwyd a Diod
• 17 Bywyd Bob Dydd
• 4 Chwarae ar Eiriau
• 3 Digrifwch Tywyll
• 10 Gwaith
• 5 Iasol
• 15 Iechyd a Heneiddio
• 6 Nadolig
• 13 Perthnasoedd
• 2 Rhaglennu
• 14 Technoleg
• 9 Teulu
• 11 Ysgol

Ieithoedd

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 中文

Cwestiynau

Oes cost?

Nac oes. Mae'r API am ddim.

Pwy sy'n berchen ar y jôcs rwy'n eu hanfon?

Rydych chi'n cadw unrhyw hawliau sydd gennych. Drwy anfon jôc rydych yn caniatáu i GiggleTime ei chyhoeddi, ei chyfieithu a'i dangos yn ein apiau, fel y mae ein telerau'n ei ddisgrifio. Telerau Gwasanaeth

Alla i dynnu jôc i lawr yn nes ymlaen?

Gallwch. Ysgrifennwch atom a byddwn yn ei thynnu i lawr. Cysylltu

Beth os yw fy allwedd yn gollwng?

Crëwch allwedd newydd yn Fy Nghyflwyniadau. Mae'r hen un yn peidio â gweithio ar unwaith.

Byddai'n well gen i ddangos jôcs ar fy ngwefan fy hun.

Yna rhowch gynnig ar ein teclyn Jôc y Dydd am ddim. Teclyn jôcs i'ch gwefan