Voltar para as Rotas da Twitch

Pastebin

Propósito:

Use essa rota para servir conteúdo diretamente do Pastebin, permitindo múltiplos filtros e formatações.

URL:

https://api.zezofelipe.com.br/twitch/pastebin/ID_DO_PASTEBIN 

Parâmetro da Rota Necessário:

Parâmetros de Consulta:

Exemplos de Uso

A seguir, apresento alguns exemplos práticos de comandos.

Retornar Uma Linha Aleatória do Paste

Parâmetro: id

Quando apenas id for especificado, será retornada uma linha aleatória do paste, sem incluir linhas em branco.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/xM3ZNzDj)

Exemplo de Resposta:

JinxTally é incrível! 

Analisar Paste com Variáveis

Inclua variáveis na URL para que elas sejam interpretadas no conteúdo do seu paste. Isso pode ser útil para gerar respostas personalizadas ou variáveis de retorno. Atualmente, são suportados seis parâmetros principais, mas você também pode passar argumentos personalizados usando args. Além disso, é possível acessar as variáveis de filtro no seu paste. Ambos os métodos seguem a ordem em que aparecem na URL.

Sintaxes Gerais Suportadas:

• ${variável}
• $(variável)
• $variável

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/xq4me4qL?user=$(user)&randuser=$(random.chatter)&randnum=$(random.1-20)&args=PogChamp)

Exemplo de Paste:

$(user) e $(random.chatter) enfrentaram-se! Depois que a poeira baixou... $(user) emergiu vitorioso! 
$user deu $(random.#) presentes para ${random.chatter}! 
Jo...ken...pô! $(user) colocou Tesoura ✌️ e ${random.chatter} colocou Pedra 👊! O oponente arrebenta $(user) à pedradas! ${args.3} 

Exemplo de Resposta:

Jo...ken...pô! ZezoFelipe colocou Tesoura ✌️ e JinxTally colocou Pedra 👊! O oponente arrebenta ZezoFelipe à pedradas! PogChamp 

Probabilidade de Uma Linha do Paste Ser Retornada

Parâmetro: chance

Permite controlar a probabilidade de uma linha ser retornada. Funciona como um sistema de raridade ou filtro probabilístico por porcentagem.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?chance=50&fallback=Nada%20aconteceu.)

Exemplo de Paste:

Essa linha tem 50% de chance de ser retornada. 

Exemplo de Resposta:

Nada aconteceu. 

Comentários

Parâmetro: comments

Comentários podem ser úteis para deixar anotações dentro do paste ou para remover rapidamente uma linha da seleção, mantendo-a preservada. Tanto # quanto // podem ser utilizados para indicar uma linha de comentário.

Por padrão, comments é definido comofalse, sendo necessário serem especificados na URL caso existam no paste.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?comments=true)

Exemplo de Paste:

// Esse é o meu paste de saudações. Guardo todos os meus cumprimentos aqui. 
// Nenhuma dessas duas linhas será retornada. 
Oi! 
// Oiê! <- esse eu removi por enquanto 
E aí! 

Exemplo de Resposta:

Oi! 

Filtrar Linhas Que Contenham o Texto Especificado

Parâmetro: contains

Permite buscar linhas que contenham uma determinada palavra ou texto específico.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?contains=palavra)

Exemplo de Paste:

Aqui não tem o que eu quero. 
Aqui tem a palavra que eu quero. 

Exemplo de Resposta:

Aqui tem a palavra que eu quero. 

Retornar Linhas em Sequência

Parâmetro: cycle

Permite retornar linhas de forma sequencial a cada requisição.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?user=$(user)&cycle=true)

Exemplo de Paste:

Essa primeira linha foi para $(user). 
Essa segunda linha foi para $(user). 
$(user) foi retornado com a próxima linha. 

Exemplos de Resposta:

Essa primeira linha foi para JinxTally. 
Essa segunda linha foi para ZezoFelipe. 
xCADAMURO foi retornado com a próxima linha. 

Excluir Linhas Que Contenham o Texto Especificado

Parâmetro: exclude

Permite excluir linhas que contenham uma determinada palavra ou texto específico.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?exclude=palavra)

Exemplo de Paste:

Aqui tem o que eu quero. 
Aqui tem a palavra que eu não quero. 

Exemplo de Resposta:

Aqui tem o que eu quero. 

Retornar Texto Quando Nenhuma Linha É Encontrada

Parâmetro: fallback

Permite retornar um texto quando nenhuma linha for encontrada, o texto deve ser codificado em urlencode.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?filter=Oi&fallback=E%20a%C3%AD)

Exemplo de Paste:

:[Olá] Essa é uma saudação com filtro "olá" 

Exemplo de Resposta:

E aí 

Filtrar Linhas por Tags

Parâmetro: filter

Permite retornar apenas as linhas do paste que possuam determinadas tags no início da linha. Cada linha pode conter uma ou mais tags dentro de colchetes, seguidas por dois-pontos:[]. O filtro aceita múltiplas tags separadas por vírgula.

Essas tags não são retornadas nas mensagens de bot.

Também é possível utilizar o valor especial untagged para retornar apenas as linhas que não possuem nenhuma tag.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?filter=saudacao,despedida)

Paste de Exemplo:

:[saudacao] Oi! 
:[saudacao] Olá! 
:[despedida] Até logo! 
:[elogio] Você é incrível! 
Essa linha não tem tag. 

Exemplo de Resposta:

Oi! 

Selecionar Linha Específica pelo Índice

Parâmetro: index

Permite selecionar uma linha específica do paste com base em seu índice. A contagem começa em 1, ou seja, index=1 representa a primeira linha do paste.

Caso o índice especificado seja maior que o número total de linhas, será retornado um erro, a menos que o parâmetro wrap seja usado.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?index=2)

Exemplo de Paste:

Primeira linha 
Segunda linha 
Terceira linha 
Quarta linha 

Exemplo de Resposta:

Segunda linha 

Usando wrap com index:

Quando o índice informado exceder o número total de linhas, o parâmetro wrap permite que o retorno "volte ao início" da lista, evitando o erro INDEX_OUT_OF_RANGE.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?index=7&wrap=true)

Exemplo de Paste:

Linha 1 
Linha 2 
Linha 3 
Linha 4 

Exemplo de Resposta:

Linha 3 

Converter Texto para Minúsculas

Parâmetro: lowercase

Converte todo o texto retornado para letras minúsculas. Esse parâmetro é aplicado após a substituição de variáveis e formatações, garantindo que o resultado final seja totalmente convertido.

Útil para manter consistência de formatação em respostas de bots ou comandos que precisam ignorar diferenças de capitalização.

Como a conversão ocorre após a substituição de variáveis, nomes de usuários, canais e demais variáveis também são afetados. Isso significa que mesmo valores serão exibidos em letras minúsculas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?lowercase=true)

Exemplo de Paste:

Esse Texto Será TODO Retornado Com Letras Minúsculas 

Exemplos de Resposta:

esse texto será todo retornado com letras minúsculas 

Definir Tempo Máximo para Cache

Parâmetro: maxcache

Define o tempo máximo em segundos que o conteúdo do paste pode permanecer em cache antes de ser forçado a atualizar. Ele atua como um limitador superior para o ttl interno do sistema de cache.

É útil quando você deseja garantir que as informações retornadas sejam atualizadas com mais frequência, mesmo que o cache padrão seja maior. Ou que o cache maior evitando requisições desnecessárias.

O valor padrão de cache para essa rota é de 1800 segundos (30 minutos), maxcache impõe um tempo máximo, mesmo que o ttl interno seja maior.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?maxcache=60)

Uso com TTL:

maxcache pode ser usado em conjunto com ttl para ajustar o comportamento do cache.

• ttl define o tempo desejado de cache.
• maxcache define o tempo máximo permitido para qualquer cache, mesmo que o ttl seja maior.

Ainda que ttl seja maior que o maxcache, o valor de maxcache prevalece.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?ttl=600&maxcache=60)

Ignorar Linhas

Parâmetro: offset

Permite pular um número específico de linhas no início do paste antes de aplicar qualquer filtro ou seleção. É útil para ignorar introduções, cabeçalhos ou seções iniciais que você não quer que sejam incluídas na seleção aleatória ou sequencial.

O valor é baseado em contagem base-1 (a primeira linha é a 1). Assim, offset=2 ignora as duas primeiras linhas e começa a leitura a partir da terceira.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?offset=2)

Exemplo de Paste:

Introdução: Linhas iniciais que serão ignoradas 
Mais uma linha introdutória 
Primeira linha relevante 
Segunda linha relevante 
Terceira linha relevante 

Exemplo de Resposta:

Primeira linha relevante 

Uso em Conjunto com Outros Parâmetros:

offset é aplicado antes dos parâmetros de seleção, como index, range e return. Isso significa que o deslocamento afeta a posição de todas as linhas subsequentes.

Por exemplo, se você definir offset=3 e index=1, a linha retornada será a quarta linha do paste original.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?offset=3&index=1)

Exemplo de Paste:

Linha 1 - Será ignorada 
Linha 2 - Será ignorada 
Linha 3 - Será ignorada 
Linha 4 - Primeira linha válida 
Linha 5 - Segunda linha válida 

Exemplo de Resposta:

Linha 4 - Primeira linha válida 

Adicionar Texto Antes de Linhas

Parâmetro: prefix

Adiciona um texto no início de cada linha retornada pelo paste. É aplicado após a substituição de variáveis e formatação final do conteúdo, permitindo criar mensagens personalizadas ou padronizadas.

É útil para adicionar prefixos como emojis, ícones, menções, ou frases fixas antes de cada resultado retornado.

prefix é aplicado após filtros, ordenação e substituição de variáveis.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?prefix=💬%20Mensagem:%20)

Exemplo de Paste:

Olá! 
Bom dia! 
Tudo certo? 

Exemplos de Resposta:

💬 Mensagem: Olá! 
💬 Mensagem: Bom dia! 
💬 Mensagem: Tudo certo? 

Uso com Variáveis:

O valor do prefix pode conter variáveis do paste, como $(user), $(channel) ou qualquer variável personalizada. Isso permite criar prefixos dinâmicos baseados no usuário que executou o comando ou no canal atual.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?user=$(user)&prefix=$(user):%20)

Exemplo de Paste:

Ganhou a partida! 
Perdeu a rodada! 
Empatou o jogo! 

Exemplos de Resposta:

Talita: Ganhou a partida! 
Talita: Perdeu a rodada! 
Talita: Empatou o jogo! 

Selecionar Intervalo de Linhas

Parâmetro: range

Permite selecionar um intervalo específico de linhas dentro do paste. O intervalo é definido no formato início-fim, usando contagem base-1 (ou seja, a primeira linha é 1).

É útil quando você deseja retornar várias linhas consecutivas sem precisar utilizar o parâmetro return=all. Também pode ser combinado com prefix, suffix, separator e outros modificadores de saída.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?range=2-4)

Exemplo de Paste:

Linha 1 - Cabeçalho 
Linha 2 - Introdução 
Linha 3 - Parte principal 
Linha 4 - Continuação 
Linha 5 - Finalização 

Exemplo de Resposta:

Linha 2 - Introdução 
Linha 3 - Parte principal 
Linha 4 - Continuação 

Uso com Outros Parâmetros

range é aplicado antes de parâmetros como shuffle, return e unique. Isso significa que apenas as linhas dentro do intervalo definido serão consideradas para embaralhamento, filtros ou repetição.

Também pode ser combinado com offset e index, mas nesse caso o comportamento dependerá da ordem de aplicação interna: primeiro o deslocamento (offset), depois o intervalo (range).

Filtrar Linhas Usando Expressões Regulares

Parâmetro: regex

Permite filtrar linhas do paste com base em uma expressão regular. É útil quando você precisa realizar buscas mais complexas ou específicas, como encontrar linhas que comecem, terminem ou contenham certos padrões de texto.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?regex=^Ol%C3%A1)

Exemplo de Paste:

Olá mundo! 
Bom dia! 
olá novamente! 
Oi! 
Olá, tudo bem? 

Exemplos de Resposta:

Olá mundo! 
Olá, tudo bem? 

Ignorar Maiúsculas e Minúsculas

Para tornar a expressão regular insensível a maiúsculas e minúsculas, adicione (?i) no início da expressão regular.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?regex=(?i)^ol%C3%A1)

Exemplo de Paste:

Olá mundo! 
Bom dia! 
olá novamente! 
Oi pessoal! 
Olá, tudo bem? 

Exemplos de Resposta:

Olá mundo! 
olá novamente! 
Olá, tudo bem? 

Uso em Conjunto com Outros Parâmetros

regex pode ser combinado com outros parâmetros de filtro, como contains, exclude e filter, para criar buscas mais específicas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?exclude=tchau&regex=(?i)^ol%C3%A1)

Exemplo de Paste:

Olá mundo! 
Tchau pessoal! 
olá novamente! 
Olá e bem-vindo! 
tchau! 
Olá, tudo bem? 

Exemplos de Resposta:

Olá mundo! 
olá novamente! 
Olá e bem-vindo! 
Olá, tudo bem? 

Repetir Linhas Selecionadas

Parâmetro: repeat

Permite repetir cada linha selecionada um número específico de vezes. É útil quando você quer enfatizar uma mensagem, gerar repetições para efeitos de chat ou criar respostas formatadas com múltiplas ocorrências da mesma linha.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?repeat=3)

Exemplo de Paste:

Parabéns! 
Você venceu a rodada! 
Boa sorte na próxima! 

Exemplo de Resposta:

Parabéns! 
Parabéns! 
Parabéns! 

Repetir Várias Linhas

Quando repeat é usado junto com parâmetros como return ou range, cada linha selecionada será repetida individualmente. Isso significa que todas as linhas retornadas terão a mesma quantidade de repetições aplicadas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?range=1-2&repeat=2)

Exemplo de Paste:

Linha 1 - Jogador venceu! 
Linha 2 - Jogador perdeu! 
Linha 3 - Empate! 

Exemplo de Resposta:

Linha 1 - Jogador venceu! 
Linha 1 - Jogador venceu! 
Linha 2 - Jogador perdeu! 
Linha 2 - Jogador perdeu! 

Definir Quantidade de Linhas Retornadas

Parâmetro: return

Define quantas linhas a rota deve retornar do paste após aplicar filtros, seleção e ordenação. O valor máximo permitido é 100 linhas para evitar abusos ou respostas excessivamente grandes.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?return=3)

Exemplo de Paste:

Linha 1 - Bem-vindo! 
Linha 2 - Parabéns! 
Linha 3 - Você conseguiu! 
Linha 4 - Continue assim! 
Linha 5 - Boa sorte! 

Exemplos de Resposta:

Linha 3 - Você conseguiu! 
Linha 4 - Continue assim! 
Linha 1 - Bem-vindo! 

Retornar Todas as Linhas

Ao definir return=all, todas as linhas válidas do paste serão retornadas em uma única resposta. Esse modo é útil para exibir listas completas, créditos ou informações que precisam ser mostradas integralmente.

É possível combinar return=all com parâmetros como separator, newline, prefix e suffix para personalizar a formatação final da resposta.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?return=all&separator=%20•%20)

Exemplo de Paste:

Primeiro lugar: JinxTally 
Segundo lugar: ZezoFelipe 
Terceiro lugar: xCADAMURO 

Exemplo de Resposta:

Primeiro lugar: JinxTally • Segundo lugar: ZezoFelipe • Terceiro lugar: xCADAMURO 

Uso com Outros Parâmetros

return pode ser combinado com outros parâmetros de seleção para criar respostas dinâmicas e personalizadas:

• shuffle – embaralha as linhas antes de escolher quais retornar.
• unique – garante que as linhas retornadas não se repitam.
• range ou filter – limitam o universo de linhas antes da seleção.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?filter=mensagem&return=2&shuffle=true&unique=true)

Exemplo de Paste:

:[mensagem] Olá! 
:[mensagem] Como vai? 
:[mensagem] Boa noite! 
:[mensagem] Até logo! 

Exemplo de Resposta:

Olá! 
Boa noite! 

Definir Modo de Seleção de Linhas

Parâmetro: select

Define a forma de seleção das linhas que serão retornadas pelo paste. Ele controla como as linhas são escolhidas, em vez de quantas (que é definido por return).

É ideal para casos em que você deseja um comportamento previsível ou específico na ordem de seleção, como sempre pegar a primeira linha, a última, uma linha aleatória, ou uma linha específica com base em variáveis.

Valores aceitos:

• first — Retorna a primeira linha válida.
• last — Retorna a última linha válida.
• random — Retorna uma linha aleatória (modo padrão).
• middle — Retorna a linha central (útil em listas fixas).
• even — Retorna apenas linhas de índice par (2, 4, 6...).
• odd — Retorna apenas linhas de índice ímpar (1, 3, 5...).

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?select=first)

Exemplo de Paste:

Linha 1 - Introdução 
Linha 2 - Desenvolvimento 
Linha 3 - Conclusão 

Exemplo de Resposta:

Linha 1 - Introdução 

Uso com Outros Parâmetros

O select pode ser combinado com outros parâmetros, como return, shuffle, filter e range, para criar seleções mais complexas.

• select=first&return=3 — Retorna as 3 primeiras linhas.
• select=last&return=2 — Retorna as 2 últimas linhas.
• select=even — Retorna apenas linhas pares.
• select=odd — Retorna apenas linhas ímpares.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?select=last&return=2&prefix=⭐%20)

Exemplo de Paste:

Linha 1 
Linha 2 
Linha 3 
Linha 4 
Linha 5 

Exemplo de Resposta:

⭐ Linha 4 
⭐ Linha 5 

Definir Separador Entre Linhas

Parâmetro: separator

Define qual texto será usado para separar as linhas retornadas pela API quando mais de uma linha é exibida.

Por padrão, as linhas são separadas por uma quebra de linha (\n), mas você pode personalizar esse comportamento conforme a necessidade.

É especialmente útil quando usado junto com return ou range, permitindo formatar a saída em uma única mensagem compacta, com separadores visuais como vírgulas, pontos, barras ou emojis.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?return=3&separator=%20•%20)

Exemplo de Paste:

Maçã 
Banana 
Uva 
Pêssego 
Laranja 

Exemplo de Resposta:

Maçã • Banana • Uva 

Combinação com Outros Parâmetros

O separator é aplicado após parâmetros como return, shuffle, unique e range. Ele também pode ser usado junto com prefix e suffix para formatação completa da saída.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?return=3&prefix=⭐%20&separator=%20|%20&suffix=%20⭐)

Exemplo de Paste:

Alpha 
Beta 
Gamma 

Exemplo de Resposta:

⭐ Alpha ⭐ | ⭐ Beta ⭐ | ⭐ Gamma ⭐ 

Embaralhar Ordem das Linhas

Parâmetro: shuffle

Embaralha aleatoriamente as linhas válidas do paste antes da seleção final. Ideal quando você quer que a ordem dos resultados mude a cada execução.

Todas as linhas são misturadas de forma aleatória antes da aplicação de return, range ou filter.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?shuffle=true&return=3)

Exemplo de Paste:

Frase 1 - Olá! 
Frase 2 - Tudo bem? 
Frase 3 - Boa sorte! 
Frase 4 - Parabéns! 
Frase 5 - Até logo! 

Exemplo de Resposta:

Frase 3 - Boa sorte! 
Frase 1 - Olá! 
Frase 5 - Até logo! 

Combinação com Outros Parâmetros

shuffle pode ser usado em conjunto com praticamente qualquer outro parâmetro de seleção. Sempre é aplicado antes de return e após filtros e exclusões.

• filter=mensagem&shuffle=true — embaralha apenas linhas com a tag “mensagem”.
• exclude=erro&shuffle=true&return=2 — exclui linhas e retorna 2 aleatórias.
• shuffle=true&prefix=🎲%20 — embaralha e adiciona emoji antes de cada linha.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?filter=mensagem&shuffle=true&return=2&prefix=🎲%20)

Exemplo de Paste:

:[mensagem] Olá! 
:[mensagem] Tudo certo? 
:[mensagem] Boa sorte! 
:[mensagem] Até logo! 

Exemplo de Resposta:

🎲 Boa sorte! 
🎲 Tudo certo? 

Dicas de Uso

• Combine shuffle com return para resultados diferentes a cada execução.
• Use unique para evitar repetições até o final do ciclo.
• Ideal para comandos como “frase do dia”, “mensagem aleatória” ou “sorteio”.
• O embaralhamento ocorre antes da aplicação de prefix, suffix e separator.

Adicionar Texto Depois de Linhas

Parâmetro: suffix

Adiciona um texto ao final de cada linha retornada pelo paste. É útil para incluir símbolos, emojis, pontuação, links, ou qualquer complemento visual ou informativo após o conteúdo principal.

É aplicado após todas as operações de seleção e substituição de variáveis, mas antes da junção das linhas com o separator. Ele funciona em conjunto com prefix para formatação completa.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?suffix=%20🎯)

Exemplo de Paste:

Você venceu! 
Continue tentando! 
Boa sorte! 

Exemplos de Resposta:

Você venceu! 🎯 
Continue tentando! 🎯 
Boa sorte! 🎯 

Uso Combinado com prefix

Você pode combinar prefix e suffix para adicionar conteúdo antes e depois de cada linha. Essa combinação é ideal para destacar blocos de texto, criar molduras visuais ou aplicartags decorativas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?prefix=⭐%20&suffix=%20⭐)

Exemplo de Paste:

Mensagem 1 
Mensagem 2 
Mensagem 3 

Exemplos de Resposta:

⭐ Mensagem 1 ⭐ 
⭐ Mensagem 2 ⭐ 
⭐ Mensagem 3 ⭐ 

Uso com separator e return

Quando combinado com separator, o suffix é aplicado antes da junção das linhas, garantindo que o texto final de cada linha seja preservado. Isso permite criar listas formatadas horizontalmente ou visualmente equilibradas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?return=3&separator=%20•%20&suffix=%20🏆)

Exemplo de Paste:

Primeiro lugar 
Segundo lugar 
Terceiro lugar 

Exemplo de Resposta:

Primeiro lugar 🏆 • Segundo lugar 🏆 • Terceiro lugar 🏆 

Uso com Variáveis

suffix também pode conter variáveis do sistema, como $(user), $(channel) ou $(count), para gerar mensagens dinâmicas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?user=$(user)&suffix=%20-%20Enviado%20por:%20$(user))

Exemplo de Paste:

Parabéns! 
Você conseguiu! 
Boa sorte! 

Exemplo de Resposta:

Parabéns! - Enviado por: zezo 
Você conseguiu! - Enviado por: zezo 
Boa sorte! - Enviado por: zezo 

Dicas de Uso:

• Combine prefix e suffix para criar molduras visuais.
• Use %20 (espaço) para ajustar o espaçamento corretamente.
• Aplicado antes de separator e após substituições de texto e variáveis.
• Evite mensagens muito longas, pois bots podem truncar a resposta.

Remover Espaços Extras das Linhas

Parâmetro: trim

Remove espaços em branco extras do início e/ou do final de cada linha retornada. É útil para garantir que o texto final fique limpo e formatado corretamente, especialmente quando o paste contém quebras, tabulações ou espaços acidentais.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?trim=true)

Exemplo de Paste:

   Olá mundo!    
  Esta linha tem espaços extras no início. 
Esta tem no final.     

Exemplos de Resposta:

Olá mundo! 
Esta linha tem espaços extras no início. 
Esta tem no final. 

Combinação com Outros Parâmetros:

trim é aplicado logo após a leitura do paste e antes da aplicação de filtros, sufixos, prefixos e separadores. Isso garante que os espaços indesejados não interfiram em filtros de texto como contains ou regex.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?trim=true&prefix=👉%20&suffix=%20👈)

Exemplo de Paste:

   Olá!    
   Mundo!    
    Como vai?    

Exemplo de Resposta:

👉 Olá! 👈 
👉 Mundo! 👈 
👉 Como vai? 👈 

Definir Tempo de Cache da Requisição

Parâmetro: ttl

Define o tempo de vida em segundos do cache armazenado para uma requisição específica da API. Controla por quanto tempo o resultado de um paste ficará salvo antes de ser recarregado novamente do Pastebin original.

Ajuda a equilibrar desempenho e atualização de dados. Valores menores deixam os dados mais atualizados, enquanto valores maiores reduzem chamadas externas e aumentam a velocidade de resposta.

Sempre que uma requisição é feita, o resultado do paste é armazenado em cache por um período determinado pelo ttl. Durante esse tempo, novas chamadas com os mesmos parâmetros retornarão o resultado em cache, sem precisar refazer a requisição no Pastebin.

Após o tempo expirar, a próxima chamada recarrega automaticamente o conteúdo atualizado e reinicia o ciclo de cache.

Valor padrão do ttl é de 1800 segundos (30 minutos).

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?ttl=120)

Interação com nocache

Se nocache for definido, o ttl será ignorado e a resposta será buscada diretamente do Pastebin em todas as requisições, sem usar ou atualizar o cache local.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?ttl=600&nocache=true)

Dicas de Uso:

• Use ttl curto (10–60 segundos) para dados dinâmicos, como placares ou frases rotativas que são atualizados constantemente.
• Use ttl longos (600–3600 segundos) para dados estáveis, como regras, descrições ou comandos fixos.
• Um cache com ttl = 0 seria sempre considerado expirado e nunca seria retornado, tornando o cache inútil, invés disso, use nocache.

Evitar Repetição de Linhas na Mesma Requisição

Parâmetro: unique

Garante que na mesma requisição não haja linhas duplicadas na resposta. É especialmente útil quando combinado com return para obter múltiplas linhas distintas.

Se você quiser evitar repetição entre múltiplas requisições, use cycle. Ou com shuffle para obter respostas aleatórias sem duplicatas.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?shuffle=true&unique=true)

Converter Texto para Maiúsculas

Parâmetro: uppercase

Converte o texto de cada linha retornada para letras maiúsculas. É útil para destacar mensagens, deixar avisos em evidência ou padronizar a formatação visual no chat.

Quando definido, todas as letras do resultado serão transformadas para caixa alta antes de aplicar prefix, suffix e separator.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?uppercase=true)

Exemplo de Paste:

Olá, Mundo! 

Exemplo de Resposta:

OLÁ, MUNDO! 

Combinação com Outros Parâmetros

O uppercase pode ser usado junto com qualquer outro parâmetro de formatação, a conversão ocorre antes de aplicar esses modificadores, garantindo que todo o texto apareça em caixa alta.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?uppercase=true&prefix=⚡%20&suffix=%20⚡&separator=%20|%20)

Exemplo de Paste:

Primeira frase 
Segunda frase 
Terceira frase 

Exemplos de Resposta:

⚡ PRIMEIRA FRASE ⚡ | ⚡ SEGUNDA FRASE ⚡ | ⚡ TERCEIRA FRASE ⚡ 

Permitir Retorno ao Início do Paste

Parâmetro: wrap

Permite que o índice especificado volte ao início do paste quando exceder o número total de linhas. Cria um comportamento cíclico para seleção por índice.

Quando definido e o índice é maior que o número de linhas disponíveis, a API calcula a posição real usando módulo, garantindo que sempre retorne uma linha válida.

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?index=7&wrap=true)

Exemplo de Paste:

Linha 1 - Primeira 
Linha 2 - Segunda   
Linha 3 - Terceira 
Linha 4 - Quarta 

Exemplo de Resposta:

Linha 3 - Terceira 

Comportamento sem wrap:

Se não for definido, um índice maior que o número de linhas resultaria em erro ou fallback:

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?index=7&fallback=%C3%8Dndice%20inválido)

Exemplo de Resposta:

Índice inválido 

Uso com Outros Parâmetros

wrap pode ser combinado com outros parâmetros para criar comportamentos mais complexos:

• index=15&wrap=true&filter=ativo - Aplica wrap apenas nas linhas com tag "ativo"
• index=10&wrap=true&offset=2 - Aplica offset primeiro, depois wrap no restante
• index=25&wrap=true&prefix=🔁%20 - Adiciona prefixo à linha selecionada com wrap

$(customapi.https://api.zezofelipe.com.br/twitch/pastebin/ABCD1234?index=10&wrap=true&filter=mensagem&prefix=🔁%20)

Exemplo de Paste:

:[mensagem] Saudação 1 
:[mensagem] Saudação 2 
:[mensagem] Saudação 3 
:[outra] Esta linha será ignorada 
:[mensagem] Saudação 4 

Exemplo de Resposta:

🔁 Saudação 2 

Cálculo com Filtros:

Com 4 linhas filtradas e index=10:

• Índice base-0: 10 - 1 = 9
• Cálculo com wrap: 9 % 4 = 1
• Linha retornada: segunda linha filtrada (Saudação 2)

Dicas de Uso:

• Combine com cycle para diferentes comportamentos de sequência
• Ideal para sistemas de rodízio onde você quer garantir que sempre retorne algo
• Útil quando o número de linhas pode variar, mas você quer evitar erros