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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxEn 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 igenEndpoints
/purchasesRapportera 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/reviewsHä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 }
}/statsAggregerade 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.