Cards

Observera att kort skapas som en del av ett meddelande via /bundles eller /conversations, men du kan hämta detaljer om dem efteråt via dessa endpoints.

Hämta samtliga cards för ett meddelande #

⚡Quick start #

💻

Quick start (cURL)

curl -X GET https://api.ip1.net/v3/messages/msg-12345/cards \
  -H "Authorization: Bearer DIN_API_TOKEN"

Anrop #

Endpoint: /messages/{messageId}/cards

Metod: GET

Exempel på anropsdata #

Detta anrop kräver ingen body. Meddelandets ID skickas i URL:en

📋

Anropsdata (URL)

https://api.ip1.net/v3/messages/65eb3d14f1234567890abcdef/cards

Fält för anropsdata #

Fältnamn	Beskrivning	Required	Typ	Exempel
messageId	ID för det meddelande som vars kort du vill lista	Ja	Query Param	`65eb3d14f1234567890abcdef`

Respons #

Returnerar en lista med de kort som ingår i meddelandet (t.ex. ett enskilt kort eller flera i en karusell).

Exempel på responsdata #

📋

Responsdata (JSON)

[
  {
    "id": "65eb3d14f1234567890a1b2c3d4",
    "messageId": "msg-12345",
    "type": 1,
    "order": 0,
    "title": "Vår stora sommarrea!",
    "content": "Klicka nedan för att se alla fantastiska erbjudanden.",
    "mediaUrl": "https://cdn.site.se/summer-sale.jpg",
    "height": 2,
    "width": 1,
    "orientation": 2,
    "suggestions": [
      {
        "text": "Se rean",
        "type": 1,
        "url": "https://site.se/rea"
      }
    ]
  }
]

Fält för responsdata #

Fältnamn	Beskrivning	Typ	Exempel
id	Unikt ID för kortet.	String	`65eb3d14f1234567890a1b2c3d4`
messageId	ID för meddelandet som kortet tillhör.	String	`65eb3d14f784682890abc24f`
type	Typ av kort.	String	”Carousell”
order	Kortets position (viktigt vid karuseller).	Integer	0
title	Rubriken på kortet (max 100 tecken).	String	”Vår stora sommarrea!”
content	Den beskrivande texten (max 2000 tecken).	String	”Klicka nedan…”
mediaUrl	URL till bild eller video.	URI	”https://cdn.se/bild.jpg”
height	Höjd (1=Small, 2=Medium, 3=Large).	Integer	2
width	Bredd (1=Small, 2=Large).	Integer	1
orientation	Orientering (1=Horisontell, 2=Vertikal).	Integer	2
suggestions	En lista med knappar kopplade direkt till kortet.	Array	[…]

Hämta förslag för ett specifikt kort #

Om du vill hämta enbart de knappar (suggestions) som hör till ett specifikt kort i ett meddelande.