# Toutes les routes

> La surface publique en une page, à garder ouverte.

Tout ce que l'API expose publiquement, dans l'ordre où on s'en sert. Les routes qui ne
figurent pas ici — l'administration, le protocole du daemon, les parcours de paiement —
ne sont pas un contrat : elles bougent sans préavis.

Racine : `https://api.arkya.gg` · En-tête : `Authorization: Bearer ark_…`

| Verbes | Route | Ce qu'elle fait |
| --- | --- | --- |
| `GET` | `/api/resources` | Lister les services |
| `GET DELETE` | `/api/resources/{id}` | Lire ou supprimer un service |
| `GET` | `/api/resources/metrics` | L'état en direct, jusqu'à 50 services |
| `POST` | `/api/resources/{id}/power` | Démarrer, arrêter, redémarrer, tuer |
| `POST` | `/api/resources/{id}/suspend` | Suspendre |
| `POST` | `/api/resources/{id}/resume` | Rétablir |
| `GET` | `/api/resources/{id}/settings` | Tous les réglages |
| `PUT` | `/api/resources/{id}/scale` | Changer la taille |
| `PUT` | `/api/resources/{id}/network` | Ouvrir ou fermer sur Internet |
| `PUT` | `/api/resources/{id}/deploy` | La commande de démarrage |
| `PUT` | `/api/resources/{id}/project` | Changer de projet |
| `GET PUT` | `/api/resources/{id}/variables` | Les réglages lus au démarrage |
| `GET` | `/api/resources/{id}/logs` | Le journal du service |
| `GET` | `/api/resources/{id}/events` | L'activité administrative |
| `GET` | `/api/resources/{id}/usage` | La consommation jour par jour |
| `GET` | `/api/resources/{id}/billed-totals` | Le total facturé |
| `GET` | `/api/resources/{id}/console` | Le ticket de console |
| `POST` | `/api/resources/{id}/command` | Une commande à la console |
| `GET` | `/api/resources/{id}/files` | Lister un dossier |
| `GET` | `/api/resources/{id}/files/contents` | Lire un fichier |
| `POST` | `/api/resources/{id}/files/write` | Écrire un fichier |
| `POST` | `/api/resources/{id}/files/directory` | Créer un dossier |
| `PUT` | `/api/resources/{id}/files/rename` | Renommer |
| `POST` | `/api/resources/{id}/files/delete` | Supprimer des fichiers |
| `GET POST` | `/api/resources/{id}/backups` | Les sauvegardes |
| `DELETE` | `/api/resources/{id}/backups/{backupId}` | Supprimer une sauvegarde |
| `POST` | `/api/resources/{id}/backups/{backupId}/restore` | Restaurer une sauvegarde |
| `GET POST` | `/api/resources/{id}/snapshots` | Les instantanés |
| `DELETE` | `/api/resources/{id}/snapshots/{name}` | Supprimer un instantané |
| `POST` | `/api/resources/{id}/snapshots/{name}/rollback` | Reprendre depuis un instantané |
| `GET` | `/api/resources/{id}/sftp` | L'accès SFTP |
| `POST` | `/api/resources/{id}/sftp/password` | Générer un mot de passe SFTP |
| `GET` | `/api/resources/{id}/database` | L'inventaire de la base |
| `GET` | `/api/resources/{id}/database/connection` | La chaîne de connexion |
| `GET` | `/api/resources/{id}/database/rows` | Les lignes d'une table |
| `POST` | `/api/resources/{id}/database/query` | Une requête SQL |
| `GET POST` | `/api/projects` | Les projets |
| `GET PATCH DELETE` | `/api/projects/{id}` | Lire, renommer, supprimer un projet |
| `GET` | `/api/projects/{id}/consommation` | La dépense du projet |
| `GET` | `/api/projects/{id}/graphe` | Le graphe des liens |
| `POST` | `/api/order/quote` | Chiffrer une commande |
| `POST` | `/api/order` | Commander |
| `GET POST` | `/api/apps` | Les applications |
| `GET` | `/api/apps/{slug}` | Lire une application |
| `POST` | `/api/apps/{slug}/deploy` | Mettre une version en service |
| `GET POST` | `/api/apps/{slug}/releases` | Les versions poussées |
| `PUT` | `/api/apps/{slug}/environment` | L'environnement |
| `GET` | `/api/apps/{slug}/logs` | Le journal de l'application |
| `GET` | `/api/apps/nodes` | Les nœuds capables |
| `GET` | `/api/apps/projects` | Les projets d'accueil |
| `GET` | `/api/apps/whoami` | Vérifier le jeton |
| `GET` | `/api/billing/overview` | Solde, dépense, jours restants |
| `GET` | `/api/billing/daily-spend` | La dépense au jour le jour |
| `GET` | `/api/billing/invoices` | Les factures |
| `GET` | `/api/billing/statements` | Les relevés |
| `GET` | `/api/billing/statements/{period}` | Un relevé |
| `GET` | `/api/wallet` | Le portefeuille |
| `GET` | `/api/wallet/transactions` | Les mouvements |
| `GET POST` | `/api/users/me/ssh-keys` | Les clés SSH |
| `DELETE` | `/api/users/me/ssh-keys/{id}` | Supprimer une clé |

## Ce qui n'est pas exposé, et pourquoi

| Surface | Pourquoi elle reste fermée |
| --- | --- |
| `/api/admin/*` | Outillage interne. Rien n'y est stable, et un jeton client n'y a pas sa place. |
| `/api/remote/*` | Le protocole que parle notre daemon avec le panel. Ce n'est pas un contrat client. |
| `/api/wallet/deposit`, cartes, recharge automatique | Des parcours de paiement, avec redirections et confirmations. Automatiser une carte par jeton est une mauvaise idée. |
| `/api/users/me/tokens` | Créer un jeton avec un jeton. Ça reste dans l'espace client, où l'on voit ce qu'on crée. |
| Notifications, préférences, profil de facturation | Des formulaires. L'espace client les sert mieux. |
| Export de compte, interventions | Des parcours humains, avec une fenêtre de temps et un consentement. |

Si l'une d'elles te manque pour un usage précis, [écris-nous](https://arkya.gg/contact) :
une route publiée est une promesse qu'on tient, on préfère la poser en connaissance de
cause.