Endpoints

Endpoints

Parâmetros

Parameters

Exemplo

Example

curl https://api.alicercelabs.com.br/api/v1/isbn/9788545702870 \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": {
            "isbn": "9788545702870",
            "titulo": "Akira vol. 1",
            "subtitulo": "Part 1 - Tetsuo",
            "autores": ["Katsuhiro Ōtomo"],
            "editora": "Editora JBC",
            "ano_publicacao": "Jun, 2017",
            "paginas": 362,
            "capa_url": "https://covers.openlibrary.org/b/id/11890190-L.jpg",
            "meta": { "fonte": "open-library" }
          },
          "meta": { "elapsed_ms": 210, "request_id": "..." }
        }

meta.fonte dentro de data diz qual das duas fontes respondeu ("open-library" ou "brasilapi") — ver "Duas fontes" abaixo.

meta.fonte inside data says which of the two sources answered ("open-library" or "brasilapi") — see "Two sources" below.

Erros possíveis

Possible errors

Duas fontes

Two sources

Primeiro a Open Library, gratuita, sem chave, cobre livros publicados no Brasil e no mundo. Se ela não encontrar o ISBN, a chamada cai pra BrasilAPI, que mistura outros provedores, inclusive a CBL (a fonte "oficial" brasileira, paga e de acesso restrito) — o fallback aqui cobre lacuna real de cobertura entre provedores, não só disponibilidade.

First, Open Library, free, no key, covers books published in Brazil and worldwide. If it doesn't find the ISBN, the call falls through to BrasilAPI, which mixes in other providers, including CBL (the Brazilian "official" source, paid and access-restricted) — the fallback here covers a real coverage gap between providers, not just availability.

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Buscar livro por ISBN

Look up a book by ISBN

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...") // ou um token JWT de login/register
ctx := context.Background()

book, err := client.ISBN.Get(ctx, "9788545702870")
if err != nil {
	panic(err)
}
fmt.Println(book.Titulo, book.Meta.Fonte)

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")  # ou um token JWT de login/register

book = client.isbn.get("9788545702870")
print(book["titulo"], book["meta"]["fonte"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_..."); // ou um token JWT de login/register

const book = await client.isbn.get("9788545702870");
console.log(book.titulo, book.meta.fonte);

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com token (JWT de login ou API key gerada no painel), 1.000/dia · 41/hora. Resposta em cache por 30 dias — metadado de livro publicado não muda.

100/day · 4/hour without a token, per calling IP; with one (a login JWT or an API key generated in the panel), 1,000/day · 41/hour. Response cached for 30 days — a published book's metadata doesn't change.