Utviklerguide

Fra tilgangstoken til første SMS

Kom i gang med REST API, OAuth 2.0 og åpen utviklerdokumentasjon. API-tilgang følger med alle Intellipush-kontoer.

  • Ingen månedsavgift for plattformen
  • Ingen bindingstid
  • SMS credits med 24 måneders gyldighet

1. Autentiser

Sett opp API-tilgang og hent OAuth 2.0-token slik dokumentasjonen beskriver.

2. Bygg forespørselen

Følg dokumentasjonen for mottaker, avsender og meldingsinnhold.

3. Håndter svaret

Ta vare på relevante tekniske referanser, og håndter feil eksplisitt.

Praktisk oversikt

Bygg den første integrasjonen steg for steg

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

Fra utvikling til produksjonsklar løsning

Sørg for at hvert trinn kan følges opp, uten at meldingsinnhold eller persondata blir en del av standardloggene.

  1. 01

    Opprett tilgang

    Følg dokumentasjonen for konto- og API-tilgang. Avklar hvilke miljøer og personer som faktisk trenger tilgang til hemmelighetene.

  2. 02

    Hent og håndter token

    Bruk OAuth 2.0 som beskrevet. Lagre token og klienthemmeligheter sikkert, roter dem ved behov, og legg dem aldri i et åpent kodearkiv.

  3. 03

    Bygg forespørselen

    Valider mottaker, avsender og tekst før kallet. Bruk dokumenterte felt fremfor antakelser, og bygg inn en kontroll mot utilsiktede masseutsendinger.

  4. 04

    Tolk tekniske svar

    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.

  5. 05

    Test relevante tilfeller

    Test gyldige og ugyldige nummer, tegnsett, lange meldinger, utilgjengelig tjeneste og gjentatte forsøk. Start med egne mottakere og lavt volum.

  6. 06

    Planlegg drift

    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.

Kjørbar quickstart

Hent token og opprett én SMS

Eksemplene følger gjeldende OpenAPI-kontrakt. Bytt bare ut miljøvariablene og bruk et testnummer du selv kontrollerer.

  1. 01

    Oppbevar tilgangsdata som hemmeligheter

    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.

    shell
    export INTELLIPUSH_API_ID="your_api_id"
    export INTELLIPUSH_API_SECRET="your_api_secret"
  2. 02

    Hent et OAuth 2.0-token

    Token-endepunktet bruker HTTP Basic med API ID som brukernavn og API Secret som passord. Svaret inneholder et tidsbegrenset access token.

    cURL
    curl --request POST \
      --url https://api.intellipush.com/oauth2/token \
      --user "$INTELLIPUSH_API_ID:$INTELLIPUSH_API_SECRET" \
      --header "Content-Type: application/json" \
      --data '{"grant_type":"client_credentials"}'
    Eksempel på tokensvar
    {
      "access_token": "eyJ...",
      "expires_in": 3600,
      "token_type": "Bearer",
      "scope": ""
    }
  3. 03

    Opprett én SMS

    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.

    cURL
    export INTELLIPUSH_ACCESS_TOKEN="your_access_token"
    
    curl --request POST \
      --url https://api.intellipush.com/restv2/sms/create \
      --header "Authorization: Bearer $INTELLIPUSH_ACCESS_TOKEN" \
      --header "Content-Type: application/json" \
      --data '{
        "message": "Your appointment is confirmed.",
        "countrycode": "+47",
        "phonenumber": "12345678"
      }'
    Eksempel på godkjent svar
    {
      "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."
    }
  4. 04

    Skill mellom opprettet og levert

    Et godkjent opprettelsessvar betyr at meldingen er registrert. Bruk ID-en fra svaret mot statusendepunktet når arbeidsflyten trenger leveringsinformasjon.

    cURL
    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

Samme kontrakt i Node.js og Python

Eksemplene bruker miljøvariabler og sender én reell SMS.

Node.js 18+
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/oauth2/token', {
  method: 'POST',
  headers: {
    Authorization: `Basic ${basic}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ grant_type: 'client_credentials' })
});
if (!tokenResponse.ok) throw new Error(`Token request failed (${tokenResponse.status})`);
const { access_token } = await tokenResponse.json();

const smsResponse = await fetch('https://api.intellipush.com/restv2/sms/create', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${access_token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    message: 'Your appointment is confirmed.',
    countrycode: '+47',
    phonenumber: '12345678'
  })
});
if (!smsResponse.ok) throw new Error(`SMS request failed (${smsResponse.status})`);
console.log(await smsResponse.json());
Python 3
import base64
import json
import os
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/oauth2/token',
    data=json.dumps({'grant_type': 'client_credentials'}).encode(),
    headers={'Authorization': f'Basic {basic}', 'Content-Type': 'application/json'},
    method='POST'
)
with urlopen(token_request) 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'},
    method='POST'
)
with urlopen(sms_request) as response:
    print(json.load(response))

Teknisk kilde kontrollert 16. august 2026: Intellipush REST API, OpenAPI 3.1.

I praksis

Nyttige hjelpemidler før første kall

Kontroller data og tekst tidlig, og gå til API-dokumentasjonen for den tekniske kontrakten.

Valider telefonnumre

Normaliser internasjonale nummer før de blir en del av en forespørsel.

Kontroller meldingslengde

Se hvordan tegnsett og innhold påvirker antall SMS-segmenter.

Be om teknisk avklaring

Kontakt Intellipush dersom løsningsdesign, volum eller ønsket arbeidsflyt trenger en faglig gjennomgang.

Kom i gang

Start gratis. Betal når du sender.

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.