1. Autentiser
Sett opp API-tilgang og hent OAuth 2.0-token slik dokumentasjonen beskriver.
This page is also available in English.
Utviklerguide
Kom i gang med REST API, OAuth 2.0 og åpen utviklerdokumentasjon. API-tilgang følger med alle Intellipush-kontoer.
Sett opp API-tilgang og hent OAuth 2.0-token slik dokumentasjonen beskriver.
Følg dokumentasjonen for mottaker, avsender og meldingsinnhold.
Ta vare på relevante tekniske referanser, og håndter feil eksplisitt.
Praktisk oversikt
Start med gjeldende API-dokumentasjon. Der finner du de autoritative beskrivelsene av tilgang, felter og tekniske svar. Denne guiden viser hvordan du kan gå frem, men erstatter ikke dokumentasjonen.
Bestem hvilken hendelse som skal utløse meldingen, og hva systemet ditt må vite etterpå. Hold konfigurasjon og hemmeligheter adskilt fra applikasjonskoden. Normaliser telefonnumrene før forespørselen bygges, og kontroller meldingslengden før dere beregner forventet bruk.
Planlegg også driften før det første produksjonskallet. Det må være tydelig hvem som kan stanse flyten, følge opp tekniske feil og finne igjen en forespørsel uten å hente frem mer persondata enn nødvendig. Dokumenter valgene sammen med integrasjonen.
Slik gjør du det
Sørg for at hvert trinn kan følges opp, uten at meldingsinnhold eller persondata blir en del av standardloggene.
Følg dokumentasjonen for konto- og API-tilgang. Avklar hvilke miljøer og personer som faktisk trenger tilgang til hemmelighetene.
Bruk OAuth 2.0 som beskrevet. Lagre token og klienthemmeligheter sikkert, roter dem ved behov, og legg dem aldri i et åpent kodearkiv.
Valider mottaker, avsender og tekst før kallet. Bruk dokumenterte felt fremfor antakelser, og bygg inn en kontroll mot utilsiktede masseutsendinger.
Håndter både godkjente forespørsler og feil. Ta vare på korrelasjons- eller referanseverdier som trengs ved feilsøking, uten å kopiere hele meldingen til loggene.
Test gyldige og ugyldige nummer, tegnsett, lange meldinger, utilgjengelig tjeneste og gjentatte forsøk. Start med egne mottakere og lavt volum.
Sett grenser for tilgang og volum, overvåk feil på en personvernvennlig måte, og dokumenter hvem som følger opp når integrasjonen stopper.
Vi betjener virksomheter i Norge og Europa. SMS-destinasjoner, avsendertyper og valgfrie funksjoner må avklares for landet og kontooppsettet dere skal bruke.
Kjørbar quickstart
Eksemplene følger gjeldende OpenAPI-kontrakt. Bytt bare ut miljøvariablene og bruk et testnummer du selv kontrollerer.
Bruk API ID og API Secret som er utstedt for kontoen. Legg dem i sikre miljøvariabler – aldri i offentlig klientkode eller et åpent repository.
export INTELLIPUSH_API_ID="your_api_id"
export INTELLIPUSH_API_SECRET="your_api_secret"Token-endepunktet bruker HTTP Basic med API ID som brukernavn og API Secret som passord. Svaret inneholder et tidsbegrenset access token.
curl --request POST \
--url https://api.intellipush.com/restv2/token \
--user "$INTELLIPUSH_API_ID:$INTELLIPUSH_API_SECRET" \
--header "Content-Type: application/x-www-form-urlencoded" \
--data-urlencode "grant_type=client_credentials"{
"access_token": "ip_at_example_opaque_token_not_for_authentication",
"expires_in": 3600,
"token_type": "Bearer",
"scope": ""
}Sett access token i miljøvariabelen under. Kallet oppretter en reell SMS og kan bruke SMS credits, så start med ditt eget nummer og et lite volum.
export INTELLIPUSH_ACCESS_TOKEN="your_access_token"
# Persist one unique key per logical send; reuse only for the same payload.
export INTELLIPUSH_IDEMPOTENCY_KEY="your_persisted_unique_send_key"
curl --request POST \
--url https://api.intellipush.com/restv2/sms/create \
--header "Idempotency-Key: $INTELLIPUSH_IDEMPOTENCY_KEY" \
--header "Authorization: Bearer $INTELLIPUSH_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"message": "Your appointment is confirmed.",
"countrycode": "+47",
"phonenumber": "12345678"
}'{
"success": true,
"data": {
"id": 1210966,
"message": "Your appointment is confirmed.",
"countrycode": "+47",
"phonenumber": "+4712345678",
"sent": 0,
"failed": 0,
"deleted": 0
},
"status_message": "SMS was created successfully."
}Et godkjent opprettelsessvar betyr at meldingen er registrert. Bruk ID-en fra svaret mot statusendepunktet når arbeidsflyten trenger leveringsinformasjon.
curl --request POST \
--url https://api.intellipush.com/restv2/sms/status \
--header "Authorization: Bearer $INTELLIPUSH_ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{"id_array":[1210966]}'Flere språk
Eksemplene bruker miljøvariabler og sender én reell SMS. Lagre én unik nøkkel per logiske sending før første forsøk; bruk den samme bare med identisk forespørsel.
const apiId = process.env.INTELLIPUSH_API_ID;
const apiSecret = process.env.INTELLIPUSH_API_SECRET;
const basic = Buffer.from(`${apiId}:${apiSecret}`).toString('base64');
const tokenResponse = await fetch('https://api.intellipush.com/restv2/token', {
method: 'POST',
headers: {
Authorization: `Basic ${basic}`,
'Content-Type': 'application/x-www-form-urlencoded'
},
body: new URLSearchParams({ grant_type: 'client_credentials' }),
signal: AbortSignal.timeout(30000)
});
if (!tokenResponse.ok) throw new Error(`Token request failed (${tokenResponse.status})`);
const { access_token } = await tokenResponse.json();
const sendKey = process.env.INTELLIPUSH_IDEMPOTENCY_KEY;
if (!sendKey) throw new Error('Missing persisted send key');
const smsResponse = await fetch('https://api.intellipush.com/restv2/sms/create', {
method: 'POST',
headers: {
Authorization: `Bearer ${access_token}`,
'Idempotency-Key': sendKey,
'Content-Type': 'application/json'
},
body: JSON.stringify({
message: 'Your appointment is confirmed.',
countrycode: '+47',
phonenumber: '12345678'
}),
signal: AbortSignal.timeout(30000)
});
if (!smsResponse.ok) throw new Error(`SMS request failed (${smsResponse.status})`);
const result = await smsResponse.json();
if (result.success === false) throw new Error('SMS request rejected');
console.log('SMS request accepted'); // Do not log recipient data or message bodies.import base64
import json
import os
from urllib.parse import urlencode
from urllib.request import Request, urlopen
api_id = os.environ['INTELLIPUSH_API_ID']
api_secret = os.environ['INTELLIPUSH_API_SECRET']
basic = base64.b64encode(f'{api_id}:{api_secret}'.encode()).decode()
token_request = Request(
'https://api.intellipush.com/restv2/token',
data=urlencode({'grant_type': 'client_credentials'}).encode(),
headers={'Authorization': f'Basic {basic}', 'Content-Type': 'application/x-www-form-urlencoded'},
method='POST'
)
with urlopen(token_request, timeout=30) as response:
access_token = json.load(response)['access_token']
sms_request = Request(
'https://api.intellipush.com/restv2/sms/create',
data=json.dumps({
'message': 'Your appointment is confirmed.',
'countrycode': '+47',
'phonenumber': '12345678'
}).encode(),
headers={'Authorization': f'Bearer {access_token}', 'Content-Type': 'application/json',
'Idempotency-Key': os.environ['INTELLIPUSH_IDEMPOTENCY_KEY']},
method='POST'
)
with urlopen(sms_request, timeout=30) as response:
result = json.load(response)
if result.get('success') is False:
raise RuntimeError('SMS request rejected')
print('SMS request accepted') # Do not log recipient data or message bodies.Se driftsplanen for 409, usikre svar og statusoppfølging →
Tokenet er en ugjennomsiktig verdi, gyldig i 3 600 sekunder, uten refresh token. HTTP-status er fasit; status_message er ikke en stabil maskinkode. Skill HTTP-status fra leveringskoder. Håndter også 403, 405 og 409. Ikke gjenta et uklart opprettelseskall automatisk uten dokumentert idempotens: lagre én unik nøkkel per logiske sending og bruk samme nøkkel og identisk innhold ved gjentakelse innen 24 timer.
Teknisk kilde kontrollert 30. oktober 2026: Intellipush REST API 1.8.0, OpenAPI 3.1.2. Les rå OpenAPI-spesifikasjon (YAML)
I praksis
Kontroller data og tekst tidlig, og gå til API-dokumentasjonen for den tekniske kontrakten.
Normaliser internasjonale nummer før de blir en del av en forespørsel.
Se hvordan tegnsett og innhold påvirker antall SMS-segmenter.
Kontakt Intellipush dersom løsningsdesign, volum eller ønsket arbeidsflyt trenger en faglig gjennomgang.
Verktøy
Bruk verktøyene direkte i nettleseren.

Valider og normaliser telefonnumre før du importerer kontakter eller sender meldinger.
Åpne verktøy
Se antall tegn, tegnkoding og SMS-segmenter før du sender.
Åpne verktøy
Rydd telefonnumre og klargjør listen for import.
Åpne verktøyKom i gang
Opprett konto gratis og bruk portalen eller API-et. Kjøp SMS credits når du er klar til å sende – uten månedsavgift for plattformen eller bindingstid.