Artículos

Añadir

Una vez creada la campaña, deberás añadir el listado de los artículos sobre los que aplica.

http

POST /me/campaigns/:campaignId/articles HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com

[
  {
    "id": "89793238462643383279",
    "name": "Reloj en oro blanco de 18 quilates y diamantes",
    "description": "Movimiento de cuarzo de alta precisión",
    "url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg"
  },
  {
    "id": "59825349042875546873",
    "name": "Nº5 eau premiere spray",
    "description": "A decidedly lighter, fresher...",
    "url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg"
  }
]

shell

$ curl "https://api.aplazame.com/me/campaigns/:campaignId/articles" \
    -H "Accept: application/vnd.aplazame.v1+json" \
    -H "Authorization: Bearer api_private_key"\
    --data-binary '[
  {
    "id": "89793238462643383279",
    "name": "Reloj en oro blanco de 18 quilates y diamantes",
    "description": "Movimiento de cuarzo de alta precisión",
    "url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg"
  },
  {
    "id": "59825349042875546873",
    "name": "Nº5 eau premiere spray",
    "description": "A decidedly lighter, fresher...",
    "url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url": "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg"
  }
]'

python

import aplazame_sdk

client = aplazame_sdk.Client('api_private_key')
response = client.post_campaign_articles(':merchantId', ':campaignId', [
  {
    'id': '89793238462643383279',
    'name': 'Reloj en oro blanco de 18 quilates y diamantes',
    'description': 'Movimiento de cuarzo de alta precisión',
    'url': 'http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083',
    'image_url': 'http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg',
  },
  {
    'id': '59825349042875546873',
    'name': 'Nº5 eau premiere spray',
    'description': 'A decidedly lighter, fresher...',
    'url': 'http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083',
    'image_url': 'http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg',
  }
])

php

use Aplazame\Api\Client as AplazameClient;

$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, "api_private_key");

$articles = [
  [
    "id" => "89793238462643383279",
    "name" => "Reloj en oro blanco de 18 quilates y diamantes",
    "description" => "Movimiento de cuarzo de alta precisión",
    "url" => "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url" => "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg",
  ],
  [
    "id" => "59825349042875546873",
    "name" => "N°5 eau premiere spray",
    "description" => "A decidedly lighter, fresher...",
    "url" => "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    "image_url" => "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg",
  ]
];
$result = $aplazameClient->post("/me/campaigns/{$campaignId}/articles", $articles);

C#

using Aplazame.Api;

Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, "api_private_key");

dynamic[] articles = new dynamic[] {
  new {
    id = "89793238462643383279",
    name = "Reloj en oro blanco de 18 quilates y diamantes",
    description = "Movimiento de cuarzo de alta precisión",
    url = "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    image_url = "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg",
  },
  new {
    id = "59825349042875546873",
    name = "N°5 eau premiere spray",
    description = "A decidedly lighter, fresher...",
    url = "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083",
    image_url = "http://www.chanel.com/fragrance-beauty/Fragrance-N05-88145/sku/138083/product_01.jpg",
  }
};
dynamic result = client.Post($"/me/campaigns/{campaignId}/articles", articles);

Parámetro	Tipo	Requerido	Descripción
id	string	Sí	ID del artículo.
name	string	Sí	Nombre del artículo.
description	string	No	Descripción del artículo.
url	URL	Sí	URL absoluta del artículo.
image_url	URL	No	URL absoluta de la imagen del artículo.

Respuesta

HTTP/1.1 204 NO CONTENT
Content-Type: application/vnd.aplazame.v1+json

Borrado

Borrado individual de un artículo incluido en una campaña.

http

DELETE /me/campaigns/:campaignId/articles/:articleId HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com

shell

$ curl "https://api.aplazame.com/me/campaigns/:campaignId/articles/:articleId" \
    -H "Accept: application/vnd.aplazame.v1+json" \
    -H "Authorization: Bearer api_private_key"\
    -X DELETE'

python

import aplazame_sdk

client = aplazame_sdk.Client('api_private_key')
response = client.delete_campaign_article(':merchantId', ':campaignId', ':articleId')

php

use Aplazame\Api\Client as AplazameClient;

$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, "api_private_key");
$result = $aplazameClient->delete("/me/campaigns/{$campaignId}/articles/{$articleId}");

C#

using Aplazame.Api;

Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, "api_private_key");
dynamic result = client.Delete($"/me/campaigns/{campaignId}/articles/{articleId}");

Respuesta

HTTP/1.1 204 NO CONTENT
Content-Type: application/vnd.aplazame.v1+json

Borrar todos

Al no incluir el id del artículo en la URL estarás referenciando a todos los artítulos de la campaña.

http

DELETE /me/campaigns/:campaignId/articles HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com

shell

$ curl "https://api.aplazame.com/me/campaigns/:campaignId/articles" \
    -H "Accept: application/vnd.aplazame.v1+json" \
    -H "Authorization: Bearer api_private_key"\
    -X DELETE'

python

import aplazame_sdk

client = aplazame_sdk.Client('api_private_key')
response = client.delete_campaign_articles(':merchantId', ':campaignId')

php

use Aplazame\Api\Client as AplazameClient;

$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, "api_private_key");
$result = $aplazameClient->delete("/me/campaigns/{$campaignId}/articles");

C#

using Aplazame.Api;

Client client = new Client("https://api.aplazame.com", Client.EnvironmentProduction, "api_private_key");
dynamic result = client.Delete($"/me/campaigns/{campaignId}/articles");

Respuesta

HTTP/1.1 204 NO CONTENT
Content-Type: application/vnd.aplazame.v1+json

Listado

http

GET /me/campaigns/:campaignId/articles?page=2 HTTP/1.1
Accept: application/vnd.aplazame.v1+json
Authorization: Bearer api_private_key
Host: api.aplazame.com

shell

$ curl "https://api.aplazame.com/me/campaigns/:campaignId/articles" \
    -H "Accept: application/vnd.aplazame.v1+json" \
    -H "Authorization: Bearer api_private_key"

python

import aplazame_sdk

client = aplazame_sdk.Client('api_private_key')
response = client.get_campaign_articles(':merchantId', ':campaignId')

php

use Aplazame\Api\Client as AplazameClient;

$aplazameClient = new AplazameClient("https://api.aplazame.com", AplazameClient::ENVIRONMENT_PRODUCTION, "api_private_key");
$result = $aplazameClient->get("/me/campaigns/{$campaignId}/articles");

C#

using Aplazame.Api;

Client client = new Client(
  "https://api.aplazame.com",
  Client.EnvironmentProduction,
  "api_private_key"
);
dynamic result = client.Get($"/me/campaigns/{campaignId}/articles");

info

Ver documentación de paginación

Respuesta

HTTP/1.1 200 OK
Content-Type: application/json

{
  "cursor": {
    "after": 3,
    "before": 1
  },
  "paging": {
    "count": 314,
    "next": "https://api.aplazame.com/me/campaigns/:campaignId/articles?page=3",
    "previous": "https://api.aplazame.com/me/campaigns/:campaignId/articles?page=1"
  },
  "results": [
  ]
}

Parámetro	Tipo	Descripción
cursor	object	Puntero de paginación.
paging	object	Estado de paginación.
results	collection	Listado de campañas.