Pular para o conteúdo
EnglishFale com a genteEntrar

Documentos Crie os seus

Ligar os seus sistemas

Todo serviço tem link e chaves. Os seus apps e sistemas chamam com o cabeçalho que já sabem mandar.

Como outro sistema usa um serviçoO seu sistema chama o link do serviço; o trabalho é repartido entre três aparelhos; a resposta volta ao seu sistema.seu sistemaserviçoaparelhoso seu sistema chama o link, com a chaveo trabalho é repartidoos aparelhos trabalhamas partes voltama resposta chega ao seu sistemaComo outro sistema usa um serviçoO seu sistema chama o link do serviço; o trabalho é repartido entre três aparelhos; a resposta volta ao seu sistema.seu sistemaserviçoaparelhoso seu sistema chama o link, com a chaveo trabalho é repartidoos aparelhos trabalhamas partes voltama resposta chega ao seu sistema
Como outro sistema usa um serviço
  1. Crie uma chave para o serviçoNa página do serviço. Ela aparece uma vez só, e dá para revogar quando quiser.
  2. O seu sistema chama o linkCom a chave no cabeçalho que ele já sabe mandar, e o arquivo ou os dados no pedido.
  3. Os aparelhos fazem o trabalhoO orquestrador reparte, e os aparelhos livres buscam as partes.
  4. A resposta voltaNa hora, se for rápido, ou depois: o seu sistema acompanha o pedido, ou recebe um aviso assinado quando acabar.

Todo serviço, criado com IA, com código ou pronto, pode ser usado por pessoas na página dele e por outros sistemas pelo link. O seu ERP, o seu app, o seu site ou outro serviço podem chamá-lo.

A chave

  • Criada na página do serviço, com um nome que diz quem usa (“ERP do financeiro”, “App de campo”).
  • Mostrada uma vez só. Depois disso, aparece só o começo dela, com a última vez em que foi usada.
  • Revogável quando quiser, uma a uma, sem mexer nas outras.
  • Guardada só como impressão digital. Nem nós conseguimos ler uma chave de volta.

A página do serviço: o link, o exemplo de chamada já com a chave nova, e o aviso de que ela não aparece de novo.

O cabeçalho que o seu sistema já manda

Muitos sistemas só sabem mandar a chave de um jeito. O serviço aceita os mais comuns:

  • a chave como token no cabeçalho de autorização;
  • a chave num cabeçalho de chave de API;
  • a chave como usuário ou senha na autenticação básica;
  • nas funções, um cabeçalho com o nome que vocês escolherem.

Agora, ou depois

  • Trabalho curto responde na hora, com o resultado na resposta.
  • Trabalho mais longo é aceito na hora, e o seu sistema acompanha o pedido ou busca o resultado quando fica pronto.
  • Um aviso assinado pode ir ao seu sistema quando o trabalho acaba, para ele não precisar ficar perguntando.
  • Pedido repetido não roda duas vezes, e cada pedido tem um limite de quanto tempo ainda vale a pena fazê-lo.

A chamada exata, com o endereço real e exemplos, está na página de cada serviço, pronta para copiar.