Integrera Nava Insights via Nava API
Nava API är det publika partner-API:t för Nava Insights. Använd det för att skapa studier, hantera deltagare, lokalisera innehåll, köra analys och lansera studier från era egna system.
Vad det är
Nava API är det publika API-lagret för godkända partners som integrerar med Nava Insights. Det använder organisations- och användarskopade API-nycklar och följer samma studiebehörigheter och plattformsregler som Nava Insights-appen.
Vad ni kan göra
Skapa och uppdatera studier
Skapa utkast till studier, uppdatera metadata och flytta studier genom samma livscykelsteg som används i Nava Insights.
Hantera segment och deltagare
Skapa deltagarsegment, lägg till deltagare en och en eller i bulk och håll medlemskap synkat med era källsystem.
Konfigurera frågor och lokaliserat innehåll
Hantera frågeset, språk och lokaliserat studieinnehåll så att varje studie är redo för de målgrupper ni vill nå.
Kör och läs analys
Läs studiens analys, kontrollera analysstatus och trigga nya körningar när nya kvalificerade intervjuer finns tillgängliga.
Lansera studier programmatiskt
Uppdatera studie-status och publicera studier via API:t när konfigurationen är klar.
Bygg mot ett versionshanterat publikt kontrakt
Använd den dokumenterade `/v1`-ytan med interaktiv dokumentation och OpenAPI utan att vara beroende av interna tjänstekontrakt i Nava Insights.
Typiskt integrationsflöde
Skapa en studie med `POST /v1/studies`.
Skapa segment och lägg till deltagare från ert eget källsystem.
Konfigurera frågor, språk och lokaliserat innehåll.
Flytta studien genom nödvändiga statusövergångar.
Lansera den genom att skapa en publicering.
Webhooks för utgående händelser
Utöver Nava API stöder Nava Insights utgående webhooks så att era system kan reagera på studie- och intervjuhändelser utan polling. Webhook-konfiguration hanteras i Nava Insights-appen och kompletterar ett API-drivet integrationsflöde.
Prenumerera på centrala studie- och intervjuhändelser
Konfigurera HTTPS-endpoints för händelser som `study.created.v1`, `study.launched.v1`, `study.closed.v1`, `interview.started.v1` och `interview.completed.v1`.
Välj payload- och leveransformat
Välj mellan Standard Webhooks thin JSON och CloudEvents structured JSON, och kombinera formatet med den webhook-signering som passar er integration.
Signerade leveranser med test och replay
Skydda leveranser med signering, skicka testhändelser från Nava Insights-appen, granska leveranshistorik och kör replay av misslyckade eller missade leveranser vid behov.
Så får ni åtkomst
Har ni redan Nava Insights Enterprise?
Enterprise-kunder kan skapa och hantera API-nycklar i Nava Insights-appen under Inställningar → Integrationer. Nya nyckelhemligheter visas bara en gång när de skapas.
Öppna inställningar för API-nycklar →Ny partner eller integration?
Prata med Nava Insights om ert användningsfall, vilka arbetsflöden ni vill automatisera och om partneråtkomst eller en Enterprise-plan är rätt väg.
Kontakta Nava Insights →Autentisera varje anrop med en bearer API-nyckel. Behåll nycklar på serversidan och skicka dem aldrig från klientkod.
Authorization: Bearer <YOUR_API_KEY>Varför team använder Nava API
En gemensam studiemodell i produkt och API
Integrationen arbetar med samma studiekoncept, behörigheter och livscykelbeteenden som team använder i Nava Insights-appen.
En partner-säker publik yta
API:t är avsiktligt tunt och versionshanterat så att ni integrerar mot ett stabilt publikt kontrakt i stället för interna tjänstedetaljer.
Dokumentation nära det live-kontraktet
Interaktiv Scalar-dokumentation och OpenAPI serveras från själva API:t, vilket gör det enklare att inspektera och validera den aktuella ytan.
FAQ för utvecklare
Redo att komma igång?
3 intervjuer ingår gratis. Inget kreditkort krävs.