DevWorld BR API — SDK oficial

SDK oficial para integrar os serviços da "DevWorld BR" (https://api.devworldbr.site) em projetos Node.js.

Acesse recursos de downloads, pesquisas, inteligência artificial, geradores, figurinhas e logos por meio de métodos simples.

Instalação

Requisitos: Node.js e npm.

npm install devworldbr-api

Inicialização

A SDK exporta uma instância pronta para uso. Não é necessário informar API Key nem instanciar a classe.

CommonJS

const api = require('devworldbr-api');

async function main() { const result = await api.groq('O que é JavaScript?'); console.log(result); // JSON }

main().catch(console.error);

ESM

import api from 'devworldbr-api';

async function main() { const result = await api.groq('O que é JavaScript?'); console.log(result); // JSON }

main().catch(console.error);

Downloads e mídias

Método| Descrição| Retorno "playVideo(query)"| Pesquisa e obtém vídeo do YouTube| "Buffer" "playAudio(query)"| Pesquisa e obtém áudio do YouTube| JSON "ytdl(link)"| Download do YouTube por link| JSON "ttkdl(link)"| Download do TikTok| JSON "ttkimg(link)"| Imagens/slides do TikTok| JSON "kwaidl(link)"| Download do Kwai| JSON "pinterest(query)"| Pesquisa ou consulta por URL do Pinterest| JSON "spotify(link)"| Download do Spotify| JSON "igdl(link)"| Download do Instagram| JSON "FacebookDL(link)"| Download do Facebook| JSON "SoundCloudDL(link)"| Download do SoundCloud| JSON "mediafireDL(link)"| Download do MediaFire| JSON

Exemplos

// YouTube — vídeo const video = await api.playVideo('música de exemplo'); // Buffer

// YouTube — áudio const audio = await api.playAudio('música de exemplo'); // JSON

// YouTube — download por link const youtube = await api.ytdl( 'https://youtube.com/watch?v=xxx' ); // JSON

// TikTok — vídeo const tiktok = await api.ttkdl( 'https://vm.tiktok.com/xxx' ); // JSON

// TikTok — imagens/slides const slides = await api.ttkimg( 'https://vm.tiktok.com/xxx' ); // JSON

// Kwai const kwai = await api.kwaidl('https://kwai-video.com/p/xxx'); // JSON

// Pinterest — termo de pesquisa ou URL const pinterest = await api.pinterest('anime aesthetic'); // JSON

// Spotify const spotify = await api.spotify( 'https://open.spotify.com/track/xxx' ); // JSON

// Instagram const instagram = await api.igdl( 'https://www.instagram.com/p/xxx' ); // JSON

// Facebook const facebook = await api.FacebookDL( 'https://www.facebook.com/watch/?v=xxx' ); // JSON

// SoundCloud const soundcloud = await api.SoundCloudDL( 'https://soundcloud.com/user/track' ); // JSON

// MediaFire const mediafire = await api.mediafireDL( 'https://www.mediafire.com/file/xxx' ); // JSON

Ferramentas e inteligência artificial

Método| Descrição| Retorno "shazam(audioUrl)"| Identificação de músicas por URL de áudio| JSON "gpt(query)"| Consulta à IA GPT| JSON "groq(query)"| Consulta à IA Groq| JSON "gemini(query)"| Consulta à IA Gemini| JSON

// Identificação musical const musica = await api.shazam( 'https://exemplo.com/audio.mp3' ); // JSON

// Inteligências artificiais const gpt = await api.gpt('O que é JavaScript?'); // JSON const groq = await api.groq('O que é JavaScript?'); // JSON const gemini = await api.gemini('O que é JavaScript?'); // JSON

Geradores

Método| Descrição| Retorno "gnicks(nick)"| Geração de nicks| JSON "qrcode(texto)"| Geração de QR Code| "Buffer"

// Gerar nicks const nicks = await api.gnicks('Dev World'); // JSON

// Gerar QR Code const qr = await api.qrcode('https://api.devworldbr.site'); // Buffer

Pesquisas

Método| Descrição| Retorno "ytsearch(query)"| Pesquisa no YouTube, versão 1| JSON "ytsearch_v2(query)"| Pesquisa no YouTube, versão 2| JSON "wallpaper(query)"| Pesquisa de wallpapers| JSON

const videos = await api.ytsearch('título do vídeo'); // JSON

const videosV2 = await api.ytsearch_v2('título do vídeo'); // JSON

const wallpapers = await api.wallpaper('carros'); // JSON

Anime

Método| Descrição| Retorno "metadinha()"| Obtém uma metadinha aleatória| JSON

const resultado = await api.metadinha(); // JSON

Figurinhas

Todos os métodos desta categoria retornam "Buffer".

Método| Descrição "brat(text)"| Gera imagem Brat "bratVideo(text)"| Gera vídeo/GIF Brat "randomFigurinha()"| Figurinha aleatória "emojiFigurinha()"| Figurinha de emoji "animeFigurinha()"| Figurinha de anime "engracadasFigurinha()"| Figurinha engraçada "raivaFigurinha()"| Figurinha de raiva "desenhoFigurinha()"| Figurinha de desenho "animaisFigurinha()"| Figurinha de animais "bebeFigurinha()"| Figurinha de bebê "coreanaFigurinha()"| Figurinha coreana "florkFigurinha()"| Figurinha Flork

Exemplos

const brat = await api.brat('Dev World'); // Buffer

const bratGif = await api.bratVideo('Dev World'); // Buffer

const aleatoria = await api.randomFigurinha(); // Buffer

const emoji = await api.emojiFigurinha(); // Buffer

const anime = await api.animeFigurinha(); // Buffer

const engraçada = await api.engracadasFigurinha(); // Buffer

const raiva = await api.raivaFigurinha(); // Buffer

const desenho = await api.desenhoFigurinha(); // Buffer

const animais = await api.animaisFigurinha(); // Buffer

const bebe = await api.bebeFigurinha(); // Buffer

const coreana = await api.coreanaFigurinha(); // Buffer

const flork = await api.florkFigurinha(); // Buffer

Logos

Os métodos de logos retornam "Buffer", contendo o resultado gerado.

Método| Descrição| Retorno "logos1Texto(modelo, texto)"| Geração de logo com um texto| "Buffer" "logos2Textos(modelo, texto1, texto2)"| Geração de logo com dois textos| "Buffer"

// Logo com um texto const logo1 = await api.logos1Texto('darkgreen', 'Dev World'); // Buffer

//Modelos disponíveis: darkgreen glitch write advancedglow typography pixelglitch neonglitch flag flag3d deleting blackpink glowing underwater logomaker cartoon papercut watercolor affectclouds blackpinklogo gradient summerbeach luxurygold multicoloredneon sandsummer galaxywallpaper 1917 markingneon royal freecreate galaxy lighteffects dragonball neondevil frozen wooden3d metal3d ligatures 3druby sunset hackerneon cemetery halloween horror blood joker clouds grafite grafite2 estrelas colorido desfoque zombie naruto aniversario amongus

// Logo com dois textos const logo2 = await api.logos2Textos( 'pornhub', 'Dev', 'World' ); // Buffer

//Modelos disponíveis: pornhub blackpink2 deadpool amongus2 thor neon stone3d captainamerica graffiti avengers vintage tiktok buoys wood space3d wolf steel lattering

Importante: os parâmetros "modelo" devem corresponder aos modelos disponíveis na SDK. Os nomes são validados pelo próprio pacote; consulte os modelos aceitos antes de realizar a chamada.

Entendendo os retornos

A SDK trabalha principalmente com dois tipos de retorno:

• JSON: objeto ou dados retornados pela API, que podem ser consultados normalmente.
• Buffer: conteúdo binário, utilizado em arquivos de mídia, imagens, figurinhas, logos e outros recursos.

Para verificar se um resultado é um "Buffer":

const resultado = await api.qrcode('https://api.devworldbr.site');

console.log(Buffer.isBuffer(resultado)); // true

Não espere um objeto JSON nos métodos identificados como "Buffer".

Tratamento de erros

Os métodos com parâmetros obrigatórios lançam um erro quando o argumento não é informado. Utilize "try/catch" para tratar falhas durante as requisições.

async function main() { try { const resultado = await api.ytdl( 'https://youtube.com/watch?v=xxx' );

console.log(resultado); // JSON

} catch (error) { console.error('Erro na requisição:', error.message); } }

main();

Links oficiais

• Site e documentação da API: https://api.devworldbr.site
• Pacote NPM: https://www.npmjs.com/package/devworldbr-api

Crie sua conta e colabore com o projeto

Para aproveitar todos os recursos e acompanhar as novidades da DevWorld BR, crie sua conta em nosso site.

Se você quiser contribuir com o desenvolvimento e a manutenção do projeto, acesse a aba “Colaborar”. Por meio dela, você pode enviar qualquer valor para apoiar a DevWorld BR e ajudar a manter nossos serviços ativos e em constante evolução.

Toda contribuição é muito importante para nós.