Envoyer une donnée de mesure

POST 
https://www.beekube.com/api/v1/device/:id/datum

Envoyer une donnée de mesure

Request

Path Parameters

id integerrequired

Identifiant de l'objet

application/json

Body

required

date stringnullable

Possible values: Value must match regular expression [0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}(?::[0-9]{2})?

Date de la mesure : 2023-12-21 10:11:01

value float

Valeur de la mesure

unit string

Possible values: [degres, gram, kilogram, pourcentage, volt]

Unité de la mesure

type string

Possible values: [temp_ext, temp_int, hygro_ext, hygro_int, weight, device_signal, device_battery]

Type de mesure

Responses

200

OK

application/json

Schema

Schema

success boolean

Succès de la requète

message string

Message du succès

Example (from schema)

{
  "success": true,
  "message": "string"
}

401

Unauthorized

application/json

Schema

Schema

code integer

Code d'erreur

message string

Message de l'erreur

details integer[]

Informations supplémentaires

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    0
  ]
}

Example

{
  "error": {
    "code": 401,
    "message": "Unauthorized",
    "details": []
  }
}

404

Device inconnu

application/json

Schema

Schema

code integer

Code d'erreur

message string

Message de l'erreur

details integer[]

Informations supplémentaires

Example (from schema)

{
  "code": 0,
  "message": "string",
  "details": [
    0
  ]
}

Example

{
  "error": {
    "code": 404,
    "message": "Not Found: Device inconnu",
    "details": []
  }
}

• curl
• python
• go
• nodejs
• ruby
• csharp
• php
• java
• powershell

• CURL

curl -L 'https://www.beekube.com/api/v1/device/:id/datum' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'X-API-KEY: <API_KEY_VALUE>' \
-d '{
  "date": "2023-10-21 10:05:04",
  "value": 32.57,
  "unit": "kilogram",
  "type": "weight"
}'

Request Collapse all

Base URL

https://www.beekube.com/api/v1

Auth

ApiKeyAuth

Parameters

id — pathrequired

Body required

{
  "date": "2023-10-21 10:05:04",
  "value": 32.57,
  "unit": "kilogram",
  "type": "weight"
}

ResponseClear

Click the Send API Request button above and see the response here!