Os seguintes atributos compõe um dispositivo:
Nome | Tipo | Descrição |
---|---|---|
id | Integer | ID do registro |
serial_number | String | Número de série do equipamento |
enabled | Boolean | Determina se o equipamento pode ou não acessar o CloudWalk (default true) |
logical_number_id | Integer | ID do número lógico associado com o dispositivo |
meta | JSON | Informações adicionais como marca, modelo, etc |
framework_version | String | Versão do CloudWalk Framework instalado no equipamento |
updated_at | String | Timestamp da atualização do registro (ISO 8601) |
created_at | String | Timestamp da criação do registro (ISO 8601) |
created_by | Integer | ID do usuário que criou o registro |
created_via | String | Canal utilizado para criar o registro (Interface ou API) |
Retorna um array com todos os dispositivos.
GET https://api.cloudwalk.io/{versão}/devices?access_token={token}
$ curl -X GET "https://api.cloudwalk.io/v1/devices?access_token=$TOKEN"
require 'net/http'
token = 'API_TOKEN'
uri = URI("https://api.cloudwalk.io/v1/devices?access_token=#{token}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri.request_uri)
res = http.request(request)
puts "Response #{res.code} #{res.message}: #{res.body}"
{
"pagination":{
"page":1,
"total_pages":1,
"entries":2,
"total_entries":2
},
"devices":[
{
"device":{
"id":1,
"serial_number":"123-456-789",
"enabled":true,
"framework_version":"5.10.2",
"meta":{
"brand":"pax",
"model":"d200",
"communication_media":"gprs",
"gprs_signal":"80",
"sim_card_id":"8955101234567890",
"os_version":"2.4.104",
"emv_kernel_version":"v602_01 2015.04.02",
"ssa_version":"",
"battery_level":"50",
"ssl":"on",
"signature":"production"
},
"updated_at":"2015-01-30T17:42:41Z",
"created_at":"2015-01-30T17:42:41Z",
"created_by":1,
"created_via":"interface"
}
},
{
"device":{
"id":2,
"serial_number":"111-222-333",
"enabled":true,
"framework_version":"5.10.2",
"meta":{
"brand":"pax",
"model":"d200",
"communication_media":"gprs",
"gprs_signal":"80",
"sim_card_id":"8955101234567890",
"os_version":"2.4.104",
"emv_kernel_version":"v602_01 2015.04.02",
"ssa_version":"",
"battery_level":"50",
"ssl":"on",
"signature":"production"
},
"updated_at":"2015-01-30T17:47:40Z",
"created_at":"2015-01-30T17:47:40Z",
"created_by":1,
"created_via":"interface"
}
}
]
}
Retorna os detalhes de um dispositivo específico.
GET https://api.cloudwalk.io/{versão}/devices/{device_id}?access_token={token}
$ curl -X GET "https://api.cloudwalk.io/v1/devices/2?access_token=$TOKEN"
require 'net/http'
token = 'API_TOKEN'
uri = URI("https://api.cloudwalk.io/v1/devices/2?access_token=#{token}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Get.new(uri.request_uri)
res = http.request(request)
puts "Response #{res.code} #{res.message}: #{res.body}"
{
"device":{
"id":2,
"serial_number":"111-222-333",
"enabled":true,
"framework_version":"5.10.2",
"meta":{
"brand":"pax",
"model":"d200",
"communication_media":"gprs",
"gprs_signal":"80",
"sim_card_id":"8955101234567890",
"os_version":"2.4.104",
"emv_kernel_version":"v602_01 2015.04.02",
"ssa_version":"",
"battery_level":"50",
"ssl":"on",
"signature":"production"
},
"updated_at":"2015-01-30T17:47:40Z",
"created_at":"2015-01-30T17:47:40Z",
"created_by":1,
"created_via":"interface"
}
}
Libera o acesso de um dispositivo ao CloudWalk.
POST https://api.cloudwalk.io/{versão}/devices?access_token={token}
$ curl -X POST "https://api.cloudwalk.io/v1/devices?access_token=$TOKEN" \
-d '{"serial_number":"444-555-666"}'
require 'net/http'
require 'json'
token = 'API_TOKEN'
payload = {
"serial_number" => "444-555-666"
}
uri = URI("https://api.cloudwalk.io/v1/devices?access_token=#{token}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Post.new(uri.request_uri)
request.body = payload.to_json
res = http.request(request)
puts "Response #{res.code} #{res.message}: #{res.body}"
{
"device":{
"id":3,
"serial_number":"444-555-666",
"enabled":true,
"framework_version":"5.10.2",
"meta":{
"brand":"pax",
"model":"d200",
"communication_media":"gprs",
"gprs_signal":"80",
"sim_card_id":"8955101234567893",
"os_version":"2.4.104",
"emv_kernel_version":"v602_01 2015.04.02",
"ssa_version":"",
"battery_level":"50",
"ssl":"on",
"signature":"production"
},
"updated_at":"2015-01-30T17:55:19Z",
"created_at":"2015-01-30T17:55:19Z",
"created_by":1,
"created_via":"api"
}
}
Modifica um dispositivo já existente.
PUT https://api.cloudwalk.io/{versão}/devices/{serial_number}?access_token={token}
$ curl -X PUT "https://api.cloudwalk.io/v1/devices/444-555-666?access_token=$TOKEN" \
-d '{"enabled":"false"}'
require 'net/http'
require 'json'
token = 'API_TOKEN'
payload = {
"enabled" => "false"
}
uri = URI("https://api.cloudwalk.io/v1/devices/444-555-666?access_token=#{token}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Put.new(uri.request_uri)
request.body = payload.to_json
res = http.request(request)
puts "Response #{res.code} #{res.message}: #{res.body}"
{
"device":{
"id":3,
"serial_number":"444-555-666",
"enabled":false,
"framework_version":"5.10.2",
"meta":{
"brand":"pax",
"model":"d200",
"communication_media":"gprs",
"gprs_signal":"80",
"sim_card_id":"8955101234567893",
"os_version":"2.4.104",
"emv_kernel_version":"v602_01 2015.04.02",
"ssa_version":"",
"battery_level":"50",
"ssl":"on",
"signature":"production"
},
"updated_at":"2015-01-30T17:58:59Z",
"created_at":"2015-01-30T17:55:19Z",
"created_by":1,
"created_via":"api"
}
}
Exclui um dispositivo. O equipamento com o número de série excluído não terá mais acesso ao CloudWalk.
DELETE https://api.cloudwalk.io/{versão}/devices/{serial_number}?access_token={token}
$ curl -X DELETE "https://api.cloudwalk.io/v1/devices/444-555-666?access_token=$TOKEN"
require 'net/http'
token = 'API_TOKEN'
uri = URI("https://api.cloudwalk.io/v1/devices/444-555-666?access_token=#{token}")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true
request = Net::HTTP::Delete.new(uri.request_uri)
res = http.request(request)
puts "Response #{res.code} #{res.message}: #{res.body}"
{}