API & Webhooks

Update the data from a campaign session

Base URL

Parameters

<?php
	$ch = curl_init();
	$url = "https://api4coupons.com/v3/couponsession/update";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
		'couponsession' => "ac6s7u3g8a25ja7x9qg87"
	];
	curl_setopt($ch, CURLOPT_URL, "$url");
	curl_setopt($ch, CURLOPT_POST, true);
	curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
	curl_setopt($ch, CURLOPT_VERBOSE, true);
	curl_setopt($ch, CURLOPT_HTTPHEADER, [
		"X-Client-Id: $client_id",
		"X-Client-Secret: $client_secret",
		"Content-Type: application/json",
	]);
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
	$response = curl_exec($ch);
?>

const https = require("https");
const client_id = "XXX"; // Your API client ID (required)
const client_secret = "YYY"; // Your API client secret (required)
const data = JSON.stringify({
	couponsession: "ac6s7u3g8a25ja7x9qg87"
});
const options = {
    hostname: "api4coupons.com",
    port: 443,
    path: "/v3/couponsession/update",
    method: "POST",
    headers: {
        "X-Client-Id": client_id,
        "X-Client-Secret": client_secret,
		"Content-Type": "application/json",
		"Content-Length": data.length,
    },
};
const req = https.request(options, (res) => {
    console.log(`statusCode: ${res.statusCode}`);
    res.on("data", (d) => {
        process.stdout.write(d);
    });
});
req.write(data);
req.end();

require "uri"
require "net/http"

url = URI("https://api4coupons.com/v3/couponsession/update")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-Client-Id"] = "XXX" // Your API client ID (required)
request["X-Client-Secret"] = "YYY" // Your API client secret (required)
request["Content-Type"] = "application/json"
form_data = [
	['couponsession', "ac6s7u3g8a25ja7x9qg87"]
]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body

import requests
url = "https://api4coupons.com/v3/couponsession/update"
payload={
	'couponsession': 'ac6s7u3g8a25ja7x9qg87'
}
files=[]
headers = {
	'X-Client-Id': 'XXX', #Your API client ID (required)
	'X-Client-Secret': 'YYY', #Your API client secret (required)
	'Content-Type': 'application/json'
}
response = requests.request(
	"POST",
	url,
	headers=headers,
	data=payload,
	files=files
)
print(response.text)

var url = "https://api4coupons.com/v3/couponsession/update";
var client = new RestClient(url);
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("X-Client-Id", "XXX"); // Your API client ID (required)
request.AddHeader("X-Client-Secret", "YYY"); // Your API client secret (required)
request.AddHeader("Content-Type", "application/json");
request.AlwaysMultipartFormData = true;
request.AddParameter("couponsession", "ac6s7u3g8a25ja7x9qg87");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

				{
					"status":{
						"status": "OK"
					},
					"campaign": "cam_12345",
					"action": "update_session",
					"action_date": "2019-04-10 11:35:36",
					"session": "et4ufwqsnqc8r9ckrki6m",
					"customid": "",
					"operation": "validate_succesful"
				}
				

				{
					"status": {
						"status": "failed",
						"errors": {
							"error_message": "HTTP/1.0 422 Unprocessable entity.",
							"error_message_description": [
								"Session already was validated before."
							],
							"error_code": [
								358
							]
						}
					}
				}
				

Possible errors

• 200: Missing parameter: couponsession
• 300: Invalid character in parameter: couponsession.
• 300: Invalid character in parameter: customid.
• 302: Invalid value in parameter: operation
• 351: Session is expired.
• 351: Session or coupon has expired
• 352: Session already was claimed before.
• 352: Session could not be locked because it is not claimed.
• 353: Session was already unvalidated
• 354: This coupon is locked.
• 354: Session already was locked before.
• 358: Session already was validated before.
• 355: Session could not be locked because it is voided.
• 355: Session could not be unlocked because it is voided.
• 355: Session was already voided.
• 355: This coupon is voided.
• 356: Session was already unlocked
• 357: Session wasn't void
• 358: This session was already validated.
• 358: Session could not be locked because it is already validated.
• 360: Session or coupon has not reached startdate yet
• 361: Max coupons exceeded
• 512: Coupon session not found.

---

Register now for a 7-days trial account

Start using Coupontools today!

• Register for a trial

Email is required *