Créer un nouveau contact

POST https://api.lws.net/v1/contact

operationIdpostContact

Crée un nouveau contact, géré par votre compte, qui pourra ensuite être utilisé pour se connecter à nos services. Laisser le champ société vide créera un contact individuel.

Corps de la requête

application/json

company any

Nom de l'entreprise (optionnel)

Exemple: Ma Société

facultatif
lastname any

Nom de famille

Exemple: Dupont

facultatif
firstname any

Prénom

Exemple: Jean

facultatif
address any

Adresse postale

Exemple: 1 rue de la Paix

facultatif
postal string

Code postal

Exemple: 75000

facultatif
city any

Ville

Exemple: Paris

facultatif
country any

Pays

Exemple: FR

facultatif
phone any

Numéro de téléphone du contact au format international 00{code pays}{numéro}

motif ^00\d{1,3}\d{6,12}$ Exemple: 0033612345678

facultatif
email any

Adresse email

Exemple: [email protected]

facultatif
password any

Mot de passe

Exemple: password

facultatif

Exemple de requête

{
  "company": "Ma Société",
  "lastname": "Dupont",
  "firstname": "Jean",
  "address": "1 rue de la Paix",
  "postal": "75000",
  "city": "Paris",
  "country": "FR",
  "phone": "0033612345678",
  "email": "[email protected]",
  "password": "password"
}

Réponses

200

Contact créé avec succès

{
  "code": 200,
  "info": "Contact successfully created",
  "data": "367228"
}

Champs de la réponse 3

code integer

Exemple: 200
info string

Exemple: Contact successfully created
data string

ID du contact nouvellement créé. Permet de récupérer ses informations par une requête GET

Exemple: 367228

400

Paramètres invalides ou contact en double

{
  "code": 400,
  "info": {
    "email": "Invalid email address format. Example: [email protected]",
    "phone": "Required field"
  },
  "data": {
    "email": "Email regex pattern",
    "phone": "Phone number regex pattern"
  }
}

Champs de la réponse 3

code integer

Exemple: 400
info object

Exemple: {"email":"Invalid email address format. Example: [email protected]","phone":"Required field"}
data object

Exemple: {"email":"Email regex pattern","phone":"Phone number regex pattern"}

401

Non autorisé - En-têtes d'authentification manquants

{
  "code": 401,
  "info": "Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed."
}

Champs de la réponse 2

code integer

Exemple: 401
info string

Exemple: Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed.

429

Limite de requêtes dépassée

{
  "code": 429,
  "info": "Rate limit exceeded. Please try again later."
}

Champs de la réponse 2

code integer

Exemple: 429
info string

Exemple: Rate limit exceeded. Please try again later.

500

Erreur interne du serveur

{
  "code": 500,
  "info": "Internal Server Error",
  "data": "Details on the error"
}

Champs de la réponse 3

code integer

Exemple: 500
info string

Exemple: Internal Server Error
data string

Exemple: Details on the error

502

Réponse invalide retournée. Signifie généralement que les données retournées n'étaient pas attendues.

{
  "code": 502,
  "info": "Invalid response from upstream server",
  "data": {
    "status": 500,
    "error": "Internal Server Error"
  }
}

Champs de la réponse 3

code integer

Exemple: 502
info string

Exemple: Invalid response from upstream server
data any[]

Exemple: {"status":500,"error":"Internal Server Error"}

1LWS_AUTH_LOGIN='…'2LWS_AUTH_PASS='…'34curl -X POST \5 "https://api.lws.net/v1/contact" \6 -H "X-Auth-Login: $LWS_AUTH_LOGIN" \7 -H "X-Auth-Pass: $LWS_AUTH_PASS" \8 -H "Content-Type: application/json" \9 -d '{"company":"Ma Société","lastname":"Dupont","firstname":"Jean","address":"1 rue de la Paix","postal":"75000","city":"Paris","country":"FR","phone":"0033612345678","email":"[email protected]","password":"password"}'

1$lwsAuthLogin = '…';2$lwsAuthPass = '…';34$ch = curl_init("https://api.lws.net/v1/contact");5curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");6curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);7curl_setopt($ch, CURLOPT_HTTPHEADER, [8 "X-Auth-Login: " . $lwsAuthLogin,9 "X-Auth-Pass: " . $lwsAuthPass,10 "Content-Type: application/json",11]);12curl_setopt($ch, CURLOPT_POSTFIELDS, '{"company":"Ma Société","lastname":"Dupont","firstname":"Jean","address":"1 rue de la Paix","postal":"75000","city":"Paris","country":"FR","phone":"0033612345678","email":"[email protected]","password":"password"}');1314$res = json_decode(curl_exec($ch), true);

1import requests23LWS_AUTH_LOGIN = "…"4LWS_AUTH_PASS = "…"56res = requests.post(7 "https://api.lws.net/v1/contact",8 headers={9 "X-Auth-Login": LWS_AUTH_LOGIN,10 "X-Auth-Pass": LWS_AUTH_PASS,11 },12 json={"company": "Ma Société", "lastname": "Dupont", "firstname": "Jean", "address": "1 rue de la Paix", "postal": "75000", "city": "Paris", "country": "FR", "phone": "0033612345678", "email": "[email protected]", "password": "password"},13)14print(res.json())

1const LWS_AUTH_LOGIN = "…";2const LWS_AUTH_PASS = "…";34const res = await fetch("https://api.lws.net/v1/contact", {5 method: "POST",6 headers: {7 "X-Auth-Login": LWS_AUTH_LOGIN,8 "X-Auth-Pass": LWS_AUTH_PASS,9 "Content-Type": "application/json",10 },11 body: JSON.stringify({"company":"Ma Société","lastname":"Dupont","firstname":"Jean","address":"1 rue de la Paix","postal":"75000","city":"Paris","country":"FR","phone":"0033612345678","email":"[email protected]","password":"password"}),12});13const data = await res.json();

1lwsAuthLogin := "…"2lwsAuthPass := "…"34body := strings.NewReader(`{"company":"Ma Société","lastname":"Dupont","firstname":"Jean","address":"1 rue de la Paix","postal":"75000","city":"Paris","country":"FR","phone":"0033612345678","email":"[email protected]","password":"password"}`)5req, _ := http.NewRequest("POST",6 "https://api.lws.net/v1/contact", body)7req.Header.Set("X-Auth-Login", lwsAuthLogin)8req.Header.Set("X-Auth-Pass", lwsAuthPass)9req.Header.Set("Content-Type", "application/json")1011resp, err := http.DefaultClient.Do(req)

Créer un nouveau contact

Corps de la requête

Réponses

Signaler une erreur

Assistant IA