POST rule engine/mac addresses

From Social ID Developers
(Difference between revisions)
Jump to: navigation, search
(Parameters)
(Blanked the page)
 
Line 1: Line 1:
== Description ==
 
  
Cria um novo mac address associado a um usuário do Social Login.
 
 
== Resource URL ==
 
 
  POST https://api.socialidnow.com/v1/marketing/rule_engine/mac_addresses
 
 
== Parameters ==
 
 
{|
 
! align="left" width="200px" | mac_address
 
| width="200px" | obrigatório
 
| um hash no formato campo:valor, contendo os campos necessários para criação do mac address:
 
|-
 
! align="left" width="200px" style="padding-left: 20px" | mac_address
 
| width="200px" | obrigatório
 
| identificador do mac address formatado como uma string contendo 6 pares de números hexadecimais (maiúsculos ou minúsculos), separados por ":" ou "-".
 
|-
 
! align="left" width="200px" style="padding-left: 20px" | login_user_id
 
| width="200px" | obrigatório
 
| identificador do usuário
 
|}
 
 
== Authentication ==
 
 
Esta API exige autenticação do Marketing Login App. Ver [[Authentication]].
 
 
== Response ==
 
 
==== Response Status ====
 
{|
 
! align="left" width="200px" | created (201)
 
| O mac address foi criado com sucesso e associado ao usuário.
 
|+
 
! align="left" width="200px" | ok (200)
 
| O mac address já havia sido criado e associado a este usuário.
 
|+
 
! align="left" width="200px" | bad_request (400)
 
| O parâmetro "mac_address" não foi informado ou não é um hash.
 
|+
 
! align="left" width="200px" | unauthorized (401)
 
| A autenticação está errada. Ver [[#Authentication|Autenticação]].
 
|+
 
! align="left" width="200px" | unprocessable_entity (422)
 
| Erro de validação no campo "mac_address".
 
|+
 
! align="left" width="200px" | not_found (404)
 
| Usuário não encontrado ou campo "login_user_id" não informado.
 
|+
 
! align="left" width="200px" | internal_server_error (500)
 
| Um erro desconhecido ocorreu.
 
|}
 
 
== Example Request ==
 
 
Cria um novo mac address com valor 0a:1b:2c:3d:4e:5f e associa ao usuário com id 180.
 
 
curl -iX POST 'https://api.socialidnow.com/v1/marketing/rule_engine/mac_addresses' \
 
  -d '{"mac_address": { "mac_address": "0a:1b:2c:3d:4e:5f",
 
                        "login_user_id": "180" }}' \
 
  -H 'Content-type: application/json' \
 
  --user 138:e8b9ca24f1b590af67e6271297d6e1f7226625d61c5b5daa1b2f215464e292cf
 
 
Response:
 
 
HTTP/1.1 201 Created
 
Status: 201
 

Latest revision as of 22:52, 11 August 2014

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox