📌 Introduction

Cette documentation API s’adresse aux utilisateurs disposant d’un site carriĂšre. Elle dĂ©taille le mĂ©canisme d’authentification basĂ© sur un client_id et un client_secret, permettant d’obtenir un access_token pour accĂ©der aux ressources protĂ©gĂ©es.

Elle explique Ă©galement comment transmettre une candidature via un webhook API, en l’associant Ă  une opportunitĂ© existante dans l’espace utilisateur.

🛠 Base URL :

https://app.marvinrecruiter.com/api/

🔑 Flux d'authentification

  1. Obtenir un authorization_code via /website/auth/authorize
  2. Échanger l’authorization_code contre un access_token via /website/auth/token
  3. VĂ©rifier l’authentification avec /website/auth/check

🔐 Authentification

1ïžâƒŁ Obtenir un authorization_code

🛠 RequĂȘte

POST /website/auth/authorize

📌 Paramùtres

Champ Type Obligatoire Description
client_id string ✅ Oui Identifiant client
client_secret string ✅ Oui Secret client

đŸ“„ Exemple de requĂȘte

{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret"
}

đŸ“€ RĂ©ponses possibles

Code Message
200 OK { "authorization_code": "abcd1234", "expiresAt": "2024-02-18T12:00:00Z" }
401 Unauthorized { "message": { "error": "Invalid client_id or client_secret" } }