Chame uma API via HTTP

Toda API do hub é chamada através do mesmo gateway, com a mesma chave e os mesmos headers de resposta.

Esta página é para desenvolvedores que chamam APIs a partir do próprio código. Está usando um agente de IA? Você não precisa de nada disso: veja Conectar agentes de IA (MCP).

Antes da sua primeira chamada

1. Obtenha sua chave de API.
2. Abra a API no catálogo e assine um plano (ou inicie o teste gratuito, quando houver um). Chamadas a uma API à qual você não está assinado retornam 401.

Formato da URL

https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}

A página da API monta essa URL para você na seção Endpoints, com os parâmetros de cada endpoint e exemplos de código em 15 linguagens de programação (cURL, JavaScript, Node.js, Python, PHP, Java, Go, C# e mais). Copie-a de lá em vez de montá-la manualmente.

Parâmetros de query (GET)

curl 'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}[email protected]' \
  -H 'Authorization: Bearer YOUR_API_KEY'

const res = await fetch(
  'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}[email protected]',
  { headers: { Authorization: `Bearer ${process.env.ZYLA_API_KEY}` } }
);
const data = await res.json();

import os, requests

r = requests.get(
    "https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}",
    params={"email": "[email protected]"},
    headers={"Authorization": f"Bearer {os.environ['ZYLA_API_KEY']}"},
)
print(r.status_code, r.json())

Corpo JSON (POST)

Use o método mostrado no endpoint. Um método diferente retorna 401 com Invalid method.

curl -X POST 'https://zylalabs.com/api/{api_id}/{api_name}/{endpoint_id}/{endpoint_name}' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"text": "Hello world"}'

Headers de resposta

Toda resposta bem-sucedida inclui seu uso, para que você possa controlar a taxa do seu lado:

O corpo é a resposta do provedor, retornada como está. Para erros levantados pelo próprio gateway (sem assinatura, limites, endpoint desconhecido), veja Planos, limites e erros.