Saltar para o conteúdo

Programadores

Desenvolva com a Route Royal

O SDK, a API, os webhooks, as apps OAuth e o servidor MCP, para os seus próprios sites, apps e agentes. As ferramentas de programador estão no portal, aberto às organizações a quem demos acesso de programador.

  1. Um programador com acesso

  2. Sessão iniciadaA sua conta Route Royal
  3. A sua organizaçãoO acesso pertence-lhe
  4. A sua funçãoPode gerir definições de programador
  5. Acesso de programadorConcedido à sua organização
  6. Portal de programadorAutorizado

Todas as verificações passaram: as chaves, as apps e os webhooks são seus para gerir.

Com o que desenvolve

Cinco formas de entrar

Cada uma funciona dentro dos dados da sua organização e das permissões que conceder.

  • Next.js SDK

    Hooks tipados para o navegador e clientes para o servidor: autenticação, anúncios, marcações, pedidos de informação, publicações, comércio e análises para sites headless. Este site funciona com ele.

  • REST API

    Leia e escreva os dados da sua organização em api.routeroyal.com, com chaves limitadas ao que cada integração precisa.

  • Webhooks

    Eventos de contactos, negócios, imóveis, produtos, encomendas, pagamentos e muito mais, assinados com HMAC-SHA256 para poder confirmar que vêm de nós.

  • Apps OAuth

    Permita que as pessoas iniciem sessão com a Route Royal e aja em nome delas através de OAuth 2.0: códigos de autorização, tokens e revogação.

  • Servidor MCP

    Dê aos seus próprios agentes as ferramentas da Route Royal através do Model Context Protocol, dentro das permissões que conceder.

Como obter acesso

Do pedido às chaves em produção

  1. 1

    Peça acesso

    Diga-nos o que está a desenvolver e para que organização.

  2. 2

    Nós ativamos

    Ativamos o acesso de programador para a sua organização, em condições que acordamos consigo.

  3. 3

    Crie as suas chaves

    Inicie sessão, registe o seu domínio, verifique-o por DNS e crie uma chave publicável e uma chave secreta.

  4. 4

    Entre em produção

    Desenvolva com chaves de teste e passe às chaves reais quando lançar.

Chaves

Duas chaves, separadas

Cada chave do SDK pertence a um domínio que verificou. A chave completa é mostrada uma só vez e guardamos apenas o seu hash.

  • As chaves publicáveis (pk_) só leem, por isso são seguras no navegador.
  • As chaves secretas (sk_) também escrevem, por isso ficam no seu servidor.
  • Cada chave está ligada a um domínio verificado e pode ter data de validade e uma lista de IPs permitidos.
  • Os pedidos têm limite de frequência, para que nenhuma integração prejudique as outras.
.env.local
NEXT_PUBLIC_ROUTEROYAL_DOMAIN=www.example.com
NEXT_PUBLIC_ROUTEROYAL_PUBLIC_KEY=pk_test_…

# Só no servidor: nunca em código do navegador
ROUTEROYAL_SECRET_KEY=sk_test_…

Perguntas

O que os programadores perguntam

Quem pode ter acesso de programador?

As organizações na Route Royal. Concedemo-lo por organização e, dentro dela, só o podem usar as pessoas cuja função permite gerir as definições de programador.

O acesso de programador tem um custo adicional?

Acordamos as condições com cada organização quando concedemos o acesso. Fale connosco e dizemos-lhe o que se aplica ao que está a desenvolver.

Onde está a documentação?

Vem com o acesso. O SDK é um pacote privado com o guia incluído, e acompanhamos cada nova integração com a equipa que a desenvolve.

Preciso de acesso de programador para usar o Claude ou o ChatGPT com a Route Royal?

Não. Ligar o Claude ou o ChatGPT à sua organização faz parte de IA e Q. O acesso de programador serve para desenvolver os seus próprios sites, apps e agentes.

Existem limites de pedidos?

Sim. Cada chave e token tem limite de frequência, e os agentes de IA têm limites próprios por minuto e por sessão. Indicamos-lhe os limites aplicáveis quando concedemos o acesso.

Já há algo desenvolvido com isto?

Este site. As notícias são publicações da Route Royal lidas através do SDK, tal como o seu site leria os seus anúncios, marcações ou publicações.

Acesso de programador

Faça a sua primeira chamada à Route Royal

O acesso de programador é concedido por organização. Diga-nos o que está a construir e para que organização. Assim que estiver ativo, cria as suas chaves no portal e faz esta chamada com as suas.

Os pedidos são feitos por email para support@routeroyal.com.

lib/news.ts
Saída

Dois artigos, lidos no seu servidor com uma chave publicável: é assim que este site lê as suas notícias.

Chaves e dados de exemplo