Bienvenue sur la doc de nos API (BETA)
Retrouvez nos exemples sur ce côté de la page
Vous pouvez proposer dès à présent notre service à vos utilisateurs en intégrant nos API.
Enrichissez votre application grâce à nos API mises à jour en temps réel.
Pour utiliser nos API, contactez-nous à l’adresse suivante contact@elocky.com
Après étude de votre demande, un mail sera envoyé à votre adresse afin de vous transmettre votre « Client ID » et « Client Secret ».
Ces informations vous permettront de générer un « Access Token » et de vous identifier pour utiliser nos API.
Authentification API
Authentification anonyme
Pour obtenir votre "access token", utilisez ce code :
Remplacez
xxxxx
par votre "Client Id" etyyyyy
par votre "Client Secret".
# Exemple de retour en JSON
{ "access_token" : YzRhNDFlNmJmNzE3MTRmODk2OGQ5ODUyZWY4MWRiM2JhMTFkNjMxOGZjMWQ1, "expires_in" : 3600, "token_type" : bearer, "scope" : null, }
# Exemple d'access token expiré
{ "error" : invalid_grant, "error_description" : "The access token provided has expired." }
L'authentification anonyme vous permet d'utiliser les API qui ne sont liés à aucun utilisateur.
Requête HTTP
GET https://www.elocky.com/oauth/v2/token?client_id=xxxxx&client_secret=yyyyy&grant_type=client_credentials
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
client_id | OUI |
xxxxx
|
client_secret | OUI |
yyyyy
|
grant_type | OUI |
client_credentials
|
RETOUR API
Nom | Type | Description |
---|---|---|
access_token | string | |
expires_in | integer | Validité de l'access token en secondes |
token_type | string | |
scope | NULL |
Authentification Utilisateur
Pour obtenir votre "access token" d'utilisateur authentifié, utilisez ce code :
Remplacez
xxxxx
par votre "Client Id" etyyyyy
par votre "Client Secret" ainsi que l'email et le mot de passe de l'utilisateur.
# Exemple de retour en JSON
{ "access_token" : YzRhNDFlNmJmNzE3MTRmODk2OGQ5ODUyZWY4MWRiM2JhMTFkNjMxOGZjMWQ1, "expires_in" : 3600, "token_type" : bearer, "scope" : null, "refresh_token" : 5ODUyZWY4MWRiM2JhMTFkNjMxOGZjMWQ1YzRhNDFlNmJmNzE3MTRmODk2OGQ, }
# Exemple d'access token expiré
{ "error" : invalid_grant, "error_description" : "The access token provided has expired." }
La génération « d'Access Token » pour un utilisateur est quasiment la même chose que pour l'Access Token anonyme. Cela vous permettra d'utiliser nos API destinés à un utilisateur connecté.
Requête HTTP
POST https://www.elocky.com/oauth/v2/token
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
client_id | OUI |
xxxxx
|
client_secret | OUI |
yyyyy
|
grant_type | OUI |
password
|
username | OUI | email utilisateur |
password | OUI | password utilisateur |
RETOUR API
Nom | Type | Description |
---|---|---|
access_token | string | |
expires_in | integer | Validité de l'access token en secondes |
token_type | string | |
scope | NULL | |
refresh_token | string |
Refresh Token Utilisateur
Pour rafréchir votre "access token" d'utilisateur authentifié, utilisez ce code :
Remplacez
xxxxx
par votre "Client Id" etyyyyy
par votre "Client Secret" ainsi que zzzzz par votre "Refresh Token".
# Exemple de retour en JSON
{ "access_token" : YzRhNDFlNmJmNzE3MTRmODk2OGQ5ODUyZWY4MWRiM2JhMTFkNjMxOGZjMWQ1, "expires_in" : 3600, "token_type" : bearer, "scope" : null, "refresh_token" : 5ODUyZWY4MWRiM2JhMTFkNjMxOGZjMWQ1YzRhNDFlNmJmNzE3MTRmODk2OGQ, }
# Exemple d'access token expiré
{ "error" : invalid_grant, "error_description" : "The access token provided has expired." }
Le Refresh de « l'Access Token » d'un utilisateur permettra d'obtenir un nouvel Access Token lorsque le précédant a expiré.
Requête HTTP
POST https://www.elocky.com/oauth/v2/token
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
client_id | OUI |
xxxxx
|
client_secret | OUI |
yyyyy
|
grant_type | OUI |
refresh_token
|
grant_type | OUI |
zzzzz
|
RETOUR API
Nom | Type | Description |
---|---|---|
access_token | string | |
expires_in | integer | Validité de l'access token en secondes |
token_type | string | |
scope | NULL | |
refresh_token | string |
Gestion des utilisateurs
Créer un profil utilisateur
Pour créer un profil utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token"{firstName}
par le prénom de l'utilisateur à enregistrer,{lastName}
par son nom,{625131568}
par son numéro de téléphone et{+33}
pour le numéro indicatif de son pays de résidence. Changez aussi{email}
pour l'adresse email que vous souhaitez lier au compte ainsi que{password}
pour le mot de passe de ce dernier..
La requête retourne la référence de l'utilisateur créé en cas de réussite.
Ici, vous pouvez créer un profil utilisateur Elocky.
Requête HTTP
POST https://www.elocky.com/webservice/user/.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
firstName | OUI | Prénom |
lastName | OUI | Nom |
phone | OUI | Numéro de téléphone |
phoneCode | OUI | Indicatif du pays |
OUI | Adresse email d'inscription | |
password | OUI | Mot de passe du compte |
Demande de réinitialisation de mot de passe
Pour effectuer une demande de réinitilisation de mot de passe lié à un compte utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{email}
par l'adresse email du compte Elocky.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez réinitiliser le mot de passe d'un compte Elocky. Un mail sera envoyé à l'utilisateur en question avec un lien pour définir un nouveau mot de passe pour son compte.
Requête HTTP
POST https://www.elocky.com/webservice/user/.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
OUI | Adresse email du compte |
Modifier le profil utilisateur
Pour modifier le profil de l'utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{firstName}
par le prénom de l'utilisateur,{lastName}
par son nom,{XXXXXXXXXX}
par son numéro de téléphone et{email}
pour l'adresse email que vous souhaitez lier au compte.
La requête retourne "success" en cas de réussite..
Ici, vous pouvez modifier le profil de l'utilisateur Elocky.
Requête HTTP
PUT https://www.elocky.com/webservice/user/.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
firstName | OUI | Prénom |
lastName | OUI | Nom |
phone | OUI | Numéro de téléphone |
OUI | Adresse email d'inscription |
Données du profile utilisateur
Pour récupérer le profil de l'utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token".
# Exemple de retour en JSON
{ "id" : 1, "reference" : 575ffbc1132c9, "created" : 2015-12-14T12:48:58+0100, "state" : 1, "email" : contact@elocky.com, "first_name" : david, "last_name" : billiere, "photo" : 44e40ddfed81e8b70c8defbc798c5ff46f9173cb.jpeg, "phone" : +33 667850050, }
Ici, vous pouvez récupérer le profil de l'utilisateur Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/user/.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
Modifier le password
Pour modifier le mot de passe de l'utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token",{password}
par le nouveau password de l'utilisateur,{old_password}
par l'ancien password de l'utilisateur.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez modifier le mot de passe de l'utilisateur Elocky.
Requête HTTP
PUT https://www.elocky.com/webservice/user/change-password.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
password | OUI | password |
old_password | OUI | old_password |
Photo du profil de l'utilisateur
Pour télécharger une photo de profile utilisateur Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{name}
par le nom de la photo.
La requête retourne la photo en cas de réussite.
Ici, vous pouvez télécharger la photo de profile d'un utilisateur Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/user/photo/{name}/download.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
name | OUI | namePhoto.jpg |
Référence d'un utilisateur
Pour récupérer la référence d'un utilisateur Elocky via son email, utilisez ce code :
Remplacez
{token}
par votre "Access Token".
# Exemple de retour en JSON
{ "id" : 1, "reference" : 575ffbc1132c9, "email" : contact@elocky.com, }
Ici, vous pouvez récupérer la référence d'un utilisateur Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/user/{email}/reference.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
OUI | Email de l'utilisateur à récupérer |
Gestion des lieux
Créer un nouveau lieu
Pour pouvoir créer une nouvelle adresse, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant du lieu à modifier. La requête retournera l'ID du lieu nouvellement créé en cas de réussite.
Cette api permet d'enregistrer un nouveau lieu. Pour définir les paramètres de la requête, il sera nécessaire de récupérer les données de l'api de liste des pays et fuseaux horaires.
Requête HTTP
POST https://www.elocky.com/webservice/address/new.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
name | OUI | Nom du lieu |
address | OUI | Adresse du lieu |
city | OUI | Ville |
zipcode | OUI | Code postal |
country(id) | OUI | Identifiant du Pays |
timezone(id) | OUI | Identifiant du fuseau horaire |
complement | OUI | Complément d'adresse |
Liste des pays et fuseaux horaires
Pour obtenir la liste des pays et des fuseaux horaires, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
. Vous pouvez utiliser cette api de façon anonyme.
Cette api permet de récupérer une liste de pays et de fuseaux horaires. Chacun est relié à un ID qui sera nécessaire à d'autres api.
Requête HTTP
GET https://www.elocky.com/webservice/address/country.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
Liste des lieux d'un utilisateur
Pour obtenir la liste des lieux d'un utilisateur, utilisez ce code :
Remplacez
{token}
par votre "Access Token".
{
"lieux" : [
{
"coords" : []
"id" : 2,
"address" : "45 rue sainte colombe",
"zip_code" : 33000,
"city" : "Bordeaux",
"check_in" : "1970-01-01 17:19:00",
"check_out" : "1970-01-01 19:24:00",
"check_bool" : 1,
"board" : [
{
"id" : 1,
"name" : "Serrure dev",
"type_board" : {
"id" : 1,
},
"alarm" : 1,
},
{
"id" : 3,
"name" : "Fenetre ELOCKY",
"type_board" : {
"id" : 2,
},
"alarm" : 0,
}
],
"passerell" : [
{
"id" : 345,
},
{
"id" : 286
},
"country" : {
"id" : 75,
"name" : France,
},
"admin_address" : [
"state" : 1,
"name" : "Elocky Dev",
"email" : "fvallortigara@gmail.com",
"firstName" : "Franck",
"lastName" : "Vallortigara",
"photo" : "profil.jpg",
],
"alarm" : 1,
"photo" : "536287rg49eh3984fj40.jpeg",
"timezone" : {
"id" : 576,
"name" : "Europe/Paris",
}
}
]
}
Récupérer la liste des lieux liés à un utilisateur Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/address/list.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
RETOUR API
Nom | Type | Description |
---|---|---|
coords | integer | Coordonnées géographiques du lieux |
id | integer | Identifiant du lieux |
zip_code | string | Code postal |
city | string | Ville |
check_in | string | Horaire d'entrée par defaut |
check_out | string | Horaire de sortie par defaut |
check_bool | integer | Horaire par defaut activées |
alarm | int | Alarme activée |
photo | string | File name |
Board | ||
id | integer | Identifiant de l'objet |
name | string | Nom de l'objet |
type_board(id) | integer | Type d'objet |
alarm | integer | Etat de l'alarme |
passerelle(id) | integer | Identifiant passerelle |
Country | ||
id | integer | Identifiant pays |
name | string | Nom pays |
admin_address | ||
id | integer | Identifiant admin address |
user_reference | string | Référence de l'administrateur |
state | integer | Etat de l'administrateur |
name | string | Nom de l'admin address |
string | Email de l'administrateur | |
firstName | string | Prénom de l'administrateur |
lastName | string | Nom de l'administrateur |
photo | string | Photo de l'administrateur |
timezone | ||
id | integer | Identifiant timezone |
name | string | Nom timezone |
VALEURS TYPE_BOARD EN FONCTION DE L'ID
id | name |
---|---|
1 | Serrure |
2 | Capteur d'intrusion beacon |
3 | Camera |
4 | Gache électrique |
Modifier les données d'un lieu
Pour pouvoir modifier les données d'un lieu, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant du lieu à modifier. La requête retournera "success" en cas de réussite.
Cette api permet de modifier les données d'un lieu existant d'après son ID. Pour définir les paramètres de la requête, il sera nécessaire de récupérer les données de l'api de liste des pays et fuseaux horaires.
Requête HTTP
PUT https://www.elocky.com/webservice/address/edit/{id}.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
name | OUI | Nom du lieu |
address | OUI | Adresse du lieu |
city | OUI | Ville |
zipcode | OUI | Code postal |
country(id) | OUI | Identifiant du Pays |
timezone(id) | OUI | Identifiant du fuseau horaire |
complement | NON | Complément d'adresse |
Historique d'un lieu
Pour obtenir l'historique d'un lieu, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant du lieu.
L'historique est renvoyé sous forme de jeux de 30 résultats. Remplacez
{start}
par le nombre correspondant au premier résultat que vous souhaitez prendre en compte. "1" Renvoie le dernier log et les 29 précédents, "2" l'avant dernier résultat et les 29 précédents et ainsi de suite.
[
"total" : 368
{
"id" : 1,
"created" : 2017-07-31T17:50:03+02:00,
"type" : 3,
"state" : 2,
"firstName" : John,
"lastName" : Doe,
"photo" : profil.jpg,
"id_board" : 134,
"id_board_access" : 25,
},
{
"id" : 2,
"created" : 2017-01-26T17:36:40+01:00,
"type" : 1,
"state" : 60,
},
]
Récupérer l'historique des logs sur un lieu.
Requête HTTP
GET https://www.elocky.com/webservice/address/log/{id}/{start}.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
id | OUI | Identifiant du lieu : 1 |
start | OUI | 1er log pris en compte |
RETOUR API
Nom | Type | Description |
---|---|---|
total | integer | Nom du lieu |
id | integer | Adresse du lieu |
creates | DateTime | Ville |
type | integer | Code postal |
state | integer | Identifiant du Pays |
firstName | string | Identifiant du fuseau horaire |
lastName | string | Complément d'adresse |
id_board | integer | Complément d'adresse |
id_board_access | integer | Complément d'adresse |
photo | File (image) | Complément d'adresse |
VALEURS TYPE ET STATE
Type | Valeur type | State | Valeur state |
---|---|---|---|
0 | Passerelle | 3 | Ajout passerelle |
1 | Serrure | 2 | Elocky admin |
1 | Serrure | 3 | Ajout serrure |
1 | Serrure | 80 | MAJ serrure |
2 | Beacon | 3 | Ajout beacon |
3 | Accès | 2 | Notification d'ouverture |
3 | Accès | 3 | Ajout d'accès |
3 | Accès | 10 | Reboot |
3 | Accès | 11 | Reset |
3 | Accès | 12 | Déconfiguration |
3 | Accès | 13 | Configuration |
3 | Accès | 14 | Sleep normal |
3 | Accès | 15 | Sleep soft |
3 | Accès | 16 | Sleep deep |
3 | Accès | 17 | Wake up normal |
3 | Accès | 18 | Wake up soft |
3 | Accès | 19 | Wake up deep |
3 | Accès | 60 | Update software |
3 | Accès | 99 | Debug |
Supprimer un log historique
Pour supprimer un log, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant du log.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez supprimer un log de l'historique d'un lieu.
Requête HTTP
DELETE https://www.elocky.com/webservice/address/log/delete/{id}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
id | OUI | Identifiant du log |
Photo d'un lieu
Pour télécharger une photo de lieu Elocky, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{name}
par le nom de la photo.
La requête retourne la photo en cas de réussite.
Ici, vous pouvez télécharger la photo d'un lieu Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/address/photo/{name}/download.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
name | OUI | namePhoto.jpg |
Supprimer un lieu (soon)
Modifier la photo d'un lieu (soon)
Activer/Désactiver l'alarme (soon)
Liste des utilisateurs du lieu (soon)
Modifier le type d'un utilisateur (soon)
Supprimer un utilisateur du lieu (soon)
Gestion des objets
Liste des objets liés à un lieu
Pour obtenir la liste des objets d'un lieu, utilisez ce code :
Remplacez
{idAddress}
par l'identifiant du lieu et{token}
par votre "Access Token"
[
{
"board" : [
{
"nbAccess" : 2,
"id" : 455,
"name" : "Serrure dev",
"type_board" : {
"id" : 1,
},
"battery" : 90,
"tension" : 3586,
"maj" : 1,
"date_battery" : "2017-06-04T00:00:00+02:00",
},
{
"nbAccess" : 0,
"id" : 266,
"name" : "Fenetre ELOCKY",
"type_board" : {
"id" : 2
},
"battery" : -45,
"data" : 29,
"veille" : 0,
}
"passerelle" : [
{
"nbObject" : 2,
"id" : 23,
"name" : "passerelle dev 2",
"state" : 1,
},
{
"nbObject" : 1,
"id" : 19,
"name" : "passerelle dev 1",
"state" : 1,
}
}
]
Récupérer la liste des objets liés à un lieu.
Requête HTTP
GET https://www.elocky.com/webservice/address/object/list/{idAddress}.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
reference | OUI | Référence de l'administrateur du lieu |
idAddress | OUI | Identifiant de l'adresse |
access_token | OUI | Token d'authentication pour l'api |
RETOUR API
Nom | Type | Description |
---|---|---|
board | ||
nbAccess | integer | Nombre d'accès par serrure |
id | integer | Identifiant de l'objet |
name | string | Nom de l'objet |
battery | integer | Niveau de batterie |
tension | integer | Niveau de tension |
data | string | Température pour les beacons |
veille | integer | Etat de veille de l'objet |
maj | integer | Etat de mise à jour de l'objet |
date_battery | date | Date d'installation de la batterie |
reference | string | Référence de l'objet |
version | string | Version de l'objet |
programme | integer | Programme de l'objet |
reveille | integer | Degré de sensibilité |
connection | integer | Connexion de l'objet |
type_board(id) | integer | Type d'objet |
passerelle | ||
nbObject | integer | Nombre d'objets liés à la passerelle |
id | integer | Identidiant de la passerelle |
name | string | Nom de la passerelle |
vpn | string | VPN |
connectionInternet | integer | Etat connexion internet |
maj | integer | Mise à jour |
connection | integer | Connexion |
reference | string | Référence de la passerelle |
version | string | Version de la passerelle |
address_ip_local | string | Adresse IP locale |
address_ip | string | Adresse IP |
state | integer | Etat de la passerelle |
VALEURS TYPE_BOARD EN FONCTION DE L'ID
id | name |
---|---|
1 | Serrure |
2 | Capteur d'intrusion beacon |
3 | Camera |
4 | Gache électrique |
Supprimer un objet
Pour supprimer un objet, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{idBoard}
par l'identifiant de l'objet.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez supprimer un objet dont vous êtes administrateur.
Requête HTTP
DELETE https://www.elocky.com/webservice/object/delete/{idBoard}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idBoard | OUI | Identifiant de l'objet |
Déclencher l'ouverture à distance
Pour déclencher une ouverture à distance, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{idBoard}
par l'identifiant de la serrure.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez lancer une ouverture à distance sur une serrure liée à une passerelle et pour laquelle vous détenez un accès valide.
Requête HTTP
POST https://www.elocky.com/webservice/gateway/open/{idBoard}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idBoard | OUI | Identifiant de la serrure |
Modifier les information d'un objet (soon)
Modifier les information d'une box (soon)
Supprimer une box (soon)
Fonctions objets distance (soon)
Récupérer la liste des événements serrure à distance
Pour récupérer la liste des événements serrure à distance, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{idBoard}
par l'identifiant de la serrure.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez lancer une récupération d'historique à distance sur une serrure liée à une passerelle dont vous êtes modérateur ou administrateur.
Requête HTTP
POST https://www.elocky.com/webservice/gateway/event-list/{idBoard}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idBoard | OUI | Identifiant de la serrure |
Ajouter un badge à distance
Pour ajouter un badge sur une serrure à distance, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{idBoard}
par l'identifiant de la serrure.
Remplacez{name}
par le nom de l'accès et{cardId}
par l'identifiant du badge NFC.
Renseignez les valeurs{start}
et{end}
avec les dates de début et de fin de validité de l'accès sous format d'une timestamp UNIX à la seconde.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez ajouter un badge NFC à distance sur une serrure liée à une passerelle dont vous êtes modérateur ou administrateur.
Requête HTTP
POST https://www.elocky.com/webservice/gateway/permission/card/add/{idBoard}.json?access_token={token}&cardName={name}&cardId={idCard}&startEvent={start}&endEvent={end}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idBoard | OUI | Identifiant de la serrure |
cardName | OUI | Nom de l'accès |
cardId | OUI | Identifiant du badge NFC |
start | OUI | Date de début de validité de l'accès |
end | OUI | Date de fin de validité de l'accès |
Supprimer un badge à distance
Pour supprimer un badge sur une serrure à distance, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{idBoard}
par l'identifiant de la serrure.
Remplacez{name}
par le nom de l'accès et{cardId}
par l'identifiant du badge NFC.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez ajouter un badge NFC à distance sur une serrure liée à une passerelle dont vous êtes modérateur ou administrateur.
Requête HTTP
POST https://www.elocky.com/webservice/gateway/permission/card/add/{idBoard}.json?access_token={token}&cardName={name}&cardId={idCard}&startEvent={start}&endEvent={end}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idBoard | OUI | Identifiant de la serrure |
cardId | OUI | Identifiant du badge NFC |
Fonctions box distance (soon)
Gestion des accès
Liste des accès liés à un utilisateur
Pour obtenir la liste des accès, utilisez ce code :
Remplacez
{token}
par votre "Access Token"
"access" : [
{
"id" : 19,
"created" : "2016-06-14T00:00:00+02:00",
"name" : Mon accès,
"user_reference" : 575ffbc1332c9,
"access_exep" : [
{
"id" : 19,
"start" : 2017-01-16T08:00:00+01:00,
"stop" : 2017-01-16T12:00:00+01:00,
"is_dispo" : "1"
},
{
"start" : 2017-01-16T08:00:00+01:00,
"stop" : 2017-01-16T12:00:00+01:00,
"is_dispo" : "1"
}
}
],
"acces_recu" : [
{
"id" : 20,
"start" : 08:00:00,
"stop" : 16:00:00,
"state" : 1,
"day" : {,
"id" : 1,
"stop" : mardi
},
}
],
"board" : [
"id" : 9,
"name" : Serrure dev,
"address" : {
"id" : 2,
"address" : 45 rue sainte colombe,
"zip_code" : 33000,
"city" : Bordeaux,
"country" : {,
"id" : 75,
"address" : France
},
"admin_address" : [,
{
"id" : 49
"user_reference" : 575ffbc1332c9,
"state" : 1,
"name" : Elocky Dev,
"email" : fvallortigara@gmail.com,
"firstName" : Franck,
"lastName" : Vallortigara,
"photo" : profil.jpg
},
{
"id" : 10
"user_reference" : 586b85b00cb31,
"state" : 0,
"name" : Elocky Dev,
"email" : david.billiere@viacesi.fr,
"firstName" : David,
"lastName" : Billiere,
"photo" : david.jpg,
}
],
"photo" : elocky.jpg,
]
},
"type_access" : {
"id" : 1
}
"email" : david.billiere@viacesi.fr,
"firstName" : David,
"lastName" : Billiere,
"photo" : david.jpg
}
]
Récupérer la liste des accès liés à un utilisateur Elocky.
Requête HTTP
GET https://www.elocky.com/webservice/access/list/user.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
RETOUR API
Nom | Type | Description |
---|---|---|
id | integer | Identifiant de l'accès |
created | date | Date de création de l'accès |
name | string | Nom de l'accès |
user_reference | string | Référence du créateur de l'accès |
string | Email du créateur de l'accès | |
firstName | string | Prénom du créateur de l'accès |
lastName | string | Nom du créateur de l'accès |
photo | string | Photo du créateur de l'accès |
type_access(id) | integer | Identifiant du type d'accès |
favorite_access(id) | integer | Identifiant de l'accès favori |
favorite_access(name) | string | Nom de l'accès favori |
access_exep | ||
id | integer | Identifiant de l'accès exeptionnel |
start | date | Date début accès exeptionnel |
stop | date | Date début accès exeptionnel |
is_dispo | integer | Interdiction/Autorisation d'accès à la date choisie |
access_recu | ||
id | integer | Identifiant de l'accès récurent |
start | date | Horaire début accès récurent |
stop | date | Horaire début accès récurent |
state | integer | Interdiction/Autorisation d'accès à l'horaire choisie |
day(id) | integer | Identifiant du jour de l'accès récurent |
day(name) | string | Nom du jour de l'accès récurent |
board | ||
name | string | Nom de l'objet |
address | ||
id | integer | Identifiant du lieu |
address | string | Adresse du lieu |
zip_code | string | Code postal du lieu |
city | string | Ville du lieu |
photo | string | Image liée au lieu |
photo | string | Image liée au lieu |
country(id) | integer | Identifiant du Pays |
country(name) | string | Nom du Pays |
admin_address | ||
id | integer | Identifiant admin address |
user_reference | string | Référence de l'administrateur |
state | integer | Etat de l'administrateur |
name | string | Nom de l'admin address |
string | Email de l'administrateur | |
firstName | string | Prénom de l'administrateur |
lastName | string | Nom de l'administrateur |
photo | string | Photo de l'administrateur |
VALEURS TYPE_ACCESS EN FONCTION DE L'ID
id | name |
---|---|
1 | Administrateur |
2 | Modérateur |
3 | Utilisateur |
4 | Invité |
5 | Carte RFID |
6 | Carte NFC |
Liste utilisateurs invités à un accès
Pour obtenir la liste des invités sur un accès, utilisez ce code :
Remplacez
{token}
par votre "Access Token"
"access" : [
{
"id" : 122,
"user_reference" : "575ffbc1332c9",
"access_exep" : [
{
"id" : 18,
"start" : 2017-01-16T08:00:00+01:00,
"stop" : 2017-01-16T12:00:00+01:00,
"is_dispo" : "1"
},
{
"start" : 2017-01-16T19:30:00+01:00,
"stop" : 2017-01-16T22:00:00+01:00,
"is_dispo" : "1"
}
}
],
"acces_recu" : [
{
"id" : 9,
"start" : 08:00:00,
"stop" : 16:00:00,
"state" : 1,
"day" : {,
"id" : 1,
"stop" : mardi
},
}
],
"board" : [
"id" : 9,
"name" : Serrure dev,
"address" : {
"id" : 2,
"address" : 45 rue sainte colombe,
"zip_code" : 33000,
"city" : Bordeaux,
"country" : {,
"id" : 75,
"address" : France
},
"admin_address" : [,
{
"name" : Elocky Dev,
},
],
"photo" : elocky.jpg,
]
},
"type_access" : {
"id" : 1
}
"firstName" : David,
"lastName" : Billiere,
"email" : david.billiere@viacesi.fr,
"photo" : david.jpg
}
]
Récupérer la liste des invités liés à un accès.
Requête HTTP
GET https://www.elocky.com/webservice/access/list/invite.json?access_token={token}
URL PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
RETOUR API
Nom | Type | Description |
---|---|---|
id | integer | Identifiant de l'accès |
user_reference | string | Référence du créateur de l'accès |
string | Email du créateur de l'accès | |
firstName | string | Prénom du créateur de l'accès |
lastName | string | Nom du créateur de l'accès |
photo | string | Photo du créateur de l'accès |
type_access(id) | integer | Identifiant du type d'accès |
favorite_access(id) | integer | Identifiant de l'accès favori |
favorite_access(name) | string | Nom de l'accès favori |
access_exep | ||
id | integer | Identifiant de l'accès exeptionnel |
start | date | Date début accès exeptionnel |
stop | date | Date début accès exeptionnel |
is_dispo | integer | Interdiction/Autorisation d'accès à la date choisie |
access_recu | ||
id | integer | Identifiant de l'accès récurent |
start | date | Horaire début accès récurent |
stop | date | Horaire début accès récurent |
state | integer | Interdiction/Autorisation d'accès à l'horaire choisie |
day(id) | integer | Identifiant du jour de l'accès récurent |
day(name) | string | Nom du jour de l'accès récurent |
board | ||
name | string | Nom de l'objet |
address | ||
id | integer | Identifiant du lieu |
address | string | Adresse du lieu |
zip_code | string | Code postal du lieu |
city | string | Ville du lieu |
photo | string | Image liée au lieu |
photo | string | Image liée au lieu |
country(id) | integer | Identifiant du Pays |
country(name) | string | Nom du Pays |
admin_address | ||
id | integer | Identifiant admin address |
user_reference | string | Référence de l'administrateur |
state | integer | Etat de l'administrateur |
name | string | Nom de l'admin address |
string | Email de l'administrateur | |
firstName | string | Prénom de l'administrateur |
lastName | string | Nom de l'administrateur |
photo | string | Photo de l'administrateur |
VALEURS TYPE_ACCESS EN FONCTION DE L'ID
id | name |
---|---|
1 | Administrateur |
2 | Modérateur |
3 | Utilisateur |
4 | Invité |
5 | Carte RFID |
6 | Carte NFC |
Créer un nouvel accès
Pour établir un nouvel accès, utilisez ce code :
Remplacez
{token}
par votre "Access Token"AAAA
par l'addresse email de l'utilisateur que vous souhaitez ajouter (s'il est déjà utilisateur Elocky),BBBB
par l'identifiant de l'objet,CCCC
par le type d'accès (se référer au tableau des valeurs de type_access) etDDDD
par le nom que vous souhaitez donner à l'accès.
Si l'utilisateur invité ne possède pas de compte Elocky, pensez à régler
type_access
sur 4 (invité) et ignorez la donnéereferenceInvite
La requête retourne l'ID de l'accès créé
Créer un accès pour un utilisateur Elocky ou un invité. Si l'utilisateur invité possède un compte Elocky, veulliez renseigner son adresse email. Sinon, ignorez ce champ.
Requête HTTP
POST https://www.elocky.com/webservice/access/new.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
referenceInvite | NON | Référence de l'utilisateur invité ou identifiant du badge |
board | OUI | Identifiant de l'objet |
TypeAccess | OUI | Type d'accès |
nameAccess | OUI | Nom donné à l'accès |
VALEURS TYPE_ACCESS EN FONCTION DE L'ID
id | name |
---|---|
1 | Administrateur |
2 | Modérateur |
3 | Utilisateur |
4 | Invité |
5 | Carte RFID |
6 | Carte NFC |
Ajouter un nouvel horaire exceptionnel
Pour établir un nouvel accès, utilisez ce code :
Remplacez
{token}
par votre "Access Token"{id}
par l'identifiant de l'accès{dateDebut}
par la date de début d'accès exeptionnel et{dateFin}
par sa date de fin. Remplacez{X}
par l'état souhaité sur l'accès (autorisé ou interdit).
La requête retourne l'ID de l'accès exeptionnel créé
Ici, vous pouvez créer un accès exeptionnel ou alors interdire l'accès à un utilisateur de façon temporaire
Requête HTTP
POST https://www.elocky.com/webservice/access/exep/{idAccess}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idAccess | OUI | Identifiant de l'accès |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
start | OUI | Date et horaire de début d'accès exeptionnel |
stop | OUI | Date et horaire de fin d'accès exeptionnel |
isDispo | OUI | Etat de l'accès à la date indiqué |
Ajouter un nouvel horaire récurrent
Pour établir un nouvel accès récurent, utilisez ce code :
Remplacez
{token}
par votre "Access Token"{id}
par l'identifiant de l'accès{dateDebut}
par la date de début d'accès récurent et{dateFin}
par sa date de fin. Remplacez{X}
par l'identifiant du jour de l'accès récurent.
La requête retourne l'ID de l'accès récurent créé
Ici, vous pouvez créer un accès récurent selon le jour choisi
Requête HTTP
POST https://www.elocky.com/webservice/access/recu/{idAccess}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idAccess | OUI | Identifiant de l'accès |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
start | OUI | Date et horaire de début d'accès récurent |
stop | OUI | Date et horaire de fin d'accès récurent |
day | OUI | Identifiant du jour d'accès récurent |
VALEURS DE DAY EN FONCTION DE L'ID
id | name |
---|---|
1 | Lundi |
2 | Mardi |
3 | Mercredi |
4 | Jeudi |
5 | Vendredi |
6 | Samedi |
7 | Dimanche |
Ajouter des horaires permanents (7/7 - 24/24)
Pour établir un nouvel accès permanent, utilisez ce code :
Remplacez
{token}
par votre "Access Token"{id}
par l'identifiant de l'accès{dateDebut}
par la date de début d'accès permanent et{dateFin}
par sa date de fin.
La requête retourne un tableau contenant la liste des id des 7 accès récurents créés
Ici, vous pouvez créer un accès permanent sur une période choisie.
Requête HTTP
POST https://www.elocky.com/webservice/access/recu/{idAccess}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
idAccess | OUI | Identifiant de l'accès |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
start | OUI | Date et horaire de début d'accès permanent |
stop | OUI | Date et horaire de fin d'accès permanent |
Supprimer un accès exeptionnel
Pour supprimer un accès exeptionnel, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant de l'accès exeptionnel.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez supprimer un accès exeptionnel sur un lieu.
Requête HTTP
DELETE https://www.elocky.com/webservice/access/exep/delete/{id}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
id | OUI | Identifiant de l'accès exeptionnel |
Supprimer un accès récurent
Pour supprimer un accès récurent, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant de l'accès récurent.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez supprimer un accès récurent sur un lieu.
Requête HTTP
DELETE https://www.elocky.com/webservice/access/recu/delete/{id}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'API |
id | OUI | Identifiant de l'accès récurent |
Modifier un accès existant
Pour modifier un accès permanent existant, utilisez ce code :
Remplacez
{token}
par votre "Access Token"{id}
par l'identifiant de l'accès{nameAccess}
par le nom que vous souhaitez donner à l'accès et{idTypeAccess}
par l'identifier du type d'accès.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez modifier les données d'un accès existant.
Requête HTTP
PUT https://www.elocky.com/webservice/access/edit/{id}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
id | OUI | Identifiant de l'accès |
REQUIREMENTS
Nom | Obligatoire | Description |
---|---|---|
nameAccess | OUI | Nom de l'accès |
idTypeAccess | OUI | Identifiant du type d'accès |
VALEURS TYPE_ACCESS EN FONCTION DE L'ID
id | name |
---|---|
1 | Administrateur |
2 | Modérateur |
3 | Utilisateur |
4 | Invité |
5 | Code mail/sms |
6 | Carte RFID |
Supprimer un accès
Pour supprimer accès, utilisez ce code :
Remplacez
{token}
par votre "Access Token" et{id}
par l'identifiant de l'accès.
La requête retourne "success" en cas de réussite.
Ici, vous pouvez supprimer un accès sur un lieu.
Requête HTTP
DELETE https://www.elocky.com/webservice/access/delete/{id}.json?access_token={token}
QUERY PARAMETERS
Nom | Obligatoire | Description |
---|---|---|
access_token | OUI | Token d'authentication pour l'api |
id | OUI | Identifiant de l'accès |
Renouvellement d'un code invité (soon)
Codes erreurs
Code erreur | Description |
---|---|
200 | Returned when successful |
400 | Bad Request – Your request sucks |
401 | Unauthorized – Your API key is wrong |
403 | Forbidden – The kitten requested is hidden for administrators only |
404 | Not Found – The specified kitten could not be found |
429 | Too Many Requests – You’re requesting too many kittens! Slown down! |
500 | Internal Server Error – We had a problem with our server. Try again later. |
503 | Service Unavailable – We’re temporarially offline for maintanance. Please try again later. |