# TalentVerse API Reference - Reusable Code from Prototype

Extracted from `prototype/` for reuse in TalentVerse production development.

## API Integrations Summary

| # | Service | Category | Protocol | Auth | Source File |
|---|---------|----------|----------|------|-------------|
| 1 | [BIPO HRMS](02-bipo-hrms.md) | Employee Data | HTTPS + OAuth2 | Client Credentials | `nodes/bipo_connector.py` |
| 2 | [Profit.co OKR](03-profitco-okr.md) | Performance | HTTPS | API Key | `nodes/connectors/profit.py` |
| 3 | [Profit.co ePCG](04-profitco-epcg.md) | Competency | HTTPS | API Key + Username | `nodes/connectors/profit_epcg_connector.py` |
| 4 | [SharePoint](05-sharepoint.md) | Documents | MS Graph API | OAuth2 Azure AD | `nodes/sharepoint_connector.py` |
| 5 | [iLevel](06-ilevel.md) | Investments | HTTPS + OAuth2 | Client Credentials | `nodes/ilevel_connector.py` |
| 6 | [Meeting Transcripts](07-transcripts.md) | Transcripts | GraphQL / HTTPS | Bearer Token | `one_on_one/connectors/` |
| 7 | [Microsoft SSO](08-microsoft-sso.md) | Authentication | OAuth2/OIDC | PKCE + Azure AD | `services/microsoft_sso_service.py` |

## Environment Variables Required

```env
# BIPO HRMS
BIPO_USERNAME=
BIPO_PASSWORD=
BIPO_CLIENT_ID=
BIPO_CLIENT_SECRET=

# Profit.co OKR
PROFIT_API_KEY=
PROFIT_API_ACCESS_KEY=

# SharePoint (Microsoft Graph)
SHAREPOINT_TENANT_ID=
SHAREPOINT_CLIENT_ID=
SHAREPOINT_CLIENT_SECRET=
SHAREPOINT_SITE_ID=

# iLevel
ILEVEL_CLIENT_ID=
ILEVEL_CLIENT_SECRET=

# Microsoft SSO
MICROSOFT_SSO_CLIENT_ID=
MICROSOFT_SSO_CLIENT_SECRET=
MICROSOFT_SSO_TENANT_ID=

# Meeting Transcripts
FIREFLIES_API_KEY=

# Redis (for SSO state storage)
REDIS_URL=
```

## Reuse Priority

### Tier 1 - Direct Reuse (Production-tested, well-structured)
- BIPO HRMS Connector (both basic and targeted retrieval)
- Profit.co OKR Production Connector
- Profit.co ePCG Connector
- SharePoint Connector
- Microsoft SSO Service

### Tier 2 - Reuse with Adaptation
- Meeting Transcript Connectors (proven GraphQL/REST patterns)
- iLevel Connector (adapt for different portfolio data)