SDK JavaScript da Nyqo

// 1 — cliente (browser: mesma origem; demo local responde sozinho)
const nyqo = Nyqo.createClient({ apiKey: "nyq_sua_chave_aqui" });

// 2 — Nyqo Buscas (slug data-query, quota diária separada)
const busca = await nyqo.buscas.query({ type: "cpf", value: "12345678901" });

// 3 — erros padronizados (NyqoError: status/code/retryAfter)
try {
  console.log(busca);
} catch (err) {
  if (err.code === "rate_limited") {
    await new Promise((r) => setTimeout(r, err.retryAfter * 1000));
  }
  throw err;
}

// Recomendado: Authorization Bearer (padrão do SDK)
Nyqo.createClient({ apiKey: "nyq_sua_chave_aqui" });

// Alternativa: header X-API-Key
Nyqo.createClient({ apiKey: "nyq_sua_chave_aqui", authMode: "x-api-key" });

// Billing = SESSÃO same-origin (nyq_ NÃO autentica lá)
await nyqo.billing.subscription(); // logado no painel/site

import { NyqoError } from "./nyqo-sdk.js"; // browser: Nyqo.NyqoError

try {
  await nyqo.search.web("nyqo");
} catch (err) {
  console.log(err.status, err.code, err.retryAfter);
  // 401 unauthorized  — sem chave ou chave inválida (msk_ legada cai aqui)
  // 403 forbidden     — sem plano ativo, rota fora do plano/escopo da chave
  // 429 rate_limited  — quota estourada; err.retryAfter = segundos do
  //                     header Retry-After (60 janelas · 86400 Nyqo Buscas)
}

"""Nyqo Buscas (data-query) — POST https://api.nyqo.dev/api/v1/consultas."""
import os
import sys

import requests

BASE_URL = "https://api.nyqo.dev"
API_KEY = os.environ.get("NYQO_API_KEY", "nyq_sua_chave_aqui")


def main() -> None:
    try:
        res = requests.post(
            f"{BASE_URL}/api/v1/consultas",
            json={"type": "cpf", "value": "12345678901", "format": "json"},
            headers={"Authorization": f"Bearer {API_KEY}"},
            timeout=30,
        )
    except requests.RequestException as exc:  # rede, DNS, timeout
        print(f"erro de rede: {exc}", file=sys.stderr)
        raise SystemExit(1)
    if res.status_code == 401:
        print("401: chave ausente ou inválida (use nyq_...)", file=sys.stderr)
        raise SystemExit(1)
    if res.status_code == 403:
        print("403: sem plano ativo ou rota fora do escopo", file=sys.stderr)
        raise SystemExit(1)
    if res.status_code == 429:
        retry = res.headers.get("Retry-After", "86400")
        print(f"429: quota Nyqo Buscas — Retry-After: {retry}s", file=sys.stderr)
        raise SystemExit(1)
    res.raise_for_status()
    print(res.json())


if __name__ == "__main__":
    main()