Authentification
Token Bearer Sanctum, lié à l'utilisateur et à ses permissions Spatie.
Base URL
http://delyo.welink-ci.com/api/v1
En-têtes requis
À inclure sur chaque requête API.
| Champ | Description | Requis |
|---|---|---|
| Authorization | Bearer <votre_token> | Requis |
| Accept | application/json | Requis |
| Content-Type | application/json (POST, PUT) | Optionnel |
Exemple
Authorization: Bearer <votre_token>
Accept: application/json
Content-Type: application/json
Obtenir un token
Environnement de développement.
Terminal
php artisan tinker
$user = \App\Models\User::where('email', 'vous@exemple.com')->first();
$token = $user->createToken('integration-erp')->plainTextToken;
En production, les vendeurs génèrent leurs tokens depuis le tableau de bord (Tokens API). Ne commitez jamais vos clés dans le code source.
Permissions
Contrôle d'accès par rôle sur chaque route.
| Permission | Usage API | Rôles |
|---|---|---|
| delivery.create | Devis, création, webhook | vendor |
| delivery.view | GET /deliveries, GET /deliveries/{id}, GET /driver, GET /track | vendor, driver, dispatcher |
| delivery.track | Suivi carte | driver, dispatcher, admin |
| delivery.assign | Assignation manuelle (interface web) | dispatcher, admin |
Exemple
GET
/api/v1/admin/health
curl -X GET "http://delyo.welink-ci.com/api/v1/admin/health" \
-H "Authorization: Bearer <votre_token>" \
-H "Accept: application/json"
const res = await fetch("http://delyo.welink-ci.com/api/v1/admin/health", {
method: "GET",
headers: {
Authorization: "Bearer <votre_token>",
Accept: "application/json",
},
});
$response = Http::withToken('<votre_token>')
->acceptJson()
->get('http://delyo.welink-ci.com/api/v1/admin/health');