Talqo Doc

curl "https://talqo.fr/api/job_offers?status=open&per_page=20" \
  -H "X-API-Key: <YOUR_API_KEY>"

curl -X POST "https://talqo.fr/api/job_applications" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Origin: https://careers.my-company.com" \
  -F "job_offer_id=550e8400-e29b-41d4-a716-446655440000" \
  -F "first_name=Jean" \
  -F "last_name=Dupont" \
  -F "email=jean.dupont@example.com" \
  -F "phone=+33123456789" \
  -F "profile_link_linkedin=https://linkedin.com/in/jeandupont" \
  -F "profile_link_github=https://github.com/jeandupont" \
  -F "profile_link_portfolio=https://jeandupont.dev" \
  -F "cover_letter=Je suis motive par ce poste et disponible rapidement." \
  -F "cv=@/path/to/john_doe_resume.pdf;type=application/pdf"

X-API-Key: your-secret-api-key

Authorization: Bearer your-secret-api-key

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 0
Retry-After: 37
Content-Type: application/json

{
  "status": "error",
  "data": null,
  "message": "Too many requests. Please retry later."
}

{
  "status": "error",
  "data": null,
  "message": "Description lisible de l'erreur"
}

curl "https://talqo.fr/api/job_offers?status=open&per_page=20" \
  -H "X-API-Key: <YOUR_API_KEY>"

{
  "status": "success",
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "title": "Full Stack Developer",
      "description": "# About the role\n\nWe are hiring...",
      "location": "Paris, France",
      "job_type": "CDI",
      "salary": 55000,
      "salary_currency": "EUR",
      "show_salary": true,
      "required_profile_links": ["linkedin", "github"],
      "optional_profile_links": ["portfolio", "personal_website"],
      "published_at": "2024-01-15T10:00:00Z",
      "status": "open",
      "updated_at": "2024-01-15T10:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total": 45,
    "total_pages": 3
  }
}

curl "https://talqo.fr/api/job_offers/550e8400-e29b-41d4-a716-446655440000" \
  -H "X-API-Key: <YOUR_API_KEY>"

curl -X POST "https://talqo.fr/api/job_applications" \
  -H "X-API-Key: <YOUR_API_KEY>" \
  -H "Origin: https://careers.my-company.com" \
  -F "job_offer_id=550e8400-e29b-41d4-a716-446655440000" \
  -F "first_name=Jean" \
  -F "last_name=Dupont" \
  -F "email=jean.dupont@example.com" \
  -F "phone=+33123456789" \
  -F "profile_link_linkedin=https://linkedin.com/in/jeandupont" \
  -F "profile_link_github=https://github.com/jeandupont" \
  -F "profile_link_portfolio=https://jeandupont.dev" \
  -F "cover_letter=Je suis motive par ce poste et disponible rapidement." \
  -F "cv=@/path/to/john_doe_resume.pdf;type=application/pdf"

HTTP/1.1 201 Created
Content-Type: application/json

{
  "status": "success",
  "data": {
    "application_id": "c3e5b1d6-4f77-4d3a-9e36-0e6fbbfb77c2",
    "candidate_id": "3d4b1c9b-1a2a-4f51-8a82-2a9f3a2b56aa",
    "status": "new",
    "created_at": "2024-01-15T10:00:00Z"
  }
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "success",
  "data": {
    "application_id": "c3e5b1d6-4f77-4d3a-9e36-0e6fbbfb77c2",
    "candidate_id": "3d4b1c9b-1a2a-4f51-8a82-2a9f3a2b56aa",
    "status": "new",
    "created_at": "2024-01-15T10:00:00Z"
  },
  "message": "Application already exists"
}

interface JobOffer {
  id: string;                  // uuid
  title: string;
  description: string;         // Markdown CommonMark+GFM (**bold**, *italic*, <u>underline</u>, - / 1. lists, [links](url))
  location?: string | null;
  job_type?: string | null;
  salary?: number | null;       // null when show_salary is false
  salary_currency?: string | null; // EUR | USD | GBP | CHF — null when show_salary is false
  show_salary?: boolean;
  required_profile_links?: string[]; // e.g. ["linkedin", "github"]
  optional_profile_links?: string[]; // e.g. ["portfolio", "behance"]
  published_at?: string | null; // ISO 8601
  status?: string;              // "open" | "closed" | "active" | "draft" | ...
  updated_at?: string | null;   // ISO 8601
}

// Transport: multipart/form-data only
// Flat fields in FormData, "cv" is a real file.
interface CreateJobApplicationMultipartFields {
  job_offer_id: string;   // uuid (text field)
  first_name: string;
  last_name: string;
  email: string;          // normalized to lowercase server-side
  cv: File | Blob;        // binary file (PDF or DOCX), <= 10 MB
  phone?: string;
  cover_letter?: string;  // lettre de motivation (texte libre)
  // Profile links (when configured on the job offer): profile_link_<type>
  // See enum table "Profile link types" for all supported type keys and suggested labels.
}

interface CreateJobApplicationResponse {
  application_id: string;       // uuid
  candidate_id: string;         // uuid
  status: "new" | string;       // always "new" on 201; scoring/auto-reject run async after accept
  created_at: string;           // ISO 8601
}

interface JobApplication {
  id: string;                   // uuid
  candidate_id: string;         // uuid
  job_offer_id: string;         // uuid
  status: string;               // candidate_status
  source?: string;              // domaine (ex. "careers.my-company.com")
  created_at: string;           // ISO 8601
  updated_at: string;           // ISO 8601
}

// app/api/career/apply/route.ts
import { NextRequest, NextResponse } from 'next/server';

const TALQO_API_BASE = 'https://talqo.fr/api';
const TALQO_API_KEY = process.env.TALQO_API_KEY!;

export async function POST(request: NextRequest) {
  const incoming = await request.formData();

  // Rebuild FormData for Talqo: forward text fields + profile_link_* keys; CV stays binary.
  const out = new FormData();
  for (const [key, value] of incoming.entries()) {
    if (key === 'cv') continue;
    if (typeof value === 'string' && value) out.append(key, value);
  }
  const cv = incoming.get('cv');
  if (!(cv instanceof File)) {
    return NextResponse.json({ error: 'cv file is required' }, { status: 400 });
  }
  out.append('cv', cv, cv.name);

  const res = await fetch(`${TALQO_API_BASE}/job_applications`, {
    method: 'POST',
    headers: {
      // Do not set Content-Type manually: fetch adds correct multipart boundary.
      'X-API-Key': TALQO_API_KEY,
      'Origin': request.headers.get('origin') ?? '',
    },
    body: out,
  });

  const body = await res.json();
  return NextResponse.json(body, { status: res.status });
}

// Send the file as-is to your proxy; proxy forwards it to talqo.fr.
// Lean payload, no unnecessary client CPU work.
async function submitApplication({ jobOfferId, firstName, lastName, email, phone, coverLetter, profileLinks, cvFile }) {
  const form = new FormData();
  form.append('job_offer_id', jobOfferId);
  form.append('first_name', firstName);
  form.append('last_name', lastName);
  form.append('email', email.toLowerCase());
  if (phone) form.append('phone', phone);
  if (coverLetter) form.append('cover_letter', coverLetter);
  // profileLinks: { github: 'https://...', portfolio: 'https://...' } from offer.required_profile_links / optional_profile_links
  for (const [type, url] of Object.entries(profileLinks || {})) {
    if (url) form.append(`profile_link_${type}`, url);
  }
  form.append('cv', cvFile, cvFile.name);

  const res = await fetch('/api/career/apply', {
    method: 'POST',
    body: form, // Do not set Content-Type manually — browser manages boundary.
  });
  if (!res.ok) throw new Error((await res.json()).message);
  return res.json();
}

function talqo_submit_application(string $job_offer_id, array $candidate, string $cv_path): array {
    // WordPress: manually build multipart body to send CV as binary.
    $boundary = wp_generate_password(24, false);
    $eol = "\r\n";
    $body = '';

    $fields = array_merge(['job_offer_id' => $job_offer_id], $candidate);
    // expected $candidate: first_name, last_name, email, phone, cover_letter,
    // plus profile_link_<type> keys matching the job offer configuration (e.g. profile_link_linkedin).
    foreach ($fields as $name => $value) {
        if ($value === null || $value === '') continue;
        $body .= "--{$boundary}{$eol}";
        $body .= "Content-Disposition: form-data; name=\"{$name}\"{$eol}{$eol}";
        $body .= $value . $eol;
    }

    $cv_bytes = file_get_contents($cv_path);
    $filename = basename($cv_path);
    $body .= "--{$boundary}{$eol}";
    $body .= "Content-Disposition: form-data; name=\"cv\"; filename=\"{$filename}\"{$eol}";
    $body .= "Content-Type: application/pdf{$eol}{$eol}";
    $body .= $cv_bytes . $eol;
    $body .= "--{$boundary}--{$eol}";

    $response = wp_remote_post('https://talqo.fr/api/job_applications', [
        'timeout' => 30,
        'headers' => [
            'X-API-Key'    => getenv('TALQO_API_KEY'),
            'Content-Type' => "multipart/form-data; boundary={$boundary}",
            'Origin'       => home_url(),
        ],
        'body' => $body,
    ]);

    if (is_wp_error($response)) {
        return ['error' => $response->get_error_message()];
    }
    return json_decode(wp_remote_retrieve_body($response), true);
}