# IntelliForge Learning Certificate Platform

> Issue and verify tamper-proof PDF certificates with HMAC-signed shareable URLs — course participation, VTU-style internship credentials, and sports/event appreciation certificates.

IntelliForge Learning (learning.intelliforge.tech) provides API-first certificate generation for training completions and industry internships. Each certificate is a cryptographically signed URL with a downloadable PDF and public verification page. No database is required for verification.

## Documentation

- [OpenAPI specification](https://certs.intelliforge.tech/openapi.json): Machine-readable API schema (v2.0.0).
- [Interactive API docs](https://certs.intelliforge.tech/docs): Swagger UI for trying endpoints.
- [API metadata](https://certs.intelliforge.tech/api/info): Version, branding, and feature list.

## Pages

- [Certificate generator](https://certs.intelliforge.tech/): Web UI to issue participation, internship, and appreciation certificates.
- [List courses](https://certs.intelliforge.tech/api/courses): Active courses available for certificate issuance.

## Verification

- `GET /certificate/{token}/verify` — JSON verification for a single certificate.
- `POST /api/certificates/verify` — Batch verify up to 100 tokens.
- `GET /certificate/{token}` — Public HTML certificate page (shareable).
- `GET /certificate/{token}/download` — Download certificate PDF.

## Create certificates

`POST /api/certificate` with `X-API-Key` when configured.

Participation body:
```json
{"participant_name":"Jane Doe","course_name":"AI Product Development","completion_date":"2026-04-15","instructor_name":"Certificate Team","participant_email":"jane@example.com"}
```

Internship body adds: `certificate_kind`, `usn`, `internship_duration`, `internship_hours`, `mentor_name`, `institution_name`.

Appreciation body adds: `certificate_kind` `"appreciation"`, `recognition_text` (or `venue_name`), optional `event_name`, `sponsor_label`, `venue_name`.

## Automation

- Webhooks: pass `callback_url` on create to receive `certificate.created` events.
- Idempotency: pass `idempotency_key` to prevent duplicate issuance.
- Bulk admin: `POST /api/admin/certificates/bulk` with `X-Admin-Key`.
- Email delivery: optional `participant_email` via AgentMail.

## Branding (env-configurable)

- Org tagline: AN INTELLIFORGE AI INITIATIVE
- Brand: IntelliForge Learning
- Participation title: Certificate of Participation
- Internship org: Intelliforge Digital Services
- Appreciation org: IntelliForge AI
- Contact: support@intelliforge.tech

## Optional

- [Sitemap](https://certs.intelliforge.tech/sitemap.xml)
- [Robots](https://certs.intelliforge.tech/robots.txt)
- [AI plugin manifest](https://certs.intelliforge.tech/.well-known/ai-plugin.json)