Pliing.
NorskEnglish

FOR UTVIKLERE. PÅ DINE ENHETER.

Fra API
til Pliing.

Deploy ferdig. Backup tatt. En jobb feilet. Send et API-kall, og få beskjed på Apple-enhetene du velger.

Utforsk API-et Se hvordan det henger sammen

PRIVAT BETA API først. iPhone og Mac som mottakere.

REQUEST → PUSHINTERAKTIVT EKSEMPEL
notify.sh
curl https://api.pliing.app/v1/notifications \
  -H "Authorization: Bearer $PLIING_TOKEN" \
  -H "Idempotency-Key: deploy-prod-1842" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "pliing-7m3k9-xr2n8-q4v6",
    "title": "Deploy ferdig",
    "body": "main → production. Alt er oppe.",
    "level": "info"
  }'
202Acceptedid: 1842
Pliing-appikon
Pliing · Mitt prosjektnå
Deploy ferdig

main → production. Alt er oppe.

Forhåndsvisning av produktflyten. Ingen varsler sendes her.

Idempotency-Key er en unik ID for sendingen. Samme ID ved et nytt forsøk hindrer dobbeltvarsler. Prøvesenderen lager den automatisk.

BYGG DET INN DER DU JOBBER
TerminalCI/CDBackendScriptsAutomatiseringer
HTTPS + JSON

ÉN KONTO. ÉN MOTTAKER-ID.

Apple tar innloggingen.
Pliing tar leveringen.

Slik kobler du koden til enhetene dine. Kontoen følger deg; enhetene er mottakerne du styrer.

  1. 01

    Logg inn med Apple

    Samme konto på iPhone, iPad og Mac. Du trenger ikke lage og huske enda et passord.

  2. 02

    Få din Pliing-ID

    En unik ID som pliing-7m3k9-xr2n8-q4v6 forteller API-et hvilken konto varselet skal til.

  3. 03

    Koble til prosjektet

    Opprett en avgrenset API key. Godkjenn avsenderen, velg enheter og send ditt første kall.

Pliing-ID er adressen. API key-en er tilgangen. En offentlig ID gir aldri senderett alene.

RIKTIG BESKJED. RIKTIG STED.

Telefonen i lomma.
Macen på pulten.
Du velger.

Enhetene registreres mot kontoen din. Slå push av og på for hver enhet. En avskrudd eller fjernet enhet skal ikke få nye varsler.

Innboksen følger kontoen, også når du velger å ha push av på én enhet.

MIN KONTOpliing-7m3k9-xr2n8-q4v6
Push til 2 av 3 enheterKONTONIVÅ

Prøv bryterne. Dette er en illustrasjon av enhetsvalg og endrer ingen konto.

ET LITE API. EN TYDELIG KONTRAKT.

Passer inn i verktøyene
du allerede bruker.

Et HTTPS-kall med JSON. Avgrensede nøkler, samtykke og duplikatvern er en del av kontrakten fra starten.

Les API-dokumentasjonen ↗
POST/v1/notificationsSend et varsel
POST/v1/consent-requestsBe om tillatelse
GET/v1/inboxSynk innboksen
202 Accepted betyr mottatt av API-et.

At Apple har tatt imot en push, og at brukeren har lest varselet, er ulike statuser. De skal være tydelige hver for seg.

KONTROLL HELE VEIEN

Et pling skal være ønsket.

Du godkjenner avsenderen

Et prosjekt må få tillatelse før det kan sende. Du kan trekke den tilbake når som helst.

403 consent_required

Nøkler kan begrenses og trekkes tilbake

Én nøkkel per prosjekt eller integrasjon. En sendernøkkel gir ikke tilgang til mottakerens innboks.

SCOPED TOKENS

Et nytt forsøk skal ikke bli et nytt varsel

Bruk samme idempotensnøkkel når du prøver igjen. API-et gjenkjenner hendelsen.

Idempotency-Key

FØRSTE MILEPÆL

Ett kall. Én mottaker.
Et ekte Pliing.

Privat beta har Apple-innlogging, API keys og enhetsvalg. Ekte API-til-push er testet mot Apples sandbox; offentlig App Store-lansering kommer senere.

Bli kjent med API-et ↗

GODT Å VITE

Noen korte avklaringer.

Bruker jeg Apple-ID-en min som mottaker-ID?

Nei. Logg inn med Apple brukes til innlogging. Pliing oppretter sin egen stabile, unike ID for kontoen. Du sender til den ID-en, uten å dele e-postadresse eller Apples interne brukeridentifikator.

Kan alle som kjenner Pliing-ID-en sende meg push?

Nei. Avsenderen må ha en gyldig API key og godkjent tillatelse fra kontoen din. Du bestemmer også hvilke registrerte enheter som skal ha push.

Får alle enhetene samme varsel?

Kontoen har én felles innboks, med separat valg av push for hver enhet. Du kan for eksempel velge push på iPhone og Mac, og slå det av på iPad.

Hvordan bruker jeg ID-en hos andre tjenester?

Kopier hele Pliing-ID-en fra appen og lim den inn i varselinnstillingene hos en tjeneste som støtter Pliing. Tjenesten bruker sin egen API key og ber om tillatelse. Godkjenn forespørselen under Avsendere i Pliing før varsler kan sendes. Til egne scripts oppretter du prosjekt og API key i API-fanen.

Hva med overvåkere, engangskoder og abonnement?

Først ferdigstiller vi kjernen: konto, API keys, mottaker-ID, enheter og pålitelig push. Engangskoder har et eget API under utprøving. Overvåkere og betalingsmodell er ikke lansert.