Envie as suas piadas para o GiggleTime

Como funciona

1. Crie uma conta gratuita no GiggleTime ou inicie sessão.
2. Em As Minhas Submissões, diga-nos o que gostaria de enviar e, mais ou menos, quantas piadas.
3. Lemos cada pedido e respondemos por email, normalmente em um ou dois dias.
4. Depois de aprovado, crie a sua chave na mesma página. Só é mostrada uma vez, por isso guarde-a num lugar seguro.
5. Envie piadas com um simples pedido HTTPS. Cada uma aguarda revisão e pode consultar o seu estado a qualquer momento.

Como revemos as piadas

Cada piada, venha da API ou do formulário do nosso site, é lida por uma pessoa antes de ser publicada. A maioria é revista num dia.

Verificamos se se lê como uma piada, se está no idioma escolhido e se encaixa na categoria, e se ainda não está no GiggleTime em nenhum idioma. Podemos corrigir uma gralha ou mudar uma piada para uma categoria melhor.

Se não pudermos usar uma piada, dizemos-lhe sempre porquê: o motivo aparece em As Minhas Submissões e na API. As piadas aprovadas são publicadas no GiggleTime e podem ser lidas em todos os nossos idiomas.

O que aceitamos

• Piadas que escreveu, ou piadas de livre partilha, como piadas tradicionais e folclore.
• Piadas de uma linha, de pergunta e resposta, histórias curtas e piadas de toc-toc, em qualquer um dos nossos 26 idiomas.
• Piadas que escreveu com alguma ajuda de IA são aceites se as verificou e são boas. Não aceitamos piadas geradas por IA em massa.
• Nada de material copiado de outros comediantes, livros ou sites, nada de ódio ou assédio, e sem links nem publicidade.
• Marque o humor para adultos com a opção NSFW. Fica oculto para visitantes que não a ativaram.

Limites

• No início, até 20 piadas em 24 horas por chave. Aumentamos o limite a quem tem piadas aprovadas com regularidade.
• No máximo 10 piadas por minuto.
• Quando a nossa fila de revisão está cheia, as piadas novas são recusadas durante algum tempo. Tente novamente no dia seguinte.

Referência da API

Todos os pedidos vão para https://www.giggletime.app/api/v1/ e precisam da sua chave no cabeçalho Authorization:

Authorization: Bearer gtj_your_key

Chamadas

Campos para enviar uma piada

Exemplos

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

Respostas

Uma piada recebida responde 201 com o seu id. Fica pendente até a revermos:

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

Os erros respondem com um código com que pode agir:

Estados e motivos

Em GET /api/v1/jokes cada piada está pending (pendente), approved (aprovada, com o seu url) ou rejected (rejeitada, com um código e o motivo no idioma da piada):

Categorias

• 8 Animais
• 5 Assustador
• 12 Comida e Bebida
• 16 Dinheiro
• 7 Diversos
• 11 Escola
• 9 Família
• 3 Humor Negro
• 6 Natal
• 2 Programação
• 13 Relacionamentos
• 15 Saúde e Envelhecimento
• 14 Tecnologia
• 10 Trabalho
• 4 Trocadilho
• 17 Vida Cotidiana

Idiomas

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

Perguntas

Tem algum custo?

Não. A API é gratuita.

De quem são as piadas que envio?

Mantém todos os direitos que tiver. Ao enviar uma piada permite que o GiggleTime a publique, traduza e mostre nas nossas apps, como descrevem os nossos termos. Termos de Serviço

Posso retirar uma piada mais tarde?

Sim. Escreva-nos e retiramo-la. Contacto

E se a minha chave for exposta?

Crie uma nova chave em As Minhas Submissões. A antiga deixa de funcionar imediatamente.

Prefiro mostrar piadas no meu próprio site.

Então experimente o nosso widget gratuito da piada do dia. Widget de piadas para o seu site