Element på landningssidor

Element-endpoints läser och ändrar innehållet på en specifik landningssida.

Endpoints

Metod	Sökväg	Beskrivning
GET	/v2/landings/{landingId}/elements	Lista sidans element.
GET	/v2/landings/{landingId}/elements/{elementId}	Läs ett element.
POST	/landings/{landingId}/elements	Skapa ett element.
PUT	/v2/landings/{landingId}/elements/{elementId}	Ersätt ett element.
DELETE	/v2/landings/{landingId}/elements/{elementId}	Radera ett element.

Endpointsen för att skapa element tillhör en äldre, fortfarande operativ API-struktur och ligger direkt under https://api.ip1sms.com, utan /v2. Övriga elementoperationer använder /v2.

Gemensamma egenskaper

{
  "type": "Title",
  "id": "element_abc123",
  "order": 0,
  "backgroundColor": "#f7f7f7",
  "foregroundColor": "#111111",
  "padding": "2",
  "margin": "2,0,2,0",
  "textAlignment": "Center",
  "font": "Roboto"
}

Fält	Beskrivning
type	Elementtyp: Title, TextBlock, Button, Image eller Video.
id	Elementets ID.
order	Sorteringsvärde i stigande ordning; standard null.
backgroundColor	Hexfärg, publicerad standard #f7f7f7.
foregroundColor	Hexfärg, publicerad standard #111.
padding	Ett värde eller fyra kommaseparerade värden 0–8.
margin	Ett värde eller fyra kommaseparerade värden 0–8.
textAlignment	Left, Center, Right eller Justified.
alignment	Mediejustering: Left, Center eller Right.
font	Namn på webbfont.

Den publicerade beskrivningen anger ordningen för fyra padding- och marginvärden som topp, botten, vänster, höger. Verifiera ordningen visuellt om klienten genererar dessa värden automatiskt.

Titel

{
  "type": "Title",
  "content": "Välkommen till kampanjen",
  "level": 1,
  "bold": false,
  "italic": false,
  "underline": false
}

level accepterar 1–5. Textformatfälten är boolean och har standardvärdet false.

Textblock

{
  "type": "TextBlock",
  "content": "Första stycket\n\nNästa stycke",
  "fontSize": 16
}

content tolkas som Markdown. fontSize anges i pixlar och har publicerad standard 16. Behandla externt innehåll som otillförlitligt och tillåt inte osanerad HTML.

Knapp

{
  "type": "Button",
  "content": "Boka nu",
  "link": "https://example.com/boka",
  "buttonType": "Standalone",
  "size": null,
  "buttonColor": "#89b642"
}

Fält	Värden
buttonType	Standalone eller Block.
size	sm, lg eller null.
buttonColor	Hexfärg, publicerad standard #89b642.

Bild

{
  "type": "Image",
  "link": "https://example.com/kampanjbild.png",
  "responsive": true,
  "alignment": "Center",
  "height": null,
  "width": null,
  "alt": "Beskrivning av kampanjbilden"
}

När responsive är true ignoreras enligt referensen fasta height och width. Sätt alltid en meningsfull alt-text när bilden förmedlar information.

Video

{
  "type": "Video",
  "link": "https://example.com/kampanjvideo.mp4",
  "responsive": true,
  "alignment": "Center",
  "height": null,
  "width": null,
  "alt": "Kampanjvideo",
  "previewLink": "https://example.com/forhandsbild.png",
  "showControls": true,
  "autoplay": false,
  "loop": false,
  "muted": false,
  "embed": false
}

previewLink är valfri. showControls, autoplay, loop, muted och embed är boolean. Undvik autoplay med ljud och ge användaren kontroller för att uppfylla grundläggande tillgänglighetskrav.