Aller au contenu principal

Obtenir les informations détaillées d'une entreprise

Ce point d'accès permet de récupérer les informations complètes d'une entreprise à laquelle vous avez accès. Vous pouvez récupérer les informations d'une entreprise en utilisant l'une des deux méthodes suivantes :

  • id : Identifiant de l'entreprise dans notre base de données
  • ref_id : Identifiant de l'entreprise dans votre système

Dans le cas où vous fourniriez les deux paramètres id et ref_id, l'identifiant id sera prioritaire.

Pour chercher une entreprise sans fournir d'identifiant, veuillez utiliser le point d'accès liste des entreprises.

L'entreprise doit être liée à votre compte avant de pouvoir consulter ou mettre à jour ses informations. Pour ce faire, utiliser la documentation créer/associer une entreprise.

Point d'accès

POST https://canadamotorjobs.com/api/v1/{locale}/businesses/get

Paramètres

ParamètreTypeDescriptionObligatoire
idstringL'identifiant de l'entrepriserequis ou ref_id
ref_idstringL'identifiant de l'entreprise dans votre systèmerequis ou id
api_tokenstringVotre clé d'APIrequis ou bearer token

Erreurs

CodeMessage
401Unauthorized
404Not Found
500Internal Server Error

Exemple de code

// Laravel PHP
use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
'Authorization' => 'Bearer your_api_token'
])->post("https://canadamotorjobs.com/api/v1/fr/businesses/get", [
'id' => 'abc1234567890' ?? null, // L'identifiant de l'entreprise dans notre base de données
'ref_id' => '1234567890' ?? null, // L'identifiant de l'entreprise dans votre système
'api_token' => 'your_api_token' ?? null // Votre clé d'API, si vous n'utilisez pas le bearer token
]);

if ($response->successful()) {
$business = $response->json();
// Traiter les données de l'entreprise
} else {
// Gérer l'erreur
$error = $response->json();
}