API Dokumentation

Integrer gavekort i din applikation via REST API

Base URL

https://api.giftflow.dk

Autentifikation

Alle requests skal inkludere en API-nøgle i Authorization header:

Authorization: Bearer YOUR_API_KEY

Find din API-nøgle i virksomhedens integrationssettings under "API-nøgler".

Endpoints

Opret gavekort

Opret og send et nyt gavekort til en modtager

POST

Endpoint

POST /functions/apiCreateGiftCard

Request Body

product_id

string (påkrævet) - ID på gavekortprodukt

amount

number (påkrævet) - Beløb i DKK

sender_name

string (påkrævet) - Afsenders navn

receiver_name

string (påkrævet) - Modtagers navn

receiver_email

string (påkrævet) - Modtagers e-mail

message

string (valgfrit) - Besked på gavekort

template_id

string (valgfrit) - Design-skabelon ID

template_color

string (valgfrit) - Hex-farve

Response Fields

success

boolean

gift_card_code

string - Gavekort-kode

gift_card_id

string - Gavekort ID

message

string

Eksempel Request

{
  "product_id": "prod_123",
  "amount": 500,
  "sender_name": "John Doe",
  "receiver_name": "Jane Smith",
  "receiver_email": "jane@example.com",
  "message": "Glad fødselsdag!"
}

Tjek gavekort-saldo

Tjek restbeløb på et gavekort

POST

Endpoint

POST /functions/checkGiftCardBalance

Request Body

code

string (påkrævet) - Gavekort-kode

Response Fields

success

boolean

remaining_amount

number - Restbeløb i DKK

original_amount

number - Oprindeligt beløb

status

string - Status (active, fully_used, expired)

Eksempel Request

{
  "code": "GFC1234567890ABC"
}

Indløs gavekort

Indløs et gavekort og modtag koden

POST

Endpoint

POST /functions/claimGiftCard

Request Body

code

string (påkrævet) - Gavekort-kode

string (påkrævet) - Modtagers e-mail

Response Fields

success

boolean

message

string - Besked

gift_card_id

string

Eksempel Request

{
  "code": "GFC1234567890ABC",
  "email": "user@example.com"
}

Fejlhåndtering

• Status 400: Ugyldig request data

• Status 401: Manglende eller ugyldig API-nøgle

• Status 404: Ressource ikke fundet

• Status 500: Serverfejl

Rate Limits

API'en tillader op til 100 requests per minut per API-nøgle.