|
|
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
| |