Omdio

Utvecklare

API-dokumentation

Omdios öppna API låter era egna system prata med Omdio: skicka in köpsignaler för att automatiskt utlösa köpverifierade omdömesinbjudningar (företags- och produktomdömen), och hämta ut omdömen och betyg för att visa på er egen sida. API:t ingår i Pro och Enterprise.

Bas-URL och autentisering

Alla anrop går mot https://omdio.se/api/v1 över HTTPS. Autentisera varje anrop med en API-nyckel i Authorization-headern. Nycklar skapas och återkallas av ägare/admin under Inställningar i portalen och visas bara en gång vid skapandet — förvara dem som lösenord.

Authorization: Bearer omdio_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

En nyckel hör till exakt en organisation och kan bara nå den organisationens egen data. Anropen körs alltid server-till-server — exponera aldrig nyckeln i webbläsaren.

Anropsgräns

Upp till 600 anrop per 60 sekunder per nyckel. Vid överskriden gräns svarar API:t 429 med en Retry-After-header (sekunder att vänta).

Fel

Fel svarar med en JSON-kropp { "error": "...", "message": "..." }. Fältet error är en stabil kod att förgrena på; message är läsbar text.

401 missing_authorization   Nyckel saknas i Authorization-headern
401 invalid_key             Okänd eller felaktig nyckel
401 key_revoked             Nyckeln är återkallad
403 plan_required           Organisationens plan saknar API-åtkomst (Pro+)
404 location_not_found      Försäljningsstället tillhör inte din organisation
404 business_not_found      Företaget tillhör inte din organisation
400 invalid_body            Ogiltig begärans-kropp
400 invalid_query           Ogiltiga frågeparametrar
429 rate_limited            Anropsgränsen överskriden
500 processing_error        Tillfälligt fel — försök igen

Endpoints

POST/purchases

Rapportera ett genomfört köp. Omdio schemalägger en köpverifierad omdömesinbjudan enligt platsens inställningar (kanal, fördröjning, urval) och er kvot — precis som en Shopify/WooCommerce-integration. Produktomdömen samlas in på Pro och uppåt. Idempotent per order_ref och plats: samma order skapar aldrig två inbjudningar.

Begäran

curl -X POST https://omdio.se/api/v1/purchases \
  -H "Authorization: Bearer $OMDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "location_id": "b2c3d4e5-...",
    "order_ref": "1001",
    "buyer": {
      "email": "buyer@example.com",
      "phone": "+46701234567",
      "country": "SE",
      "locale": "sv"
    },
    "items": [
      { "external_id": "SKU-42", "name": "Sneakers", "sku": "SKU-42" }
    ],
    "total": 899,
    "completed_at": "2026-07-08T10:30:00Z"
  }'

Svar

202 Accepted
{ "status": "accepted", "invitation_id": "..." }

// Andra utfall:
{ "status": "queued",    "reason": "quota_exceeded" }  // kvot slut – köad, tappas ej
{ "status": "duplicate" }                              // 200, redan mottagen
{ "status": "skipped",   "reason": "..." }             // t.ex. urval, ingen kontakt
GET/reviews

Hämta era publicerade omdömen — samma innehåll som visas publikt på omdio.se. Fältet verification (verified / imported / unverified) följer med så ni kan välja att bara visa köpverifierade.

Frågeparametrar

business       (valfri)  filtrera på företagets slug
product        (valfri)  filtrera på produktens slug
verification   (valfri)  verified | imported | unverified
limit          (1–100, standard 20)
offset         (standard 0)

Exempel

curl "https://omdio.se/api/v1/reviews?limit=10" \
  -H "Authorization: Bearer $OMDIO_API_KEY"

{
  "data": [
    {
      "id": "...",
      "rating": 5,
      "body": "Snabb leverans, toppkvalitet!",
      "author_name": "Anna L.",
      "verification": "verified",
      "country": "SE",
      "created_at": "2026-07-01T08:12:00Z",
      "business": { "slug": "my-store", "name": "My Store" },
      "product":  { "slug": "sneakers", "name": "Sneakers" }
    }
  ],
  "pagination": { "limit": 10, "offset": 0, "total": 312 }
}
GET/stats

Aggregerade betyg för ett “4,7 ★ (312 omdömen)”-märke på er egen sida. Samma siffror som widgeten och Google använder: endast köpverifierade och publicerade omdömen räknas in.

curl "https://omdio.se/api/v1/stats" \
  -H "Authorization: Bearer $OMDIO_API_KEY"

{
  "totals": { "rating_avg": 4.7, "rating_count": 312 },
  "businesses": [
    { "slug": "my-store", "name": "My Store", "rating_avg": 4.7, "rating_count": 312 }
  ]
}

Frågor? Hör av er via kontaktsidan.