Kom i gang
Sider i lister
Lister som kan bli lange, svarer én side om gangen. Du ber om neste side med verdien fra forrige svar.
Lister med cursor
De fleste listene, som GET /v1/sms, GET /v1/email og GET /v1/calls, tar limit og cursor. Svaret har listen og nextCursor.
Hent de siste 50 SMS-ene
curl "https://api.telkit.no/v1/sms?limit=50" \ -H "Authorization: Bearer $TELKIT_API_KEY"const response = await fetch("https://api.telkit.no/v1/sms?limit=50", { headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, },});const answer = await response.json();| Felt | Betyr |
|---|---|
limit | Hvor mange rader siden skal ha. Største verdi står i API-referansen for hver liste. |
cursor | Verdien av nextCursor fra forrige svar. Utelat den for første side. |
nextCursor | Send denne som cursor for å hente neste side. null betyr at det ikke er flere. |
Behandle nextCursor som en ugjennomsiktig tekst: lagre og send den videre, men ikke bygg den selv.
Hendelsesloggen leses etter posisjon
GET /v1/events er annerledes. Hver hendelse har en position, et tall som øker i den rekkefølgen hendelsene ble lagret. Du spør etter alt etter den siste posisjonen du har behandlet.
Les hendelsene etter posisjon 1200
curl "https://api.telkit.no/v1/events?after=1200&limit=100" \ -H "Authorization: Bearer $TELKIT_API_KEY"const response = await fetch("https://api.telkit.no/v1/events?after=1200&limit=100", { headers: { Authorization: `Bearer ${process.env.TELKIT_API_KEY}`, },});const answer = await response.json();| Felt | Betyr |
|---|---|
events | Hendelsene, eldste først. |
next | Send denne som after i neste kall. null betyr at siden nådde head. |
head | Den nyeste posisjonen i loggen. |
floor | Den høyeste posisjonen som er slettet fordi den var for gammel. |
Les mer i Hendelsesloggen og strømmen.