Στείλτε τα ανέκδοτά σας στο GiggleTime
Το GiggleTime είναι ένας ιστότοπος ανεκδότων σε 26 γλώσσες. Αν γράφετε ανέκδοτα, έχετε λογαριασμό με χιούμορ ή μια συλλογή, μπορείτε να μας τα στέλνετε από τη δική σας εφαρμογή ή script. Κάθε ανέκδοτο το διαβάζει ένας άνθρωπος πριν δημοσιευτεί.
Πώς λειτουργεί
- Δημιουργήστε δωρεάν λογαριασμό GiggleTime ή συνδεθείτε.
- Στις Υποβολές μου, πείτε μας τι θα θέλατε να στέλνετε και περίπου πόσα ανέκδοτα.
- Διαβάζουμε κάθε αίτημα και απαντάμε με email, συνήθως μέσα σε μία ή δύο μέρες.
- Μόλις εγκριθείτε, δημιουργήστε το κλειδί σας στην ίδια σελίδα. Εμφανίζεται μόνο μία φορά, οπότε φυλάξτε το κάπου ασφαλές.
- Στείλτε ανέκδοτα με ένα απλό αίτημα HTTPS. Το καθένα περιμένει έλεγχο και μπορείτε να δείτε την κατάστασή του οποιαδήποτε στιγμή.
Πώς ελέγχουμε τα ανέκδοτα
Κάθε ανέκδοτο, είτε έρχεται από το API είτε από τη φόρμα του ιστότοπού μας, το διαβάζει ένας άνθρωπος πριν δημοσιευτεί. Τα περισσότερα ελέγχονται μέσα σε μία μέρα.
Ελέγχουμε ότι διαβάζεται σαν ανέκδοτο, ότι είναι στη γλώσσα που επιλέξατε και ταιριάζει στην κατηγορία του, και ότι δεν υπάρχει ήδη στο GiggleTime σε καμία γλώσσα. Μπορεί να διορθώσουμε ένα τυπογραφικό λάθος ή να μεταφέρουμε ένα ανέκδοτο σε καλύτερη κατηγορία.
Αν δεν μπορούμε να χρησιμοποιήσουμε ένα ανέκδοτο, σας λέμε πάντα γιατί: ο λόγος εμφανίζεται στις Υποβολές μου και στο API. Τα εγκεκριμένα ανέκδοτα δημοσιεύονται στο GiggleTime και διαβάζονται σε όλες τις γλώσσες μας.
Τι δεχόμαστε
- Ανέκδοτα που γράψατε εσείς ή ανέκδοτα ελεύθερα προς κοινοποίηση, όπως τα παραδοσιακά ανέκδοτα και η λαογραφία.
- Σύντομα ανέκδοτα, ανέκδοτα με ερώτηση και ατάκα, μικρές ιστορίες και ανέκδοτα «τοκ τοκ», σε οποιαδήποτε από τις 26 γλώσσες μας.
- Ανέκδοτα που γράψατε με λίγη βοήθεια από τεχνητή νοημοσύνη είναι εντάξει, αν τα ελέγξατε και είναι καλά. Δεν δεχόμαστε ανέκδοτα που παράγονται μαζικά από ΤΝ.
- Όχι υλικό αντιγραμμένο από άλλους κωμικούς, βιβλία ή ιστότοπους, όχι μίσος ή παρενόχληση, και χωρίς συνδέσμους ή διαφημίσεις.
- Σημειώστε το χιούμορ για ενήλικες με την ένδειξη NSFW. Κρύβεται από επισκέπτες που δεν την έχουν ενεργοποιήσει.
Όρια
- Αρχικά έως 20 ανέκδοτα σε 24 ώρες ανά κλειδί. Αυξάνουμε το όριο σε όσους εγκρίνουμε συχνά ανέκδοτα.
- Το πολύ 10 ανέκδοτα το λεπτό.
- Όταν η ουρά ελέγχου μας είναι γεμάτη, τα νέα ανέκδοτα απορρίπτονται για λίγο. Δοκιμάστε ξανά την επόμενη μέρα.
Τεκμηρίωση API
Όλα τα αιτήματα πηγαίνουν στο https://www.giggletime.app/api/v1/ και χρειάζονται το κλειδί σας στην κεφαλίδα Authorization:
Authorization: Bearer gtj_your_key
Κλήσεις
GET /api/v1/me | Τα όριά σας και πόσα ανέκδοτα στείλατε τις τελευταίες 24 ώρες. |
GET /api/v1/categories?language=en | Αναγνωριστικά και ονόματα κατηγοριών σε αυτή τη γλώσσα, οι γλώσσες και οι τύποι ανεκδότων. |
POST /api/v1/jokes | Στέλνει ένα ανέκδοτο ως JSON. |
GET /api/v1/jokes | Τα ανέκδοτά σας, τα πιο πρόσφατα πρώτα, με την κατάστασή τους. Προαιρετικά: limit (έως 100) και before_id για την επόμενη σελίδα. |
Πεδία για την αποστολή ανεκδότου
language | Υποχρεωτικό. Ο κωδικός γλώσσας, για παράδειγμα en, bg ή es. |
category_id | Υποχρεωτικό. Ένα αναγνωριστικό κατηγορίας από τη λίστα παρακάτω ή από το /api/v1/categories. |
type | Υποχρεωτικό. one-liner, setup-punchline, story ή knock-knock. |
setup, punchline | Για ανέκδοτα με ερώτηση και ατάκα: έως 300 χαρακτήρες για κάθε μέρος. |
text | Για όλους τους άλλους τύπους: έως 300 χαρακτήρες ή 2000 για ιστορίες. |
author | Προαιρετικό. Σε ποιον αποδίδεται το ανέκδοτο, έως 60 χαρακτήρες. |
nsfw | Προαιρετικό. true για χιούμορ για ενήλικες. |
Παραδείγματα
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": 5, "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": 5, "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: 5, 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());
Απαντήσεις
Ένα ανέκδοτο που παραλήφθηκε απαντά 201 με το αναγνωριστικό του. Μένει σε αναμονή μέχρι να το ελέγξουμε:
{"id": 1830, "status": "pending", "remaining_today": 19}
Τα σφάλματα απαντούν με έναν κωδικό στον οποίο μπορείτε να ανταποκριθείτε:
400 | invalid_language, invalid_category, invalid_joke_type, missing_text, too_long, invalid_json |
401 | unauthorized: το κλειδί λείπει, είναι λάθος ή έχει ανακληθεί. |
403 | terms_required: συνδεθείτε στον ιστότοπο και αποδεχτείτε τους τρέχοντες όρους. account_suspended |
409 | duplicate_joke: το ίδιο ανέκδοτο υπάρχει ήδη στο GiggleTime. |
429 | too_fast, daily_limit: περιμένετε και δοκιμάστε ξανά αργότερα. |
503 | review_queue_full: δοκιμάστε ξανά την επόμενη μέρα. |
Καταστάσεις και λόγοι
Στο GET /api/v1/jokes κάθε ανέκδοτο είναι pending (σε αναμονή), approved (εγκεκριμένο, με το url του) ή rejected (απορρίφθηκε, με κωδικό και τον λόγο στη γλώσσα του ανεκδότου):
duplicate | Δεν εγκρίθηκε: αυτό το ανέκδοτο υπάρχει ήδη στο GiggleTime. |
not_a_joke | Δεν εγκρίθηκε: αυτό δεν διαβάζεται σαν ανέκδοτο. |
wrong_language | Δεν εγκρίθηκε: το κείμενο δεν είναι στη γλώσσα που δηλώθηκε. |
offensive | Δεν εγκρίθηκε: παραβιάζει τους κανόνες περιεχομένου μας. |
copied | Δεν εγκρίθηκε: μοιάζει με υλικό άλλου κωμικού. |
quality | Δεν εγκρίθηκε: δεν ταιριάζει στο GiggleTime. |
Κατηγορίες
5Ανατριχιαστικό7Διάφορα10Δουλειά8Ζώα17Καθημερινή Ζωή4Λογοπαίγνιο3Μαύρο Χιούμορ9Οικογένεια2Προγραμματισμός13Σχέσεις11Σχολείο14Τεχνολογία15Υγεία & Γήρανση12Φαγητό & Ποτό16Χρήματα6Χριστούγεννα
Γλώσσες
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 中文
Ερωτήσεις
Κοστίζει κάτι;
Όχι. Το API είναι δωρεάν.
Σε ποιον ανήκουν τα ανέκδοτα που στέλνω;
Κρατάτε όποια δικαιώματα έχετε. Στέλνοντας ένα ανέκδοτο επιτρέπετε στο GiggleTime να το δημοσιεύει, να το μεταφράζει και να το δείχνει στις εφαρμογές μας, όπως περιγράφουν οι όροι μας. Όροι Χρήσης
Μπορώ να αφαιρέσω ένα ανέκδοτο αργότερα;
Ναι. Γράψτε μας και θα το αφαιρέσουμε. Επικοινωνία
Τι γίνεται αν διαρρεύσει το κλειδί μου;
Δημιουργήστε νέο κλειδί στις Υποβολές μου. Το παλιό σταματά αμέσως να λειτουργεί.
Προτιμώ να δείχνω ανέκδοτα στον δικό μου ιστότοπο.
Τότε δοκιμάστε το δωρεάν widget με το ανέκδοτο της ημέρας. Widget με ανέκδοτα για τον ιστότοπό σας