⚙️ L’API a été pensée pour s’intégrer facilement à tout type d’infrastructure, tout en respectant les règles et contraintes du SDK Acomba.

Contact#

Authentification#

Étape 1 : Obtenir votre clé API#

💡 Important : Conservez votre clé API en lieu sûr. Elle donne accès à vos données sensibles.

Étape 2 : Effectuer votre première requête API#

cURL#

JavaScript (Axios)#

C# (HttpClient)#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "http://{{api_url}}/api/organisation/charter/");
request.Headers.Add("x-api-key", "VOTRE_CLÉ_API_ICI");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

💡 Important :

Chaque requête doit inclure l’en-tête x-api-key. Sans celle-ci, l’accès est refusé.

Certaines modifications (ex. : numéro de client ou fournisseur) ne sont pas encore autorisées pour respecter la structure interne d’Acomba.

Concepts clés#

Références#

Exemple#

"reference": {
  "updated_by_user_id": 1,
  "card_pos": 203,
  "language_id": 2,
  "term_id": 10,
  "tax_group_id": 6
}

✅ Bonne pratique : conservez les clés de références (id | refrence). C'est clés sont utiles pour valider l'intégrité des donnes entre vos systèmes et Acomba.

Champs en lecture seul#

Restrictions#

🛑 Important : une fois un élément créé dans Acomba (ex. client, fournisseur, compte), son numéro (number) ne peut plus être modifié via l’API.