Technical documentation for the OSBridge matching engine API.
5 min readReturns a ranked list of open-source issues matched to the authenticated user's skill profile.
Requires a valid NextAuth session. The endpoint uses the session's GitHub ID to look up the user's skill profile.
| 1 | interface MatchResponse { |
| 2 | success: boolean; |
| 3 | data: { |
| 4 | matches: Array<{ |
| 5 | issueId: string; |
| 6 | title: string; |
| 7 | repoFullName: string; |
| 8 | githubUrl: string; |
| 9 | labels: string[]; |
| 10 | matchScore: number; // 0-1 (displayed as percentage) |
| 11 | whyExplanation: string; // AI-generated rationale |
| 12 | commentCount: number; |
| 13 | createdAt: string; |
| 14 | }>; |
| 15 | totalMatches: number; |
| 16 | profileLastSynced: string; |
| 17 | }; |
| 18 | } |
// 401 — Not authenticated
{ "error": "Authentication required" }
// 404 — No skill profile found
{ "error": "No skill profile found. Sync your LeetCode profile first." }
// 500 — Internal server error
{ "error": "Matching engine error" }