Pular para o conteúdo principal

Spectra API

Inteligência de materiais industriais como API. Encontre materiais similares por especificação real, consulte o selo Spectra Check de confiabilidade, e integre tudo no seu fluxo de aprovação — sem planilha, sem e-mail, sem adivinhação.

A API é REST, versionada (/v1), e a referência é gerada a partir da spec OpenAPI canônica do backend.

curl "https://app.joinspectra.ai/api/v1/health"
# HTTP/1.1 200 OK
Quickstart →Da chave à primeira resposta em ~5 minutos.Autenticação →API Key vs JWT, escopo por org e workspace.Cookbook →5 receitas em curl, Python e TypeScript.API Reference →Todos os endpoints, sincronizada com o backend.

O essencial em 30 segundos​

Base URLhttps://app.joinspectra.ai/api/v1
AuthX-API-Key: spec_live_… (builder) ou Authorization: Bearer <jwt> (humano) — nunca os dois juntos
Versionamentoprefixo de path /v1
Paginaçãocursor (canônica) ou offset (legada) — veja Paginação
Rate limit30 requisições / 30 s → 429 RATE_LIMITED
Errosenvelope único Pattern H com errorCode + traceId

O contrato de erro​

Toda resposta de erro tem a mesma forma. Programe contra ela uma vez:

{
  "statusCode": 400,
  "errorCode": "VALIDATION_ERROR",
  "message": "material must be a UUID",
  "traceId": "b3f1c2a4-…",
  "timestamp": "2026-06-01T12:00:00.000Z",
  "details": { "field": "material" }
}

Use o errorCode (estável) na sua lógica — nunca o message. O traceId correlaciona incidentes na status page. Detalhes em Erros.