# API för Bidalis presentkortsbutik

> Ett kostnadsfritt, skrivskyddat JSON-API för presentkortskatalogen på den här webbplatsen: länder, kategorier, valutor och varumärken, med belopp, inlösningsinstruktioner och villkor. Ingen registrering och ingen API-nyckel.

## Dina första anrop

Varje ändpunkt är ett GET-anrop som returnerar JSON. Kopiera ett kommando och kör det.

Lista länderna med presentkort

```sh
curl -s https://giftcards.bidali.com/api/v1/countries
```

Hitta presentkort för matbutiker i Kanada

```sh
curl -s "https://giftcards.bidali.com/api/v1/countries/canada/brands?category=groceries&limit=5"
```

Hämta ett varumärke: belopp, inlösen och villkor

```sh
curl -s https://giftcards.bidali.com/api/v1/countries/canada/brands/doordash-ca
```

Läs valfri sida som Markdown

```sh
curl -s -H "Accept: text/markdown" https://giftcards.bidali.com/brands/canada/doordash-ca
```

## Ändpunkter

- `GET /api/v1`: Describe the Catalogue API
- `GET /api/v1/countries`: List the countries with gift cards
- `GET /api/v1/categories`: List the gift card categories
- `GET /api/v1/currencies`: List the currencies gift cards are priced in
- `GET /api/v1/countries/{country}/brands`: List the brands on sale in a country
- `GET /api/v1/countries/{country}/brands/{brand}`: Get one brand: amounts, redemption and terms
- `GET /api/v1/openapi.json`: Get this OpenAPI document as JSON
- `GET /api/v1/openapi.yaml`: Get this OpenAPI document as YAML

## Allt en agent kan läsa

- OpenAPI 3.1: https://giftcards.bidali.com/openapi.json · https://giftcards.bidali.com/openapi.yaml
- Markdown: `Accept: text/markdown`, or https://giftcards.bidali.com/index.md
- llms.txt: https://giftcards.bidali.com/llms.txt
- Sitemap: https://giftcards.bidali.com/sitemap.xml

## Fel

Fel returneras som JSON, med den HTTP-status som passar: 400 för en saknad eller ogiltig parameter, 404 för ett okänt land, varumärke eller sökväg, 405 för alla metoder utom GET, och 502 eller 504 när katalogtjänsten fallerar. Fältet code ändras inte; fältet hint säger vad du ska göra härnäst.

```json
{ "error": { "code": "country_not_found", "message": "No country matches \"atlantis\".", "hint": "Use a slug or an ISO 3166-1 alpha-2 code from GET /api/v1/countries.", "docs": "https://giftcards.bidali.com/developers#errors" } }
```

Svar cachas i upp till fem minuter. En sida innehåller högst 100 varumärken: följ pagination.next för resten.

## Köp presentkort med Bidalis Gift Card API

Det här API:et läser bara katalogen. För att köpa presentkort från din egen programvara eller en AI-agent använder du Bidalis Gift Card API. Det fungerar med API-nycklar och har tidig åtkomst.

- Läs dokumentationen: https://docs.bidali.com
- Gift Card API: https://www.bidali.com/products/gift-card-api
- Kontakta sälj: https://www.bidali.com/contact?intent=sales

MCP-åtkomst är på väg.

## Other formats

- HTML page: https://giftcards.bidali.com/sv/developers
- This page as Markdown: https://giftcards.bidali.com/sv/developers.md
- Same data as JSON (Catalogue API): https://giftcards.bidali.com/api/v1
- Guide to this store for AI agents: https://giftcards.bidali.com/llms.txt
- Catalogue API reference (OpenAPI 3.1): https://giftcards.bidali.com/openapi.json

## Languages

[English](https://giftcards.bidali.com/developers.md) · [Español](https://giftcards.bidali.com/es/developers.md) · [Português](https://giftcards.bidali.com/pt/developers.md) · [Français](https://giftcards.bidali.com/fr/developers.md) · [Deutsch](https://giftcards.bidali.com/de/developers.md) · [Italiano](https://giftcards.bidali.com/it/developers.md) · [Polski](https://giftcards.bidali.com/pl/developers.md) · [Svenska](https://giftcards.bidali.com/sv/developers.md)