Overview

Getting Started

Use the public catalog without credentials, or authenticate with a seller API key for protected operations.

1. Choose the API

2. Call the Public Catalog API

curl --request GET \
  --url "https://alefba.eu/api/v1/catalog?page=1&limit=20" \
  --header "Accept: application/json"

3. Call a protected endpoint

curl --request GET \
  --url "https://alefba.eu/api/v1/ping" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer alefba_live_YOUR_API_KEY"

4. Handle errors

Protected endpoints can return 401 for missing or invalid credentials and 429 when the daily request limit has been reached.