| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204 |
- <?php
- /**
- * Endpoint pour récupérer les contrats de travail (work-contracts) Lucca
- *
- * Méthode : GET
- * Paramètres de query optionnels :
- * - page: Index de la page à récupérer (commence à 1)
- * - limit: Nombre d'items par page (max 1000)
- * - fields.root: "count" pour récupérer le nombre total d'items
- * - ownerId: ID(s) de l'employé (peut être un array, ex: ownerId=1,2,3)
- * - isApplicable: true/false pour filtrer les contrats applicables
- * - isArchived: true/false pour filtrer les contrats archivés
- * - typeId: ID(s) du type de contrat (peut être un array, ex: typeId=1,2)
- * - establishmentId: ID(s) de l'établissement (peut être un array, ex: establishmentId=13,14)
- *
- * Exemples d'utilisation :
- * - GET /get_work_contracts.php
- * - GET /get_work_contracts.php?ownerId=416
- * - GET /get_work_contracts.php?ownerId=416&isApplicable=true
- * - GET /get_work_contracts.php?limit=50&page=2
- * - GET /get_work_contracts.php?establishmentId=13&typeId=1
- *
- * Réponse : {"success": true, "work_contracts": [...], "count": 1}
- */
- // Activation du débogage
- ini_set('display_errors', 1);
- ini_set('display_startup_errors', 1);
- error_reporting(E_ALL);
- function json_response(int $statusCode, array $payload): void {
- http_response_code($statusCode);
- header('Content-Type: application/json; charset=utf-8');
- echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
- exit;
- }
- // Charge le client API Lucca
- require_once __DIR__ . '/lucca_client.php';
- // Récupère les paramètres de query
- $query_params = [];
- // Pagination
- if (isset($_GET['page'])) {
- $page = (int)$_GET['page'];
- if ($page >= 1) {
- $query_params['page'] = $page;
- }
- }
- if (isset($_GET['limit'])) {
- $limit = (int)$_GET['limit'];
- if ($limit >= 0 && $limit <= 1000) {
- $query_params['limit'] = $limit;
- }
- }
- // Count total
- if (isset($_GET['fields.root']) && $_GET['fields.root'] === 'count') {
- $query_params['fields.root'] = 'count';
- }
- // Filtres
- if (isset($_GET['ownerId'])) {
- // Peut être un seul ID ou une liste séparée par des virgules
- $query_params['ownerId'] = $_GET['ownerId'];
- }
- if (isset($_GET['isApplicable'])) {
- // Convertir en booléen string pour l'API
- $isApplicable = filter_var($_GET['isApplicable'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
- if ($isApplicable !== null) {
- $query_params['isApplicable'] = $isApplicable ? 'true' : 'false';
- }
- }
- if (isset($_GET['isArchived'])) {
- // Convertir en booléen string pour l'API
- $isArchived = filter_var($_GET['isArchived'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
- if ($isArchived !== null) {
- $query_params['isArchived'] = $isArchived ? 'true' : 'false';
- }
- }
- if (isset($_GET['typeId'])) {
- // Peut être un seul ID ou une liste séparée par des virgules
- $query_params['typeId'] = $_GET['typeId'];
- }
- if (isset($_GET['establishmentId'])) {
- // Peut être un seul ID ou une liste séparée par des virgules
- $query_params['establishmentId'] = $_GET['establishmentId'];
- }
- // Requête GET vers l'API Lucca pour récupérer les work-contracts
- // Documentation: https://developers.lucca.fr/api-reference/directory/list-work-contracts
- $result = lucca_request('GET', '/directory/api/4.0/work-contracts', $query_params, null, 60, false);
- // ✅ Gestion unifiée des erreurs
- if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
- $result['code'] !== 200) {
-
- $error_response = [
- "error" => "Erreur lors de la récupération des contrats de travail",
- "http_code" => $result['code']
- ];
-
- // Déterminer le message d'erreur le plus pertinent
- if (!empty($result['error'])) {
- $error_response['message'] = $result['error'];
- } elseif (!empty($result['lucca_error'])) {
- $error_response['message'] = $result['lucca_error'];
- } elseif (!empty($result['error_message'])) {
- $error_response['message'] = $result['error_message'];
- } elseif (isset($result['data']['title'])) {
- $error_response['message'] = $result['data']['title'];
- } elseif (isset($result['data']['message'])) {
- $error_response['message'] = $result['data']['message'];
- } else {
- $error_response['message'] = "Erreur inconnue";
- }
-
- // Ajouter tous les détails disponibles de l'erreur Lucca
- if (!empty($result['lucca_error'])) {
- $error_response['lucca_error_header'] = $result['lucca_error'];
- }
-
- // Ajouter tous les headers de réponse pour diagnostic complet
- if (!empty($result['headers'])) {
- $error_response['response_headers'] = $result['headers'];
- }
-
- // Ajouter les détails complets de la réponse si disponibles
- if (!empty($result['data'])) {
- $error_response['lucca_response'] = $result['data'];
- }
-
- // Ajouter le body brut pour diagnostic
- if (!empty($result['body'])) {
- $error_response['raw_response_body'] = $result['body'];
- }
-
- // Ajouter les informations curl pour diagnostic
- if (!empty($result['curl_info'])) {
- $error_response['curl_info'] = $result['curl_info'];
- }
-
- // Ajouter l'URL complète de la requête pour diagnostic
- if (!empty($result['curl_info']['url'])) {
- $error_response['request_url'] = $result['curl_info']['url'];
- }
-
- // Ajouter les paramètres de query pour diagnostic
- $error_response['query_params_sent'] = $query_params;
-
- // Suggestion pour les erreurs 401 (problème d'authentification)
- if ($result['code'] === 401) {
- $error_response['suggestion'] = "Erreur 401 Unauthorized : Le token API est invalide ou a expiré.";
- $error_response['solution'] = [
- "1" => "Vérifiez que le token API est correct dans lucca_client.php",
- "2" => "Vérifiez que le token n'a pas expiré",
- "3" => "Dans Lucca, allez dans : Configuration > API > Applications tierces"
- ];
- }
-
- // Suggestion pour les erreurs 403 (problème de permissions)
- if ($result['code'] === 403) {
- $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour lire les contrats de travail.";
- $error_response['solution'] = [
- "1" => "Vérifiez que le token API a les droits de lecture sur les contrats de travail",
- "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
- "3" => "Vérifiez les permissions accordées au token",
- "4" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Read' ou 'Admin'"
- ];
- }
-
- // Suggestion pour les erreurs 400 (probablement des paramètres invalides)
- if ($result['code'] === 400) {
- $error_response['suggestion'] = "Une erreur 400 peut indiquer des paramètres de requête invalides.";
- $error_response['params_sent'] = $query_params;
- $error_response['check'] = [
- "page" => "Doit être >= 1",
- "limit" => "Doit être entre 0 et 1000",
- "isApplicable" => "Doit être un booléen (true/false)",
- "isArchived" => "Doit être un booléen (true/false)"
- ];
- }
-
- json_response($result['code'] ?: 500, $error_response);
- }
- // Récupère les work-contracts depuis le data déjà parsé
- $work_contracts = $result['data']['items'] ?? [];
- $count = $result['data']['count'] ?? count($work_contracts);
- // Réponse finale
- json_response(200, [
- "success" => true,
- "message" => "Contrats de travail récupérés avec succès",
- "work_contracts" => $work_contracts,
- "count" => $count,
- "query_params" => $query_params
- ]);
|