Ditt första API-anrop på 5 minuter

Snabbaste vägen in är ett personligt åtkomsttoken — ingen OAuth, ingen appregistrering. Det läser och skriver dina egna pon-data, vilket är precis rätt för skript, Home Assistant och homelab-grejer.

1. Hämta pon till din iPhone

   Ditt konto och dina listor bor i appen — hämta pon i App Store och registrera dig där.

   

2. Logga in på my.pon.app

   Använd ditt pon-konto. Din e-post måste vara bekräftad — annars svarar aktiveringen med 403 EMAIL_UNVERIFIED.

3. Aktivera utvecklarläget

   my → För utvecklare. Du godkänner API-villkoren en gång.

4. Skapa ett token

   Välj de scopes du behöver. Hemligheten pon_pat_… visas en enda gång — förvara den som ett lösenord. Giltighetstid: 90 dagar som standard, upp till 365, eller aldrig.

5. Anropa API:et

   Det var allt — vanlig Bearer, ingen signeringsdans:

# list your lists
curl https://api.pon.app/v3/lists \
  -H "Authorization: Bearer pon_pat_XXXX"

const res = await fetch("https://api.pon.app/v3/lists", {
  headers: { Authorization: "Bearer pon_pat_XXXX" },
});
const { data } = await res.json();
console.log(data);

import requests

res = requests.get(
    "https://api.pon.app/v3/lists",
    headers={"Authorization": "Bearer pon_pat_XXXX"},
)
print(res.json()["data"])

Lägg till en vara

POST /v3/lists/{list-id}/items — skrivsidan fungerar på samma sätt:

curl -X POST https://api.pon.app/v3/lists/LIST_ID/items \
  -H "Authorization: Bearer pon_pat_XXXX" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Oat milk" }'

await fetch(`https://api.pon.app/v3/lists/${listId}/items`, {
  method: "POST",
  headers: {
    Authorization: "Bearer pon_pat_XXXX",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ name: "Oat milk" }),
});

requests.post(
    f"https://api.pon.app/v3/lists/{list_id}/items",
    headers={"Authorization": "Bearer pon_pat_XXXX"},
    json={"name": "Oat milk"},
)

Varje svar använder samma kuvert: { "data": …, "meta": … } vid framgång, { "errors": [ { "code", "message" } ] } vid fel.

Nästa steg

• Autentisering — när ett token räcker, och när du vill ha OAuth.
• Webhooks — reagera på liständringar utan polling.
• Gränser och fair use — vad som är generöst, och vad som är ett tak.