Visão geral
As duas formas são OAuth 2.0 e geram o mesmo token: mesmas rotas /v1, mesmos escopos e mesmo header Authorization: Bearer. Muda só como o token é obtido.
Pense no token como um crachá
Pense no token como o crachá de um prédio: ele abre só as portas liberadas (os escopos) e vence depois de um tempo.
- Integração direta: o lojista pega na recepção (portal Developers) um login e senha e entrega para quem vai integrar. Com eles, a integração retira o crachá sempre que precisar.
- Conectar com BeeFood: a integradora manda o lojista até a recepção. Ele se identifica, escolhe o que liberar, e a recepção entrega o crachá direto para a integradora. Ninguém vê a senha de ninguém.
Nos dois casos o crachá é o mesmo e abre as mesmas portas. Muda só como ele foi obtido.
Comparativo
| Integração direta | Conectar com BeeFood | |
|---|---|---|
| Fluxo OAuth | Client Credentials | Authorization Code + PKCE |
| Quem cria a credencial | O lojista, no portal Developers | O próprio lojista, clicando num botão no site da integradora |
| A integradora recebe | clientId + clientSecret (copiados pelo lojista) | Tokens direto, sem ver segredo nenhum |
| Ideal para | Sistema próprio do lojista; integradora com poucos clientes | Integradoras com muitos lojistas (ex.: CRMs, marketplaces) |
| Precisa cadastro prévio na BeeFood | Não | Não |
Qual escolher?
- Você é o próprio lojista ou integra poucos restaurantes → Integração direta
- Você é uma integradora e quer um botão “Conectar com BeeFood” no seu sistema → Conectar com BeeFood