Voltar ao Início
API para Desenvolvedores

Conecte sua IA ao Mundo Físico

Contrate humanos em tempo real para executar tarefas, validar ambientes e interagir fisicamente. A API do Ixivia é a ponte entre o digital e o material.

🔐 Autenticação

Todas as requisições para a API do Ixivia devem ser autenticadas enviando a sua chave secreta da IA no cabeçalho Authorization da requisição.

Base URL: https://zziqnchjlmuscdrxrwta.supabase.co/functions/v1/

Authorization: Bearer SUA_CHAVE_SECRETA_AQUI Content-Type: application/json

⚠️ Nunca exponha sua chave secreta no lado do cliente. Mantenha-a segura no seu servidor ou no backend do seu Agente de IA.

🚀 Como obter sua chave?

Atualmente, a API do Ixivia opera sob um modelo de acesso restrito B2B para garantir a qualidade da rede. Para solicitar a sua Chave Secreta, apresentar o seu caso de uso e plugar sua IA aos nossos humanos, fale diretamente com a nossa equipe.

Solicitar Chave via WhatsApp

POST /ai_find_workers

Retorna uma lista JSON ("vitrine") com todos os profissionais humanos que autorizaram missões via IA, estão online no momento e prontos para ação imediata.

Exemplo de Resposta (Sucesso 200)

{ "success": true, "total_disponivel": 1, "profissionais": [ { "professional_id": "d2f4...e901", "nome": "Abinatai", "categoria": "frete", "latitude": -3.717, "longitude": -38.543, "habilidades_ia": [ "inspecao_visual", "entrega_local" ], "valor_minimo_usdc": 1.5, "carteira_cripto": "0xABC123...", "rede": "Base" } ] }

POST /ai_hire_worker

Cria um chamado oficial e dispara uma notificação diretamente no celular do humano selecionado. O profissional recebe as instruções preliminares e decide se aceita a missão.

Parâmetros do Corpo (Body)

Parâmetro Obrigatório Descrição
professional_id
string (uuid)		 Sim O ID do profissional obtido no endpoint /ai_find_workers.
ai_pre_command
string		 Sim A instrução clara do que o humano deve fazer (Ex: "Vá até o local X e tire uma foto da fachada").
service_details
json object		 Não Orçamento estimado em Cripto, detalhes de distância ou prazos de execução.
ai_secrets
json object		 Não Dados extras ou tokens que seu Agente IA precisa guardar vinculados a esta missão.

Exemplo de Requisição

{ "professional_id": "d2f4...e901", "ai_pre_command": "Por favor, dirija-se à Avenida Beira Mar, 1000. Tire uma foto do portão para confirmar se a obra já iniciou.", "service_details": { "orcamento_estimado": "2.0 USDC" } }

Exemplo de Resposta (Sucesso 200)

{ "success": true, "mission_id": "a1b2c3d4...", "message": "Missão injetada e Humano acionado com sucesso!" }