GET_work_contracts.php 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204
  1. <?php
  2. /**
  3. * Endpoint pour récupérer les contrats de travail (work-contracts) Lucca
  4. *
  5. * Méthode : GET
  6. * Paramètres de query optionnels :
  7. * - page: Index de la page à récupérer (commence à 1)
  8. * - limit: Nombre d'items par page (max 1000)
  9. * - fields.root: "count" pour récupérer le nombre total d'items
  10. * - ownerId: ID(s) de l'employé (peut être un array, ex: ownerId=1,2,3)
  11. * - isApplicable: true/false pour filtrer les contrats applicables
  12. * - isArchived: true/false pour filtrer les contrats archivés
  13. * - typeId: ID(s) du type de contrat (peut être un array, ex: typeId=1,2)
  14. * - establishmentId: ID(s) de l'établissement (peut être un array, ex: establishmentId=13,14)
  15. *
  16. * Exemples d'utilisation :
  17. * - GET /get_work_contracts.php
  18. * - GET /get_work_contracts.php?ownerId=416
  19. * - GET /get_work_contracts.php?ownerId=416&isApplicable=true
  20. * - GET /get_work_contracts.php?limit=50&page=2
  21. * - GET /get_work_contracts.php?establishmentId=13&typeId=1
  22. *
  23. * Réponse : {"success": true, "work_contracts": [...], "count": 1}
  24. */
  25. // Activation du débogage
  26. ini_set('display_errors', 1);
  27. ini_set('display_startup_errors', 1);
  28. error_reporting(E_ALL);
  29. function json_response(int $statusCode, array $payload): void {
  30. http_response_code($statusCode);
  31. header('Content-Type: application/json; charset=utf-8');
  32. echo json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
  33. exit;
  34. }
  35. // Charge le client API Lucca
  36. require_once __DIR__ . '/../lucca_client.php';
  37. // Récupère les paramètres de query
  38. $query_params = [];
  39. // Pagination
  40. if (isset($_GET['page'])) {
  41. $page = (int)$_GET['page'];
  42. if ($page >= 1) {
  43. $query_params['page'] = $page;
  44. }
  45. }
  46. if (isset($_GET['limit'])) {
  47. $limit = (int)$_GET['limit'];
  48. if ($limit >= 0 && $limit <= 1000) {
  49. $query_params['limit'] = $limit;
  50. }
  51. }
  52. // Count total
  53. if (isset($_GET['fields.root']) && $_GET['fields.root'] === 'count') {
  54. $query_params['fields.root'] = 'count';
  55. }
  56. // Filtres
  57. if (isset($_GET['ownerId'])) {
  58. // Peut être un seul ID ou une liste séparée par des virgules
  59. $query_params['ownerId'] = $_GET['ownerId'];
  60. }
  61. if (isset($_GET['isApplicable'])) {
  62. // Convertir en booléen string pour l'API
  63. $isApplicable = filter_var($_GET['isApplicable'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
  64. if ($isApplicable !== null) {
  65. $query_params['isApplicable'] = $isApplicable ? 'true' : 'false';
  66. }
  67. }
  68. if (isset($_GET['isArchived'])) {
  69. // Convertir en booléen string pour l'API
  70. $isArchived = filter_var($_GET['isArchived'], FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
  71. if ($isArchived !== null) {
  72. $query_params['isArchived'] = $isArchived ? 'true' : 'false';
  73. }
  74. }
  75. if (isset($_GET['typeId'])) {
  76. // Peut être un seul ID ou une liste séparée par des virgules
  77. $query_params['typeId'] = $_GET['typeId'];
  78. }
  79. if (isset($_GET['establishmentId'])) {
  80. // Peut être un seul ID ou une liste séparée par des virgules
  81. $query_params['establishmentId'] = $_GET['establishmentId'];
  82. }
  83. // Requête GET vers l'API Lucca pour récupérer les work-contracts
  84. // Documentation: https://developers.lucca.fr/api-reference/directory/list-work-contracts
  85. $result = lucca_request('GET', '/directory/api/4.0/work-contracts', $query_params, null, 60, false);
  86. // ✅ Gestion unifiée des erreurs
  87. if (!empty($result['error']) || !empty($result['lucca_error']) || !empty($result['error_message']) ||
  88. $result['code'] !== 200) {
  89. $error_response = [
  90. "error" => "Erreur lors de la récupération des contrats de travail",
  91. "http_code" => $result['code']
  92. ];
  93. // Déterminer le message d'erreur le plus pertinent
  94. if (!empty($result['error'])) {
  95. $error_response['message'] = $result['error'];
  96. } elseif (!empty($result['lucca_error'])) {
  97. $error_response['message'] = $result['lucca_error'];
  98. } elseif (!empty($result['error_message'])) {
  99. $error_response['message'] = $result['error_message'];
  100. } elseif (isset($result['data']['title'])) {
  101. $error_response['message'] = $result['data']['title'];
  102. } elseif (isset($result['data']['message'])) {
  103. $error_response['message'] = $result['data']['message'];
  104. } else {
  105. $error_response['message'] = "Erreur inconnue";
  106. }
  107. // Ajouter tous les détails disponibles de l'erreur Lucca
  108. if (!empty($result['lucca_error'])) {
  109. $error_response['lucca_error_header'] = $result['lucca_error'];
  110. }
  111. // Ajouter tous les headers de réponse pour diagnostic complet
  112. if (!empty($result['headers'])) {
  113. $error_response['response_headers'] = $result['headers'];
  114. }
  115. // Ajouter les détails complets de la réponse si disponibles
  116. if (!empty($result['data'])) {
  117. $error_response['lucca_response'] = $result['data'];
  118. }
  119. // Ajouter le body brut pour diagnostic
  120. if (!empty($result['body'])) {
  121. $error_response['raw_response_body'] = $result['body'];
  122. }
  123. // Ajouter les informations curl pour diagnostic
  124. if (!empty($result['curl_info'])) {
  125. $error_response['curl_info'] = $result['curl_info'];
  126. }
  127. // Ajouter l'URL complète de la requête pour diagnostic
  128. if (!empty($result['curl_info']['url'])) {
  129. $error_response['request_url'] = $result['curl_info']['url'];
  130. }
  131. // Ajouter les paramètres de query pour diagnostic
  132. $error_response['query_params_sent'] = $query_params;
  133. // Suggestion pour les erreurs 401 (problème d'authentification)
  134. if ($result['code'] === 401) {
  135. $error_response['suggestion'] = "Erreur 401 Unauthorized : Le token API est invalide ou a expiré.";
  136. $error_response['solution'] = [
  137. "1" => "Vérifiez que le token API est correct dans lucca_client.php",
  138. "2" => "Vérifiez que le token n'a pas expiré",
  139. "3" => "Dans Lucca, allez dans : Configuration > API > Applications tierces"
  140. ];
  141. }
  142. // Suggestion pour les erreurs 403 (problème de permissions)
  143. if ($result['code'] === 403) {
  144. $error_response['suggestion'] = "Erreur 403 Forbidden : Le token API n'a pas les permissions nécessaires pour lire les contrats de travail.";
  145. $error_response['solution'] = [
  146. "1" => "Vérifiez que le token API a les droits de lecture sur les contrats de travail",
  147. "2" => "Dans Lucca, allez dans : Configuration > API > Applications tierces",
  148. "3" => "Vérifiez les permissions accordées au token",
  149. "4" => "Le token doit avoir au minimum les permissions : 'Work Contracts - Read' ou 'Admin'"
  150. ];
  151. }
  152. // Suggestion pour les erreurs 400 (probablement des paramètres invalides)
  153. if ($result['code'] === 400) {
  154. $error_response['suggestion'] = "Une erreur 400 peut indiquer des paramètres de requête invalides.";
  155. $error_response['params_sent'] = $query_params;
  156. $error_response['check'] = [
  157. "page" => "Doit être >= 1",
  158. "limit" => "Doit être entre 0 et 1000",
  159. "isApplicable" => "Doit être un booléen (true/false)",
  160. "isArchived" => "Doit être un booléen (true/false)"
  161. ];
  162. }
  163. json_response($result['code'] ?: 500, $error_response);
  164. }
  165. // Récupère les work-contracts depuis le data déjà parsé
  166. $work_contracts = $result['data']['items'] ?? [];
  167. $count = $result['data']['count'] ?? count($work_contracts);
  168. // Réponse finale
  169. json_response(200, [
  170. "success" => true,
  171. "message" => "Contrats de travail récupérés avec succès",
  172. "work_contracts" => $work_contracts,
  173. "count" => $count,
  174. "query_params" => $query_params
  175. ]);