Consultar contexto da integração
GET /api/v1/integration/context
Reportar problema nesta página
Copie o relato, descreva a dificuldade e envie pelo suporte disponível no RuralZap. Não inclua chaves ou dados financeiros.
Abrir RuralZap para acessar o suporteA credencial determina o Space. x-space-id não seleciona nem amplia acesso.
Autenticação
Authorization: Bearer. A chave determina o Space. Confira permissões.
Parâmetros
Esta consulta não recebe parâmetros de query.
cURL
curl --fail-with-body "$RURALZAP_BASE_URL/api/v1/integration/context" \
-H "Authorization: Bearer $RURALZAP_API_KEY"TypeScript
// Execute no servidor com Node.js 22+ e tsx. Não registre o payload financeiro.
const base = process.env.RURALZAP_BASE_URL;
const key = process.env.RURALZAP_API_KEY;
if (!base || !key) throw new Error('Configure RURALZAP_BASE_URL e RURALZAP_API_KEY.');
const origin = new URL(base);
if (origin.protocol !== 'https:' || origin.username || origin.password || origin.pathname !== '/' || origin.search || origin.hash) throw new Error('Informe uma origem HTTPS sem caminho ou credenciais.');
const response = await fetch(new URL('/api/v1/integration/context', origin), {
headers: { Authorization: `Bearer ${key}` },
signal: AbortSignal.timeout(30000),
redirect: 'error',
});
if (!response.ok) throw new Error(`HTTP ${response.status}; consulte /guias/erros.`);
const data: unknown = await response.json();
// Valide data com /openapi.json antes de persistir. Preserve decimais como strings.
export { data };Python
"""Chamada única, Python 3, servidor. Não registra respostas financeiras."""
import json
import os
import urllib.request
from urllib.parse import urlsplit
base = os.environ['RURALZAP_BASE_URL']
key = os.environ['RURALZAP_API_KEY']
origin = urlsplit(base)
if origin.scheme != 'https' or not origin.netloc or origin.username or origin.password or origin.path not in ('', '/') or origin.query or origin.fragment:
raise ValueError('Informe uma origem HTTPS sem caminho ou credenciais.')
class NoRedirect(urllib.request.HTTPRedirectHandler):
def redirect_request(self, req, fp, code, msg, headers, newurl):
return None
request = urllib.request.Request(base.rstrip('/') + '/api/v1/integration/context', headers={'Authorization': 'Bearer ' + key})
with urllib.request.build_opener(NoRedirect).open(request, timeout=30) as response:
data = json.load(response)
# Valide data com /openapi.json. Preserve dinheiro como string ou Decimal.Resposta 200
Exemplo sintético, sem dados de clientes.
{
"integrationId": "019a1000-0000-7000-8000-000000000001",
"spaceId": "019a1000-0000-7000-8000-000000000001",
"scopes": [
"balances:read"
],
"capabilities": [
"context",
"wallets",
"balances"
]
}Campos
| Campo | Tipo | Obrigatório | Significado |
|---|---|---|---|
integrationId | string | Sim | uuid |
spaceId | string | Sim | uuid |
scopes | array | Sim | |
capabilities | array | Sim | Rotas disponíveis na interseção dos escopos e direitos atuais. |
Erros
| HTTP | Descrição |
|---|---|
| 400 | Parâmetros inválidos ou moeda não suportada |
| 401 | Credencial inválida, expirada, revogada ou de outro ambiente |
| 403 | Permissão ou acesso ao recurso indisponível |
| 404 | Filtro ou recurso fora do Space |
| 429 | Limite excedido; respeite Retry-After |
| 503 | Indisponibilidade temporária |
Consulte causas e soluções. Erros públicos usam error.code, error.message e error.requestId. Em 429, aguarde Retry-After.
Downloads
cURL · TypeScript · Python · OpenAPI