# Utviklerguide for Intellipush SMS API

Canonical URL: https://www.intellipush.com/utviklerguide/

Kjørbar vei fra OAuth 2.0 client credentials til én opprettet SMS.

## Token

Send POST til https://api.intellipush.com/restv2/token med API ID og API Secret som HTTP Basic, Content-Type application/x-www-form-urlencoded og grant_type=client_credentials.

## Opprett SMS

Send POST til https://api.intellipush.com/restv2/sms/create med Bearer-token og JSON-feltene message, countrycode og phonenumber. Kallet oppretter en reell SMS og kan bruke SMS credits.

## Produksjon

Bruk eget testnummer og lavt volum først. Tokenet er ugjennomsiktig, varer 3 600 sekunder og har ikke refresh token. Håndter HTTP 400, 401, 403, 405, 409 og 5xx; skill disse fra leveringskoder. status_message er ikke en stabil maskinkode. Opprettet er ikke levert: bruk returnert ID med POST /restv2/sms/status og id_array. Kontroller /capabilities før valgfrie funksjoner. Ved dokumentert idempotens: lagre én unik nøkkel per logiske sending og bruk samme nøkkel og identisk innhold ved gjentakelse innen 24 timer. Ikke send uklare opprettelseskall om igjen automatisk. Hold hemmeligheter utenfor klientkode.

## Hent token og opprett én SMS

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

### 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.

```sh
export INTELLIPUSH_API_ID="your_api_id"
export INTELLIPUSH_API_SECRET="your_api_secret"
```

### 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.

```sh
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"
```

#### Eksempel på tokensvar

```json
{
  "access_token": "ip_at_example_opaque_token_not_for_authentication",
  "expires_in": 3600,
  "token_type": "Bearer",
  "scope": ""
}
```

### 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.

```sh
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"
  }'
```

#### Eksempel på godkjent svar

```json
{
  "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."
}
```

### 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.

```sh
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]}'
```

### Samme kontrakt i Node.js og Python

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.

#### Node.js 18+

```javascript
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.
```

#### Python 3

```python
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.
```

### Før produksjonsbruk

Håndter 400-, 401- og 5xx-svar eksplisitt, beskytt hemmelighetene og bruk dokumentasjonen som fasit. Ta vare på X-Request-ID ved feilsøking. Kontroller /capabilities før du bruker valgfrie funksjoner; idempotens ved opprettelse krever at funksjonen er aktivert og at integrasjonen sender en egen Idempotency-Key.

[Se driftsplanen for 409, usikre svar og statusoppfølging](https://www.intellipush.com/sms-api-drift/)

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.

## Dokumentasjon

Vi betjener virksomheter i Norge og Europa. SMS-destinasjoner, avsendertyper og valgfrie funksjoner må avklares for landet og kontooppsettet dere skal bruke.

Teknisk kilde kontrollert 30. oktober 2026: Intellipush REST API 1.8.0, OpenAPI 3.1.2.

[Interaktiv API-dokumentasjon](https://api.intellipush.com/restv2/developer/)

[OpenAPI YAML](https://api.intellipush.com/restv2/developer/intellipush.yaml)
