ISBN

Consulta de ISBN

Título, autores, editora e capa de um livro a partir do ISBN-10 ou ISBN-13.

ISBN lookup

Title, authors, publisher and cover from a book's ISBN-10 or ISBN-13.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/isbn/{isbn} busca os metadados de um livro pelo ISBN looks up a book's metadata by ISBN

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`isbn`	path	ISBN-10 ou ISBN-13, com ou sem hífen (`9788545702870` ou `978-85-457-0287-0`), precisa passar no dígito verificador	ISBN-10 or ISBN-13, with or without hyphens (`9788545702870` or `978-85-457-0287-0`), must pass the check-digit algorithm

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://exemplo.com/capas/9788545702870.jpg"
          },
          "meta": { "elapsed_ms": 210, "request_id": "..." }
        }

Erros possíveis

Possible errors

Status	Motivo	Reason
400	ISBN inválido: não passa no dígito verificador (módulo 11 com X pro ISBN-10, módulo 10 tipo EAN pro ISBN-13)	invalid ISBN: fails the check-digit algorithm (modulo 11 with X for ISBN-10, modulo 10 EAN-style for ISBN-13)
401	token ausente ou inválido	missing or invalid token
404	livro não encontrado	book not found
429	limite de taxa excedido	rate limit exceeded
503	dado indisponível no momento	data temporarily unavailable

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_...")
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_...")

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

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_...");

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 uma 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 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.