Utvecklare

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.

Snabbstart OpenAPI-specifikation

Snabbstart

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

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

Hitta presentkort för matbutiker i Kanada

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

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

Läs valfri sida som Markdown

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

Referens

Ändpunkter

Alla sökvägar är relativa till https://giftcards.bidali.com. OpenAPI-dokumentet beskriver varje parameter och svar.

Ändpunkter
Sökväg	Metod	Vad den returnerar
`/api/v1`	`GET`	Describe the Catalogue API
`/api/v1/countries`	`GET`	List the countries with gift cards
`/api/v1/categories`	`GET`	List the gift card categories
`/api/v1/currencies`	`GET`	List the currencies gift cards are priced in
`/api/v1/countries/{country}/brands`	`GET`	List the brands on sale in a country
`/api/v1/countries/{country}/brands/{brand}`	`GET`	Get one brand: amounts, redemption and terms
`/api/v1/openapi.json`	`GET`	Get this OpenAPI document as JSON
`/api/v1/openapi.yaml`	`GET`	Get this OpenAPI document as YAML

Maskinläsbart

Allt en agent kan läsa

OpenAPI 3.1

/openapi.json och /openapi.yaml beskriver varje ändpunkt, parameter och svar, för SDK-generatorer och verktygsanrop.

Markdown-sidor

Skicka Accept: text/markdown till valfri sida, eller lägg till .md i sökvägen (/index.md för startsidan), för att få den som Markdown.

llms.txt

/llms.txt beskriver butiken i klartext och när den passar att använda.

Webbplatskarta

/sitemap.xml listar alla sidor, med deras adress på varje språk.

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.

{
  "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 via kod

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.

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

Läs dokumentationen Gift Card API Kontakta sälj

Frågor från utvecklare

Behöver jag en API-nyckel?

Inte för katalog-API:et på den här webbplatsen: det är öppet och skrivskyddat. Bidalis Gift Card API, som lägger beställningar, använder API-nycklar.

Kan jag köpa ett presentkort med det här API:et?

Nej, det läser bara katalogen. Skicka personen till varumärkets sida på den här webbplatsen (links.page i varje svar) för att köpa, eller använd Bidalis Gift Card API för att köpa via kod.

Finns det en gräns för antalet anrop?

Det finns ingen publicerad gräns. Svar cachas i några minuter, så hämta en lista en gång och återanvänd den.

Finns det en MCP-server?

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