Sharing
The LinkedIn link, and why a share link is never the proof.
A credential has three delivery surfaces: the PDF, the badge image, and a link that takes it somewhere its holder keeps and shows it. Today that last one is the LinkedIn link.
A share link is not the proof
A share link carries the credential's code and points at the public check page. The check page is what says whether the credential is still valid. A link that answered that itself would be a cached verdict somewhere the issuer cannot reach, which is exactly the thing a revocation has to be able to override.
This has one visible consequence: a revoked credential gets no share link at all. An entry added to somebody's LinkedIn profile is not recalled when the credential later is, so handing one out for a withdrawn credential would put a copy of a false claim on a public profile.
An expired credential does get a link, with its expiry. Expiry is a term that ran out, not a withdrawal, and the holder is entitled to keep the record.
Getting the links
curl https://api.example.com/api/v1/credentials/$CODE/share \
-H "Authorization: Bearer $API_KEY"
{
"success": true,
"data": {
"checkUrl": "https://verify.example.com/c/ACME-MERN-NOV26-0007",
"linkedInAddToProfile": "https://www.linkedin.com/profile/add?..."
}
}
A link that cannot be built for a credential is null, never missing. A client has to be able to tell
"there is no link for this credential" from "this response did not mention it", and an absent key
means the second.
Needs the share:read scope.
linkedInAddToProfile opens LinkedIn's own "add a certification" form, pre-filled. Set the
organisation's LinkedIn page id (a number, from the page's own URL) in credential settings — with
it, the certification on somebody's profile links back to the issuer's page; without it, LinkedIn
shows the issuer's name as plain text and the profile has an unlinked employer nobody can look up,
which is most of the value of adding it.
Animated designs
A design can carry an animation — reveal, shimmer, seal or glow, with a duration and an
intensity. It is delivered as animated SVG on the share and embed surfaces.
The PDF, the email and every printed copy stay still. That is the right way round: the still version is the credential and the animation is presentation, and an animated certificate must be the same credential as its still version or the thing being verified and the thing being shown have come apart.
Every animation ships with a prefers-reduced-motion branch that disables it. A document somebody
receives for an achievement is exactly the kind of thing opened by people with vestibular disorders,
and a sweeping full-page highlight is a textbook trigger. Needs the animatedDesigns plan feature.