# How to implement a REST API?

> Em muitas ocasiões, precisamos enviar uma mensagem via solicitação HTTP é muito útil para enviar lembretes ou confirmações de Pedidos. Nesse caso, cada provedor implementa uma função handleCtx que permite injetar a...
>
> - **Canonical URL:** https://www.builderbot.app/pt/showcases/api-use
> - **Documentation Index:** https://www.builderbot.app/llms.txt
> - **Full Corpus:** https://www.builderbot.app/llms-full.txt

Em muitas ocasiões, precisamos enviar uma mensagem via solicitação HTTP é muito útil para enviar lembretes ou confirmações de Pedidos. Nesse caso, cada provedor implementa uma função `handleCtx` que permite injetar a instanciação do bot e acessar suas funções a partir de um controlador.

<Error>
É importante utilizar esta função sob a sua própria responsabilidade, uma vez que o uso abusivo pode ser considerado spam e o seu número pode ser bloqueado.
</Error>

## Send Single Message

  
  ```bash (Message)
  curl https://api.example.chat/v1/messages \
    -d number="34000000" \
    -d message="Hello!"
  ```
  

No exercício abaixo, você pode obter um exemplo de como funciona. É interessante entender que internamente a biblioteca já implementa uma versão muito leve do HTTP semelhante ao express, mas chamada [polka](https://github.com/lukeed/polka/tree/main).

```ts (app.ts)
import 'dotenv/config'
import { createBot, MemoryDB, createProvider } from '@builderbot/bot'
import { BaileysProvider } from '@builderbot/provider-baileys'
import flow from './flows';

const PORT = process.env.PORT ?? 3001

const main = async () => {
    const provider = createProvider(BaileysProvider)

    const { handleCtx, httpServer } = await createBot({
        database: new MemoryDB(),
        provider,
        flow,
    })

    httpServer(+PORT)

    provider.server.post('/v1/messages', handleCtx(async (bot, req, res) => {
        const { number, message } = req.body
        await bot.sendMessage(number, message, {})
        return res.end('send')
    }))
}

main()
```
---

## Send with Media

  
  ```bash (Media Link)
  curl https://api.example.chat/v1/messages \
    -d number="34000000" \
    -d message="Ey! send media"
  ```
  ```bash (Media Local)
  curl --location 'https://api.example.chat/v1/messages' \
  --form 'message="Ey! send media"' \
  --form 'number="34000000"' \
  --form 'file=@"/C:/local/image.png"'
  ```
  

No exemplo a seguir, você entenderá como enviar arquivos, imagens ou vídeos de uma api quando o arquivo estiver em um URL público ou também se quiser carregá-lo por meio de uma solicitação.

```ts (app-media.ts)
import 'dotenv/config'
import { createBot, MemoryDB, createProvider } from '@builderbot/bot'
import { BaileysProvider } from '@builderbot/provider-baileys'
import flow from './flows';

const PORT = process.env.PORT ?? 3001

const main = async () => {
    const provider = createProvider(BaileysProvider)

    const { handleCtx, httpServer } = await createBot({
        database: new MemoryDB(),
        provider,
        flow,
    })

    httpServer(+PORT)

    provider.server.post('/v1/messages', handleCtx(async (bot, req, res) => {
        const { number, message, media } = req.body
        await bot.sendMessage(number, message, { media }) // https://i.imgur.com/0HpzsEm.png
        return res.end('send')
    }))
}

main()
```
```ts (app-media.storage.ts)
import 'dotenv/config'
import { createBot, MemoryDB, createProvider } from '@builderbot/bot'
import { BaileysProvider } from '@builderbot/provider-baileys'
import multer from 'multer'
import flow from './flows';

const PORT = process.env.PORT ?? 3001

const storage = multer.diskStorage({
    destination: function (_, file, cb) {
        cb(null, './tmp/')
    },
    filename: function (_, file, cb) {
        cb(null, file.originalname)
    }
})
const upload = multer({ storage })

const main = async () => {
    const provider = createProvider(BaileysProvider)
    
    const { handleCtx, httpServer } = await createBot({
        database: new MemoryDB(),
        provider,
        flow,
    })

    httpServer(+PORT)

    provider.server
    .use(upload.single('file'))
    .post('/v1/messages', handleCtx(async (bot, req, res) => {
        const { number, message } = req.body
        await bot.sendMessage(number, message, { media: req.file.path })
        return res.end('send')
    }))
}

main()
```

---
