API-integration för certifikat, för utvecklare

API-översikt

TRUE:s certifikat-API är utformat för utvecklare som behöver automatisera utfärdande av meritbevis utan att brottas med komplexitet.

Fem endpoints hanterar allt:

• Skapa certifikat
• Hämta certifikatdata
• Lista utfärdade certifikat
• Uppdatera certifikatstatus
• Återkalla certifikat

RESTful-arkitektur innebär standardiserade HTTP-metoder, JSON-nyttolaster och förutsägbara svar. Om du har integrerat ett modernt API vet du redan hur du använder TRUE.

Blockkedja ingår: varje certifikat blockkedjesäkras automatiskt. Ingen extra konfiguration, inga separata anrop. Verifieringsdata inkluderas i varje API-svar.

Snabbstart

Autentisering

TRUE använder API-nyckelautentisering. Inkludera din nyckel i förfrågningshuvudet:

curl -X POST https://api.trueoriginal.com/v1/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{...}'

API-nycklar genereras i din TRUE-instrumentpanel. Du kan skapa separata nycklar för utvecklings-, staging- och produktionsmiljöer.

Skapa ett certifikat

Utfärda ett certifikat med en enda POST-förfrågan:

curl -X POST https://api.trueoriginal.com/v1/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tmpl_abc123",
    "recipient": {
      "name": "Maria Andersson",
      "email": "[email protected]"
    },
    "fields": {
      "course_name": "Advanced Project Management",
      "completion_date": "2026-03-03",
      "credential_id": "PM-2026-0042"
    }
  }'

Svar:

{
  "id": "cert_xyz789",
  "status": "issued",
  "recipient": {
    "name": "Maria Andersson",
    "email": "[email protected]"
  },
  "verification_url": "https://verify.yourorg.com/cert_xyz789",
  "blockchain": {
    "network": "polygon",
    "transaction_hash": "0x1234...abcd",
    "confirmed": true
  },
  "created_at": "2026-03-03T09:15:00Z"
}

Certifikatet skapas, blockkedjesäkras och mottagaren tar emot det via e-post, allt från ett enda API-anrop.

Hämta ett certifikat

curl -X GET https://api.trueoriginal.com/v1/certificates/cert_xyz789 \
  -H "Authorization: Bearer YOUR_API_KEY"

Returnerar fullständig certifikatdata inklusive blockkedjeverifieringsstatus, visningsanalys och delningsspårning.

Integrationsguider

TRUE integrerar med de plattformar din organisation redan använder.

Salesforce

Utlös certifikatutfärdande när affärsmöjligheter avslutas, utbildning genomförs eller certifieringar tilldelas.

Integrationsupplägg: 1. Skapa en Connected App i Salesforce. 2. Bygg en Apex-trigger eller ett Process Builder-flöde. 3. Anropa TRUE API vid relevanta händelser. 4. Lagra certifikat-ID:n tillbaka i Salesforce-poster.

Exempelscenario: när en kontakt genomför ett utbildningsprogram (eget fält uppdateras) utfärdas ett certifikat och länkas till deras post.

// Förenklat Apex-exempel
HttpRequest req = new HttpRequest();
req.setEndpoint('https://api.trueoriginal.com/v1/certificates');
req.setMethod('POST');
req.setHeader('Authorization', 'Bearer ' + trueApiKey);
req.setHeader('Content-Type', 'application/json');
req.setBody(JSON.serialize(certificatePayload));

Canvas LMS

Utfärda certifikat automatiskt när studenter slutför kurser eller uppnår behärskningsnivå.

Integrationsupplägg: 1. Konfigurera Canvas webhook för kursavslutningshändelser. 2. Bygg mellanprogramvara för att ta emot webhooks och anropa TRUE API. 3. Mappa Canvas-användardata till certifikatfält. 4. Valfritt: publicera certifikatlänken tillbaka till Canvas.

Canvas webhook-nyttolast innehåller: användar-ID, kurs-ID och tidsstämpel för avslutning, allt som behövs för att fylla i ett certifikat.

Moodle

Automatisera meritbevisutfärdande baserat på kursavslutning, provresultat eller anpassade avslutningskriterier.

Integrationsupplägg: 1. Använd Moodles händelsesystem (course_completed, quiz_passed). 2. Bygg ett lokalt plugin eller en extern webhook-hanterare. 3. Omvandla Moodle-händelsedata till TRUE API-format. 4. Utfärda certifikat och lagra verifierings-URL:er i Moodle-användarprofiler.

Learnster

Koppla Learnsters avslutningshändelser till TRUE för sömlös meritgivning.

Integrationsupplägg: 1. Konfigurera Learnsters avslutnings-webhooks. 2. Mappa Learnsters inlärningsdata till certifikatmottagarfält. 3. Utfärda certifikat vid kurs- eller programavslutning. 4. Spåra meritbevisanalys parallellt med inlärningsanalys.

Masshantering

Utfärdar du hundratals eller tusentals certifikat? TRUE hanterar masshantering effektivt.

Batch-endpoint

curl -X POST https://api.trueoriginal.com/v1/certificates/batch \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template_id": "tmpl_abc123",
    "recipients": [
      {"name": "Anna Svensson", "email": "[email protected]", "fields": {...}},
      {"name": "Erik Lindqvist", "email": "[email protected]", "fields": {...}},
      ...
    ]
  }'

Svar: batch-jobb-ID för att spåra framsteg.

Batchstatus

curl -X GET https://api.trueoriginal.com/v1/batches/batch_123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Returnerar: totalt antal, slutfört antal, misslyckat antal och enskilda certifikat-ID:n.

CSV-alternativ

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

E-postbaserat utfärdande

Inte varje arbetsflöde behöver API-integration. TRUE:s e-postbaserade utfärdande erbjuder automatisering utan utvecklingsarbete.

Så fungerar det: 1. Konfigurera en e-postmall i TRUE-instrumentpanelen. 2. Skicka strukturerade e-postmeddelanden till TRUE:s utfärdandeadress. 3. TRUE tolkar mottagardata från e-postinnehållet. 4. Certifikat utfärdas och levereras automatiskt.

Användningsfall: utlösa certifikatutfärdande från system som kan skicka e-post men saknar API-förmågor (äldre HR-system, enkla formulärverktyg eller manuella processer).

Webhooks

TRUE skickar webhook-notifieringar när certifikathändelser inträffar.

Händelser som stöds: - certificate.issued — Certifikat skapat och blockkedjebekräftat - certificate.viewed — Mottagare eller tredje part visade certifikatet - certificate.shared — Certifikat delat till LinkedIn eller inbäddat - certificate.verified — Någon verifierade certifikatet via QR/portal - certificate.revoked — Certifikat återkallat

Webhook-nyttolast:

{
  "event": "certificate.viewed",
  "certificate_id": "cert_xyz789",
  "timestamp": "2026-03-03T10:30:00Z",
  "data": {
    "viewer_location": "Stockholm, SE",
    "referrer": "linkedin.com"
  }
}

Konfigurera webhook-endpoints i din TRUE-instrumentpanel. TRUE stöder flera endpoints och filtrering per händelsetyp.

Tekniska specifikationer

Hastighetsbegränsningar

Hastighetsbegränsningsrubriker ingår i varje svar: X-RateLimit-Limit, X-RateLimit-Remaining och X-RateLimit-Reset.

Felhantering

TRUE returnerar standard-HTTP-statuskoder med detaljerade felmeddelanden:

{
  "error": {
    "code": "invalid_template",
    "message": "Template tmpl_invalid does not exist or is not active",
    "documentation_url": "https://docs.trueoriginal.com/errors/invalid_template"
  }
}

Vanliga statuskoder: 200 (lyckad), 201 (skapad), 400 (felaktig begäran), 401 (ej auktoriserad), 404 (hittades inte), 429 (hastighetsgräns nådd), 500 (serverfel).

Säkerhet

• TLS 1.3 krävs för alla anslutningar.
• API-nycklar är miljöbegränsade och kan återkallas.
• IP-allowlistning tillgänglig för företagskonton.
• Revisionsloggar spårar all API-aktivitet.

Användningsfall

Automatiserade examinationer

Universitet och yrkeshögskolor utfärdar hundratals diplom på examinationsdagen. API-integration automatiserar hela flödet: studentsystem markerar studenter som examinerade, webhook utlöser certifikatutfärdande, studenter tar emot blockkedjesäkrade diplom direkt och verifieringslänkar registreras i studentposter. Ingen manuell hantering, inga utskriftsfördröjningar och studenter delar sina meritbevis på LinkedIn samma dag.

Efterlevnadsutbildning

Organisationer måste spåra och certifiera efterlevnadsutbildning. API-integration säkerställer 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.

Kursavslutning

Onlineutbildningsplattformar behöver sömlös meritgivning. Varje kursavslutning utlöser: plattformen detekterar att avslutningskriterier uppfyllts, API utfärdar personaliserat certifikat, inläraren tar emot delbart meritbevis och plattformens analys spårar engagemangsökning från delade certifikat.

Varför TRUE:s API

Enkelhet. Fem endpoints. Det är hela API-ytan. TRUE:s API är utformat för att fungera på timmar, inte veckor.

Blockkedja inbyggd. Blockkedjeverifiering är inte en separat modul eller extra kostnad. Varje API-utfärdat certifikat blockkedjesäkras automatiskt på Ethereum, Polygon, AVAX eller Fantom.

Anpassad domän. Certifikat utfärdade via API bor på din domän, credentials.dinorg.com, inte på TRUE:s webbplats.

Utvecklarupplevelse. Tydlig dokumentation, konsekventa svar, hjälpsamma felmeddelanden och en sandlådemiljö för testning.

Kom igång

1. Begär API-åtkomst via din TRUE-instrumentpanel eller kontakta oss.
2. Skapa certifikatmallar med ditt varumärke och nödvändiga fält.
3. Generera API-nycklar för dina miljöer.
4. Bygg din integration med vår dokumentation och exempelkod.
5. Testa i sandlådeläge innan du går live.
6. Utfärda blockkedjesäkrade certifikat i stor skala.

De flesta integrationer går live inom en till två veckor.

Vilka programmeringsspråk stöds? TRUE:s REST API fungerar med vilket språk som helst som kan göra HTTP-förfrågningar. Dokumentationen inkluderar exempel i curl, JavaScript, Python och PHP.

Finns det en sandlådemiljö? Ja. Sandlåde-API-nycklar låter dig testa hela API:et utan att utfärda riktiga certifikat eller förbruka produktionskvoter.

Vad händer om API:et går ner? TRUE:s API har 99,9 procents drifttid-SLA för företagskonton. Webhook-omförsök hanterar tillfälliga fel automatiskt.

Kan jag anpassa certifikat via API? Ja. API-förfrågningar kan fylla i vilket fält som helst definierat i dina certifikatmallar.

Hur får jag API-nycklar? API-åtkomst ingår i TRUE-prenumerationer. Generera nycklar från din instrumentpanel eller kontakta oss.

Boka en kostnadsfri demo och se hur API-integration fungerar i praktiken.