Certifikat-API: så utfärdar du certifikat med ett REST-API

Sammanfattning: Ett certifikat-API är ett webbgränssnitt som låter era egna system skapa och utfärda certifikat automatiskt, utan att någon öppnar ett designverktyg. Med ett REST-API skickar ert LMS, CRM eller HR-system en HTTPS-förfrågan med mottagarens uppgifter och namnet på en designmall, och certifikatet utfärdas. TRUE:s API gör det med fem slutpunkter (Issue, Preview, Templates, Content och Issued), och varje dokument säkras i en publik blockkedja och kan verifieras av vem som helst.

Vad är ett certifikat-API?

Ett certifikat-API är ett programmeringsgränssnitt som skapar och utfärdar certifikat när ett annat system ber om det. En lärplattform, ett CRM eller ett HR-system skickar mottagarens uppgifter, och API:et levererar ett färdigt certifikat, examensbevis eller en licens. TRUE Originals certifikat-API utfärdar dokument på det sättet, och vart och ett av dem är blockkedjesäkrat.

Ibland kallas det en certifikatgenerator med API. Det är samma sak sett från resultatet: förfrågan genererar dokumentet ur en mall. Ordet API-certifikat kan också betyda något helt annat. Ett API för SSL/TLS-certifikat hanterar de X.509-certifikat som krypterar trafiken mellan servrar och har ingenting med ett examensbevis att göra. Certifikaten här är den andra sorten. De visar att en namngiven person har gått en kurs, klarat ett prov eller har en licens. Den bredare frågan om API:er för sådana dokument tas upp i Vad är ett API? Säkra digitala dokument via TRUE:s API.

Hur utfärdar man certifikat med ett REST-API?

Ett system utfärdar certifikat med ett REST-API genom att skicka en POST-förfrågan över HTTPS till API:ets slutpunkt för utfärdande, med mottagarens uppgifter och namnet på en designmall i anropet. API:et fogar in uppgifterna i mallen och utfärdar dokumentet. Med TRUE:s API visar samma förfrågan, skickad till slutpunkten Preview, först hur certifikatet kommer att se ut, innan något utfärdas.

REST är den arkitekturstil som Roy Fielding beskrev i sin doktorsavhandling vid University of California, Irvine, år 2000. ”The central feature that distinguishes the REST architectural style from other network-based styles is its emphasis on a uniform interface between components”, skrev Fielding. Det som skiljer REST från andra stilar är med andra ord ett enhetligt gränssnitt mellan komponenterna. För ett certifikat-API är det lätt att föreställa sig. Ett certifikat är en resurs som alla andra. Du skapar det med POST och läser tillbaka det med GET.

Med TRUE:s API går utfärdandet till i fem steg:

1. Bygg certifikatets designmall i TRUE Dashboard (Build > Design Templates) och bestäm vilka fält den visar.
2. Läs mallens struktur med slutpunkten Templates, så att ert system vet vilka fält det ska skicka.
3. Skicka mottagarens uppgifter till Preview och kontrollera resultatet.
4. Skicka samma förfrågan till Issue. Certifikatet skapas, blockkedjesäkras och mottagaren tar emot det via e-post, allt från ett enda API-anrop.
5. Lista det ni har utfärdat med slutpunkten Issued, filtrerat på status när det behövs.

Vad behöver jag konfigurera innan jag anropar ett certifikat-API?

Innan det första anropet till TRUE:s API behövs två saker: API-uppgifter och en designmall. Uppgifterna autentiserar varje förfrågan. Designmallen bestämmer vilka fält certifikatet visar, vad de heter och hur många sidor dokumentet blir.

TRUE:s API autentiserar med API-nycklar som skickas via Basic Auth, det HTTP-schema som IETF definierar i RFC 7617 (september 2015) och som skickar användar-id och lösenord kodade i Base64. Varje förfrågan bär huvudet Authorization: Basic base64(username:password). Alla anrop går över HTTPS. Ett anrop över vanlig HTTP misslyckas, och det gör även en förfrågan utan autentisering. API-åtkomst ingår i TRUE-prenumerationer.

Designmallen är där organisationens eget arbete sitter. Den bär varumärket och fälten, och ett TRUE-dokument som byggs ur den kan löpa över flera sidor. Kurser och andra återkommande poster ligger i Document Content (TRUE Dashboard > Build > Document Content), var och en med en kortkod. En förfrågan anger kursen med kortkoden i stället för att upprepa hela kursnamnet varje gång.

Hur ser en förfrågan till ett certifikat-API ut?

En förfrågan till TRUE:s certifikat-API är en JSON-kropp med två nycklar: design, namnet på designmallen, och data, en lista med mottagarens fält. Fältnamnen kommer från er egen mall, så exemplet nedan använder bara namn ur illustrationen på TRUE:s API-sida.

{
  "design": "true-demo-document",
  "data": [
    {
      "Contact Firstname": "Maria",
      "Contact Lastname": "Andersson",
      "E-mail address": "[email protected]",
      "Course": "course-swedish"
    }
  ]
}

Värdet i Course är en kortkod från Document Content, här posten ”Course Swedish” ur exemplet på TRUE:s API-sida. Skickad till Preview ger förfrågan en förhandsvisning. Skickad till Issue utfärdar samma förfrågan certifikatet.

Vilka slutpunkter har TRUE:s API?

TRUE:s API har fem slutpunkter: Issue, Preview, Templates, Content och Issued. Issue och Preview är POST-anrop som bygger dokument. Templates, Content och Issued är GET-anrop som läser det som redan finns i ert TRUE-konto.

• Issue (POST) utfärdar ett dokument med den design ni väljer.
• Preview (POST) tar samma förfrågan som Issue och returnerar en förhandsvisning utan att utfärda något.
• Templates (GET) listar era designmallar, eller returnerar strukturen och instruktionerna för en enskild mall.
• Content (GET) returnerar posterna i Document Content, var och en med titel, kortkod och datum då den lades till.
• Issued (GET) listar de dokument ni har utfärdat. Valfria parametrar filtrerar på status (all, approved eller verified), väljer full eller simple data och bläddrar i resultatet med limit och page.

Fem slutpunkter är hela ytan. TRUE:s API-sida säger det på en rad: ”Det finns bara 5 slutpunkter totalt med smidig hantering och enkla inställningar.” En utvecklare som har anropat ett REST-API tidigare kan läsa hela referensen i ett svep. TRUE:s API är utformat för att fungera på timmar, inte veckor.

Kan jag testa TRUE:s API innan jag bygger något?

Ja. TRUE Original publicerar en Postman-samling som ger tillgång till en demoslutpunkt, så att en utvecklare kan skicka riktiga förfrågningar och läsa riktiga svar innan något är uppsatt hos organisationen. Kör anropet issue i samlingen, så har du sett hela flödet. De flesta integrationer går live inom en till två veckor.

Dokumentation är en känd svag punkt i mjukvarubranschen. I Postmans 2025 State of the API Report, en enkät bland fler än 5 700 utvecklare, arkitekter och chefer, uppgav 55 procent att de brottas med inkonsekvent dokumentation och 34 procent att de inte hittar befintliga API:er. TRUE:s API samlar autentisering, alla fem slutpunkterna, förfrågans format och Postman-samlingen på en enda sida.

Kan jag utfärda certifikat utan att skriva kod?

Ja. TRUE Original har två sätt att utfärda certifikat automatiskt utan kod: Email-API:t och färdiga kopplingar till plattformar som organisationen redan använder. Båda utfärdar samma blockkedjesäkrade TRUE-dokument som REST-API:et.

Email-API:t fungerar som namnet antyder. Ni skickar ett e-postmeddelande till TRUE med förutbestämt meddelande och struktur, och TRUE-systemet skapar dokumentet och utfärdar det till rätt person. Varje system som kan skicka e-post kan utlösa ett certifikat på det här sättet.

För team utan utvecklingsresurser accepterar TRUE CSV-uppladdningar via instrumentpanelen. Samma automatisering, ingen kod krävs.

Vilka LMS- och CRM-system är kopplade till TRUE:s API?

Fler än tjugo plattformar är kopplade till TRUE Original, bland lärplattformar, CRM-system och affärssystem. Canvas, Moodle, Learnster, Salesforce, Microsoft Dynamics 365, Zapier och Shopify finns bland dem, och alla kopplingar listas på TRUE:s integrationssida.

I Moodle: automatisera meritbevisutfärdande baserat på kursavslutning, provresultat eller anpassade avslutningskriterier. Sidorna om Canvas, Moodle och Learnster beskriver vad varje LMS-koppling gör, och sidan om Salesforce täcker CRM-sidan. Med Salesforce: utlös certifikatutfärdande när affärsmöjligheter avslutas, utbildning genomförs eller certifieringar tilldelas. En plattform som inte finns i listan kan ändå kopplas via REST-API:et, eftersom mönstret är detsamma i alla system som har ett API. TRUE erbjuder också webhooks för organisationer som kopplar in en egen datakälla.

Vad händer när API:et har utfärdat ett certifikat?

Ett certifikat som utfärdats via TRUE:s API är ett TRUE Original-dokument: en delbar länk på utfärdarens egen domän, säkrad i en publik blockkedja och verifierbar för vem som helst via TRUE Verify eller en QR-kod. Mottagaren får en länk, inte en fil.

TRUE är blockkedjeagnostiskt. Dokumenten skrivs till flera publika blockkedjor, bland dem Ethereum och Polygon, och en kund som vill ha en viss kedja kan få det. När posten är skriven går dokumentet inte att ändra. Ett PDF-certifikat är en fil som kan redigeras och förfalskas, medan ett TRUE-dokument är låst i blockkedjan och kan verifieras av vem som helst, när som helst. Blockkedjeverifiering är inte en separat modul eller extra kostnad.

Utfärdaren ser också vad som händer sedan. TRUE:s analys visar när, var och av vem ett dokument öppnas och delas. Varje delning visar utfärdarens varumärke för nya människor, och TRUE-dokument har genererat över 100 miljoner marknadsföringsexponeringar världen över. Resten av plattformen runt API:et beskrivs på TRUE:s funktionssida.

Vid efterlevnadsutbildning säkerställer API-integration att meritbevis följer avslutningen: LMS markerar utbildning som avslutad, API-anrop utfärdar certifikat med utbildningsuppgifter, certifikat inkluderar utgångsdatum vid behov, HR-system tar emot webhook som bekräftar utfärdandet, och analys spårar när certifikat verifieras av revisorer.

Varför utfärdar organisationer certifikat via ett API?

Organisationer utfärdar certifikat via ett API eftersom API:et gör jobbet en gång per mall i stället för en gång per mottagare. En kursanordnare som skickar tio certifikat i månaden kan skriva dem för hand. Vid tiotusen går det inte. TRUE Original har utfärdat över 900 000 dokument åt fler än 200 utfärdare, med kunder i fler än 15 länder.

Examensdagen via API:et: ingen manuell hantering, inga utskriftsfördröjningar och studenter delar sina meritbevis på LinkedIn samma dag.

Resten av mjukvaruvärlden har gått åt samma håll. Enligt Postmans 2025 State of the API Report har 82 procent av organisationerna infört API-first i någon grad, och 25 procent arbetar helt API-first, en ökning med 12 procent jämfört med 2024. För en organisation som utfärdar certifikat betyder API-first att systemet som vet att en kurs är avklarad också är systemet som utfärdar beviset.

Med TRUE:s API är det beviset ett enda POST-anrop.

Vanliga frågor

Har TRUE ett REST-API för att utfärda certifikat?

Ja. TRUE Original har ett eget REST-API för att utfärda blockkedjesäkrade certifikat, examensbevis och andra dokument, med fem slutpunkter totalt: Issue, Preview, Templates, Content och Issued.

Hur autentiserar jag mot TRUE:s API?

TRUE:s API använder API-nycklar som skickas via Basic Auth, med huvudet Authorization: Basic base64(username:password). Alla förfrågningar måste gå över HTTPS, och anrop över vanlig HTTP eller utan autentisering misslyckas.

Är ett certifikat-API samma sak som ett API för SSL-certifikat?

Nej. Ett certifikat-API som TRUE:s API utfärdar certifikat som människor förtjänar, till exempel kursintyg, examensbevis och licenser. Ett API för SSL/TLS-certifikat hanterar de X.509-certifikat som krypterar trafiken mellan servrar.

Kan jag förhandsgranska ett certifikat innan API:et utfärdar det?

Ja. Slutpunkten Preview i TRUE:s API tar samma förfrågan som Issue och returnerar en förhandsvisning av dokumentet utan att utfärda något.

Kan jag utfärda certifikat via e-post i stället för via API:et?

Ja. Med TRUE:s Email-API skickar ni ett e-postmeddelande med förutbestämt meddelande och struktur, och TRUE-systemet skapar dokumentet och utfärdar det automatiskt till rätt person.