DOCUMENTATION OFFICIELLE
PhilBuilder API v1
Lance des builds Android et Windows par programmation — sans passer par l'interface web.
🔐 Authentification
L'API PhilBuilder utilise deux types de tokens.
1. PhilAuth Token (session utilisateur)
Obtenu via PhilAuth (/v1/login). Utilisé pour gérer tes clés API.
Session PhilIdentity
Authorization: Bearer <phil_token>
🔄 Refresh automatique : Le token est stocké en mémoire et renouvelé automatiquement via le refresh token.
2. Clé API (phil_...)
Générée via POST /api/v1/keys. Utilisée pour lancer des builds.
Clé API
Authorization: Bearer phil_test_key_...
⚠️ Important : Le
card_code est le numéro de ta carte PhilCard (16 chiffres, sans espaces).
🔑 Gestion des clés API
Connecte-toi avec ton PhilMail pour gérer tes clés API.
👤
💰 Solde : --- PC
📊 Rôle : user
⚠️ Copie cette clé maintenant — elle ne sera plus jamais affichée en entier.
Chargement de tes clés…
📋 Forfaits API
| Forfait | Prix | Durée | Builds/jour | Langages |
|---|---|---|---|---|
| Gratuit | 0 PC | 7 jours | 3 | Cordova & Capacitor |
| Beginner | 60 PC | 19 jours | 15 | Cordova, Capacitor & React |
| Starter | 120 PC | 30 jours | 40 | Tous |
| Équipe | 550 PC | 30 jours | Illimité | Tous |
| Équipe Pro | 900 PC | 60 jours | Illimité | Tous |
| Custom | 4 PC / 3 builds | — | Pay-as-you-go | Tous |
| Entreprise | 40 000 PC | Illimité | Illimité | Tous + Support prioritaire |
🔑 Créer une clé API
POST
/api/v1/keys
Session PhilIdentity
curl -X POST https://apk-builder.philtech-organisation.workers.dev/api/v1/keys \
-H "Authorization: Bearer <phil_token>" \
-H "Content-Type: application/json" \
-d '{
"plan_type": "starter",
"key_name": "ma-cle-ci",
"card_code": "4986950139370036",
"full_name": "Henock Agbo"
}'
📋 Lister les clés
GET
/api/v1/keys
Session PhilIdentity
curl https://apk-builder.philtech-organisation.workers.dev/api/v1/keys \ -H "Authorization: Bearer <phil_token>"
🗑️ Révoquer une clé
DELETE
/api/v1/keys
Session PhilIdentity
curl -X DELETE https://apk-builder.philtech-organisation.workers.dev/api/v1/keys \
-H "Authorization: Bearer <phil_token>" \
-H "Content-Type: application/json" \
-d '{"key": "phil_test_key_..."}'
🔄 Recharger une clé Custom
POST
/api/v1/keys/recharge
Session PhilIdentity
curl -X POST https://apk-builder.philtech-organisation.workers.dev/api/v1/keys/recharge \
-H "Authorization: Bearer <phil_token>" \
-H "Content-Type: application/json" \
-d '{"key": "phil_test_key_...", "amount": 8}'
📦 Uploader le ZIP
POST
/api/upload-zip
Public
curl -X POST https://apk-builder.philtech-organisation.workers.dev/api/upload-zip \ -F "zip=@./projet.zip"
🖼️ Uploader l'icône
POST
/api/upload-icon
Public
curl -X POST https://apk-builder.philtech-organisation.workers.dev/api/upload-icon \ -F "icon=@./icone.png"
🚀 Lancer un build
POST
/api/v1/build
Clé API
curl -X POST https://apk-builder.philtech-organisation.workers.dev/api/v1/build \
-H "Authorization: Bearer phil_test_key_..." \
-H "Content-Type: application/json" \
-d '{
"zip_url": "https://.../source.zip",
"app_name": "Mon App",
"project_type": "flutter"
}'
📋 Lister les builds
GET
/api/v1/builds
Clé API
curl https://apk-builder.philtech-organisation.workers.dev/api/v1/builds \ -H "Authorization: Bearer phil_test_key_..."
📊 Statut d'un build
GET
/api/v1/builds/:id
Clé API
curl https://apk-builder.philtech-organisation.workers.dev/api/v1/builds/f1b7347d... \ -H "Authorization: Bearer phil_test_key_..."
💳 PhilCard
GET
/api/card/balance
Session PhilIdentity
curl https://apk-builder.philtech-organisation.workers.dev/api/card/balance \ -H "Authorization: Bearer <phil_token>"
GET
/api/card/transactions
Session PhilIdentity
curl https://apk-builder.philtech-organisation.workers.dev/api/card/transactions \ -H "Authorization: Bearer <phil_token>"
📊 Admin — Statistiques
GET
/api/admin/stats
Admin requis
curl https://apk-builder.philtech-organisation.workers.dev/api/admin/stats \ -H "Authorization: Bearer <phil_token>"
📋 Admin — Tous les builds
GET
/api/admin/builds
Admin requis
curl https://apk-builder.philtech-organisation.workers.dev/api/admin/builds \ -H "Authorization: Bearer <phil_token>"
📁 Types de projet
webreactvue
svelteangularsolidjs
preactioniccapacitor
react-nativekotlinjava
kotlin-multiplatformflutter
dotnet-mauicsharp
pythongo
godotluarubynativescript
❌ Codes d'erreur
| Code | Signification | Action |
|---|---|---|
| 401 | Clé API ou session invalide | Reconnecte-toi |
| 400 | Champ requis manquant ou invalide | Relis la doc |
| 402 | Solde PhilCard insuffisant | Recharge sur PhilCard |
| 403 | Clé de service invalide | Vérifie service_key |
| 404 | Build ou clé introuvable | Vérifie l'ID |
| 429 | Quota journalier atteint | Attends minuit |