Api BCVTC

Liera votre site internet à l'application BCVTC.

Cela vous permet de recevoir les courses et les demandes de réservations effectuées sur votre site directement sur l'application BCVTC.

Si vous avez des questions n'hesitez pas à nous contacter

Php BUILDER

Si vous utilisez PHP dans votre projet, nous vous conseillons d'utiliser notre PHP Builder.

Request Price (CURL Php)

Endpoint : http://bcvtc.fr/api/v2/request/ Méthode : POST

Vous pouvez avant chaque requête de création "CREATE REQUEST" faire une demande de prix

L'API BCVTC va vous répondre avec un JSON object qui contient toutes les informations liées à la requête, voici un example :

Exemple de la requête

$data = [
    'apikey'            => "8aae855c8f174f1e6fd7a41b65d9081d",			
    'pickupaddress'     => "37 Rue du Rocher, 75008 Paris",			
    'dropoffaddress'    => '50 avenue daumesnil 75012 paris',										
    'triptype'          => '10'
    ];

$curl = curl_init();

    curl_setopt_array($curl,[

        CURLOPT_RETURNTRANSFER => 1,

        CURLOPT_URL => "http://bcvtc.fr/api/v2/request/",

        CURLOPT_POST => 1,

        CURLOPT_SSL_VERIFYPEER => 0,

        CURLOPT_POSTFIELDS => http_build_query($data)

    ]);

    $response = curl_exec($curl);

    echo $response;
            
curl_close($curl);

(*) Paramètre obligatoire

Paramètre Description Type
apikey * La clé API de l'utilisateur, vous la trouvez dans l'application BCVTC > Paramètre > Api String
pickupaddress * Adresse de départ, exemple : (37 Rue du Rocher, 75008 Paris), si google n'arrive pas à reconnaitre l'adresse, le calcul renvoie un FALSE String
dropoffaddress * Pareil que l'adresse de départ String
triptype * 10 pour déplacement, et 20 pour mise à disposition, sachez que si la valeur de (triptype) est (20) le MadKms et MadHours sont obligatoires Int ou String
MadKms Nombre de kilomètres pour la mise à disposition, si le (triptype) est (20), MadKms evient obligatoire Int
MadHours Nombre d'heures pour la mise à disposition, si le (triptype) est (20), MadHours devient obligatoire Int

Exemple de réponse

{
  "status": 200,
  "message": "RequestOK",
  "response": {
    "Route": {
      "DropOffAddress": [
        "50 Avenue Daumesnil, 75012 Paris, France"
      ],
      "PickUpAddress": [
        "37 Rue du Rocher, 75008 Paris, France"
      ],
      "DistanceText": "7,0 km",
      "DistanceValue": 7023,
      "DurationText": "23 minutes",
      "DurationValue": 1407
    },
    "CarsPrice": {
      "1": {
        "CarId": "2",
        "TripType": "10",
        "CarName": "MERCEDES GLE",
        "CarVIN": "DS-879-ZE",
        "CarPicutreBase64": "Base64String",
        "CarPriceForKM": "1.3",
        "CarPriceForMinute": "0.3",
        "CarTripTimePrice": "7.04",
        "CarTripKmPrice": "9.13",
        "CarTripPriceHT": "16.16",
        "CarTripPriceTextHT": "16,16 € HT",
        "CarTripPriceTTC": "17.78",
        "CarTripPriceTextTTC": "17,78 € TTC",
        "ApplicateTva": true
      },
      "2": {
        "CarId": "3",
        "TripType": "10",
        "CarName": "MERCEDES Classe A",
        "CarVIN": "DA-888-CS",
        "CarPicutreBase64": "Base64String",
        "CarPriceForKM": "1",
        "CarPriceForMinute": "0.2",
        "CarTripTimePrice": "4.69",
        "CarTripKmPrice": "7.02",
        "CarTripPriceHT": "11.71",
        "CarTripPriceTextHT": "11,71 € HT",
        "CarTripPriceTTC": "12.88",
        "CarTripPriceTextTTC": "12,88 € TTC",
        "ApplicateTva": true
      }
    }
  }
}

Create Request (CURL Php)

Endpoint : http://bcvtc.fr/api/v2/create/ Méthode : POST

Vous pouvez créer des bons de commandes / demandes de réservation via l'API BCVTC.

Pour cela vous devez envoyer les paramètres suivants :


$data = [
    'apikey'                    => "8aae855c8f174f1e6fd7a41b65d9081d",			
    'request'                   => "1",			
    'client_civ'                => 'Mr',
    'client_first_name'         => "Ahmed",			
    'client_last_name'          => "Laggoun",			
    'client_email'              => 'mail@site.fr',
    'client_phone'              => "0601020304",			
    'client_comment'            => "Bonjour",			
    'paxes'                     => '1',
    'pickupaddress'             => "37 Rue du Rocher, 75008 Paris",			
    'dropoffaddress'            => "50 avenue daumesnil 75012 paris",			
    'triptype'                  => '10',
    'carid'                     => "3",			
    'distancetext'              => "20 kms",			
    'durationtext'              => '20 minutes',
    'price_ht'                  => 20.00,			
    'price_ttc'                 => 20.20,			
    'pay_methode'               => 'es',
    'pickupdatetime'            => '2017-03-03 20:20:20',
    'driverid'                  => '2'
    ];

$curl = curl_init();

    curl_setopt_array($curl,[

        CURLOPT_RETURNTRANSFER => 1,

        CURLOPT_URL => "http://bcvtc.fr/api/v2/create/",

        CURLOPT_POST => 1,

        CURLOPT_SSL_VERIFYPEER => 0,

        CURLOPT_POSTFIELDS => http_build_query($data)

    ]);

    $response = curl_exec($curl);

    echo $response;
            
curl_close($curl);

(*) Paramètre obligatoire

Paramètre Description Type
apikey * La clé API de l'utilisateur, vous la trouvez dans l'application BCVTC > Paramètre > Api String
request * Le type de la requête, 1 pour BON DE COMMANDE et 3 pour DEMANDE DE RESERVATION, si la requête est une demande de réservation, le client va recevoir un mail qui lui demande de confirmer son adresse email. Int ou String
client_civ * Mr , Mme, Ste String
client_first_name * Nom de famille client String
client_last_name * Prénom du client String
client_email * Email client, si la requête est une demande de réservation, le mail de confirmation de la commande sera envoyé sur cette adresse String
client_phone * Numéro de téléphone client String
client_comment Commentaire client String
paxes * Nombre de passagers de 1 à 8 max Int ou String
pickupaddress * Adresse de départ, exemple : (37 Rue du Rocher, 75008 Paris), si google n'arrive pas à reconnaitre l'adresse, le calcul renvoie un FALSE String
dropoffaddress * Pareil que l'adresse de départ String
triptype * 10 pour déplacement, et 20 pour mise à disposition, sachez que si la valeur de (triptype) est (20) le MadKms et MadHours sont obligatoires Int ou String
MadKms Nombre de kilomètres pour la mise à disposition, si la valeur de (triptype) est (20), MadKms devient obligatoire Int
MadHours Nombre d'heures pour la mise à disposition, si la valeur de (triptype) est (20), MadHours devient obligatoire Int
carid l'ID du véhicule (Incluse dans la réponse d'une Price Request , exemple : "CarId": "3") Int ou String
distancetext (optionnel) Le texte de la distance envoyé par Google Maps ( exemple : 30 kms) String
durationtext (optionnel) Le texte de la durée envoyé par Google Maps ( exemple : 32 minutes ou 1 heures et 5 minutes String
price_ht * Prix de la course HT (exemple : 30.00 pour 30,00 €) Int
price_ttc * Prix de la course TTC (exemple : 35.00 pour 35,00 €) Int
pay_methode * Es : espèce, Cb : Carte bancaire, Ch : chèque , Au : autre String
pickupdatetime * La date et l'heure de prise en charge, format YYYY-MM-DD HH:ii:SS, doit être supérieur String
driverid Si vous connaissez l'ID du chauffeur, BCVTC enverra un mail automatiquement au chauffeur indiqué, sinon l'application va automatiquement assigné la course au possesseur du compte BCVTC Int ou String

Exemple de réponse

{
  "status": 200,
  "message": "RequestCreated",
  "response": {
    "TicketId": "VOqeMd16dOIK",
    "Message": "Pending client email confirmation"
  }
}

Get Ticket

Endpoint : http://bcvtc.fr/api/v2/ticket/ Méthode : GET

Vous pouvez récupérer les informations d'un bon de commande VALIDE.

http://bcvtc.fr/api/v2/ticket/

(*) Paramètre obligatoire

Paramètre Description Type
apikey * La clé API de l'utilisateur, vous la trouvez dans l'application BCVTC > Paramètre > Api String
ticketid * l'ID du bon. String

Exemple de la réponse


{
  "status": 200,
  "message": "TicketOK",
  "response": {
    "TicketId": "eyIJX2rmhbL7",
    "RequestDate": "2017-05-23 20:39:55",
    "ClientId": null,
    "DriverId": "0",
    "ClientCiv": "Mr",
    "ClientLastName": "LAGGOUN",
    "ClientFirstName": "Ahmed",
    "ClientEmail": "mail@site.fr",
    "ClientPhone": "0601020304",
    "Paxes": "1",
    "PickUpDate": "2017-05-28 19:35:00",
    "PickUpAddress": "30 Rue de Dunkerque, 75010 Paris, France",
    "DropOffAddress": "50 Rue de Dunkerque, 75010 Paris, France",
    "TripType": "10",
    "PriceHT": "10",
    "PriceTTC": "11",
    "PayMethode": "es",
    "TripKm": null,
    "TripMinutes": null,
    "CarId": "7",
    "TripComment": "test",
    "IsPayed": "0"
  }
}