Introduction
Welcome to the JotUrl API Version i1! This is the right place to find information on how to programmatically interact with the JotUrl interface.
Authentication
Session token
Step 1: acquiring a token
Example
{PUBLIC_KEY} = "ae7b4635320411fe"
{PRIVATE_KEY} = "9283c835ef5e21d3"
{GMT_DATETIME} = "2018-11-30T20:04Z"
{PASSWORD} = HMAC_SHA256({PRIVATE_KEY}, {PUBLIC_KEY} + ':' + {GMT_DATETIME}) =
= HMAC_SHA256("9283c835ef5e21d3", "ae7b4635320411fe:2018-11-30T20:04Z") =
= "e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa"
Request
https://joturl.com/a/i1/users/login?username=test@example.com&password=e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
The above request returns a JSON structured like this:
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"session_id": "93bed02bf74e191294e22da6272a18a8",
"datetime": "2018-11-30T20:04Z"
}
}
Session authentication needs the generation of a session token session_id
that is used to sign all other request to the API endpoints.
To generate the session_id
you have to make a request (GET
or POST
) to the API endpoint:
https://joturl.com/a/i1/users/login?username={EMAIL}&password={PASSWORD}
where {EMAIL}
is the email you use to login the JotUrl dashaboard and {PASSWORD}
is obtained by using an HMAC_SHA256 hash function:
{PASSWORD} = HMAC_SHA256({PRIVATE_KEY}, {PUBLIC_KEY} + ':' + {GMT_DATETIME})
{PUBLIC_KEY}
and {PRIVATE_KEY}
are your public and private API keys, respectively (API Keys).
Parameter {GMT_DATETIME}
is the the GMT date/time in the format YYYY-MM-ddThh:mmZ
where:
- YYYY is the full numeric representation of the year (4 digits)
- MM is the month with leading zeros (01-12)
- dd is the day with leading zeros (01-31)
- T is the uppercase letter T
- hh is the hour with leading zeros (00-23)
- mm are the minutes with leading zeros (00-59)
- Z is the uppercase letter Z
Parameter {GMT_DATETIME}
must be generated on a device as synchronized as possible with the GMT date/time (each request requires a new {GMT_DATETIME}
).
Step 2: sign API calls
Example
_sid = {session_id} =
= "93bed02bf74e191294e22da6272a18a8"
_h = HMAC_SHA256({PRIVATE_KEY}, {session_id} + ':' + {GMT_DATETIME}) =
= HMAC_SHA256("9283c835ef5e21d3", "93bed02bf74e191294e22da6272a18a8:2018-11-30T20:04Z") =
= "c9afd295a66bdfd68b2ee5a6c1031ff343d17691d56af17504127cf22d5a9d5b"
Request
https://joturl.com/a/i1/users/info?_sid=93bed02bf74e191294e22da6272a18a8&_h=c9afd295a66bdfd68b2ee5a6c1031ff343d17691d56af17504127cf22d5a9d5b
Response
{
"status": {
"code": 500,
"text": "INVALID session",
"error": "",
"rate": 0
},
"result": []
}
Every request to API endpoints have to be signed with the parameters _sid
and _h
. Where _sid
is the session token {session_id}
obtained in step 1 and _h
is generated with the same method used for the {PASSWORD}
parameter in step 1:
_h = HMAC_SHA256({PRIVATE_KEY}, {session_id} + ':' + {GMT_DATETIME})
Parameter {GMT_DATETIME}
is obtained in the same way and follows the same rules as in step 1.
The session token
The session token session_id
expires approximately every 30 days, but may expire sooner due to various factors and if you call the API method users/logout.
As a best practice, we suggest you to continue to use it until you get an "INVALID session" error response from the API endpoint. In this case, you have to restart the authentication procedure from the beginning.
Examples
The examples in this section return the expected values for the HMAC_SHA256
hash, these values can be used to test the implementation of the HMAC_SHA256
hash you are using. You can find SDKs and examples here.
PHP
PHP example.
<?php
function HMAC_SHA256( $private_key, $message, $time = null ) {
return hash_hmac(
'sha256',
$message . ':' . ( $time ?: gmdate( "Y-m-d\TH:i\Z", time() ) ),
$private_key
);
}
$public_key = "ae7b4635320411fe";
$private_key = "9283c835ef5e21d3";
$gmt_datetime = "2018-11-30T20:04Z";
// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
echo HMAC_SHA256( $private_key, $public_key, $gmt_datetime );
Python
Python example.
# coding: utf8
import sys
import hmac
import hashlib
try:
def HMAC_SHA256(private_key="", message="", time=""):
message += ":"
if time:
message += str(time)
else:
message += str(datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%MZ'))
return hmac.new(str.encode(private_key), str.encode(message), hashlib.sha256).hexdigest()
public_key = "ae7b4635320411fe"
private_key = "9283c835ef5e21d3"
gmt_datetime = "2018-11-30T20:04Z"
# e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
print(HMAC_SHA256(private_key, public_key, gmt_datetime))
except Exception as t:
print(t)
sys.exit(0)
# end try
NodeJS
NodeJS example.
const crypto = require('crypto');
try {
function gmdate() {
var iso = (new Date()).toISOString();
return iso.substr(0, iso.length - 8) + 'Z';
}
function create_sha256(key, message) {
var hmac = crypto.createHmac('sha256', key);
hmac.update(message);
return hmac.digest('hex');
}
function HMAC_SHA256(private_key, message, time) {
var msg = message + ":" + (time ? time : gmdate());
return create_sha256(private_key, msg);
}
var public_key = "ae7b4635320411fe";
var private_key = "9283c835ef5e21d3";
var gmt_datetime = "2018-11-30T20:04Z";
// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
console.log(HMAC_SHA256(private_key, public_key, gmt_datetime));
} catch (e) {
console.log(e.message);
}
Java
Java example.
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.security.NoSuchAlgorithmException;
import java.security.InvalidKeyException;
import java.text.SimpleDateFormat;
import java.util.Locale;
import java.util.Date;
import java.util.TimeZone;
public class HMAC_SHA256_EXAMPLE {
public static String gmdate() {
String pattern = "yyy-MM-dd'T'HH:mm'Z'";
SimpleDateFormat simpleDateFormat = new SimpleDateFormat(pattern);
simpleDateFormat.setTimeZone(TimeZone.getTimeZone("UTC"));
return simpleDateFormat.format(new Date());
}
public static String hex(byte[] bytes) {
StringBuilder result = new StringBuilder();
for (byte aByte: bytes) {
result.append(String.format("%02x", aByte));
}
return result.toString();
}
public static String HMAC_SHA256(String private_key, String message, String date_time)
throws NoSuchAlgorithmException, InvalidKeyException {
Mac sha256_HMAC = Mac.getInstanceNumber("HmacSHA256");
SecretKeySpec secret_key = new SecretKeySpec(private_key.getBytes(), "HmacSHA256");
sha256_HMAC.initClient(secret_key);
return hex(sha256_HMAC.doFinal((message + ":" + date_time).getBytes()));
}
public static String HMAC_SHA256(String private_key, String message)
throws NoSuchAlgorithmException, InvalidKeyException {
return HMAC_SHA256(private_key, message, gmdate());
}
public static void main(String[] args) {
try {
String public_key = "ae7b4635320411fe";
String private_key = "9283c835ef5e21d3";
String date_time = "2018-11-30T20:04Z";
// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
System.out.println(HMAC_SHA256(private_key, public_key, date_time));
}
catch(Exception e) {
System.out.println("Error");
}
}
}
C#
C# example.
using System;
using System.Security.Cryptography;
using System.Text;
namespace HMAC_SHA256_EXAMPLE
{
class Program
{
public static string gmdate()
{
return DateTime.UtcNow.ToString("yyyy-MM-ddTHH:mmZ");
}
public static string hex(byte[] ba)
{
StringBuilder hex = new StringBuilder(ba.Length * 2);
foreach (byte b in ba)
{
hex.AppendFormat("{0:x2}", b);
}
return hex.ToString();
}
private static string HMAC_SHA256(string private_key, string message, string time = "")
{
var hash = new HMACSHA256(Encoding.ASCII.GetBytes(private_key));
return hex(hash.ComputeHash(Encoding.ASCII.GetBytes(message + ":" + (time ?? gmdate()))));
}
static void Main(string[] args)
{
var public_key = "ae7b4635320411fe";
var private_key = "9283c835ef5e21d3";
var gmt_datetime = "2018-11-30T20:04Z";
// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
Console.WriteLine(HMAC_SHA256(private_key, public_key, gmt_datetime));
}
}
}
Flutter (Dart)
Flutter (Dart) example.
import 'dart:convert';
import 'package:crypto/crypto.dart';
void main() {
String public_key = 'ae7b4635320411fe';
String private_key = '9283c835ef5e21d3';
String gmt_datetime = '2018-11-30T20:04Z';
// e78a507e8e031a02c5c81a2eacb5bd6c1f846a99af7c5d0f339f006dc44384aa
print(HMAC_SHA256(private_key, public_key, gmt_datetime));
}
String gmdate() {
String iso = DateTime.now().toUtc().toIso8601String();
return iso.substring(0, 16) + 'Z';
}
String create_sha256(String key, String message) {
var hmacSha256 = new Hmac(sha256, utf8.encode(key));
var digest = hmacSha256.convert(utf8.encode(message));
return digest.toString();
}
String HMAC_SHA256(String private_key, String message, [String time = '']) {
String msg = message + ":" + (!time.isEmpty ? time : gmdate());
return create_sha256(private_key, msg);
}
Token authentication
Token authentication (also called bearer authentication) is an HTTP authentication scheme that involves security tokens called bearer tokens.
Step 1: acquiring a token
Request
https://joturl.com/a/i1/apis/tokens
The above request returns a JSON structured like this:
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"read_write_token": "tok_RWxtd74zqlcv18d6qiau75kr1bwpagqbq5",
"read_only_token": "tok_RO064cmpvzcsxc5ufg0xzx58ms3q15bn10"
}
}
API tokens authentication needs a read-only or read/write token that is used to sign all other request to the API endpoints. API tokens do not expire and can be reset using the endpoint apis/tokens.
To get API tokens you have to make a request (GET
or POST
) to the endpoint:
https://joturl.com/a/i1/users/tokens
you must already be logged in using the session token.
Step 2: sign API calls
Every request to API endpoints have to be signed with the Authorization
HTTP header:
Authorization: Bearer {token}
where {token}
is one of the API tokens obtained in step 1.
With the read-only token you can only call endpoints with access [read].
You can find the required access of each endpoint immediately below the endpoint itself in this documentation.
Input requests
Example
https://joturl.com/a/i1/urls/shorten?long_url=https%3A%2F%2Fwww.joturl.com%2F&alias=jot
Parameters to each JotUrl API can be passed both with the GET and POST methods.
Output formats
Query
format=json
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 87
},
"result": {DATA}
}
Query
format=jsonp&callback=clbfunc
Response
clbfunc({
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 87
},
"result": {DATA}
})
Query
format=jsonp
Response
{
"status": {
"code": 500,
"text": "MISSING callback",
"error": "",
"rate": 21
},
"result": []
}
Query
format=xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>87</rate>
</status>
<result>{DATA}</result>
</response>
Query
format=txt
Response
status_code=200
status_text=OK
status_error=
status_rate=87
result={DATA}
Query
format=plain
Response
{DATA}
The JotUrl API supports Cross Origin Resource Sharing (CORS) requests from any domain.
All JotUrl APIs support five return formats: json
, jsonp
, xml
, txt
, plain
. Note that the formats txt
and plain
may return only limited information.
The default output format is format = json
that is also used when the parameter format is invalid (e.g., format = jsonp
but no callback parameter is specified).
Rate limits
If the rate limits are exceeded, the call fails and returns a 403 status code, with a LIMIT EXCEEDED status text (see Output formats for details).
Typical response
{
"status": {
"code": <STATUS CODE>,
"text": "<STATUS TEXT>",
"error": "<STATUS ERROR>",
"rate": <REQUESTS PER SECOND>
},
"result": <DATA>
}
If you send requests too quickly, make sure that the rate
parameter in the status
response is below the rate limits set for your account. The rate
parameter is always expressed in requests per second. If you exceed the limits set for your account, our engine may block your requests for a time directly proportional to the speed with which you are sending the requests: the greater the gap with your rate limits, the greater the blocking time. Finally, if you do not fall within your rate limits for a long time, our engine could permanently block any further requests.
QR-Codes
A QR-Code is provided for each shorten URL. To generate it append .qrcode
or .qr
to the end of any shortened link. For example: http://jo.my/jotvideo.qrcode
, http://jo.my/jotvideo.qr
Errors
For each request the status code is equal to the HTTP response status that can be:
code | text | error | explanation |
---|---|---|---|
200 | OK | successful request | |
403 | LIMIT EXCEEDED | details on the error if available | rate limit exceeded |
404 | NOT FOUND | details on the error if available | the query is well-formed but there is no available response |
405 | METHOD NOT ALLOWED | details on the error if available | the endpoint is not available to the calling user |
414 | Request-URI Too Large | details on the error if available | GET request contains long query information, use a POST request instead |
500 | INVALID [PARAMETER] | details on the error if available | invalid parameter [PARAMETER] in the request |
INVALID METHOD [METHOD] | details on the error if available | invalid method [METHOD] | |
MISSING [ARGUMENT] | details on the error if available | the required argument [ARGUMENT] is missing in the request | |
503 | GENERIC ERROR | details on the error if available | a generic error occurred and/or the service is temporarily unavailable 1 |
1 A GENERIC ERROR
(503) is also issued in all those cases where a parameter has passed all validation checks, but for some reason our engine cannot use it to complete the request. For example, if you try to create a tracking link with the alias $alias
you will see the error INVALID alias
(500), since the alias $alias
contains the forbidden character $
, but if you try to create a tracking link with the alias alias
and it is already have been used, you will see the error GENERIC ERROR
(503) and the error
field of the output status will be "The chosen alias is not available".
Parameters types
API endpoints require some parameters to be sent as part of the request. Most parameters are simple strings, but some endpoints require other types to be provided.
type | description | example |
---|---|---|
string | sequence of alphanumeric text or other symbols | hamburger |
id | variable length string obtained as a result of an API call | 62613864764b3762725a343966673d3d |
array | comma separated list of type string, a maximum of 100 items are allowed | hamburger, test |
array_of_ids | comma separated list of type id, a maximum of 100 items are allowed | 62613864764b375a343966673d3d, 86590152f1891e680, 5952b26623c9b47ad9e |
integer | integer | 12 |
float | float with . (point) as a decimal separator | 12.34 |
boolean | boolean parameter, accepted values are true, false, on, off, 1, 0 | 1 |
date | date in the format yyyy-mm-dd (UTC) | 2019-06-04 |
datetime | date/time in the format yyyy-mm-dd hh:mm:ss (UTC) | 2019-06-04 19:21:34 |
json | stringified JSON object or associative array | {"test":"check"}, param[test]=check |
enum | is a string with a value chosen from a list of allowed values | remarketing |
JotUrl SDKs
JotUrl SDKs help you develop apps, websites and plugins that relies on all the functionality of our APIs. We currently support PHP, Python, Java and NodeJS, but you can easily integrate our APIs with all development technologies.
PHP SDK
Click here to download the SDK for PHP with an example included.
PHP example
<?php
// replace [your login] with the email you use to login into JotUrl
define( 'SDK_USER_NAME', '[your login]' );
// replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
define( 'SDK_PUBLIC_API_KEY', '[public key]' );
// replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
define( 'SDK_PRIVATE_API_KEY', '[private key]' );
require_once 'sdk/JotUrlSDK.php';
try {
// create an instance of JotUrlSDK
$joturl = new JotUrlSDK( SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY );
$joturl->wrapper( function ( $sdk ) {
// get logged user information
$url = $sdk->buildURL( 'users/info' );
echo "Getting user info" . PHP_EOL;
$result = $sdk->call( $url );
echo "====== USER INFO ======" . PHP_EOL;
print_r( $result );
} );
$joturl->wrapper( function ( $sdk ) {
// get first 5 projects
$url = $sdk->buildURL( 'projects/list', array( "fields" => "id,name", "length" => 5 ) );
echo "Getting first 5 projects (if available)" . PHP_EOL;
$result = $sdk->call( $url );
echo "====== PROJECTS ======" . PHP_EOL;
print_r( $result );
} );
} catch ( Throwable $t ) {
die( $t->getMessage() );
}
Documentation
<?php
/**
* Creates an instance of the JotUrl SDK.
*
* @param string $username the username used to login into JotURL dashboard
* @param string $public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param string $private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
*/
new JotUrlSDK( $username, $public_key, $private_key );
/**
* Automatically try to access the JotURL API, the callback is called if the access is successful.
*
* @param mixed $callback callback to be called on success
*
* @return mixed value returned by the $callback function, an exception is thrown on error
*/
function wrapper( $callback );
/**
* Given an endpoint and parameters (optional) returns the URL to be called.
*
* @param string $endpoint endpoint to be called
* @param array $parameters associative array [param => value]
*
* @return string the URL to be called
*/
function buildURL( $endpoint, $parameters = array() );
/**
* Call and get results from the API endpoint.
*
* @param string $url URL to be called
* @param array $postParameters [OPTIONAL] array containing post parameters
*
* @return bool|array associative array containing the result of the call
*/
function call( $url, $postParameters = array() );
Python SDK
Click here to download the SDK for Python 3+ with an example included.
Python example
# coding: utf8
import sys
from sdk.JotUrlSDK import JotUrlSDK
# replace [your login] with the email you use to login into JotUrl
SDK_USER_NAME = "[your login]"
# replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
SDK_PUBLIC_API_KEY = "[public key]"
# replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
SDK_PRIVATE_API_KEY = "[private key]"
try:
# create an instance of JotUrlSDK
joturl = JotUrlSDK(SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY)
def getUserInfo(sdk):
# get logged user information
url = sdk.buildURL("users/info")
print("Getting user info")
result = sdk.call(url)
print("====== USER INFO ======")
print(result)
joturl.wrapper(getUserInfo)
def getProjectsList(sdk):
# get first 5 projects
url = sdk.buildURL("projects/list", {"fields": "id,name", "length": 5})
print("Getting first 5 projects (if available)")
result = sdk.call(url)
print("====== PROJECTS ======")
print(result)
joturl.wrapper(getProjectsList)
def getProjectsListWithPOSTRequest(sdk):
# get first 5 projects
url = sdk.buildURL("projects/list")
print("Getting first 5 projects (if available) with a POST request")
result = sdk.call(url, {"fields": "id,name", "length": 5})
print("====== PROJECTS ======")
print(result)
joturl.wrapper(getProjectsListWithPOSTRequest)
except Exception as t:
print(t)
sys.exit(0)
# end try
Documentation
"""
Creates an instance of the JotUrl SDK.
@param username the username used to login into JotURL dashboard
@param public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
@param private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
"""
def __init__(self, username="", public_key="", private_key=""):
"""
Automatically try to access the JotURL API, the callback is called if the access is successful.
@param callback callback to be called on success
returns True on success, raises an exception on error
"""
def wrapper(self, callback=None):
"""
Given an endpoint and parameters (optional) returns the URL to be called.
@param endpoint endpoint to be called
@param parameters associative array [param => value]
returns the URL to be called
"""
def buildURL(self, endpoint="", parameters={}):
"""
Call and get results from the API endpoint.
@param url URL to be called
@param postParameters [OPTIONAL] array containing post parameters
returns bool|array JSON containing the result of the call, false on failure, raises an exception on error
"""
def call(self, url="", postParameters={}):
NodeJS SDK
Click here to download the SDK for NodeJS with an example included.
NodeJS example
// replace [your login] with the email you use to login into JotUrl
const SDK_USER_NAME = '[your login]';
// replace [public key] with your public key: https://www.joturl.com/reserved/settings.html#tools-api
const SDK_PUBLIC_API_KEY = '[public key]';
// replace [private key] with your private key: https://www.joturl.com/reserved/settings.html#tools-api
const SDK_PRIVATE_API_KEY = '[private key]';
try {
// create an instance of JotUrlSDK
let joturl = require('./sdk/JotUrlSDK.js')(SDK_USER_NAME, SDK_PUBLIC_API_KEY, SDK_PRIVATE_API_KEY);
// get logged user information
console.log("Getting user info");
joturl.call('users/info').then(result => {
console.log(result);
/* get first 5 projects */
console.log("Getting first 5 projects (if available)");
joturl.call('projects/list', {"fields": "id,name", "length": 5}).then(result => {
console.log(result);
}).catch(e => {
console.log(e.message);
});
}).catch(e => {
console.log(e.message);
});
} catch (e) {
console.log(e.message);
}
Documentation
/**
* Creates an instance of the JotUrl SDK.
*
* @param _username the username used to login into JotURL dashboard
* @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param base_url the base URL to be use to call API endpoints, defaults to https://joturl.com/a/i1/
*
* @returns {JotUrlSDK}
*/
require('JotUrlSDK')(_username, _public_key, _private_key, base_url);
/**
* Call and get results from the API endpoint.
*
* @param endpoint API endpoint to be called
* @param parameters [OPTIONAL] parameters to be passed to the call
* @param postParameters [OPTIONAL] post parameters to be passed to the call
*
* @returns {Promise}
*/
function call(endpoint, parameters = {}, postParameters = {});
Java SDK
Click here to download the SDK for Java with an example included.
Java example
import joturlsdk.JotUrlRunnable;
import joturlsdk.JotUrlSDK;
public class JotUrlExample {
public static void main(String[] args) {
try {
JotUrlSDK sdk = new JotUrlSDK("[username]", "[public_key]", "[private_key]");
sdk.call("users/info", new JotUrlRunnable() {
public void run() {
System.out.println(this.result);
}
});
} catch (Exception e) {
System.out.println("Error: " + e.getMessage());
}
}
}
Documentation
/**
* Creates an instance of the JotUrl SDK.
*
* @param _username the username used to login into JotURL dashboard
* @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
*
* @returns {JotUrlSDK}
*/
JotUrlSDK sdk = new JotUrlSDK(_username, _public_key, _private_key);
/**
* Call and get results from the API endpoint.
*
* @param endpoint API endpoint to be called
* @param parameters parameters to be passed to the call (null to ignore)
* @param postParameters post parametersto be passed to the call (null to ignore)
*
*/
JotUrlSDK.call(String endpoint, JotUrlRunnable callback, Map<String, String> parameters, Map<String, String> postParameters);
JotUrlSDK.call(String endpoint, JotUrlRunnable callback);
JotUrlSDK.callGET(String endpoint, Map<String, String> parameters, JotUrlRunnable callback);
JotUrlSDK.callPOST(String endpoint, Map<String, String> postParameters, JotUrlRunnable callback);
Flutter SDK
Click here to download the SDK for Flutter with an example included.
Dart example
import 'package:joturlsdk/joturlsdk.dart';
void main() async {
final String username = '[username]';
final String public_key = '[public_key]';
final String private_key = '[private_key]';
try {
JotUrlSDK sdk = new JotUrlSDK(username, public_key, private_key);
dynamic result = await sdk.call("users/info");
print('result: ' + result.toString());
} catch (e) {
print("Error: " + e.toString());
}
}
Documentation
/**
* Creates an instance of the JotUrl SDK.
*
* @param _username the username used to login into JotURL dashboard
* @param _public_key public api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param _private_key private api key, you can find it on https://www.joturl.com/reserved/settings.html#tools-api
* @param base_url the base URL to be use to call API endpoints, defaults to https://joturl.com/a/i1/
*
* @returns JotUrlSDK
* @constructor
*/
JotUrlSDK sdk = new JotUrlSDK(_username, _public_key, _private_key);
/**
* Call and get results from the API endpoint.
*
* @param endpoint API endpoint to be called
* @param getParameters query parameters to be passed to the call (null to ignore)
* @param postParameters post parametersto be passed to the call (null to ignore)
*
*/
sdk.call(endpoint, {Map<String, dynamic> getParameters = null, Map<String, dynamic> postParameters = null});
API reference
/decode
access: [READ]
This method converts API error codes into a friendly text message (in the current user language).
Example 1 (json)
Request
https://joturl.com/a/i1/decode?code=10
Query parameters
code = 10
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"message": "An error occurred while deleting the QR codes of a URL"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/decode?code=10&format=xml
Query parameters
code = 10
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<message>An error occurred while deleting the QR codes of a URL</message>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/decode?code=10&format=txt
Query parameters
code = 10
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_message=An error occurred while deleting the QR codes of a URL
Example 4 (plain)
Request
https://joturl.com/a/i1/decode?code=10&format=plain
Query parameters
code = 10
format = plain
Response
An error occurred while deleting the QR codes of a URL
Required parameters
parameter | description |
---|---|
codeSTRING | numeric code representing the error message |
Return values
parameter | description |
---|---|
lang | language in which the message is |
message | decoded text message |
/timestamp
access: [READ]
This method returns the current server timestamp (UTC) with microseconds as float.
Example 1 (json)
Request
https://joturl.com/a/i1/timestamp
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"timestamp": 1746969530.9984
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/timestamp?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<timestamp>1746969530.9984</timestamp>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/timestamp?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_timestamp=1746969530.9984
Example 4 (plain)
Request
https://joturl.com/a/i1/timestamp?format=plain
Query parameters
format = plain
Response
1746969530.9984
Return values
parameter | description |
---|---|
timestamp | the current Unix timestamp with microseconds |
/translate
access: [READ]
This method translates an error codes into a friendly text message.
Example 1 (json)
Request
https://joturl.com/a/i1/translate?code=sample_message&lang=en
Query parameters
code = sample_message
lang = en
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"text": "This is a sample error message",
"lang": "en"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=xml
Query parameters
code = sample_message
lang = en
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<text>This is a sample error message</text>
<lang>en</lang>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=txt
Query parameters
code = sample_message
lang = en
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_text=This is a sample error message
result_lang=en
Example 4 (plain)
Request
https://joturl.com/a/i1/translate?code=sample_message&lang=en&format=plain
Query parameters
code = sample_message
lang = en
format = plain
Response
This is a sample error message
en
Required parameters
parameter | description |
---|---|
codeSTRING | string code representing the error message |
Optional parameters
parameter | description |
---|---|
langSTRING | language in which you want to translate the message |
Return values
parameter | description |
---|---|
lang | language in which the message is |
text | text message corresponding to code |
/apis
/apis/accepted
access: [WRITE]
This method returns the actual result from an accepted (202) API endpoint.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/accepted
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": []
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/accepted?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/accepted?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result=
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/accepted?format=plain
Query parameters
format = plain
Response
Example 5 (json)
Request
https://joturl.com/a/i1/apis/accepted?_accepted_id=c0a0b8edf822a7187c238dda439701f3
Query parameters
_accepted_id = c0a0b8edf822a7187c238dda439701f3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"_accepted_id": "c0a0b8edf822a7187c238dda439701f3",
"_accepted_key": "method_id",
"_accepted_perc": 0,
"_accepted_count": 0,
"_accepted_total": 0,
"_accepted_errors": 0,
"_accepted_dt": "2025-05-11 13:18:49"
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/apis/accepted?_accepted_id=c0a0b8edf822a7187c238dda439701f3&format=xml
Query parameters
_accepted_id = c0a0b8edf822a7187c238dda439701f3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<_accepted_id>c0a0b8edf822a7187c238dda439701f3</_accepted_id>
<_accepted_key>method_id</_accepted_key>
<_accepted_perc>0</_accepted_perc>
<_accepted_count>0</_accepted_count>
<_accepted_total>0</_accepted_total>
<_accepted_errors>0</_accepted_errors>
<_accepted_dt>2025-05-11 13:18:49</_accepted_dt>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/apis/accepted?_accepted_id=c0a0b8edf822a7187c238dda439701f3&format=txt
Query parameters
_accepted_id = c0a0b8edf822a7187c238dda439701f3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result__accepted_id=c0a0b8edf822a7187c238dda439701f3
result__accepted_key=method_id
result__accepted_perc=0
result__accepted_count=0
result__accepted_total=0
result__accepted_errors=0
result__accepted_dt=2025-05-11 13:18:49
Example 8 (plain)
Request
https://joturl.com/a/i1/apis/accepted?_accepted_id=c0a0b8edf822a7187c238dda439701f3&format=plain
Query parameters
_accepted_id = c0a0b8edf822a7187c238dda439701f3
format = plain
Response
c0a0b8edf822a7187c238dda439701f3
method_id
0
0
0
0
2025-05-11 13:18:49
Optional parameters
parameter | description |
---|---|
_accepted_idID | ID returned by the accepted (202) API endpoint |
stop_taskBOOLEAN | 1 to stop the background task, _accepted_id is mandatory if stop_task is 1 |
Return values
parameter | description |
---|---|
_accepted_count | [OPTIONAL] completed subtasks (e.g., the number of imported tracking links) |
_accepted_dt | [OPTIONAL] starting date/time of the task |
_accepted_errors | [OPTIONAL] total number of subtasks not completed correctly (e.g., the number of tracking links for which the import has failed) |
_accepted_id | [OPTIONAL] ID of the task started by the accepted (202) API endpoint |
_accepted_key | [OPTIONAL] key that uniquely identifies the accepted (202) API endpoint that started the task |
_accepted_perc | [OPTIONAL] percentage of completition of the task |
_accepted_total | [OPTIONAL] total number of subtasks (e.g., the total number of tracking links to be imported) |
data | [OPTIONAL] data returned at the end of the task from the accepted (202) API endpoint |
stopped | [OPTIONAL] 1 if the task has been stopped, 0 otherwise, returned only if stop_task is 1 |
/apis/has_access
access: [READ]
User permissions can remove access to this version of the API. This method returns 1 only if the user has access to this version of the API.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/has_access
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"has_access": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/has_access?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<has_access>0</has_access>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/has_access?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_has_access=0
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/has_access?format=plain
Query parameters
format = plain
Response
0
Return values
parameter | description |
---|---|
has_access | 1 if the user has access to this API version, 0 otherwise |
/apis/keys
access: [WRITE]
This method returns the API keys associated to the logged in user.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/keys
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"public": "a93456c93eea5870c0a86f1466a68320",
"private": "c13a11aaf3b1a4f8f954d0ddf7a7daa2"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/keys?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<public>a93456c93eea5870c0a86f1466a68320</public>
<private>c13a11aaf3b1a4f8f954d0ddf7a7daa2</private>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/keys?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_public=a93456c93eea5870c0a86f1466a68320
result_private=c13a11aaf3b1a4f8f954d0ddf7a7daa2
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/keys?format=plain
Query parameters
format = plain
Response
a93456c93eea5870c0a86f1466a68320
c13a11aaf3b1a4f8f954d0ddf7a7daa2
Example 5 (json)
Request
https://joturl.com/a/i1/apis/keys?password=d9go9mob1p&reset=1
Query parameters
password = d9go9mob1p
reset = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"public": "4c4c3f853436412e730e713a7d8df040",
"private": "652c8f2455e228c1cbff22ce623220a0"
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/apis/keys?password=d9go9mob1p&reset=1&format=xml
Query parameters
password = d9go9mob1p
reset = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<public>4c4c3f853436412e730e713a7d8df040</public>
<private>652c8f2455e228c1cbff22ce623220a0</private>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/apis/keys?password=d9go9mob1p&reset=1&format=txt
Query parameters
password = d9go9mob1p
reset = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_public=4c4c3f853436412e730e713a7d8df040
result_private=652c8f2455e228c1cbff22ce623220a0
Example 8 (plain)
Request
https://joturl.com/a/i1/apis/keys?password=d9go9mob1p&reset=1&format=plain
Query parameters
password = d9go9mob1p
reset = 1
format = plain
Response
4c4c3f853436412e730e713a7d8df040
652c8f2455e228c1cbff22ce623220a0
Optional parameters
parameter | description |
---|---|
passwordSTRING | current account password, to be sent if reset = 1 |
resetBOOLEAN | 1 to reset API keys, if this parameter is 1 the POST method is required (because the password is sent) |
Return values
parameter | description |
---|---|
private | the user private API key |
public | the user public API key |
/apis/lab
/apis/lab/add
access: [WRITE]
This method adds a new LAB script.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B
Query parameters
name = test script
script = LogManager.log('script');
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "test script",
"script": "LogManager.log('script');",
"id": "de658d0dbc7fc81c3c24a18200de3f6c",
"creation": "2025-05-11 13:18:49"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=xml
Query parameters
name = test script
script = LogManager.log('script');
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>test script</name>
<script>LogManager.log('script');</script>
<id>de658d0dbc7fc81c3c24a18200de3f6c</id>
<creation>2025-05-11 13:18:49</creation>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=txt
Query parameters
name = test script
script = LogManager.log('script');
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=test script
result_script=LogManager.log('script');
result_id=de658d0dbc7fc81c3c24a18200de3f6c
result_creation=2025-05-11 13:18:49
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/add?name=test+script&script=LogManager.log%28%27script%27%29%3B&format=plain
Query parameters
name = test script
script = LogManager.log('script');
format = plain
Response
test script
LogManager.log('script');
de658d0dbc7fc81c3c24a18200de3f6c
2025-05-11 13:18:49
Required parameters
parameter | description |
---|---|
nameSTRING | LAB script name |
scriptHTML | LAB script content |
Return values
parameter | description |
---|---|
creation | creation date/time of the LAB script |
id | ID of the LAB script |
name | LAB script name (max length: 100000 bytes) |
/apis/lab/count
access: [READ]
This method returns the number of LAB scripts.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/count?search=a
Query parameters
search = a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/count?search=a&format=xml
Query parameters
search = a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/count?search=a&format=txt
Query parameters
search = a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/count?search=a&format=plain
Query parameters
search = a
format = plain
Response
2
Example 5 (json)
Request
https://joturl.com/a/i1/apis/lab/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 55
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/apis/lab/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>55</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/apis/lab/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=55
Example 8 (plain)
Request
https://joturl.com/a/i1/apis/lab/count?format=plain
Query parameters
format = plain
Response
55
Optional parameters
parameter | description |
---|---|
searchSTRING | filter LAB scripts by searching them |
Return values
parameter | description |
---|---|
count | total number of LAB scripts, filtered by search: if passed |
/apis/lab/delete
access: [WRITE]
This method deletes LAB scripts by using the parameter ids.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
Query parameters
ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=xml
Query parameters
ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>2</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=txt
Query parameters
ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=2
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f&format=plain
Query parameters
ids = 7f6ffaa6bb0b408017b62254211691b5,bff030594cd09ce531297feac0327b3f
format = plain
Response
2
Example 5 (json)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
Query parameters
ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=xml
Query parameters
ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=txt
Query parameters
ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/apis/lab/delete?ids=6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df&format=plain
Query parameters
ids = 6abcc8f24321d1eb8c95855eab78ee95,18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
format = plain
Response
18aaf4672792c237acf34af9f8fe3ee3,df906bde6d2bb9848a5f23b35c3cf7df
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of LAB script IDs to be deleted, max number of IDs in the list: 100 |
Return values
parameter | description |
---|---|
deleted | number of deleted scripts |
/apis/lab/edit
access: [WRITE]
This method edits a LAB script.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/edit?id=1a1d19952388d8c7c76c702f11601053&name=test+script
Query parameters
id = 1a1d19952388d8c7c76c702f11601053
name = test script
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1a1d19952388d8c7c76c702f11601053",
"name": "test script",
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/edit?id=1a1d19952388d8c7c76c702f11601053&name=test+script&format=xml
Query parameters
id = 1a1d19952388d8c7c76c702f11601053
name = test script
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1a1d19952388d8c7c76c702f11601053</id>
<name>test script</name>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/edit?id=1a1d19952388d8c7c76c702f11601053&name=test+script&format=txt
Query parameters
id = 1a1d19952388d8c7c76c702f11601053
name = test script
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1a1d19952388d8c7c76c702f11601053
result_name=test script
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/edit?id=1a1d19952388d8c7c76c702f11601053&name=test+script&format=plain
Query parameters
id = 1a1d19952388d8c7c76c702f11601053
name = test script
format = plain
Response
1a1d19952388d8c7c76c702f11601053
test script
1
Required parameters
parameter | description |
---|---|
idID | ID of the LAB script to edit |
Optional parameters
parameter | description |
---|---|
nameSTRING | LAB script name |
scriptHTML | content of the LAB script |
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/apis/lab/info
access: [READ]
This method returns info about a LAB script.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"id": "b84e2f688b4c8f47e02b658a28c84605",
"name": "script name 0",
"creation": "2025-05-11 13:37:10",
"script": "LogManager.log('script 0');"
},
{
"id": "a2c6a500c4884f841f038c50a423b5e0",
"name": "script name 1",
"creation": "2025-05-11 14:09:00",
"script": "LogManager.log('script 1');"
},
{
"id": "c7abac2e1580bd763cd1e63750dbc7f6",
"name": "script name 2",
"creation": "2025-05-11 16:00:16",
"script": "LogManager.log('script 2');"
},
{
"id": "f0be27a73b95eff7ed856f20cc18c040",
"name": "script name 3",
"creation": "2025-05-11 17:59:34",
"script": "LogManager.log('script 3');"
},
{
"id": "d98e5ea51c68cf5296e7638f1a780960",
"name": "script name 4",
"creation": "2025-05-11 19:16:14",
"script": "LogManager.log('script 4');"
}
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<id>b84e2f688b4c8f47e02b658a28c84605</id>
<name>script name 0</name>
<creation>2025-05-11 13:37:10</creation>
<script>LogManager.log('script 0');</script>
</i0>
<i1>
<id>a2c6a500c4884f841f038c50a423b5e0</id>
<name>script name 1</name>
<creation>2025-05-11 14:09:00</creation>
<script>LogManager.log('script 1');</script>
</i1>
<i2>
<id>c7abac2e1580bd763cd1e63750dbc7f6</id>
<name>script name 2</name>
<creation>2025-05-11 16:00:16</creation>
<script>LogManager.log('script 2');</script>
</i2>
<i3>
<id>f0be27a73b95eff7ed856f20cc18c040</id>
<name>script name 3</name>
<creation>2025-05-11 17:59:34</creation>
<script>LogManager.log('script 3');</script>
</i3>
<i4>
<id>d98e5ea51c68cf5296e7638f1a780960</id>
<name>script name 4</name>
<creation>2025-05-11 19:16:14</creation>
<script>LogManager.log('script 4');</script>
</i4>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=b84e2f688b4c8f47e02b658a28c84605
result_0_name=script name 0
result_0_creation=2025-05-11 13:37:10
result_0_script=LogManager.log('script 0');
result_1_id=a2c6a500c4884f841f038c50a423b5e0
result_1_name=script name 1
result_1_creation=2025-05-11 14:09:00
result_1_script=LogManager.log('script 1');
result_2_id=c7abac2e1580bd763cd1e63750dbc7f6
result_2_name=script name 2
result_2_creation=2025-05-11 16:00:16
result_2_script=LogManager.log('script 2');
result_3_id=f0be27a73b95eff7ed856f20cc18c040
result_3_name=script name 3
result_3_creation=2025-05-11 17:59:34
result_3_script=LogManager.log('script 3');
result_4_id=d98e5ea51c68cf5296e7638f1a780960
result_4_name=script name 4
result_4_creation=2025-05-11 19:16:14
result_4_script=LogManager.log('script 4');
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/info?format=plain
Query parameters
format = plain
Response
b84e2f688b4c8f47e02b658a28c84605
script name 0
2025-05-11 13:37:10
LogManager.log('script 0');
a2c6a500c4884f841f038c50a423b5e0
script name 1
2025-05-11 14:09:00
LogManager.log('script 1');
c7abac2e1580bd763cd1e63750dbc7f6
script name 2
2025-05-11 16:00:16
LogManager.log('script 2');
f0be27a73b95eff7ed856f20cc18c040
script name 3
2025-05-11 17:59:34
LogManager.log('script 3');
d98e5ea51c68cf5296e7638f1a780960
script name 4
2025-05-11 19:16:14
LogManager.log('script 4');
Required parameters
parameter | description |
---|---|
idID | ID of the LAB script |
Return values
parameter | description |
---|---|
creation | creation date/time of the LAB script |
id | ID of the LAB script |
name | name of the LAB script |
script | content of the LAB script |
/apis/lab/list
access: [READ]
This method returns a list of available custom scripts for the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/lab/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"id": "eae81749038aed20de960162ecba004a",
"name": "script name 0",
"creation": "2025-05-11 14:14:13"
},
{
"id": "f3892d1ae1e34a4fae72cbf7298a0349",
"name": "script name 1",
"creation": "2025-05-11 14:25:42"
},
{
"id": "d13e23d92462412cd44a0431a15dfcaf",
"name": "script name 2",
"creation": "2025-05-11 15:21:42"
},
{
"id": "61aff2d2dc2c3183f16eb8e8c3f78312",
"name": "script name 3",
"creation": "2025-05-11 16:32:48"
},
{
"id": "ca881cdef4143ac2a50938f241661d16",
"name": "script name 4",
"creation": "2025-05-11 19:03:32"
}
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/lab/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<id>eae81749038aed20de960162ecba004a</id>
<name>script name 0</name>
<creation>2025-05-11 14:14:13</creation>
</i0>
<i1>
<id>f3892d1ae1e34a4fae72cbf7298a0349</id>
<name>script name 1</name>
<creation>2025-05-11 14:25:42</creation>
</i1>
<i2>
<id>d13e23d92462412cd44a0431a15dfcaf</id>
<name>script name 2</name>
<creation>2025-05-11 15:21:42</creation>
</i2>
<i3>
<id>61aff2d2dc2c3183f16eb8e8c3f78312</id>
<name>script name 3</name>
<creation>2025-05-11 16:32:48</creation>
</i3>
<i4>
<id>ca881cdef4143ac2a50938f241661d16</id>
<name>script name 4</name>
<creation>2025-05-11 19:03:32</creation>
</i4>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/lab/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=eae81749038aed20de960162ecba004a
result_0_name=script name 0
result_0_creation=2025-05-11 14:14:13
result_1_id=f3892d1ae1e34a4fae72cbf7298a0349
result_1_name=script name 1
result_1_creation=2025-05-11 14:25:42
result_2_id=d13e23d92462412cd44a0431a15dfcaf
result_2_name=script name 2
result_2_creation=2025-05-11 15:21:42
result_3_id=61aff2d2dc2c3183f16eb8e8c3f78312
result_3_name=script name 3
result_3_creation=2025-05-11 16:32:48
result_4_id=ca881cdef4143ac2a50938f241661d16
result_4_name=script name 4
result_4_creation=2025-05-11 19:03:32
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/lab/list?format=plain
Query parameters
format = plain
Response
eae81749038aed20de960162ecba004a
script name 0
2025-05-11 14:14:13
f3892d1ae1e34a4fae72cbf7298a0349
script name 1
2025-05-11 14:25:42
d13e23d92462412cd44a0431a15dfcaf
script name 2
2025-05-11 15:21:42
61aff2d2dc2c3183f16eb8e8c3f78312
script name 3
2025-05-11 16:32:48
ca881cdef4143ac2a50938f241661d16
script name 4
2025-05-11 19:03:32
Optional parameters
parameter | description |
---|---|
searchSTRING | filters items to be extracted by searching them |
Return values
parameter | description |
---|---|
count | total number of LAB scripts |
data | list of available/filtered LAB scripts for the current user |
/apis/limits
access: [READ]
This method returns the API limits for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/limits
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"primary": {
"limit": 500,
"unit": "HOUR"
},
"secondary": {
"limit": 50000,
"unit": "DAY"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/limits?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<primary>
<limit>500</limit>
<unit>HOUR</unit>
</primary>
<secondary>
<limit>50000</limit>
<unit>DAY</unit>
</secondary>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/limits?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_primary_limit=500
result_primary_unit=HOUR
result_secondary_limit=50000
result_secondary_unit=DAY
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/limits?format=plain
Query parameters
format = plain
Response
500
HOUR
50000
DAY
Return values
parameter | description |
---|---|
primary | object containing the primary rate limit: an integer limit and the unit in which the limit is expressed. unit is one of the following [MINUTE,HOUR,DAY,3_DAY]. 3_DAY is equivalent to 3 days |
secondary | object containing the secondary rate limit: an integer limit and the unit in which the limit is expressed. unit is one of the following [MINUTE,HOUR,DAY,3_DAY]. 3_DAY is equivalent to 3 days |
/apis/list
access: [READ]
This method returns the list of available versions of the API.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"id": "v1",
"name": "Version v1"
},
{
"id": "i1",
"name": "Version i1"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<id>v1</id>
<name>Version v1</name>
</i0>
<i1>
<id>i1</id>
<name>Version i1</name>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=v1
result_data_0_name=Version v1
result_data_1_id=i1
result_data_1_name=Version i1
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/list?format=plain
Query parameters
format = plain
Response
2
v1
Version v1
i1
Version i1
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of versions |
data | array containing required information on API versions the user has access to |
/apis/tokens
access: [WRITE]
This method returns the API tokens associated to the logged in user.
Example 1 (json)
Request
https://joturl.com/a/i1/apis/tokens
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"read_write_token": "tok_RWe35a837d1e3194fff8f749ae36c146f4",
"read_only_token": "tok_RO7953a11dfea4c27cbf6bdf448899b15c"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/apis/tokens?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<read_write_token>tok_RWe35a837d1e3194fff8f749ae36c146f4</read_write_token>
<read_only_token>tok_RO7953a11dfea4c27cbf6bdf448899b15c</read_only_token>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/apis/tokens?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_read_write_token=tok_RWe35a837d1e3194fff8f749ae36c146f4
result_read_only_token=tok_RO7953a11dfea4c27cbf6bdf448899b15c
Example 4 (plain)
Request
https://joturl.com/a/i1/apis/tokens?format=plain
Query parameters
format = plain
Response
tok_RWe35a837d1e3194fff8f749ae36c146f4
tok_RO7953a11dfea4c27cbf6bdf448899b15c
Example 5 (json)
Request
https://joturl.com/a/i1/apis/tokens?password=d35db6e1gc&reset=1
Query parameters
password = d35db6e1gc
reset = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"read_write_token": "tok_RW17e950b7929dcab961513c2296c3d332",
"read_only_token": "tok_RO0e530145a258d5cba1aa54110ae41827"
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/apis/tokens?password=d35db6e1gc&reset=1&format=xml
Query parameters
password = d35db6e1gc
reset = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<read_write_token>tok_RW17e950b7929dcab961513c2296c3d332</read_write_token>
<read_only_token>tok_RO0e530145a258d5cba1aa54110ae41827</read_only_token>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/apis/tokens?password=d35db6e1gc&reset=1&format=txt
Query parameters
password = d35db6e1gc
reset = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_read_write_token=tok_RW17e950b7929dcab961513c2296c3d332
result_read_only_token=tok_RO0e530145a258d5cba1aa54110ae41827
Example 8 (plain)
Request
https://joturl.com/a/i1/apis/tokens?password=d35db6e1gc&reset=1&format=plain
Query parameters
password = d35db6e1gc
reset = 1
format = plain
Response
tok_RW17e950b7929dcab961513c2296c3d332
tok_RO0e530145a258d5cba1aa54110ae41827
Optional parameters
parameter | description |
---|---|
passwordSTRING | current account password, to be sent if reset = 1 |
resetBOOLEAN | 1 to reset the API tokens, if this parameter is 1 the POST method is required (because the password is sent) |
Return values
parameter | description |
---|---|
read_only_token | the read-only API access token |
read_write_token | the read/write API access token |
/cdns
/cdns/add
access: [WRITE]
This method allows to upload a resource to the CDN.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D
Query parameters
type = image
info = {"name":"this is my resource"}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "5ae141172fb2a9354e284ed9b8e6df1f",
"name": "this is my resource",
"creation": "2025-05-11 13:18:49",
"url": "https:\/\/cdn.endpoint\/path\/to\/resource",
"width": 533,
"height": 400,
"size": 20903,
"mime_type": "image\/png"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=xml
Query parameters
type = image
info = {"name":"this is my resource"}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>5ae141172fb2a9354e284ed9b8e6df1f</id>
<name>this is my resource</name>
<creation>2025-05-11 13:18:49</creation>
<url>https://cdn.endpoint/path/to/resource</url>
<width>533</width>
<height>400</height>
<size>20903</size>
<mime_type>image/png</mime_type>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=txt
Query parameters
type = image
info = {"name":"this is my resource"}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=5ae141172fb2a9354e284ed9b8e6df1f
result_name=this is my resource
result_creation=2025-05-11 13:18:49
result_url=https://cdn.endpoint/path/to/resource
result_width=533
result_height=400
result_size=20903
result_mime_type=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/add?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&format=plain
Query parameters
type = image
info = {"name":"this is my resource"}
format = plain
Response
5ae141172fb2a9354e284ed9b8e6df1f
this is my resource
2025-05-11 13:18:49
https://cdn.endpoint/path/to/resource
533
400
20903
image/png
Required parameters
parameter | description |
---|---|
typeSTRING | CDN type, see i1/cdns/property for details |
Optional parameters
parameter | description | max length |
---|---|---|
external_urlURL | URL to an external resource (not managed by the CDN), this URL must be with HTTPS | 4000 |
infoJSON | JSON containing additional info on the resource | |
inputSTRING | name of the HTML form field that contains data for the resource, if not passed the default value input will be used (i.e., input = input ) |
NOTES: The parameter input contains the name of the field of the HTML form that is used to send resource data to this method. Form must have
enctype = "multipart/form-data"
andmethod = "post"
.
<form
action="/a/i1/cdns/add"
method="post"
enctype="multipart/form-data">
<input name="input" value="resource_field" type="hidden"/>
[other form fields]
<input name="resource_field" type="file"/>
</form>
Return values
parameter | description |
---|---|
creation | date/time when the CDN resource was created |
height | height in pixels of the CDN resource, if available |
id | ID of the CDN resource |
mime_type | MIME type of the resource, or 'external_url' for external URLs |
name | name of the CDN resource |
size | size in bytes of the CDN resource, if available |
url | URL of the CDN resource |
width | width in pixels of the CDN resource, if available |
/cdns/count
access: [READ]
This method returns the number of resources on the CDN.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/count?format=plain
Query parameters
format = plain
Response
4
Required parameters
parameter | description |
---|---|
typeSTRING | CDN resource type, for available types see i1/cdns/list |
Optional parameters
parameter | description |
---|---|
filtersJSON | filters to be used to count media, for available filters see i1/cdns/list |
searchSTRING | filters CDN resources to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) CDN resources |
/cdns/delete
access: [WRITE]
This method deletes a resource from the CDN.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/delete?id=4015afa347ea7796ac8f7c61d81e9f98
Query parameters
id = 4015afa347ea7796ac8f7c61d81e9f98
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "4015afa347ea7796ac8f7c61d81e9f98",
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/delete?id=4015afa347ea7796ac8f7c61d81e9f98&format=xml
Query parameters
id = 4015afa347ea7796ac8f7c61d81e9f98
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>4015afa347ea7796ac8f7c61d81e9f98</id>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/delete?id=4015afa347ea7796ac8f7c61d81e9f98&format=txt
Query parameters
id = 4015afa347ea7796ac8f7c61d81e9f98
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=4015afa347ea7796ac8f7c61d81e9f98
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/delete?id=4015afa347ea7796ac8f7c61d81e9f98&format=plain
Query parameters
id = 4015afa347ea7796ac8f7c61d81e9f98
format = plain
Response
4015afa347ea7796ac8f7c61d81e9f98
1
Required parameters
parameter | description |
---|---|
idID | ID of the CDN resource to delete |
Optional parameters
parameter | description |
---|---|
confirmBOOLEAN | If 1 this method deletes the CDN resource even if it is linked to a tracking link |
Return values
parameter | description |
---|---|
deleted | 1 if successful, otherwise a generic error message is issued |
id | echo back of the id input parameter |
/cdns/edit
access: [WRITE]
This method allows to modify a CDN resource.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=a13d296eb4179ba81ebc07484fba1488
Query parameters
type = image
info = {"name":"this is my resource"}
id = a13d296eb4179ba81ebc07484fba1488
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "a13d296eb4179ba81ebc07484fba1488",
"name": "this is my resource",
"creation": "2025-05-11 13:18:49",
"url": "https:\/\/cdn.endpoint\/path\/to\/resource",
"width": 533,
"height": 400,
"size": 20903,
"mime_type": "image\/png"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=a13d296eb4179ba81ebc07484fba1488&format=xml
Query parameters
type = image
info = {"name":"this is my resource"}
id = a13d296eb4179ba81ebc07484fba1488
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>a13d296eb4179ba81ebc07484fba1488</id>
<name>this is my resource</name>
<creation>2025-05-11 13:18:49</creation>
<url>https://cdn.endpoint/path/to/resource</url>
<width>533</width>
<height>400</height>
<size>20903</size>
<mime_type>image/png</mime_type>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=a13d296eb4179ba81ebc07484fba1488&format=txt
Query parameters
type = image
info = {"name":"this is my resource"}
id = a13d296eb4179ba81ebc07484fba1488
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=a13d296eb4179ba81ebc07484fba1488
result_name=this is my resource
result_creation=2025-05-11 13:18:49
result_url=https://cdn.endpoint/path/to/resource
result_width=533
result_height=400
result_size=20903
result_mime_type=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/edit?type=image&info=%7B%22name%22%3A%22this+is+my+resource%22%7D&id=a13d296eb4179ba81ebc07484fba1488&format=plain
Query parameters
type = image
info = {"name":"this is my resource"}
id = a13d296eb4179ba81ebc07484fba1488
format = plain
Response
a13d296eb4179ba81ebc07484fba1488
this is my resource
2025-05-11 13:18:49
https://cdn.endpoint/path/to/resource
533
400
20903
image/png
Required parameters
parameter | description |
---|---|
idID | ID of the CDN resource |
typeSTRING | CDN type, see i1/cdns/property for details |
Optional parameters
parameter | description | max length |
---|---|---|
external_urlURL | URL to an external resource (not managed by the CDN), this URL must be with HTTPS | 4000 |
infoJSON | JSON containing additional info on the resource | |
inputSTRING | name of the HTML form field that contains data for the resource, if not passed the default value input will be used (i.e., input = input ) |
NOTES: The parameter input contains the name of the field of the HTML form that is used to send resource data to this method. Form must have
enctype = "multipart/form-data"
andmethod = "post"
.
<form
action="/a/i1/cdns/edit"
method="post"
enctype="multipart/form-data">
<input name="input" value="resource_field" type="hidden"/>
[other form fields]
<input name="resource_field" type="file"/>
</form>
Return values
parameter | description |
---|---|
creation | date/time when the CDN resource was created |
height | height in pixels of the CDN resource, if available |
id | ID of the CDN resource |
mime_type | MIME type of the resource, or 'external_url' for external URLs |
name | name of the CDN resource |
size | size in bytes of the CDN resource, if available |
url | URL of the CDN resource |
width | width in pixels of the CDN resource, if available |
/cdns/info
access: [READ]
This method returns information about a resource on the CDN.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/info?id=f4e573f6ead6d1c5518dd9e0e579a25a
Query parameters
id = f4e573f6ead6d1c5518dd9e0e579a25a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"id": "f4e573f6ead6d1c5518dd9e0e579a25a",
"name": "this is my resource",
"creation": "2019-06-25 13:01:23",
"url": "https:\/\/cdn.endpoint\/path\/to\/resource",
"width": 533,
"height": 400,
"size": 20903,
"mime_type": "image\/png"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/info?id=f4e573f6ead6d1c5518dd9e0e579a25a&format=xml
Query parameters
id = f4e573f6ead6d1c5518dd9e0e579a25a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<id>f4e573f6ead6d1c5518dd9e0e579a25a</id>
<name>this is my resource</name>
<creation>2019-06-25 13:01:23</creation>
<url>https://cdn.endpoint/path/to/resource</url>
<width>533</width>
<height>400</height>
<size>20903</size>
<mime_type>image/png</mime_type>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/info?id=f4e573f6ead6d1c5518dd9e0e579a25a&format=txt
Query parameters
id = f4e573f6ead6d1c5518dd9e0e579a25a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=f4e573f6ead6d1c5518dd9e0e579a25a
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/info?id=f4e573f6ead6d1c5518dd9e0e579a25a&format=plain
Query parameters
id = f4e573f6ead6d1c5518dd9e0e579a25a
format = plain
Response
f4e573f6ead6d1c5518dd9e0e579a25a
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png
Required parameters
parameter | description |
---|---|
idID | ID of the CDN resource |
Return values
parameter | description |
---|---|
data | array containing required information on CDN resources |
/cdns/links
/cdns/links/add
access: [WRITE]
This method allows to add an association between a CDN resource and a key and/or a tracking link. This method allows multiple instances for the combination (CDN resource,key).
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=2d2dc5268ae83b66ef430e7d06a1f573&value=%7B%22position%22%3A%22top_left%22%7D
Query parameters
key = my_custom_config_key
cdn_id = 2d2dc5268ae83b66ef430e7d06a1f573
value = {"position":"top_left"}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=2d2dc5268ae83b66ef430e7d06a1f573&value=%7B%22position%22%3A%22top_left%22%7D&format=xml
Query parameters
key = my_custom_config_key
cdn_id = 2d2dc5268ae83b66ef430e7d06a1f573
value = {"position":"top_left"}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=2d2dc5268ae83b66ef430e7d06a1f573&value=%7B%22position%22%3A%22top_left%22%7D&format=txt
Query parameters
key = my_custom_config_key
cdn_id = 2d2dc5268ae83b66ef430e7d06a1f573
value = {"position":"top_left"}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/links/add?key=my_custom_config_key&cdn_id=2d2dc5268ae83b66ef430e7d06a1f573&value=%7B%22position%22%3A%22top_left%22%7D&format=plain
Query parameters
key = my_custom_config_key
cdn_id = 2d2dc5268ae83b66ef430e7d06a1f573
value = {"position":"top_left"}
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
cdn_idID | ID of the CDN resource | |
keySTRING | key that identifies the CDN resource/tracking link association, available values: reports_config , instaurl , instaurl_bg , instaurl_images , preview_image | 50 |
Optional parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
valueJSON | value for the association, it must be a stringified JSON |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/cdns/links/delete
access: [WRITE]
This method deletes all the associations between a CDN resource and a key and/or a tracking link. If the resource ID is not passed, it deletes all associations by using the key.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=7eb1a2a4bfe4611ee747a64428846070
Query parameters
key = my_custom_config_key
cdn_id = 7eb1a2a4bfe4611ee747a64428846070
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 7
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=7eb1a2a4bfe4611ee747a64428846070&format=xml
Query parameters
key = my_custom_config_key
cdn_id = 7eb1a2a4bfe4611ee747a64428846070
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>7</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=7eb1a2a4bfe4611ee747a64428846070&format=txt
Query parameters
key = my_custom_config_key
cdn_id = 7eb1a2a4bfe4611ee747a64428846070
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=7
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/links/delete?key=my_custom_config_key&cdn_id=7eb1a2a4bfe4611ee747a64428846070&format=plain
Query parameters
key = my_custom_config_key
cdn_id = 7eb1a2a4bfe4611ee747a64428846070
format = plain
Response
7
Required parameters
parameter | description | max length |
---|---|---|
keySTRING | key that identifies the CDN resource/tracking link association, available values: reports_config , instaurl , instaurl_bg , instaurl_images , preview_image | 50 |
Optional parameters
parameter | description |
---|---|
cdn_idID | if passed, only the associations with the CDN resource identified by this ID will be deleted |
url_idID | if passed, only the associations with the tracking link identified by this ID will be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted associations |
/cdns/links/get
access: [READ]
This method returns all the associations between a CDN resource and a key and/or a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=fc934217c7e5c1a5296fbd4693f072a2
Query parameters
key = my_custom_config_key
cdn_id = fc934217c7e5c1a5296fbd4693f072a2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"id": "f8f5468a24d7c406de41bcf8ca60226c",
"key": "my_custom_config_key",
"value": {
"position": "top_left"
},
"cdn_id": "fc934217c7e5c1a5296fbd4693f072a2",
"url_id": "f554f14f27c40dd80a7089b391f26beb",
"name": "this is my resource",
"creation": "2019-06-25 13:01:23",
"url": "https:\/\/cdn.endpoint\/path\/to\/resource",
"width": 533,
"height": 400,
"size": 20903,
"mime_type": "image\/png"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=fc934217c7e5c1a5296fbd4693f072a2&format=xml
Query parameters
key = my_custom_config_key
cdn_id = fc934217c7e5c1a5296fbd4693f072a2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<id>f8f5468a24d7c406de41bcf8ca60226c</id>
<key>my_custom_config_key</key>
<value>
<position>top_left</position>
</value>
<cdn_id>fc934217c7e5c1a5296fbd4693f072a2</cdn_id>
<url_id>f554f14f27c40dd80a7089b391f26beb</url_id>
<name>this is my resource</name>
<creation>2019-06-25 13:01:23</creation>
<url>https://cdn.endpoint/path/to/resource</url>
<width>533</width>
<height>400</height>
<size>20903</size>
<mime_type>image/png</mime_type>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=fc934217c7e5c1a5296fbd4693f072a2&format=txt
Query parameters
key = my_custom_config_key
cdn_id = fc934217c7e5c1a5296fbd4693f072a2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=f8f5468a24d7c406de41bcf8ca60226c
result_data_key=my_custom_config_key
result_data_value_position=top_left
result_data_cdn_id=fc934217c7e5c1a5296fbd4693f072a2
result_data_url_id=f554f14f27c40dd80a7089b391f26beb
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/links/get?key=my_custom_config_key&cdn_id=fc934217c7e5c1a5296fbd4693f072a2&format=plain
Query parameters
key = my_custom_config_key
cdn_id = fc934217c7e5c1a5296fbd4693f072a2
format = plain
Response
f8f5468a24d7c406de41bcf8ca60226c
my_custom_config_key
top_left
fc934217c7e5c1a5296fbd4693f072a2
f554f14f27c40dd80a7089b391f26beb
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png
Required parameters
parameter | description | max length |
---|---|---|
keySTRING | key that identifies the CDN resource/tracking link association, available values: reports_config , instaurl , instaurl_bg , instaurl_images , preview_image | 50 |
Optional parameters
parameter | description |
---|---|
cdn_idID | if passed, only the associations with the CDN resource identified by this ID will be returned |
url_idID | if passed, only the associations with the tracking link identified by this ID will be returned |
Return values
parameter | description |
---|---|
data | array containing information on the association and the linked CDN resource |
/cdns/links/set
access: [WRITE]
This method allows to set the association between a CDN resource and a key and/or a tracking link. This method allows only one instance for the combination (CDN resource,key).
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=dc4b03ce413b9a51a1358b5bff91a1a6&value=%7B%22position%22%3A%22top_left%22%7D
Query parameters
key = my_custom_config_key
cdn_id = dc4b03ce413b9a51a1358b5bff91a1a6
value = {"position":"top_left"}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"set": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=dc4b03ce413b9a51a1358b5bff91a1a6&value=%7B%22position%22%3A%22top_left%22%7D&format=xml
Query parameters
key = my_custom_config_key
cdn_id = dc4b03ce413b9a51a1358b5bff91a1a6
value = {"position":"top_left"}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<set>1</set>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=dc4b03ce413b9a51a1358b5bff91a1a6&value=%7B%22position%22%3A%22top_left%22%7D&format=txt
Query parameters
key = my_custom_config_key
cdn_id = dc4b03ce413b9a51a1358b5bff91a1a6
value = {"position":"top_left"}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_set=1
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/links/set?key=my_custom_config_key&cdn_id=dc4b03ce413b9a51a1358b5bff91a1a6&value=%7B%22position%22%3A%22top_left%22%7D&format=plain
Query parameters
key = my_custom_config_key
cdn_id = dc4b03ce413b9a51a1358b5bff91a1a6
value = {"position":"top_left"}
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
cdn_idID | ID of the CDN resource | |
keySTRING | key that identifies the CDN resource/tracking link association, available values: reports_config , instaurl , instaurl_bg , instaurl_images , preview_image | 50 |
Optional parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
valueJSON | value for the association, it must be a stringified JSON |
Return values
parameter | description |
---|---|
set | 1 on success, 0 otherwise |
/cdns/list
access: [READ]
This method returns a list of resource on the CDN linked with the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/list?type=image
Query parameters
type = image
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": {
"id": "1234567890abcdef",
"name": "this is my resource",
"creation": "2019-06-25 13:01:23",
"url": "https:\/\/cdn.endpoint\/path\/to\/resource",
"width": 533,
"height": 400,
"size": 20903,
"mime_type": "image\/png"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/list?type=image&format=xml
Query parameters
type = image
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<id>1234567890abcdef</id>
<name>this is my resource</name>
<creation>2019-06-25 13:01:23</creation>
<url>https://cdn.endpoint/path/to/resource</url>
<width>533</width>
<height>400</height>
<size>20903</size>
<mime_type>image/png</mime_type>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/list?type=image&format=txt
Query parameters
type = image
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=1234567890abcdef
result_data_name=this is my resource
result_data_creation=2019-06-25 13:01:23
result_data_url=https://cdn.endpoint/path/to/resource
result_data_width=533
result_data_height=400
result_data_size=20903
result_data_mime_type=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/list?type=image&format=plain
Query parameters
type = image
format = plain
Response
1
1234567890abcdef
this is my resource
2019-06-25 13:01:23
https://cdn.endpoint/path/to/resource
533
400
20903
image/png
Required parameters
parameter | description |
---|---|
typeSTRING | CDN type, see i1/cdns/property for details |
Optional parameters
parameter | description |
---|---|
filtersJSON | filters to be used extracing media |
lengthINTEGER | extracts this number of CDN resources (maxmimum allowed: 100) |
searchSTRING | filters CDN resources to be extracted by searching them |
startINTEGER | starts to extract CDN resources from this position |
Return values
parameter | description |
---|---|
count | total number of (filtered) CDN resources |
data | array containing required information on CDN resources |
/cdns/property
access: [READ]
This method return limits for uploading a resource on the CDN.
Example 1 (json)
Request
https://joturl.com/a/i1/cdns/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"image": {
"max_size": 5242880,
"allowed_types": [
"gif",
"jpg",
"png",
"svg",
"webp"
],
"allowed_mimes": [
"image\/gif",
"image\/jpeg",
"image\/jpg",
"image\/pjpeg",
"image\/x-png",
"image\/png",
"image\/svg+xml",
"application\/svg+xml",
"image\/webp"
]
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/cdns/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<image>
<max_size>5242880</max_size>
<allowed_types>
<i0>gif</i0>
<i1>jpg</i1>
<i2>png</i2>
<i3>svg</i3>
<i4>webp</i4>
</allowed_types>
<allowed_mimes>
<i0>image/gif</i0>
<i1>image/jpeg</i1>
<i2>image/jpg</i2>
<i3>image/pjpeg</i3>
<i4>image/x-png</i4>
<i5>image/png</i5>
<i6>image/svg+xml</i6>
<i7>application/svg+xml</i7>
<i8>image/webp</i8>
</allowed_mimes>
</image>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/cdns/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_image_max_size=5242880
result_image_allowed_types_0=gif
result_image_allowed_types_1=jpg
result_image_allowed_types_2=png
result_image_allowed_types_3=svg
result_image_allowed_types_4=webp
result_image_allowed_mimes_0=image/gif
result_image_allowed_mimes_1=image/jpeg
result_image_allowed_mimes_2=image/jpg
result_image_allowed_mimes_3=image/pjpeg
result_image_allowed_mimes_4=image/x-png
result_image_allowed_mimes_5=image/png
result_image_allowed_mimes_6=image/svg+xml
result_image_allowed_mimes_7=application/svg+xml
result_image_allowed_mimes_8=image/webp
Example 4 (plain)
Request
https://joturl.com/a/i1/cdns/property?format=plain
Query parameters
format = plain
Response
5242880
gif
jpg
png
svg
webp
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png
image/svg+xml
application/svg+xml
image/webp
Example 5 (json)
Request
https://joturl.com/a/i1/cdns/property?type=image
Query parameters
type = image
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"max_size": 5242880,
"allowed_types": [
"gif",
"jpg",
"png",
"svg",
"webp"
],
"allowed_mimes": [
"image\/gif",
"image\/jpeg",
"image\/jpg",
"image\/pjpeg",
"image\/x-png",
"image\/png",
"image\/svg+xml",
"application\/svg+xml",
"image\/webp"
]
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/cdns/property?type=image&format=xml
Query parameters
type = image
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<max_size>5242880</max_size>
<allowed_types>
<i0>gif</i0>
<i1>jpg</i1>
<i2>png</i2>
<i3>svg</i3>
<i4>webp</i4>
</allowed_types>
<allowed_mimes>
<i0>image/gif</i0>
<i1>image/jpeg</i1>
<i2>image/jpg</i2>
<i3>image/pjpeg</i3>
<i4>image/x-png</i4>
<i5>image/png</i5>
<i6>image/svg+xml</i6>
<i7>application/svg+xml</i7>
<i8>image/webp</i8>
</allowed_mimes>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/cdns/property?type=image&format=txt
Query parameters
type = image
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_max_size=5242880
result_allowed_types_0=gif
result_allowed_types_1=jpg
result_allowed_types_2=png
result_allowed_types_3=svg
result_allowed_types_4=webp
result_allowed_mimes_0=image/gif
result_allowed_mimes_1=image/jpeg
result_allowed_mimes_2=image/jpg
result_allowed_mimes_3=image/pjpeg
result_allowed_mimes_4=image/x-png
result_allowed_mimes_5=image/png
result_allowed_mimes_6=image/svg+xml
result_allowed_mimes_7=application/svg+xml
result_allowed_mimes_8=image/webp
Example 8 (plain)
Request
https://joturl.com/a/i1/cdns/property?type=image&format=plain
Query parameters
type = image
format = plain
Response
5242880
gif
jpg
png
svg
webp
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png
image/svg+xml
application/svg+xml
image/webp
Optional parameters
parameter | description |
---|---|
typeSTRING | CDN resource type, available types: image |
Return values
parameter | description |
---|---|
[ARRAY] | it is an object (type,(max_size,allowed_types,allowed_mimes)), see parameters max_size, allowed_types, allowed_mimes for details |
allowed_mimes | array containing the allowed mimes for the resource |
allowed_types | array containing the allowed types for the resource |
max_size | it is the maximum size in bytes the resource can have |
/conversions
/conversions/affiliates
/conversions/affiliates/count
access: [READ]
This method returns the number of affiliates.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/affiliates/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 20
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/affiliates/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>20</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/affiliates/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=20
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/affiliates/count?format=plain
Query parameters
format = plain
Response
20
Optional parameters
parameter | description |
---|---|
idID | ID of the affiliate network |
Return values
parameter | description |
---|---|
count | number of affiliate networks |
/conversions/affiliates/list
access: [READ]
This method lists all affiliates network.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/affiliates/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"id": "644a4b356f74446f62613864764b3762725a343966673d3d",
"name": "Network name",
"actual_url_params": "id={:CLICK_ID:}",
"postback_url_params": "clickid={id}&comm={comm}",
"integration_link": ""
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/affiliates/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<id>644a4b356f74446f62613864764b3762725a343966673d3d</id>
<name>Network name</name>
<actual_url_params>id={:CLICK_ID:}</actual_url_params>
<postback_url_params><[CDATA[clickid={id}&amp;comm={comm}]]></postback_url_params>
<integration_link></integration_link>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/affiliates/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=644a4b356f74446f62613864764b3762725a343966673d3d
result_data_name=Network name
result_data_actual_url_params=id={:CLICK_ID:}
result_data_postback_url_params=clickid={id}&amp;comm={comm}
result_data_integration_link=
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/affiliates/list?format=plain
Query parameters
format = plain
Response
644a4b356f74446f62613864764b3762725a343966673d3d
Network name
id={:CLICK_ID:}
clickid={id}&amp;comm={comm}
Optional parameters
parameter | description |
---|---|
idID | ID of the affiliate network |
lengthINTEGER | number of items to return (default: 1000, max value: 1000) |
searchSTRING | filter items by searching them |
startINTEGER | index of the starting item to retrieve (default: 0) |
Return values
parameter | description |
---|---|
count | number of affiliate networks |
data | array containing affiliate networks |
/conversions/codes
/conversions/codes/add
access: [WRITE]
Create a conversion code for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code¬es=this+is+a+note+for+the+conversion+code
Query parameters
name = name of the new conversion code
notes = this is a note for the conversion code
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "name of the new conversion code",
"notes": "this is a note for the conversion code",
"id": "5f4cc7bf2fafc878959d70ee44b71999",
"enable_postback_url": 0,
"affiliate_network_id": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code¬es=this+is+a+note+for+the+conversion+code&format=xml
Query parameters
name = name of the new conversion code
notes = this is a note for the conversion code
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>name of the new conversion code</name>
<notes>this is a note for the conversion code</notes>
<id>5f4cc7bf2fafc878959d70ee44b71999</id>
<enable_postback_url>0</enable_postback_url>
<affiliate_network_id></affiliate_network_id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code¬es=this+is+a+note+for+the+conversion+code&format=txt
Query parameters
name = name of the new conversion code
notes = this is a note for the conversion code
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=name of the new conversion code
result_notes=this is a note for the conversion code
result_id=5f4cc7bf2fafc878959d70ee44b71999
result_enable_postback_url=0
result_affiliate_network_id=
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/add?name=name+of+the+new+conversion+code¬es=this+is+a+note+for+the+conversion+code&format=plain
Query parameters
name = name of the new conversion code
notes = this is a note for the conversion code
format = plain
Response
name of the new conversion code
this is a note for the conversion code
5f4cc7bf2fafc878959d70ee44b71999
0
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | conversion name | 100 |
Optional parameters
parameter | description | max length |
---|---|---|
affiliate_network_idID | ID of the linked affiliate network, see i1/conversions/affliates/list for details | |
enable_postback_urlBOOLEAN | 1 to enable postback URLs for the conversion | |
notesSTRING | notes for the conversion | 255 |
Return values
parameter | description |
---|---|
affiliate_network_id | echo back of the affiliate_network_id input parameter |
enable_postback_url | echo back of the enable_postback_url input parameter |
id | ID of the conversion code |
name | echo back of the name input parameter |
notes | echo back of the notes input parameter |
/conversions/codes/count
access: [READ]
This method returns the number of defined conversion codes.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4321
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4321</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4321
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/count?format=plain
Query parameters
format = plain
Response
4321
Example 5 (json)
Request
https://joturl.com/a/i1/conversions/codes/count?search=text+to+search
Query parameters
search = text to search
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1234
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=xml
Query parameters
search = text to search
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1234</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=txt
Query parameters
search = text to search
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1234
Example 8 (plain)
Request
https://joturl.com/a/i1/conversions/codes/count?search=text+to+search&format=plain
Query parameters
search = text to search
format = plain
Response
1234
Optional parameters
parameter | description |
---|---|
searchSTRING | filters conversion codes to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) conversion codes |
/conversions/codes/delete
access: [WRITE]
This method deletes a set of conversion codes using their IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe
Query parameters
ids = 7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe&format=xml
Query parameters
ids = 7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe&format=txt
Query parameters
ids = 7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe&format=plain
Query parameters
ids = 7ad6fda239e645017044ddb17c6a2841,6c8c6086bfd2e5aa40dc487073276f25,5c0f71e87bd5e17382506160b90b9ebe
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086
Query parameters
ids = 939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": [
"939a235347580327cdebd778837f622e"
],
"deleted": 2
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086&format=xml
Query parameters
ids = 939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>
<i0>939a235347580327cdebd778837f622e</i0>
</ids>
<deleted>2</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086&format=txt
Query parameters
ids = 939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=939a235347580327cdebd778837f622e
result_deleted=2
Example 8 (plain)
Request
https://joturl.com/a/i1/conversions/codes/delete?ids=939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086&format=plain
Query parameters
ids = 939a235347580327cdebd778837f622e,bb666e28052dd1fa07036f0f97c1b5be,5a0dc71e6af060f2d69ffadc9210e086
format = plain
Response
939a235347580327cdebd778837f622e
2
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of conversion code IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted conversion codes |
ids | [OPTIONAL] list of conversion code IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/conversions/codes/edit
access: [WRITE]
Edit fields of a conversion.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/edit?id=2c17377ad705ec452323c6726e685093¬es=new+notes+for+the+conversion+code
Query parameters
id = 2c17377ad705ec452323c6726e685093
notes = new notes for the conversion code
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "2c17377ad705ec452323c6726e685093",
"notes": "new notes for the conversion code"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/edit?id=2c17377ad705ec452323c6726e685093¬es=new+notes+for+the+conversion+code&format=xml
Query parameters
id = 2c17377ad705ec452323c6726e685093
notes = new notes for the conversion code
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>2c17377ad705ec452323c6726e685093</id>
<notes>new notes for the conversion code</notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/edit?id=2c17377ad705ec452323c6726e685093¬es=new+notes+for+the+conversion+code&format=txt
Query parameters
id = 2c17377ad705ec452323c6726e685093
notes = new notes for the conversion code
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=2c17377ad705ec452323c6726e685093
result_notes=new notes for the conversion code
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/edit?id=2c17377ad705ec452323c6726e685093¬es=new+notes+for+the+conversion+code&format=plain
Query parameters
id = 2c17377ad705ec452323c6726e685093
notes = new notes for the conversion code
format = plain
Response
2c17377ad705ec452323c6726e685093
new notes for the conversion code
Required parameters
parameter | description |
---|---|
idID | ID of the conversion code |
Optional parameters
parameter | description | max length |
---|---|---|
affiliate_network_idID | ID of the affiliate network linked to the conversion code, it is ignored if enable_postback_url = 0 | |
enable_postback_urlBOOLEAN | 1 to enabled postback URLs for the conversion code, 0 to disable it | |
nameSTRING | name of the conversion code | 100 |
notesSTRING | notes for the conversion code | 255 |
Return values
parameter | description |
---|---|
affiliate_network_id | [OPTIONAL] echo back of the affiliate_network_id input parameter |
enable_postback_url | [OPTIONAL] echo back of the enable_postback_url input parameter |
id | echo back of the id input parameter |
name | [OPTIONAL] echo back of the name input parameter |
notes | [OPTIONAL] echo back of the notes input parameter |
/conversions/codes/info
access: [READ]
This method returns information about conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/info?id=4314ba71d4191f7eec9ed50d92d8e1d2&fields=id,name,notes
Query parameters
id = 4314ba71d4191f7eec9ed50d92d8e1d2
fields = id,name,notes
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "4314ba71d4191f7eec9ed50d92d8e1d2",
"name": "name",
"notes": "notes"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/info?id=4314ba71d4191f7eec9ed50d92d8e1d2&fields=id,name,notes&format=xml
Query parameters
id = 4314ba71d4191f7eec9ed50d92d8e1d2
fields = id,name,notes
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>4314ba71d4191f7eec9ed50d92d8e1d2</id>
<name>name</name>
<notes>notes</notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/info?id=4314ba71d4191f7eec9ed50d92d8e1d2&fields=id,name,notes&format=txt
Query parameters
id = 4314ba71d4191f7eec9ed50d92d8e1d2
fields = id,name,notes
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=4314ba71d4191f7eec9ed50d92d8e1d2
result_name=name
result_notes=notes
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/info?id=4314ba71d4191f7eec9ed50d92d8e1d2&fields=id,name,notes&format=plain
Query parameters
id = 4314ba71d4191f7eec9ed50d92d8e1d2
fields = id,name,notes
format = plain
Response
4314ba71d4191f7eec9ed50d92d8e1d2
name
notes
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance |
idID | conversion ID |
Return values
parameter | description |
---|---|
[ARRAY] | see i1/conversions/codes/list for details on returned fields |
/conversions/codes/list
access: [READ]
This method returns a list of user's conversions, specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name
Query parameters
fields = count,id,name
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"id": "cadbcad7c39a91466210d9b11bf2403f",
"name": "conversion code 1"
},
{
"id": "a09bafe35eb523ee87ce1e634d627562",
"name": "conversion code 2"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=xml
Query parameters
fields = count,id,name
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<id>cadbcad7c39a91466210d9b11bf2403f</id>
<name>conversion code 1</name>
</i0>
<i1>
<id>a09bafe35eb523ee87ce1e634d627562</id>
<name>conversion code 2</name>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=txt
Query parameters
fields = count,id,name
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=cadbcad7c39a91466210d9b11bf2403f
result_data_0_name=conversion code 1
result_data_1_id=a09bafe35eb523ee87ce1e634d627562
result_data_1_name=conversion code 2
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/list?fields=count,id,name&format=plain
Query parameters
fields = count,id,name
format = plain
Response
2
cadbcad7c39a91466210d9b11bf2403f
conversion code 1
a09bafe35eb523ee87ce1e634d627562
conversion code 2
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: count, id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of coversion codes (maxmimum allowed: 100) |
orderbyARRAY | orders coversion codes by field, available fields: count, id, ext_id, ext_postback_id, name, notes, enable_postback_url, affiliate_network_id, creation, clicks, last_click, value, performance |
searchSTRING | filters coversion codes to be extracted by searching them |
sortSTRING | sorts coversion codes in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract coversion codes from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of (filtered) coversion codes, returned only if count is passed in fields |
data | array containing required information on coversion codes |
/conversions/codes/params
/conversions/codes/params/count
access: [READ]
This method returns the number of parameters linked to a conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/params/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/params/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/params/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/params/count?format=plain
Query parameters
format = plain
Response
5
Required parameters
parameter | description |
---|---|
idID | ID of the conversion code |
Optional parameters
parameter | description |
---|---|
param_numSTRING | filter conversion parameters by parameter number, see i1/conversions/codes/params/list for details |
searchSTRING | filters conversion parameters to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) conversion parameters |
/conversions/codes/params/has_params
access: [READ]
This method returns the number of parameters related to a conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/params/has_params?id=22ec71de954751c965962d76c87239b0
Query parameters
id = 22ec71de954751c965962d76c87239b0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"has_params": 1,
"param": 1,
"ep00": 1,
"ep01": 0,
"ep02": 0,
"ep03": 0,
"ep04": 0,
"ep05": 0,
"ep06": 0,
"ep07": 0,
"ep08": 0,
"ep09": 0,
"ep10": 0,
"ep11": 0,
"ep12": 0,
"ep13": 0,
"ep14": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/params/has_params?id=22ec71de954751c965962d76c87239b0&format=xml
Query parameters
id = 22ec71de954751c965962d76c87239b0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<has_params>1</has_params>
<param>1</param>
<ep00>1</ep00>
<ep01>0</ep01>
<ep02>0</ep02>
<ep03>0</ep03>
<ep04>0</ep04>
<ep05>0</ep05>
<ep06>0</ep06>
<ep07>0</ep07>
<ep08>0</ep08>
<ep09>0</ep09>
<ep10>0</ep10>
<ep11>0</ep11>
<ep12>0</ep12>
<ep13>0</ep13>
<ep14>0</ep14>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/params/has_params?id=22ec71de954751c965962d76c87239b0&format=txt
Query parameters
id = 22ec71de954751c965962d76c87239b0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_has_params=1
result_param=1
result_ep00=1
result_ep01=0
result_ep02=0
result_ep03=0
result_ep04=0
result_ep05=0
result_ep06=0
result_ep07=0
result_ep08=0
result_ep09=0
result_ep10=0
result_ep11=0
result_ep12=0
result_ep13=0
result_ep14=0
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/params/has_params?id=22ec71de954751c965962d76c87239b0&format=plain
Query parameters
id = 22ec71de954751c965962d76c87239b0
format = plain
Response
1
1
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Required parameters
parameter | description |
---|---|
idID | ID of the conversion code |
Return values
parameter | description |
---|---|
ep00 | 1 if the extended parameter ep00 is associated to the conversion code |
ep01 | 1 if the extended parameter ep01 is associated to the conversion code |
ep02 | 1 if the extended parameter ep02 is associated to the conversion code |
ep03 | 1 if the extended parameter ep03 is associated to the conversion code |
ep04 | 1 if the extended parameter ep04 is associated to the conversion code |
ep05 | 1 if the extended parameter ep05 is associated to the conversion code |
ep06 | 1 if the extended parameter ep06 is associated to the conversion code |
ep07 | 1 if the extended parameter ep07 is associated to the conversion code |
ep08 | 1 if the extended parameter ep08 is associated to the conversion code |
ep09 | 1 if the extended parameter ep09 is associated to the conversion code |
ep10 | 1 if the extended parameter ep10 is associated to the conversion code |
ep11 | 1 if the extended parameter ep11 is associated to the conversion code |
ep12 | 1 if the extended parameter ep12 is associated to the conversion code |
ep13 | 1 if the extended parameter ep13 is associated to the conversion code |
ep14 | 1 if the extended parameter ep14 is associated to the conversion code |
has_params | 1 if at least one extended parameter is associated to the conversion code |
param | 1 if param is associated to the conversion code |
/conversions/codes/params/list
access: [READ]
This method returns a list of parameters related to a conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=df1e92edd49304d6f067f992e7d61273
Query parameters
id = df1e92edd49304d6f067f992e7d61273
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"param_id": "f5d9a96983c103d874cb8ebead9ee8ea",
"param": "this is the value #1 of parameter 'param'"
},
{
"param_id": "b2c52248e74307b73d34fc902f6b4d49",
"param": "this is the value #2 of parameter 'param'"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=df1e92edd49304d6f067f992e7d61273&format=xml
Query parameters
id = df1e92edd49304d6f067f992e7d61273
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<param_id>f5d9a96983c103d874cb8ebead9ee8ea</param_id>
<param>this is the value #1 of parameter 'param'</param>
</i0>
<i1>
<param_id>b2c52248e74307b73d34fc902f6b4d49</param_id>
<param>this is the value #2 of parameter 'param'</param>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=df1e92edd49304d6f067f992e7d61273&format=txt
Query parameters
id = df1e92edd49304d6f067f992e7d61273
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_param_id=f5d9a96983c103d874cb8ebead9ee8ea
result_data_0_param=this is the value #1 of parameter 'param'
result_data_1_param_id=b2c52248e74307b73d34fc902f6b4d49
result_data_1_param=this is the value #2 of parameter 'param'
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=df1e92edd49304d6f067f992e7d61273&format=plain
Query parameters
id = df1e92edd49304d6f067f992e7d61273
format = plain
Response
2
f5d9a96983c103d874cb8ebead9ee8ea
this is the value #1 of parameter 'param'
b2c52248e74307b73d34fc902f6b4d49
this is the value #2 of parameter 'param'
Example 5 (json)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=0f719599482e77c99ed505cefdf84546¶m_num=0
Query parameters
id = 0f719599482e77c99ed505cefdf84546
param_num = 0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"param_id": "3278329290f8f6fac639385565184a4b",
"param": "this is the value of extended parameter 'ep00'"
}
]
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=0f719599482e77c99ed505cefdf84546¶m_num=0&format=xml
Query parameters
id = 0f719599482e77c99ed505cefdf84546
param_num = 0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<param_id>3278329290f8f6fac639385565184a4b</param_id>
<param>this is the value of extended parameter 'ep00'</param>
</i0>
</data>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=0f719599482e77c99ed505cefdf84546¶m_num=0&format=txt
Query parameters
id = 0f719599482e77c99ed505cefdf84546
param_num = 0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_param_id=3278329290f8f6fac639385565184a4b
result_data_0_param=this is the value of extended parameter 'ep00'
Example 8 (plain)
Request
https://joturl.com/a/i1/conversions/codes/params/list?id=0f719599482e77c99ed505cefdf84546¶m_num=0&format=plain
Query parameters
id = 0f719599482e77c99ed505cefdf84546
param_num = 0
format = plain
Response
1
3278329290f8f6fac639385565184a4b
this is the value of extended parameter 'ep00'
Required parameters
parameter | description |
---|---|
idID | ID of the conversion code |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of coversion parameters (maxmimum allowed: 100) |
param_numSTRING | if not passed or param_num = 255 it returns the parameter param , if param_num = 0 it returns the extended paarameter ep00 , ..., if param_num = 7 it returns the extended paarameter ep07 , ..., if param_num = 14 it returns the extended paarameter ep14 , |
searchSTRING | filters coversion parameters to be extracted by searching them |
startINTEGER | starts to extract coversion parameters from this position |
Return values
parameter | description |
---|---|
count | number of available parameter with the specified param_num |
data | array containing required information on coversion code parameters |
/conversions/codes/urls
/conversions/codes/urls/count
access: [READ]
This method returns the number of tracking links liked to a conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/urls/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/urls/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/urls/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/urls/count?format=plain
Query parameters
format = plain
Response
4
Required parameters
parameter | description |
---|---|
idID | ID of the conversion code |
Optional parameters
parameter | description |
---|---|
searchSTRING | filters tracking pixels to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) tracking pixels |
/conversions/codes/urls/list
access: [READ]
This method returns a list of tracking links related to a conversion code.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/codes/urls/list?id=4f3c1011c387cf1d4545d4f5b67b1d4d&fields=count,url_id,alias
Query parameters
id = 4f3c1011c387cf1d4545d4f5b67b1d4d
fields = count,url_id,alias
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"url_id": "fbfe3d567cc41130ea1312dcd5ea2e83",
"alias": "118e33e4"
},
{
"url_id": "0836bf115436b4e4e61596e2c30db63b",
"alias": "d5dffce2"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/codes/urls/list?id=4f3c1011c387cf1d4545d4f5b67b1d4d&fields=count,url_id,alias&format=xml
Query parameters
id = 4f3c1011c387cf1d4545d4f5b67b1d4d
fields = count,url_id,alias
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<url_id>fbfe3d567cc41130ea1312dcd5ea2e83</url_id>
<alias>118e33e4</alias>
</i0>
<i1>
<url_id>0836bf115436b4e4e61596e2c30db63b</url_id>
<alias>d5dffce2</alias>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/codes/urls/list?id=4f3c1011c387cf1d4545d4f5b67b1d4d&fields=count,url_id,alias&format=txt
Query parameters
id = 4f3c1011c387cf1d4545d4f5b67b1d4d
fields = count,url_id,alias
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_url_id=fbfe3d567cc41130ea1312dcd5ea2e83
result_data_0_alias=118e33e4
result_data_1_url_id=0836bf115436b4e4e61596e2c30db63b
result_data_1_alias=d5dffce2
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/codes/urls/list?id=4f3c1011c387cf1d4545d4f5b67b1d4d&fields=count,url_id,alias&format=plain
Query parameters
id = 4f3c1011c387cf1d4545d4f5b67b1d4d
fields = count,url_id,alias
format = plain
Response
2
fbfe3d567cc41130ea1312dcd5ea2e83
118e33e4
0836bf115436b4e4e61596e2c30db63b
d5dffce2
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, url_id, alias, short_url, creation, long_url, domain_host, domain_id, project_name, project_id |
idID | ID of the conversion code |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of tracking links (maxmimum allowed: 100) |
orderbyARRAY | orders tracking links by field, available fields: url_id, alias, short_url, creation, long_url, domain_host, domain_id, project_name, project_id |
searchSTRING | filters tracking links to be extracted by searching them |
sortSTRING | sorts tracking links in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract tracking links from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of tracking links, returned only if count is passed in fields |
data | array containing information on the tracking links, the returned information depends on the fields parameter. |
/conversions/count
access: [READ]
This method is actually an interface to i1/conversions/codes/count and/or to i1/conversions/pixels/count according to types.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/count?types=code,pixel
Query parameters
types = code,pixel
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 425
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/count?types=code,pixel&format=xml
Query parameters
types = code,pixel
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>425</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/count?types=code,pixel&format=txt
Query parameters
types = code,pixel
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=425
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/count?types=code,pixel&format=plain
Query parameters
types = code,pixel
format = plain
Response
425
Required parameters
parameter | description |
---|---|
typesARRAY | comma separated list of types; available types are [code, pixel] |
Return values
parameter | description |
---|---|
count | number of conversion, if both types are passed, it contains the sum of number of conversion codes and conversion pixels |
/conversions/list
access: [READ]
This method is actually an interface to i1/conversions/codes/list and/or to i1/conversions/pixels/list according to types.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url
Query parameters
types = code,pixel
fields = name,id,short_url
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"name": "conversion code 1 (postback enabled)",
"id": "d0e837cdb7d263e782f3bf2b8dd4296a",
"ext_id": "9d0eec03cca715de35425a59e32bd13e",
"ext_postback_id": "86eca28b61a9f12c4b602038099c258a",
"type": "code"
},
{
"name": "conversion code 2",
"id": "7e4e56a17f5ed8ca6034e4aba1abd4c9",
"ext_id": "f7a3951c68c539f30adfd097b03019c4",
"type": "code"
},
{
"id": "423f64e7587af2c26e7e1266da458fb2",
"short_url": "https:\/\/domain.ext\/tracking_pixel_alias",
"type": "pixel"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=xml
Query parameters
types = code,pixel
fields = name,id,short_url
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<name>conversion code 1 (postback enabled)</name>
<id>d0e837cdb7d263e782f3bf2b8dd4296a</id>
<ext_id>9d0eec03cca715de35425a59e32bd13e</ext_id>
<ext_postback_id>86eca28b61a9f12c4b602038099c258a</ext_postback_id>
<type>code</type>
</i0>
<i1>
<name>conversion code 2</name>
<id>7e4e56a17f5ed8ca6034e4aba1abd4c9</id>
<ext_id>f7a3951c68c539f30adfd097b03019c4</ext_id>
<type>code</type>
</i1>
<i2>
<id>423f64e7587af2c26e7e1266da458fb2</id>
<short_url>https://domain.ext/tracking_pixel_alias</short_url>
<type>pixel</type>
</i2>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=txt
Query parameters
types = code,pixel
fields = name,id,short_url
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=conversion code 1 (postback enabled)
result_data_0_id=d0e837cdb7d263e782f3bf2b8dd4296a
result_data_0_ext_id=9d0eec03cca715de35425a59e32bd13e
result_data_0_ext_postback_id=86eca28b61a9f12c4b602038099c258a
result_data_0_type=code
result_data_1_name=conversion code 2
result_data_1_id=7e4e56a17f5ed8ca6034e4aba1abd4c9
result_data_1_ext_id=f7a3951c68c539f30adfd097b03019c4
result_data_1_type=code
result_data_2_id=423f64e7587af2c26e7e1266da458fb2
result_data_2_short_url=https://domain.ext/tracking_pixel_alias
result_data_2_type=pixel
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/list?types=code,pixel&fields=name,id,short_url&format=plain
Query parameters
types = code,pixel
fields = name,id,short_url
format = plain
Response
conversion code 1 (postback enabled)
d0e837cdb7d263e782f3bf2b8dd4296a
9d0eec03cca715de35425a59e32bd13e
86eca28b61a9f12c4b602038099c258a
code
conversion code 2
7e4e56a17f5ed8ca6034e4aba1abd4c9
f7a3951c68c539f30adfd097b03019c4
code
https://domain.ext/tracking_pixel_alias
Required parameters
parameter | description |
---|---|
typesARRAY | comma separated list of types; available types are [code, pixel] |
Return values
parameter | description |
---|---|
count | [OPTIONAL] number of conversion, if both types are passed, it contains the sum of number of conversion codes and conversion pixels |
data | array containing information on conversions |
/conversions/pixels
/conversions/pixels/add
access: [WRITE]
Add a tracking pixel for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=ebd34eb9a16f73d46e7b877cc16b9761&url_project_id=4258a7c36952eb83215af539cfde0111¬es=
Query parameters
alias = jot
domain_id = ebd34eb9a16f73d46e7b877cc16b9761
url_project_id = 4258a7c36952eb83215af539cfde0111
notes =
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "832bf9c541314e17ececd45a44924493",
"alias": "jot",
"domain_id": "ebd34eb9a16f73d46e7b877cc16b9761",
"domain_host": "jo.my",
"domain_nickname": "",
"url_project_id": "4258a7c36952eb83215af539cfde0111",
"project_name": "project name",
"short_url": "\/\/jo.my\/jot",
"template_type": 2,
"notes": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=ebd34eb9a16f73d46e7b877cc16b9761&url_project_id=4258a7c36952eb83215af539cfde0111¬es=&format=xml
Query parameters
alias = jot
domain_id = ebd34eb9a16f73d46e7b877cc16b9761
url_project_id = 4258a7c36952eb83215af539cfde0111
notes =
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>832bf9c541314e17ececd45a44924493</id>
<alias>jot</alias>
<domain_id>ebd34eb9a16f73d46e7b877cc16b9761</domain_id>
<domain_host>jo.my</domain_host>
<domain_nickname></domain_nickname>
<url_project_id>4258a7c36952eb83215af539cfde0111</url_project_id>
<project_name>project name</project_name>
<short_url>//jo.my/jot</short_url>
<template_type>2</template_type>
<notes></notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=ebd34eb9a16f73d46e7b877cc16b9761&url_project_id=4258a7c36952eb83215af539cfde0111¬es=&format=txt
Query parameters
alias = jot
domain_id = ebd34eb9a16f73d46e7b877cc16b9761
url_project_id = 4258a7c36952eb83215af539cfde0111
notes =
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=832bf9c541314e17ececd45a44924493
result_alias=jot
result_domain_id=ebd34eb9a16f73d46e7b877cc16b9761
result_domain_host=jo.my
result_domain_nickname=
result_url_project_id=4258a7c36952eb83215af539cfde0111
result_project_name=project name
result_short_url=//jo.my/jot
result_template_type=2
result_notes=
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/add?alias=jot&domain_id=ebd34eb9a16f73d46e7b877cc16b9761&url_project_id=4258a7c36952eb83215af539cfde0111¬es=&format=plain
Query parameters
alias = jot
domain_id = ebd34eb9a16f73d46e7b877cc16b9761
url_project_id = 4258a7c36952eb83215af539cfde0111
notes =
format = plain
Response
//jo.my/jot
Required parameters
parameter | description | max length |
---|---|---|
aliasSTRING | alias for the tracking pixel, see i1/urls/shorten for details of available characters in alias | 510 |
Optional parameters
parameter | description |
---|---|
conversion_idsARRAY_OF_IDS | ID of the associated conversion codes |
domain_idID | ID of the domain for the tracking pixel, if not set the default domain for the user will be used |
notesSTRING | notes for the tracking pixel |
tagsARRAY | comma-separated list of tags for the tracking pixel |
url_project_idID | ID of the project where the tracking pixel will be put in, if not specified the default: project is used |
Return values
parameter | description |
---|---|
alias | see i1/urls/shorten for details on returnd fields |
domain_host | see i1/urls/shorten for details on returnd fields |
domain_id | see i1/urls/shorten for details on returnd fields |
domain_nickname | see i1/urls/shorten for details on returnd fields |
id | ID of the created tracking pixel |
notes | see i1/urls/shorten for details on returnd fields |
project_id | see i1/urls/shorten for details on returnd fields |
project_name | see i1/urls/shorten for details on returnd fields |
short_url | see i1/urls/shorten for details on returnd fields |
tags | see i1/urls/shorten for details on returnd fields |
tags | see i1/urls/shorten for details on returnd fields |
url_conversions_number | number of associated conversion codes |
/conversions/pixels/count
access: [READ]
This method returns the number of defined conversion pixels.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/count?format=plain
Query parameters
format = plain
Response
4
Optional parameters
parameter | description |
---|---|
searchSTRING | filters conversion pixels to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) conversion pixels |
/conversions/pixels/delete
access: [WRITE]
This method deletes a set of conversion pixel using their IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972
Query parameters
ids = 969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972&format=xml
Query parameters
ids = 969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972&format=txt
Query parameters
ids = 969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972&format=plain
Query parameters
ids = 969758dbae7c37b7f694e1ce4efc4ecf,208524e27ed871d564b33008575fb176,bca2f4389bee3e92f77b558a45fa9972
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e
Query parameters
ids = 05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": [
"05e3e4a301c851d6bc774fd7441266c6"
],
"deleted": 2
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e&format=xml
Query parameters
ids = 05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>
<i0>05e3e4a301c851d6bc774fd7441266c6</i0>
</ids>
<deleted>2</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e&format=txt
Query parameters
ids = 05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=05e3e4a301c851d6bc774fd7441266c6
result_deleted=2
Example 8 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/delete?ids=05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e&format=plain
Query parameters
ids = 05e3e4a301c851d6bc774fd7441266c6,5698d9e89c42969e632d52b4398d375c,701df88834ab589e56ddbd2526a7f40e
format = plain
Response
05e3e4a301c851d6bc774fd7441266c6
2
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of tracking pixel IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted tracking pixels |
tracking_pixel_ids | [OPTIONAL] list of tracking pixel IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/conversions/pixels/edit
access: [WRITE]
Edit fields of a Tracking Pixel.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/edit?id=4c4100d3575968c5a818dece2bf7aa8d&alias=jot&domain_id=d8463c29cea445b39e4abe4f7df3fa77&url_project_id=6bfa04a383a43ec9f11b68b7fa547b1d¬es=new+notes
Query parameters
id = 4c4100d3575968c5a818dece2bf7aa8d
alias = jot
domain_id = d8463c29cea445b39e4abe4f7df3fa77
url_project_id = 6bfa04a383a43ec9f11b68b7fa547b1d
notes = new notes
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "4c4100d3575968c5a818dece2bf7aa8d",
"alias": "jot",
"domain_id": "d8463c29cea445b39e4abe4f7df3fa77",
"domain_host": "jo.my",
"domain_nickname": "",
"url_project_id": "6bfa04a383a43ec9f11b68b7fa547b1d",
"project_name": "project name",
"short_url": "\/\/jo.my\/jot",
"template_type": 2,
"notes": "new notes"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/edit?id=4c4100d3575968c5a818dece2bf7aa8d&alias=jot&domain_id=d8463c29cea445b39e4abe4f7df3fa77&url_project_id=6bfa04a383a43ec9f11b68b7fa547b1d¬es=new+notes&format=xml
Query parameters
id = 4c4100d3575968c5a818dece2bf7aa8d
alias = jot
domain_id = d8463c29cea445b39e4abe4f7df3fa77
url_project_id = 6bfa04a383a43ec9f11b68b7fa547b1d
notes = new notes
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>4c4100d3575968c5a818dece2bf7aa8d</id>
<alias>jot</alias>
<domain_id>d8463c29cea445b39e4abe4f7df3fa77</domain_id>
<domain_host>jo.my</domain_host>
<domain_nickname></domain_nickname>
<url_project_id>6bfa04a383a43ec9f11b68b7fa547b1d</url_project_id>
<project_name>project name</project_name>
<short_url>//jo.my/jot</short_url>
<template_type>2</template_type>
<notes>new notes</notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/edit?id=4c4100d3575968c5a818dece2bf7aa8d&alias=jot&domain_id=d8463c29cea445b39e4abe4f7df3fa77&url_project_id=6bfa04a383a43ec9f11b68b7fa547b1d¬es=new+notes&format=txt
Query parameters
id = 4c4100d3575968c5a818dece2bf7aa8d
alias = jot
domain_id = d8463c29cea445b39e4abe4f7df3fa77
url_project_id = 6bfa04a383a43ec9f11b68b7fa547b1d
notes = new notes
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=4c4100d3575968c5a818dece2bf7aa8d
result_alias=jot
result_domain_id=d8463c29cea445b39e4abe4f7df3fa77
result_domain_host=jo.my
result_domain_nickname=
result_url_project_id=6bfa04a383a43ec9f11b68b7fa547b1d
result_project_name=project name
result_short_url=//jo.my/jot
result_template_type=2
result_notes=new notes
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/edit?id=4c4100d3575968c5a818dece2bf7aa8d&alias=jot&domain_id=d8463c29cea445b39e4abe4f7df3fa77&url_project_id=6bfa04a383a43ec9f11b68b7fa547b1d¬es=new+notes&format=plain
Query parameters
id = 4c4100d3575968c5a818dece2bf7aa8d
alias = jot
domain_id = d8463c29cea445b39e4abe4f7df3fa77
url_project_id = 6bfa04a383a43ec9f11b68b7fa547b1d
notes = new notes
format = plain
Response
//jo.my/jot
Required parameters
parameter | description |
---|---|
idID | ID of the tracking pixel |
Optional parameters
parameter | description |
---|---|
conversion_idsARRAY_OF_IDS | ID of the associated conversion codes |
notesSTRING | notes for the tracking pixel |
tagsARRAY | comma-separated list of tags for the tracking pixel |
Return values
parameter | description |
---|---|
alias | see i1/urls/shorten for details on returnd fields |
domain_host | see i1/urls/shorten for details on returnd fields |
domain_id | see i1/urls/shorten for details on returnd fields |
id | ID of the created tracking pixel |
long_url | see i1/urls/shorten for details on returnd fields |
notes | see i1/urls/shorten for details on returnd fields |
project_id | see i1/urls/shorten for details on returnd fields |
project_name | see i1/urls/shorten for details on returnd fields |
short_url | see i1/urls/shorten for details on returnd fields |
tags | see i1/urls/shorten for details on returnd fields |
url_conversions_number | number of associated conversion codes |
/conversions/pixels/info
access: [READ]
This method returns information specified in a comma separated input called fields about a conversion.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=1c892395404539b9af43c69d69fccd21
Query parameters
fields = id,short_url
id = 1c892395404539b9af43c69d69fccd21
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "1c892395404539b9af43c69d69fccd21",
"short_url": "http:\/\/jo.my\/5647158c"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=1c892395404539b9af43c69d69fccd21&format=xml
Query parameters
fields = id,short_url
id = 1c892395404539b9af43c69d69fccd21
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>1c892395404539b9af43c69d69fccd21</id>
<short_url>http://jo.my/5647158c</short_url>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=1c892395404539b9af43c69d69fccd21&format=txt
Query parameters
fields = id,short_url
id = 1c892395404539b9af43c69d69fccd21
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=1c892395404539b9af43c69d69fccd21
result_data_0_short_url=http://jo.my/5647158c
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/info?fields=id,short_url&id=1c892395404539b9af43c69d69fccd21&format=plain
Query parameters
fields = id,short_url
id = 1c892395404539b9af43c69d69fccd21
format = plain
Response
http://jo.my/5647158c
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, see method i1/conversions/pixels/list for reference |
idID | ID of the tracking pixel whose information is required |
Return values
parameter | description |
---|---|
data | array containing 1 item on success, the returned information depends on the fields parameter. |
/conversions/pixels/list
access: [READ]
This method returns a list of tracking pixels.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=9b2efef349e1c6d832b2f3053ed01790
Query parameters
fields = id,short_url
url_project_id = 9b2efef349e1c6d832b2f3053ed01790
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "c1dcfb08ca779257a34f370e18f787b5",
"short_url": "http:\/\/jo.my\/17e46425"
},
{
"id": "b3942b295715505a36643570e8797f4c",
"short_url": "http:\/\/jo.my\/96bfeccd"
},
{
"id": "0d2c94999e67e523473ba308f2a48d15",
"short_url": "http:\/\/jo.my\/798a5934"
},
{
"id": "6fb315d3d1a6323a786b32339a53c74e",
"short_url": "http:\/\/jo.my\/42e5a829"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=9b2efef349e1c6d832b2f3053ed01790&format=xml
Query parameters
fields = id,short_url
url_project_id = 9b2efef349e1c6d832b2f3053ed01790
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>c1dcfb08ca779257a34f370e18f787b5</id>
<short_url>http://jo.my/17e46425</short_url>
</i0>
<i1>
<id>b3942b295715505a36643570e8797f4c</id>
<short_url>http://jo.my/96bfeccd</short_url>
</i1>
<i2>
<id>0d2c94999e67e523473ba308f2a48d15</id>
<short_url>http://jo.my/798a5934</short_url>
</i2>
<i3>
<id>6fb315d3d1a6323a786b32339a53c74e</id>
<short_url>http://jo.my/42e5a829</short_url>
</i3>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=9b2efef349e1c6d832b2f3053ed01790&format=txt
Query parameters
fields = id,short_url
url_project_id = 9b2efef349e1c6d832b2f3053ed01790
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=c1dcfb08ca779257a34f370e18f787b5
result_data_0_short_url=http://jo.my/17e46425
result_data_1_id=b3942b295715505a36643570e8797f4c
result_data_1_short_url=http://jo.my/96bfeccd
result_data_2_id=0d2c94999e67e523473ba308f2a48d15
result_data_2_short_url=http://jo.my/798a5934
result_data_3_id=6fb315d3d1a6323a786b32339a53c74e
result_data_3_short_url=http://jo.my/42e5a829
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/pixels/list?fields=id,short_url&url_project_id=9b2efef349e1c6d832b2f3053ed01790&format=plain
Query parameters
fields = id,short_url
url_project_id = 9b2efef349e1c6d832b2f3053ed01790
format = plain
Response
http://jo.my/17e46425
http://jo.my/96bfeccd
http://jo.my/798a5934
http://jo.my/42e5a829
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: count, id, short_url, creation, url_tags, clicks, unique_visits, qrcodes_visits, conversions_visits, notes, alias |
Optional parameters
parameter | description |
---|---|
idID | ID of the tracking pixel |
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: count, id, short_url, creation, url_tags, clicks, unique_visits, qrcodes_visits, conversions_visits, notes, alias |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
data | array containing information on the tracking pixels, the returned information depends on the fields parameter. |
/conversions/settings
/conversions/settings/get
access: [READ]
This method returns global setting for conversions.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/settings/get
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"last_or_first_click": "last",
"expiration_cookie": "30",
"currency_id": "3951872b2b8564b33fb6d19350557891"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/settings/get?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<last_or_first_click>last</last_or_first_click>
<expiration_cookie>30</expiration_cookie>
<currency_id>3951872b2b8564b33fb6d19350557891</currency_id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/settings/get?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_last_or_first_click=last
result_expiration_cookie=30
result_currency_id=3951872b2b8564b33fb6d19350557891
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/settings/get?format=plain
Query parameters
format = plain
Response
last
30
3951872b2b8564b33fb6d19350557891
Return values
parameter | description |
---|---|
currency_id | ID of the currency to apply to conversions, see i1/currencies/list for details |
expiration_cookie | expiration period (in days) for conversion cookies |
last_or_first_click | the click is assigned to the first or last click |
/conversions/settings/property
access: [READ]
This method returns default values and properties for conversion settings.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/settings/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"default_last_or_first_click": "last",
"default_expiration_cookie": "30",
"default_currency_id": "644a4b356f74446f62613864764b3762725a343966673d3d",
"default_clickbank_secret_key": "",
"expiration_cookie_days": [
1,
7,
30,
60,
90
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/settings/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<default_last_or_first_click>last</default_last_or_first_click>
<default_expiration_cookie>30</default_expiration_cookie>
<default_currency_id>644a4b356f74446f62613864764b3762725a343966673d3d</default_currency_id>
<default_clickbank_secret_key></default_clickbank_secret_key>
<expiration_cookie_days>
<i0>1</i0>
<i1>7</i1>
<i2>30</i2>
<i3>60</i3>
<i4>90</i4>
</expiration_cookie_days>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/settings/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_default_last_or_first_click=last
result_default_expiration_cookie=30
result_default_currency_id=644a4b356f74446f62613864764b3762725a343966673d3d
result_default_clickbank_secret_key=
result_expiration_cookie_days_0=1
result_expiration_cookie_days_1=7
result_expiration_cookie_days_2=30
result_expiration_cookie_days_3=60
result_expiration_cookie_days_4=90
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/settings/property?format=plain
Query parameters
format = plain
Response
last
30
644a4b356f74446f62613864764b3762725a343966673d3d
1
7
30
60
90
Return values
parameter | description |
---|---|
default_clickbank_secret_key | default ClickBank secret key |
default_currency_id | default currency ID for the conversion, see i1/currencies/list for details |
default_expiration_cookie | default expiration (in days) for the conversion cookie |
default_last_or_first_click | default behavior for the click assignment |
expiration_cookie_days | list of allowed expiration days |
/conversions/settings/set
access: [WRITE]
This method sets global setting for conversions.
Example 1 (json)
Request
https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30¤cy_id=3f61523d4a8ff51931a1725eb2a485ad&clickbank_secret_key=277CADDC0D10AF88
Query parameters
last_or_first_click = last
expiration_cookie = 30
currency_id = 3f61523d4a8ff51931a1725eb2a485ad
clickbank_secret_key = 277CADDC0D10AF88
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30¤cy_id=3f61523d4a8ff51931a1725eb2a485ad&clickbank_secret_key=277CADDC0D10AF88&format=xml
Query parameters
last_or_first_click = last
expiration_cookie = 30
currency_id = 3f61523d4a8ff51931a1725eb2a485ad
clickbank_secret_key = 277CADDC0D10AF88
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30¤cy_id=3f61523d4a8ff51931a1725eb2a485ad&clickbank_secret_key=277CADDC0D10AF88&format=txt
Query parameters
last_or_first_click = last
expiration_cookie = 30
currency_id = 3f61523d4a8ff51931a1725eb2a485ad
clickbank_secret_key = 277CADDC0D10AF88
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/conversions/settings/set?last_or_first_click=last&expiration_cookie=30¤cy_id=3f61523d4a8ff51931a1725eb2a485ad&clickbank_secret_key=277CADDC0D10AF88&format=plain
Query parameters
last_or_first_click = last
expiration_cookie = 30
currency_id = 3f61523d4a8ff51931a1725eb2a485ad
clickbank_secret_key = 277CADDC0D10AF88
format = plain
Response
1
Required parameters
parameter | description |
---|---|
clickbank_secret_keySTRING | ClickBank secret key |
currency_idID | ID of the currency to apply to conversions, see i1/currencies/list for details |
expiration_cookieINTEGER | expiration period (in days) for conversion cookies, available values: 1, 7, 30, 60, 90 |
last_or_first_clickSTRING | assign a conversion to the first or last click made by the user on the tracking link/pixel |
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/ctas
/ctas/count
access: [READ]
This method returns the number of defined call to actions.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/count?format=plain
Query parameters
format = plain
Response
5
Optional parameters
parameter | description |
---|---|
searchSTRING | filters CTAs to be extracted by searching them |
typesSTRING | comma-separated list of types to filter CTAs, for available types see i1/ctas/property |
Return values
parameter | description |
---|---|
count | number of (filtered) CTAs |
/ctas/delete
access: [WRITE]
This method deletes a set of CTAs by using their IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/delete?ids=38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb
Query parameters
ids = 38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/delete?ids=38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb&format=xml
Query parameters
ids = 38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/delete?ids=38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb&format=txt
Query parameters
ids = 38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/delete?ids=38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb&format=plain
Query parameters
ids = 38751b186d294de8c6af3a3f68d6dae3,cbb1a89cbc33eb6d303a8c0d7b1de5c0,10589487e7dc9704ed2b7b7d72c70beb
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/ctas/delete?ids=ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee
Query parameters
ids = ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/ctas/delete?ids=ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee&format=xml
Query parameters
ids = ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/ctas/delete?ids=ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee&format=txt
Query parameters
ids = ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/ctas/delete?ids=ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee&format=plain
Query parameters
ids = ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461,629d6f64fce4e6912721f7c2c460a3ee
format = plain
Response
ecebec78af51bf2a6cb5f6b7f9aaeab7,c4f9467b11afe361438161fcceed6461
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of CTA IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted CTAs |
ids | [OPTIONAL] list of CTA IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/ctas/download
access: [READ]
This method returns data that is collected for a specific CTA. Only data collected in the last 90 days can be returned.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"headers": [
"name",
"age",
"email"
],
"lines": [
[
"John",
"27",
"john@example.com"
],
[
"Doo",
"31",
"doo@example.com"
]
],
"extracted": 2,
"skipped": 3,
"count": 5,
"next": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&format=xml
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<headers>
<i0>name</i0>
<i1>age</i1>
<i2>email</i2>
</headers>
<lines>
<i0>
<i0>John</i0>
<i1>27</i1>
<i2>john@example.com</i2>
</i0>
<i1>
<i0>Doo</i0>
<i1>31</i1>
<i2>doo@example.com</i2>
</i1>
</lines>
<extracted>2</extracted>
<skipped>3</skipped>
<count>5</count>
<next></next>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&format=txt
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_headers_0=name
result_headers_1=age
result_headers_2=email
result_lines_0_0=John
result_lines_0_1=27
result_lines_0_2=john@example.com
result_lines_1_0=Doo
result_lines_1_1=31
result_lines_1_2=doo@example.com
result_extracted=2
result_skipped=3
result_count=5
result_next=
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&format=plain
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
format = plain
Response
name
age
email
John
27
john@example.com
Doo
31
doo@example.com
2
3
5
Example 5 (json)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&return_json=1
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
return_json = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"name": "John",
"age": "27",
"email": "john@example.com"
},
{
"name": "Doo",
"age": "31",
"email": "doo@example.com"
}
],
"extracted": 2,
"skipped": 3,
"count": 5,
"next": ""
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&return_json=1&format=xml
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
return_json = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<name>John</name>
<age>27</age>
<email>john@example.com</email>
</i0>
<i1>
<name>Doo</name>
<age>31</age>
<email>doo@example.com</email>
</i1>
</data>
<extracted>2</extracted>
<skipped>3</skipped>
<count>5</count>
<next></next>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&return_json=1&format=txt
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
return_json = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=John
result_data_0_age=27
result_data_0_email=john@example.com
result_data_1_name=Doo
result_data_1_age=31
result_data_1_email=doo@example.com
result_extracted=2
result_skipped=3
result_count=5
result_next=
Example 8 (plain)
Request
https://joturl.com/a/i1/ctas/download?id=737f21d414de17dbd4cbd8d91144cfce&return_json=1&format=plain
Query parameters
id = 737f21d414de17dbd4cbd8d91144cfce
return_json = 1
format = plain
Response
John
27
john@example.com
Doo
31
doo@example.com
2
3
5
Required parameters
parameter | description |
---|---|
idID | ID of the call to action |
Optional parameters
parameter | description |
---|---|
from_dateDATE | date (inclusive) from which to start the export (default: 90 days before today) |
lengthINTEGER | number of items to return (default: 1000, max value: 1000) |
return_jsonBOOLEAN | if 1 this method returns a JSON data fields instead of headers and lines fields (default: 0) |
sampleBOOLEAN | 1 to return sample data, 0 otherwise (default: 0) |
startINTEGER | index of the starting item to retrieve (default: 0) |
to_dateDATE | date (inclusive) to finish the export (default: today) |
Return values
parameter | description |
---|---|
count | maximum number of items |
data | [OPTIONAL] alternative to headers and lines , returned if return_json=1 |
extracted | number of extracted items |
headers | [OPTIONAL] names of the corresponding information returned in lines, returned if return_json=0 |
lines | [OPTIONAL] array containing information of the CTA data, returned if return_json=0 |
next | URL to be called in order to fetch the next page of the list |
skipped | number of skipped items |
/ctas/socialapps
/ctas/socialapps/add
access: [WRITE]
Add a new social app.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=8422033f5e8170cc674588e79921ffce&secret=69814384425eff217e34f2b2896d706e
Query parameters
provider = facebook
name = my custom social app
appid = 8422033f5e8170cc674588e79921ffce
secret = 69814384425eff217e34f2b2896d706e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"provider": "facebook",
"id": "211bb619d3946443da423d20bdce9932",
"name": "my custom social app",
"appid": "8422033f5e8170cc674588e79921ffce"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=8422033f5e8170cc674588e79921ffce&secret=69814384425eff217e34f2b2896d706e&format=xml
Query parameters
provider = facebook
name = my custom social app
appid = 8422033f5e8170cc674588e79921ffce
secret = 69814384425eff217e34f2b2896d706e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<provider>facebook</provider>
<id>211bb619d3946443da423d20bdce9932</id>
<name>my custom social app</name>
<appid>8422033f5e8170cc674588e79921ffce</appid>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=8422033f5e8170cc674588e79921ffce&secret=69814384425eff217e34f2b2896d706e&format=txt
Query parameters
provider = facebook
name = my custom social app
appid = 8422033f5e8170cc674588e79921ffce
secret = 69814384425eff217e34f2b2896d706e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_provider=facebook
result_id=211bb619d3946443da423d20bdce9932
result_name=my custom social app
result_appid=8422033f5e8170cc674588e79921ffce
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/add?provider=facebook&name=my+custom+social+app&appid=8422033f5e8170cc674588e79921ffce&secret=69814384425eff217e34f2b2896d706e&format=plain
Query parameters
provider = facebook
name = my custom social app
appid = 8422033f5e8170cc674588e79921ffce
secret = 69814384425eff217e34f2b2896d706e
format = plain
Response
facebook
211bb619d3946443da423d20bdce9932
my custom social app
8422033f5e8170cc674588e79921ffce
Required parameters
parameter | description | max length |
---|---|---|
appidSTRING | social app ID/Key/Client ID | 255 |
nameSTRING | name of the social app | 255 |
providerSTRING | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph | 50 |
secretSTRING | social app secret | 255 |
Return values
parameter | description |
---|---|
appid | social app ID/Key/Client ID |
id | ID of the social app |
name | name of the social app |
provider | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph |
/ctas/socialapps/count
access: [READ]
This method returns the number of defined social apps.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/count?format=plain
Query parameters
format = plain
Response
5
Example 5 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 8 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Optional parameters
parameter | description | max length |
---|---|---|
providerSTRING | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph | 50 |
searchSTRING | count items by searching them |
Return values
parameter | description |
---|---|
count | number of social apps the user has access to (filtered by search if passed) |
/ctas/socialapps/delete
access: [WRITE]
Delete a social app.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809
Query parameters
ids = 5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809&format=xml
Query parameters
ids = 5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>2</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809&format=txt
Query parameters
ids = 5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=2
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809&format=plain
Query parameters
ids = 5f138f5dcc9829cdfc34b22a60657c86,2614e403d7472d5251a73d10182b7809
format = plain
Response
2
Example 5 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32
Query parameters
ids = a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32&format=xml
Query parameters
ids = a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32&format=txt
Query parameters
ids = a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/delete?ids=a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32&format=plain
Query parameters
ids = a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17,96799779faf52d8243404d2169f80d32
format = plain
Response
a6b42821a5bc7422e45ee8770a886dcc,1166d143c6f30fa8b139fadef11a7f17
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of social app IDs to be deleted |
Optional parameters
parameter | description |
---|---|
confirmBOOLEAN | 1 to force the cancellation of social apps even if in use (default: 0) |
Return values
parameter | description |
---|---|
deleted | number of deleted social apps |
ids | [OPTIONAL] list of social app IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/ctas/socialapps/edit
access: [WRITE]
Edit a social app.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=e5f5cba646e2a314572c84f9e1d01d45
Query parameters
provider = facebook
name = social app name
appid = e5f5cba646e2a314572c84f9e1d01d45
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "46592ab6205a193cef927b21c4fcb98d",
"provider": "facebook",
"name": "social app name",
"appid": "e5f5cba646e2a314572c84f9e1d01d45"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=e5f5cba646e2a314572c84f9e1d01d45&format=xml
Query parameters
provider = facebook
name = social app name
appid = e5f5cba646e2a314572c84f9e1d01d45
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>46592ab6205a193cef927b21c4fcb98d</id>
<provider>facebook</provider>
<name>social app name</name>
<appid>e5f5cba646e2a314572c84f9e1d01d45</appid>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=e5f5cba646e2a314572c84f9e1d01d45&format=txt
Query parameters
provider = facebook
name = social app name
appid = e5f5cba646e2a314572c84f9e1d01d45
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=46592ab6205a193cef927b21c4fcb98d
result_provider=facebook
result_name=social app name
result_appid=e5f5cba646e2a314572c84f9e1d01d45
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/edit?provider=facebook&name=social+app+name&appid=e5f5cba646e2a314572c84f9e1d01d45&format=plain
Query parameters
provider = facebook
name = social app name
appid = e5f5cba646e2a314572c84f9e1d01d45
format = plain
Response
46592ab6205a193cef927b21c4fcb98d
facebook
social app name
e5f5cba646e2a314572c84f9e1d01d45
Required parameters
parameter | description |
---|---|
idID | ID of the social app |
Optional parameters
parameter | description | max length |
---|---|---|
appidSTRING | social app ID/Key/Client ID | 255 |
nameSTRING | name of the social app | 255 |
providerSTRING | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph | 50 |
secretSTRING | social app secret | 255 |
Return values
parameter | description |
---|---|
appid | social app ID/Key/Client ID |
id | ID of the social app |
name | name of the social app |
provider | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph |
/ctas/socialapps/info
access: [READ]
This method returns information on a social app.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/info?id=c46d7d75eb3af84d9d75d31584fbe6d2
Query parameters
id = c46d7d75eb3af84d9d75d31584fbe6d2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "c46d7d75eb3af84d9d75d31584fbe6d2",
"provider": "facebook",
"name": "this is my app name",
"appid": "c8fa7af50e16ed7e3a61e7658b248577"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/info?id=c46d7d75eb3af84d9d75d31584fbe6d2&format=xml
Query parameters
id = c46d7d75eb3af84d9d75d31584fbe6d2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>c46d7d75eb3af84d9d75d31584fbe6d2</id>
<provider>facebook</provider>
<name>this is my app name</name>
<appid>c8fa7af50e16ed7e3a61e7658b248577</appid>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/info?id=c46d7d75eb3af84d9d75d31584fbe6d2&format=txt
Query parameters
id = c46d7d75eb3af84d9d75d31584fbe6d2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=c46d7d75eb3af84d9d75d31584fbe6d2
result_provider=facebook
result_name=this is my app name
result_appid=c8fa7af50e16ed7e3a61e7658b248577
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/info?id=c46d7d75eb3af84d9d75d31584fbe6d2&format=plain
Query parameters
id = c46d7d75eb3af84d9d75d31584fbe6d2
format = plain
Response
c46d7d75eb3af84d9d75d31584fbe6d2
facebook
this is my app name
c8fa7af50e16ed7e3a61e7658b248577
Required parameters
parameter | description |
---|---|
idID | ID of the social app |
Return values
parameter | description |
---|---|
appid | social app ID/Key/Client ID |
id | ID of the social app |
name | name of the social app |
provider | name of the provider of the app, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph |
/ctas/socialapps/list
access: [READ]
This method returns a list of social apps.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": {
"id": "b25385905b4aea3b616e8d5e059bd7cd",
"provider": "facebook",
"name": "this is my app name",
"appid": "3802c415d9d14191828427477e500a91"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<id>b25385905b4aea3b616e8d5e059bd7cd</id>
<provider>facebook</provider>
<name>this is my app name</name>
<appid>3802c415d9d14191828427477e500a91</appid>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=b25385905b4aea3b616e8d5e059bd7cd
result_data_provider=facebook
result_data_name=this is my app name
result_data_appid=3802c415d9d14191828427477e500a91
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/list?format=plain
Query parameters
format = plain
Response
1
b25385905b4aea3b616e8d5e059bd7cd
facebook
this is my app name
3802c415d9d14191828427477e500a91
Optional parameters
parameter | description | max length |
---|---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) | |
orderbyARRAY | orders items by field, available fields: start, length, search, orderby, sort, provider, format, callback | |
providerSTRING | filter social apps by provider, available providers: google, facebook, twitter, linkedin, amazon, microsoftgraph | 50 |
searchSTRING | filters items to be extracted by searching them | |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order | |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of social apps |
data | array containing information on social apps the user has access to |
/ctas/socialapps/property
access: [READ]
Returns the supported social app providers.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/socialapps/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"providers": [
"amazon",
"facebook",
"google",
"linkedin",
"microsoftgraph",
"twitter"
]
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/socialapps/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<providers>
<i0>amazon</i0>
<i1>facebook</i1>
<i2>google</i2>
<i3>linkedin</i3>
<i4>microsoftgraph</i4>
<i5>twitter</i5>
</providers>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/socialapps/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_providers_0=amazon
result_data_providers_1=facebook
result_data_providers_2=google
result_data_providers_3=linkedin
result_data_providers_4=microsoftgraph
result_data_providers_5=twitter
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/socialapps/property?format=plain
Query parameters
format = plain
Response
amazon
facebook
google
linkedin
microsoftgraph
twitter
Return values
parameter | description |
---|---|
data | list of supported social apps |
/ctas/urls
/ctas/urls/count
access: [READ]
This method returns the number of user's urls related to a call to action.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/urls/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/urls/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/urls/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/urls/count?format=plain
Query parameters
format = plain
Response
2
Required parameters
parameter | description |
---|---|
cta_idID | ID of the CTA |
Optional parameters
parameter | description |
---|---|
searchSTRING | filters tracking pixels to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) tracking pixels |
/ctas/urls/list
access: [READ]
This method returns a list of user's urls data related to a call to action.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/urls/list?id=b95a9c278a7fe0196893935ed23c0453&fields=count,id,url_url
Query parameters
id = b95a9c278a7fe0196893935ed23c0453
fields = count,id,url_url
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"id": "5931715e1f10e0df05599b92c5bfdc59",
"url_url": "cdac6b2b"
},
{
"id": "9e85e3171c51bc6fb568fb37fd32aff0",
"url_url": "2677da37"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/urls/list?id=b95a9c278a7fe0196893935ed23c0453&fields=count,id,url_url&format=xml
Query parameters
id = b95a9c278a7fe0196893935ed23c0453
fields = count,id,url_url
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<id>5931715e1f10e0df05599b92c5bfdc59</id>
<url_url>cdac6b2b</url_url>
</i0>
<i1>
<id>9e85e3171c51bc6fb568fb37fd32aff0</id>
<url_url>2677da37</url_url>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/urls/list?id=b95a9c278a7fe0196893935ed23c0453&fields=count,id,url_url&format=txt
Query parameters
id = b95a9c278a7fe0196893935ed23c0453
fields = count,id,url_url
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=5931715e1f10e0df05599b92c5bfdc59
result_data_0_url_url=cdac6b2b
result_data_1_id=9e85e3171c51bc6fb568fb37fd32aff0
result_data_1_url_url=2677da37
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/urls/list?id=b95a9c278a7fe0196893935ed23c0453&fields=count,id,url_url&format=plain
Query parameters
id = b95a9c278a7fe0196893935ed23c0453
fields = count,id,url_url
format = plain
Response
2
5931715e1f10e0df05599b92c5bfdc59
cdac6b2b
9e85e3171c51bc6fb568fb37fd32aff0
2677da37
Required parameters
parameter | description |
---|---|
cta_idID | ID of the CTA |
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, url_url, short_url, url_creation, url, has_preview, domain_extended_name, domain_id, project_name, project_is_default, project_id |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of tracking links (maxmimum allowed: 100) |
orderbyARRAY | orders tracking links by field, available fields: id, url_url, short_url, url_creation, url, has_preview, domain_extended_name, domain_id, project_name, project_is_default, project_id |
searchSTRING | filters tracking links to be extracted by searching them |
sortSTRING | sorts tracking links in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract tracking links from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of tracking links, returned only if count is passed in fields |
data | array containing information on the tracking links, the returned information depends on the fields parameter. |
/ctas/webhooks
/ctas/webhooks/info
access: [READ]
This method return information on a webhook.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/webhooks/info?id=6e5a136c2d3d44e670d75f391a93a05b
Query parameters
id = 6e5a136c2d3d44e670d75f391a93a05b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "6e5a136c2d3d44e670d75f391a93a05b",
"url": "https:\/\/my.custom.webhook\/",
"type": "custom",
"info": [],
"notes": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/webhooks/info?id=6e5a136c2d3d44e670d75f391a93a05b&format=xml
Query parameters
id = 6e5a136c2d3d44e670d75f391a93a05b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>6e5a136c2d3d44e670d75f391a93a05b</id>
<url>https://my.custom.webhook/</url>
<type>custom</type>
<info>
</info>
<notes></notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/webhooks/info?id=6e5a136c2d3d44e670d75f391a93a05b&format=txt
Query parameters
id = 6e5a136c2d3d44e670d75f391a93a05b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=6e5a136c2d3d44e670d75f391a93a05b
result_url=https://my.custom.webhook/
result_type=custom
result_info=
result_notes=
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/webhooks/info?id=6e5a136c2d3d44e670d75f391a93a05b&format=plain
Query parameters
id = 6e5a136c2d3d44e670d75f391a93a05b
format = plain
Response
6e5a136c2d3d44e670d75f391a93a05b
https://my.custom.webhook/
custom
Required parameters
parameter | description |
---|---|
idID | ID of the CTA from which to remove the webhook |
Return values
parameter | description |
---|---|
id | echo back of the id input parameter |
info | extended info of the webhook |
notes | notes for the webhook |
type | webhook type, see i1/ctas/webhooks/property for details |
url | URL of the webhook |
/ctas/webhooks/property
access: [READ]
Return available webhook types and their parameters.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite
Query parameters
types = custom,zapier,mailerlite
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"custom": {
"name": "Custom webhook",
"private": 0,
"url_required": 1,
"info": {
"home": "https:\/\/joturl.zendesk.com\/hc\/en-us\/articles\/360012882199",
"logo": "data:image\/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg=="
},
"parameters": [
{
"name": "fields",
"type": "json",
"maxlength": 2000,
"description": "couples key\/values",
"mandatory": 0,
"example": "{\"source\":\"joturl\",\"test\":1}"
}
]
},
"mailerlite": {
"name": "MailerLite",
"private": 0,
"url_required": 0,
"info": {
"home": "https:\/\/www.mailerlite.com\/",
"logo": "https:\/\/www.mailerlite.com\/assets\/logo-color.png"
},
"parameters": [
{
"name": "apikey",
"type": "string",
"maxlength": 500,
"description": "MailerLite API key",
"documentation": "https:\/\/help.mailerlite.com\/article\/show\/35040-where-can-i-find-the-api-key",
"mandatory": 1,
"example": "8ec635c831f29c9818f2fa91c90dece7"
},
{
"name": "group",
"type": "string",
"maxlength": 500,
"description": "GroupID of the MailerLite group",
"documentation": "https:\/\/app.mailerlite.com\/subscribe\/api",
"mandatory": 1,
"example": "2013312623"
},
{
"name": "fields",
"type": "json",
"maxlength": 2000,
"description": "couples key\/values",
"mandatory": 0,
"example": "{\"source\":\"joturl\",\"test\":1}"
}
]
},
"zapier": {
"name": "Zapier",
"private": 1,
"url_required": 0,
"info": {
"home": "https:\/\/zapier.com\/",
"logo": "https:\/\/cdn.zapier.com\/zapier\/images\/logos\/zapier-logo.png"
},
"parameters": []
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=xml
Query parameters
types = custom,zapier,mailerlite
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<custom>
<name>Custom webhook</name>
<private>0</private>
<url_required>1</url_required>
<info>
<home>https://joturl.zendesk.com/hc/en-us/articles/360012882199</home>
<logo>data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==</logo>
</info>
<parameters>
<i0>
<name>fields</name>
<type>json</type>
<maxlength>2000</maxlength>
<description>couples key/values</description>
<mandatory>0</mandatory>
<example>{"source":"joturl","test":1}</example>
</i0>
</parameters>
</custom>
<mailerlite>
<name>MailerLite</name>
<private>0</private>
<url_required>0</url_required>
<info>
<home>https://www.mailerlite.com/</home>
<logo>https://www.mailerlite.com/assets/logo-color.png</logo>
</info>
<parameters>
<i0>
<name>apikey</name>
<type>string</type>
<maxlength>500</maxlength>
<description>MailerLite API key</description>
<documentation>https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key</documentation>
<mandatory>1</mandatory>
<example>8ec635c831f29c9818f2fa91c90dece7</example>
</i0>
<i1>
<name>group</name>
<type>string</type>
<maxlength>500</maxlength>
<description>GroupID of the MailerLite group</description>
<documentation>https://app.mailerlite.com/subscribe/api</documentation>
<mandatory>1</mandatory>
<example>2013312623</example>
</i1>
<i2>
<name>fields</name>
<type>json</type>
<maxlength>2000</maxlength>
<description>couples key/values</description>
<mandatory>0</mandatory>
<example>{"source":"joturl","test":1}</example>
</i2>
</parameters>
</mailerlite>
<zapier>
<name>Zapier</name>
<private>1</private>
<url_required>0</url_required>
<info>
<home>https://zapier.com/</home>
<logo>https://cdn.zapier.com/zapier/images/logos/zapier-logo.png</logo>
</info>
<parameters>
</parameters>
</zapier>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=txt
Query parameters
types = custom,zapier,mailerlite
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_custom_name=Custom webhook
result_data_custom_private=0
result_data_custom_url_required=1
result_data_custom_info_home=https://joturl.zendesk.com/hc/en-us/articles/360012882199
result_data_custom_info_logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
result_data_custom_parameters_0_name=fields
result_data_custom_parameters_0_type=json
result_data_custom_parameters_0_maxlength=2000
result_data_custom_parameters_0_description=couples key/values
result_data_custom_parameters_0_mandatory=0
result_data_custom_parameters_0_example={"source":"joturl","test":1}
result_data_mailerlite_name=MailerLite
result_data_mailerlite_private=0
result_data_mailerlite_url_required=0
result_data_mailerlite_info_home=https://www.mailerlite.com/
result_data_mailerlite_info_logo=https://www.mailerlite.com/assets/logo-color.png
result_data_mailerlite_parameters_0_name=apikey
result_data_mailerlite_parameters_0_type=string
result_data_mailerlite_parameters_0_maxlength=500
result_data_mailerlite_parameters_0_description=MailerLite API key
result_data_mailerlite_parameters_0_documentation=https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key
result_data_mailerlite_parameters_0_mandatory=1
result_data_mailerlite_parameters_0_example=8ec635c831f29c9818f2fa91c90dece7
result_data_mailerlite_parameters_1_name=group
result_data_mailerlite_parameters_1_type=string
result_data_mailerlite_parameters_1_maxlength=500
result_data_mailerlite_parameters_1_description=GroupID of the MailerLite group
result_data_mailerlite_parameters_1_documentation=https://app.mailerlite.com/subscribe/api
result_data_mailerlite_parameters_1_mandatory=1
result_data_mailerlite_parameters_1_example=2013312623
result_data_mailerlite_parameters_2_name=fields
result_data_mailerlite_parameters_2_type=json
result_data_mailerlite_parameters_2_maxlength=2000
result_data_mailerlite_parameters_2_description=couples key/values
result_data_mailerlite_parameters_2_mandatory=0
result_data_mailerlite_parameters_2_example={"source":"joturl","test":1}
result_data_zapier_name=Zapier
result_data_zapier_private=1
result_data_zapier_url_required=0
result_data_zapier_info_home=https://zapier.com/
result_data_zapier_info_logo=https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
result_data_zapier_parameters=
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/webhooks/property?types=custom,zapier,mailerlite&format=plain
Query parameters
types = custom,zapier,mailerlite
format = plain
Response
Custom webhook
0
1
https://joturl.zendesk.com/hc/en-us/articles/360012882199
data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
MailerLite
0
0
https://www.mailerlite.com/
https://www.mailerlite.com/assets/logo-color.png
apikey
string
500
MailerLite API key
https://help.mailerlite.com/article/show/35040-where-can-i-find-the-api-key
1
8ec635c831f29c9818f2fa91c90dece7
group
string
500
GroupID of the MailerLite group
https://app.mailerlite.com/subscribe/api
1
2013312623
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
Zapier
1
0
https://zapier.com/
https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
Optional parameters
parameter | description |
---|---|
typesSTRING | comma-separated list of webhook types to be returned, if empty all types are returned, available types: activecampaign , custom , drift , getresponse , hubspot , mailchimp , mailerlite , mailjet , mautic , moosend , sendinblue , zapier |
Return values
parameter | description |
---|---|
data | array containing information on webhook parameters by type |
/ctas/webhooks/subscribe
access: [WRITE]
This method add a webhook subscription to a CTA.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/webhooks/subscribe?id=98265f11025a2f755c50a9a4bb6b3055&url=https%3A%2F%2Fjoturl.com%2F
Query parameters
id = 98265f11025a2f755c50a9a4bb6b3055
url = https://joturl.com/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/webhooks/subscribe?id=98265f11025a2f755c50a9a4bb6b3055&url=https%3A%2F%2Fjoturl.com%2F&format=xml
Query parameters
id = 98265f11025a2f755c50a9a4bb6b3055
url = https://joturl.com/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/webhooks/subscribe?id=98265f11025a2f755c50a9a4bb6b3055&url=https%3A%2F%2Fjoturl.com%2F&format=txt
Query parameters
id = 98265f11025a2f755c50a9a4bb6b3055
url = https://joturl.com/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/webhooks/subscribe?id=98265f11025a2f755c50a9a4bb6b3055&url=https%3A%2F%2Fjoturl.com%2F&format=plain
Query parameters
id = 98265f11025a2f755c50a9a4bb6b3055
url = https://joturl.com/
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the CTA to which to add the webhook |
typeSTRING | webhook type, allowed types: activecampaign , custom , drift , getresponse , hubspot , mailchimp , mailerlite , mailjet , mautic , moosend , sendinblue , zapier |
Optional parameters
parameter | description | max length |
---|---|---|
infoJSON | info to be used with the webhook (e.g., an API key), see below for details | |
notesSTRING | notes for the webhook | 4000 |
unsubscribeBOOLEAN | 1 to unsubscribe from the current webhook (if any) and subscribe to the new one | |
urlSTRING | URL of the webhook, required for types: custom , zapier | 4000 |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/ctas/webhooks/test
access: [WRITE]
This endpoint sends test data to a CTA webhook.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/webhooks/test?id=b1158da1962d17b44a0f7b59a735e6a0
Query parameters
id = b1158da1962d17b44a0f7b59a735e6a0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ok": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/webhooks/test?id=b1158da1962d17b44a0f7b59a735e6a0&format=xml
Query parameters
id = b1158da1962d17b44a0f7b59a735e6a0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ok>1</ok>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/webhooks/test?id=b1158da1962d17b44a0f7b59a735e6a0&format=txt
Query parameters
id = b1158da1962d17b44a0f7b59a735e6a0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/webhooks/test?id=b1158da1962d17b44a0f7b59a735e6a0&format=plain
Query parameters
id = b1158da1962d17b44a0f7b59a735e6a0
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the CTA associated with the webhook |
Return values
parameter | description |
---|---|
ok | 1 on success, otherwise an error is returned |
/ctas/webhooks/unsubscribe
access: [WRITE]
This method removes a webhook subscription to a CTA.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=1138a8cf5ec6927059b99487dfaf9e95
Query parameters
id = 1138a8cf5ec6927059b99487dfaf9e95
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"removed": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=1138a8cf5ec6927059b99487dfaf9e95&format=xml
Query parameters
id = 1138a8cf5ec6927059b99487dfaf9e95
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<removed>1</removed>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=1138a8cf5ec6927059b99487dfaf9e95&format=txt
Query parameters
id = 1138a8cf5ec6927059b99487dfaf9e95
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_removed=1
Example 4 (plain)
Request
https://joturl.com/a/i1/ctas/webhooks/unsubscribe?id=1138a8cf5ec6927059b99487dfaf9e95&format=plain
Query parameters
id = 1138a8cf5ec6927059b99487dfaf9e95
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the CTA from which to remove the webhook |
Return values
parameter | description |
---|---|
removed | 1 on success, 0 otherwise |
/currencies
/currencies/info
access: [READ]
This method returns a list of available currencies.
Example 1 (json)
Request
https://joturl.com/a/i1/currencies/info?id=3b0b7fcfdb035312711b74de3c8eec2d
Query parameters
id = 3b0b7fcfdb035312711b74de3c8eec2d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "3b0b7fcfdb035312711b74de3c8eec2d",
"code": "EUR",
"sign": "€"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/currencies/info?id=3b0b7fcfdb035312711b74de3c8eec2d&format=xml
Query parameters
id = 3b0b7fcfdb035312711b74de3c8eec2d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>3b0b7fcfdb035312711b74de3c8eec2d</id>
<code>EUR</code>
<sign><[CDATA[&euro;]]></sign>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/currencies/info?id=3b0b7fcfdb035312711b74de3c8eec2d&format=txt
Query parameters
id = 3b0b7fcfdb035312711b74de3c8eec2d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=3b0b7fcfdb035312711b74de3c8eec2d
result_data_0_code=EUR
result_data_0_sign=&euro;
Example 4 (plain)
Request
https://joturl.com/a/i1/currencies/info?id=3b0b7fcfdb035312711b74de3c8eec2d&format=plain
Query parameters
id = 3b0b7fcfdb035312711b74de3c8eec2d
format = plain
Response
3b0b7fcfdb035312711b74de3c8eec2d
EUR
&euro;
Required parameters
parameter | description |
---|---|
idID | ID of the currency |
Return values
parameter | description |
---|---|
data | information on the specified currency |
/currencies/list
access: [READ]
This method returns a list of available currencies.
Example 1 (json)
Request
https://joturl.com/a/i1/currencies/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "42b2278b6d9a9eda6f7f5e5a5aab95da",
"code": "EUR",
"sign": "€"
},
{
"id": "2319d1375e67eb35ed65c45894c27ab6",
"code": "USD",
"sign": "$"
},
{
"id": "8f5186cf1b13d666c5f40e40d04661b4",
"code": "GBP",
"sign": "£"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/currencies/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>42b2278b6d9a9eda6f7f5e5a5aab95da</id>
<code>EUR</code>
<sign><[CDATA[&euro;]]></sign>
</i0>
<i1>
<id>2319d1375e67eb35ed65c45894c27ab6</id>
<code>USD</code>
<sign>$</sign>
</i1>
<i2>
<id>8f5186cf1b13d666c5f40e40d04661b4</id>
<code>GBP</code>
<sign><[CDATA[&pound;]]></sign>
</i2>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/currencies/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=42b2278b6d9a9eda6f7f5e5a5aab95da
result_data_0_code=EUR
result_data_0_sign=&euro;
result_data_1_id=2319d1375e67eb35ed65c45894c27ab6
result_data_1_code=USD
result_data_1_sign=$
result_data_2_id=8f5186cf1b13d666c5f40e40d04661b4
result_data_2_code=GBP
result_data_2_sign=&pound;
Example 4 (plain)
Request
https://joturl.com/a/i1/currencies/list?format=plain
Query parameters
format = plain
Response
42b2278b6d9a9eda6f7f5e5a5aab95da
EUR
&euro;
2319d1375e67eb35ed65c45894c27ab6
USD
$
8f5186cf1b13d666c5f40e40d04661b4
GBP
&pound;
Return values
parameter | description |
---|---|
data | information on the specified currency |
/domains
/domains/add
access: [WRITE]
Add a domain for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
favicon_url = https://path.to/fav/icon
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1234567890abcdef",
"force_https": "0",
"host": "domain.ext",
"nickname": "my domain nickname",
"redirect_url": "https:\/\/redirect.users.to\/",
"favicon_url": "https:\/\/path.to\/fav\/icon",
"logo": "data:image\/gif;base64,R0lGODlhAQABAIAAAAAAAP\/\/\/yH5BAEAAAAALAAAAAABAAEAAAIBRAA7",
"deeplink_id": "",
"domain_domains_deeplink_name": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=xml
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
favicon_url = https://path.to/fav/icon
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1234567890abcdef</id>
<force_https>0</force_https>
<host>domain.ext</host>
<nickname>my domain nickname</nickname>
<redirect_url>https://redirect.users.to/</redirect_url>
<favicon_url>https://path.to/fav/icon</favicon_url>
<logo>data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7</logo>
<deeplink_id></deeplink_id>
<domain_domains_deeplink_name></domain_domains_deeplink_name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=txt
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
favicon_url = https://path.to/fav/icon
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_force_https=0
result_host=domain.ext
result_nickname=my domain nickname
result_redirect_url=https://redirect.users.to/
result_favicon_url=https://path.to/fav/icon
result_logo=data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
result_deeplink_id=
result_domain_domains_deeplink_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/add?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&favicon_url=https%3A%2F%2Fpath.to%2Ffav%2Ficon&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=plain
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
favicon_url = https://path.to/fav/icon
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = plain
Response
1234567890abcdef
0
domain.ext
my domain nickname
https://redirect.users.to/
https://path.to/fav/icon
data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
Required parameters
parameter | description | max length |
---|---|---|
hostSTRING | domain to add (e.g., domain.ext) | 850 |
Optional parameters
parameter | description | max length |
---|---|---|
deeplink_idID | ID of the deep link configuration | |
favicon_urlSTRING | the default favicon URL for the branded domain (to avoid securiy issues it must be HTTPS) | 4000 |
forceBOOLEAN | 1 to disable security checks, 0 otherwise. This parameter is ignored if force_https = 1 | |
force_httpsBOOLEAN | 1 to force HTTPS on HTTP requests, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain) | |
inputSTRING | name of the HTML form field that contains image data for the logo (max dimensions 120px x 50px , max size 150kB ), see notes for details | 255 |
nicknameSTRING | the domain nickname | 50 |
redirect_urlSTRING | the default destination URL where to redirect when a user types the domain without any alias (or an invalid alias) | 4000 |
robots_txtSTRING | the robots.txt content to serve for the domain, when robots_txt = :NONE: requests to robots.txt will return a 404 error, if empty the following robots.txt will be served:user-agent: * | 4000 |
NOTES: The parameter input contains the name of the field of the HTML form that is used to send logo data to this method. Form must have
enctype = "multipart/form-data"
andmethod = "post"
.
<form
action="/a/i1/domains/add"
method="post"
enctype="multipart/form-data">
<input name="input" value="logo" type="hidden"/>
[other form fields]
<input name="logo" type="file"/>
</form>
Return values
parameter | description |
---|---|
deeplink_id | ID of the deep link configuration |
deeplink_name | NA |
favicon_url | default favicon URL |
force_https | 1 if the HTTPS is forced for the domain, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain) |
host | the domain that was just added |
id | ID of the added domain |
logo | default logo for the domain (base64 encoded) |
nickname | the domain nickname |
redirect_url | default redirect URL |
robots_txt | the robots.txt content to serve for the domain |
/domains/certificates
/domains/certificates/acmes
/domains/certificates/acmes/domains/cert
access: [WRITE]
This method creates or renews an SSL certificate for a domain.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=8f9bc234c8138c632a5931d2bc9ef279
Query parameters
domain_id = 8f9bc234c8138c632a5931d2bc9ef279
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"created": 1,
"private_key": "-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----",
"csr": "-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----",
"cert": "-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----",
"cert_fingerprint": "9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264",
"cert_valid_from": "2025-05-11T13:18:49",
"cert_valid_to": "2025-08-09T13:18:49",
"intermediate": "-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=8f9bc234c8138c632a5931d2bc9ef279&format=xml
Query parameters
domain_id = 8f9bc234c8138c632a5931d2bc9ef279
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<created>1</created>
<private_key>-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----</private_key>
<csr>-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----</csr>
<cert>-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----</cert>
<cert_fingerprint>9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264</cert_fingerprint>
<cert_valid_from>2025-05-11T13:18:49</cert_valid_from>
<cert_valid_to>2025-08-09T13:18:49</cert_valid_to>
<intermediate>-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----</intermediate>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=8f9bc234c8138c632a5931d2bc9ef279&format=txt
Query parameters
domain_id = 8f9bc234c8138c632a5931d2bc9ef279
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_created=1
result_private_key=-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----
result_csr=-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----
result_cert=-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
result_cert_fingerprint=9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264
result_cert_valid_from=2025-05-11T13:18:49
result_cert_valid_to=2025-08-09T13:18:49
result_intermediate=-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/cert?domain_id=8f9bc234c8138c632a5931d2bc9ef279&format=plain
Query parameters
domain_id = 8f9bc234c8138c632a5931d2bc9ef279
format = plain
Response
1
-----BEGIN PRIVATE KEY-----[BASE64-ENCODED INFO]-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE REQUEST-----[BASE64-ENCODED INFO]-----END CERTIFICATE REQUEST-----
-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
9B5BDE73B0B3604B66688BB1092B0BB0DE2FD264
2025-05-11T13:18:49
2025-08-09T13:18:49
-----BEGIN CERTIFICATE-----[BASE64-ENCODED INFO]-----END CERTIFICATE-----
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain for which the SSL certificate is asked |
Return values
parameter | description |
---|---|
cert | domain SSL certificate (PEM format) |
cert_fingerprint | fingerprint of the SSL certificate |
cert_valid_from | SSL certificate is valid from this date |
cert_valid_to | SSL certificate is valid up to this date, usually the certificate expires 90 days after the cert_valid_from date; see <a href="https://letsencrypt.org/docs/faq/">the Let's Encrypt FAQ</a> for details |
created | 1 on success, 0 otherwise |
csr | certificate signing request (CSR) for the doamin (PEM format) |
intermediate | domain intermediate certificate(s) (PEM format) |
private_key | domain private key (PEM format) |
/domains/certificates/acmes/domains/install
access: [WRITE]
This method installs an SSL certificate for a domain.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=a3bcb4a05b7f890637cbc6769ee8f94d
Query parameters
domain_id = a3bcb4a05b7f890637cbc6769ee8f94d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"installed": 1,
"host": "jo.my",
"cn": "jo.my",
"certificate_domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
"domains": "jo.my, www.jo.my",
"fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
"id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
"valid_from": "2018-01-23 14:58:37",
"valid_to": "2018-04-23 14:58:37",
"issuer": "JotUrl S.r.l."
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=a3bcb4a05b7f890637cbc6769ee8f94d&format=xml
Query parameters
domain_id = a3bcb4a05b7f890637cbc6769ee8f94d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<installed>1</installed>
<host>jo.my</host>
<cn>jo.my</cn>
<certificate_domain_id>6e666877484257716e798888484252472b645a4a49518d8d</certificate_domain_id>
<domains>jo.my, www.jo.my</domains>
<fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>
<id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>
<valid_from>2018-01-23 14:58:37</valid_from>
<valid_to>2018-04-23 14:58:37</valid_to>
<issuer>JotUrl S.r.l.</issuer>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=a3bcb4a05b7f890637cbc6769ee8f94d&format=txt
Query parameters
domain_id = a3bcb4a05b7f890637cbc6769ee8f94d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_installed=1
result_host=jo.my
result_cn=jo.my
result_certificate_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_domains=jo.my, www.jo.my
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_issuer=JotUrl S.r.l.
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/install?domain_id=a3bcb4a05b7f890637cbc6769ee8f94d&format=plain
Query parameters
domain_id = a3bcb4a05b7f890637cbc6769ee8f94d
format = plain
Response
1
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain for which the SSL certificate has to be installed |
Return values
parameter | description |
---|---|
certificate_domain_id | ID of the domain the certificate belongs to |
cn | common name of the certificate |
domains | comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext") |
fingerprint | fingerprint of the certificate |
host | domain the certificate belongs to |
id | ID of the certificate |
installed | 1 on success, 0 otherwise |
issuer | the certificate issuer |
valid_from | the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04) |
valid_to | the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04) |
/domains/certificates/acmes/domains/revoke
access: [WRITE]
This method revokes an SSL certificate for a domain.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=493af7508b5879e72fc1fc92471f94f3
Query parameters
domain_id = 493af7508b5879e72fc1fc92471f94f3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"revoked": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=493af7508b5879e72fc1fc92471f94f3&format=xml
Query parameters
domain_id = 493af7508b5879e72fc1fc92471f94f3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<revoked>0</revoked>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=493af7508b5879e72fc1fc92471f94f3&format=txt
Query parameters
domain_id = 493af7508b5879e72fc1fc92471f94f3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_revoked=0
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/revoke?domain_id=493af7508b5879e72fc1fc92471f94f3&format=plain
Query parameters
domain_id = 493af7508b5879e72fc1fc92471f94f3
format = plain
Response
0
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain for which the SSL certificate should be revoked |
Return values
parameter | description |
---|---|
revoked | 1 on success, 0 otherwise |
/domains/certificates/acmes/domains/validate
access: [WRITE]
This method validates a domain. You have to validate a domain before creating an SSL certificate.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=c4a1006c8299bf66ffc5b4bce55f6d77
Query parameters
domain_id = c4a1006c8299bf66ffc5b4bce55f6d77
Response
{
"status": "valid"
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=c4a1006c8299bf66ffc5b4bce55f6d77&format=xml
Query parameters
domain_id = c4a1006c8299bf66ffc5b4bce55f6d77
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>valid</status>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=c4a1006c8299bf66ffc5b4bce55f6d77&format=txt
Query parameters
domain_id = c4a1006c8299bf66ffc5b4bce55f6d77
format = txt
Response
status=valid
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/domains/validate?domain_id=c4a1006c8299bf66ffc5b4bce55f6d77&format=plain
Query parameters
domain_id = c4a1006c8299bf66ffc5b4bce55f6d77
format = plain
Response
valid
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain to validate |
Optional parameters
parameter | description |
---|---|
include_www_subdomainBOOLEAN | 1 if the WWW subdomain should be asked, 0 otherwise |
Return values
parameter | description |
---|---|
domains | list of available domains in the certificate |
status | status of the validation request; call this method until a valid status is returned or a timeout of 30 seconds occurs. If the validation fails, you have to wait at least 30 minutes before retrying [unknown|pending|valid] |
/domains/certificates/acmes/users/deactivate
access: [WRITE]
This method deactivates a user on the Let's Encrypt ACME server.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deactivated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deactivated>1</deactivated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deactivated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/deactivate?format=plain
Query parameters
format = plain
Response
1
Return values
parameter | description |
---|---|
deactivated | 1 on success, 0 otherwise |
/domains/certificates/acmes/users/generatekey
access: [WRITE]
This method generates an RSA key for the user, this key have to be used with all operations on the Let's Encrypt ACME server.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"generated": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<generated>0</generated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_generated=0
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/generatekey?format=plain
Query parameters
format = plain
Response
0
Return values
parameter | description |
---|---|
generated | 1 on success, 0 otherwise |
/domains/certificates/acmes/users/register
access: [WRITE]
This method registers a user on the Let's Encrypt ACME server.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/register
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"registered": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<registered>1</registered>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_registered=1
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/acmes/users/register?format=plain
Query parameters
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
agreementSTRING | links to the Let's Encrypt agreement. Registration on Let's Encrypt ACME server requires two steps; in the first one you have to call this method without parameters, it will return an agreement link and the security parameter nonce, that the user must explicitely approve the agreement; in the second step, you have to call this method with parameters agreement and nonce set to the values returned by the previous call |
forceBOOLEAN | 1 if the registration process have to be forced (overwriting old values), 0 otherwise |
nonceID | a random security string to be used during the registration process |
Return values
parameter | description |
---|---|
agreement | [OPTIONAL] returned only if agreement is needed (agreement is only in English) |
nonce | [OPTIONAL] returned only if agreement is needed |
registered | 1 on success, 0 otherwise |
/domains/certificates/add
access: [WRITE]
This method allows to upload a certificate for a specific domain.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
cert_files_type = pfx
input_pfx_archive = [pfx_file]
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"host": "jo.my",
"id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
"fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
"valid_from": "2018-01-23 14:58:37",
"valid_to": "2018-04-23 14:58:37",
"cn": "jo.my",
"domains": "jo.my, www.jo.my"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=xml
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
cert_files_type = pfx
input_pfx_archive = [pfx_file]
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<host>jo.my</host>
<id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>
<fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>
<valid_from>2018-01-23 14:58:37</valid_from>
<valid_to>2018-04-23 14:58:37</valid_to>
<cn>jo.my</cn>
<domains>jo.my, www.jo.my</domains>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=txt
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
cert_files_type = pfx
input_pfx_archive = [pfx_file]
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_host=jo.my
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_cn=jo.my
result_domains=jo.my, www.jo.my
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/add?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&cert_files_type=pfx&input_pfx_archive=%5Bpfx_file%5D&format=plain
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
cert_files_type = pfx
input_pfx_archive = [pfx_file]
format = plain
Response
jo.my
69785a4b2f7676744c5a4759642f67524561584b58778d8d
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
2018-01-23 14:58:37
2018-04-23 14:58:37
jo.my
jo.my, www.jo.my
Required parameters
parameter | description |
---|---|
cert_files_typeSTRING | this parameter must be pfx or cert_files , according to the certificate files |
domain_idID | ID of the domain the certificate belongs to |
Optional parameters
parameter | description |
---|---|
input_ca_certificate1STRING | name of the HTML form field that is used to transfer the ca certificate #1 data, see notes for details |
input_ca_certificate2STRING | name of the HTML form field that is used to transfer the ca certificate #2 data, see notes for details |
input_ca_certificate3STRING | name of the HTML form field that is used to transfer the ca certificate #2 data, see notes for details |
input_certificateSTRING | name of the HTML form field that is used to transfer the certificate data, mandatory if cert_files_type = cert_files , see notes for details |
input_pfx_archiveSTRING | name of the HTML form field that is used to transfer the PFX data, mandatory if cert_files_type = pfx , see notes for details |
input_private_keySTRING | name of the HTML form field that is used to transfer the private key data, mandatory if cert_files_type = cert_files , see notes for details |
pfx_passwordHTML | password of the PFX archive, mandatory if cert_files_type = pfx and the PFX archive is protected by a password |
NOTES: Parameters starting with input_ are the names of the field of the HTML form used to send data to this method. Form must have
enctype = "multipart/form-data"
andmethod = "post"
.
<form
action="/a/i1/domains/certificates/add"
method="post"
enctype="multipart/form-data">
<input name="input_pfx_archive" value="pfx_file" type="hidden"/>
<input name="input_private_key" value="private_key_file" type="hidden"/>
<input name="input_certificate" value="certificate_file" type="hidden"/>
<input name="input_ca_certificate1" value="certificate1_file" type="hidden"/>
<input name="input_ca_certificate2" value="certificate2_file" type="hidden"/>
<input name="input_ca_certificate3" value="certificate3_file" type="hidden"/>
[other form fields]
<input name="pfx_file" type="file"/>
<input name="private_key_file" type="file"/>
<input name="certificate_file" type="file"/>
<input name="certificate1_file" type="file"/>
<input name="certificate2_file" type="file"/>
<input name="certificate3_file" type="file"/>
</form>
Return values
parameter | description |
---|---|
cn | common name of the certificate |
domain_id | ID of the domain the certificate belongs to |
domains | comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext") |
fingerprint | fingerprint of the certificate |
host | domain the certificate belongs to |
id | ID of the certificate |
valid_from | the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04) |
valid_to | the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04) |
/domains/certificates/count
access: [READ]
This method returns number of certificates associated to a specific domain.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/count?format=plain
Query parameters
format = plain
Response
3
Optional parameters
parameter | description |
---|---|
domain_idID | filters certificates for this domain ID |
searchSTRING | count items by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) certificates |
/domains/certificates/csr
/domains/certificates/csr/create
access: [WRITE]
This method allows to create a Certificate Signing Request (CSR).
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US
Query parameters
commonName = domain.ext
organizationName = My Company
organizationalUnitName = accounting
localityName = Los Angeles
stateOrProvinceName = California
countryName = US
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"private_key": "-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq
0\/vm\/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMml
HMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rh
nZNOCM2+NeKvZxN0ZUXTRn2Ed\/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykE
PP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC\/TyDZT2J8Q+w5SEMVylehHNd\/8b5
l3f7NhIW50eIZsmY0xgfpV1wsHUp\/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEV
TqdTl05\/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh\/hD
xyg0pFqTY4Vq48co5q9pG0wWEt\/cN\/73jbnSpIIjgjo+gU8M7UWYzlUk\/9uRVbLC
7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzX
ZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGL
AGjkfMdErAHGK2k\/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZ
sGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOm
YPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q
4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3y
tbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F\/wlkZk2aNHKATu1GZhYKhpGUbhC
vPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVF
K6hpQu7x8hZ1yuehpW3azhm98\/eV7bW48SMcvHl6CGEffGnpQrJ\/ou52mYMhS3Ga
UglUmQGybHkCgYEAm5OsL1P\/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT
9ZZuwbDDfgYBr\/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9Hkf
kteB03tGGZAA7qHy\/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+\/pI9hiCYvcCgYBf
9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM\/eBk\/72FwF+X9OtxWo8J4f6h2
yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53
Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga\/hpw
qGoJ8bl5gab0U\/1u9sXdbMKqeyyaFjXo\/RaLdSOG9y4UFJP\/2JMeTh1FRCWaN7rK
6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc\/zK1OZfUZmOLV+3
yZDE4U3\/Zkgx7gSM\/Ffxw\/62
-----END PRIVATE KEY-----
",
"csr": "-----BEGIN CERTIFICATE REQUEST-----
MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWEx
FDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYD
VQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2\/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3IS
EzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h\/NkAgoe
y8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9
hHfwk+rRg1LgrFyAaEcM\/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0\/ZGN1
rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf\/G+Zd3+zYSFudHiGbJmNMYH6Vd
cLB1Kf6Eb8jYEaIPgegp5kbgG\/es5l3\/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJ
KoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5\/Qa+kCFzsVDpEaJOuc
2GujOYydNTwFpsQCcVdW\/LR1mbsiS2CVTMTP+VrppiC\/XIJ0btlXeRNzLZdQ9UaX
xBgj46J79oYxXkIpnskcms3SsrKGnK\/Q1bnus0jpvTlji9DnZglQt9QvzePF15As
QCERgitEUTRKzxvYjozq\/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7
XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9
S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=
-----END CERTIFICATE REQUEST-----
"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=xml
Query parameters
commonName = domain.ext
organizationName = My Company
organizationalUnitName = accounting
localityName = Los Angeles
stateOrProvinceName = California
countryName = US
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<private_key>-----BEGIN PRIVATE KEY-----
MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq
0/vm/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMml
HMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rh
nZNOCM2+NeKvZxN0ZUXTRn2Ed/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykE
PP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC/TyDZT2J8Q+w5SEMVylehHNd/8b5
l3f7NhIW50eIZsmY0xgfpV1wsHUp/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEV
TqdTl05/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh/hD
xyg0pFqTY4Vq48co5q9pG0wWEt/cN/73jbnSpIIjgjo+gU8M7UWYzlUk/9uRVbLC
7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzX
ZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGL
AGjkfMdErAHGK2k/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZ
sGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOm
YPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q
4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3y
tbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F/wlkZk2aNHKATu1GZhYKhpGUbhC
vPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVF
K6hpQu7x8hZ1yuehpW3azhm98/eV7bW48SMcvHl6CGEffGnpQrJ/ou52mYMhS3Ga
UglUmQGybHkCgYEAm5OsL1P/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT
9ZZuwbDDfgYBr/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9Hkf
kteB03tGGZAA7qHy/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+/pI9hiCYvcCgYBf
9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM/eBk/72FwF+X9OtxWo8J4f6h2
yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53
Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga/hpw
qGoJ8bl5gab0U/1u9sXdbMKqeyyaFjXo/RaLdSOG9y4UFJP/2JMeTh1FRCWaN7rK
6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc/zK1OZfUZmOLV+3
yZDE4U3/Zkgx7gSM/Ffxw/62
-----END PRIVATE KEY-----
</private_key>
<csr>-----BEGIN CERTIFICATE REQUEST-----
MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWEx
FDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYD
VQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3IS
EzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h/NkAgoe
y8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9
hHfwk+rRg1LgrFyAaEcM/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0/ZGN1
rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf/G+Zd3+zYSFudHiGbJmNMYH6Vd
cLB1Kf6Eb8jYEaIPgegp5kbgG/es5l3/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJ
KoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5/Qa+kCFzsVDpEaJOuc
2GujOYydNTwFpsQCcVdW/LR1mbsiS2CVTMTP+VrppiC/XIJ0btlXeRNzLZdQ9UaX
xBgj46J79oYxXkIpnskcms3SsrKGnK/Q1bnus0jpvTlji9DnZglQt9QvzePF15As
QCERgitEUTRKzxvYjozq/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7
XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9
S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=
-----END CERTIFICATE REQUEST-----
</csr>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=txt
Query parameters
commonName = domain.ext
organizationName = My Company
organizationalUnitName = accounting
localityName = Los Angeles
stateOrProvinceName = California
countryName = US
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_private_key=-----BEGIN PRIVATE KEY-----MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq0/vm/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMmlHMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rhnZNOCM2+NeKvZxN0ZUXTRn2Ed/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykEPP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC/TyDZT2J8Q+w5SEMVylehHNd/8b5l3f7NhIW50eIZsmY0xgfpV1wsHUp/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEVTqdTl05/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh/hDxyg0pFqTY4Vq48co5q9pG0wWEt/cN/73jbnSpIIjgjo+gU8M7UWYzlUk/9uRVbLC7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzXZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGLAGjkfMdErAHGK2k/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZsGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOmYPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3ytbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F/wlkZk2aNHKATu1GZhYKhpGUbhCvPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVFK6hpQu7x8hZ1yuehpW3azhm98/eV7bW48SMcvHl6CGEffGnpQrJ/ou52mYMhS3GaUglUmQGybHkCgYEAm5OsL1P/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT9ZZuwbDDfgYBr/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9HkfkteB03tGGZAA7qHy/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+/pI9hiCYvcCgYBf9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM/eBk/72FwF+X9OtxWo8J4f6h2yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga/hpwqGoJ8bl5gab0U/1u9sXdbMKqeyyaFjXo/RaLdSOG9y4UFJP/2JMeTh1FRCWaN7rK6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc/zK1OZfUZmOLV+3yZDE4U3/Zkgx7gSM/Ffxw/62-----END PRIVATE KEY-----
result_csr=-----BEGIN CERTIFICATE REQUEST-----MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExFDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYDVQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3ISEzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h/NkAgoey8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9hHfwk+rRg1LgrFyAaEcM/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0/ZGN1rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf/G+Zd3+zYSFudHiGbJmNMYH6VdcLB1Kf6Eb8jYEaIPgegp5kbgG/es5l3/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJKoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5/Qa+kCFzsVDpEaJOuc2GujOYydNTwFpsQCcVdW/LR1mbsiS2CVTMTP+VrppiC/XIJ0btlXeRNzLZdQ9UaXxBgj46J79oYxXkIpnskcms3SsrKGnK/Q1bnus0jpvTlji9DnZglQt9QvzePF15AsQCERgitEUTRKzxvYjozq/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=-----END CERTIFICATE REQUEST-----
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/csr/create?commonName=domain.ext&organizationName=My+Company&organizationalUnitName=accounting&localityName=Los+Angeles&stateOrProvinceName=California&countryName=US&format=plain
Query parameters
commonName = domain.ext
organizationName = My Company
organizationalUnitName = accounting
localityName = Los Angeles
stateOrProvinceName = California
countryName = US
format = plain
Response
-----BEGIN PRIVATE KEY-----MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDb8gTFlUVgqoPq0/vm/oUo0k9wW2vBpUp3chITNgjMXki05yGMNYCJR7uHCfd0XzVWOi4D7DJMIMmlHMOCVgjnei8FgniH82QCCh7LxHEAscCts32XWjQ9d4datLOrMGwDopj7W62vE+rhnZNOCM2+NeKvZxN0ZUXTRn2Ed/CT6tGDUuCsXIBoRwz8p47phewY4ge3xWmoaykEPP2yVpd1oe5dlliGPT9kY3WuQYHiZ+TakmcC/TyDZT2J8Q+w5SEMVylehHNd/8b5l3f7NhIW50eIZsmY0xgfpV1wsHUp/oRvyNgRog+B6CnmRuAb96zmXf8HrmnzKQEVTqdTl05/AgMBAAECggEBAIF2g7iJlLzBocSn4q6lQlw07u2D4nmpgZutWVZVh/hDxyg0pFqTY4Vq48co5q9pG0wWEt/cN/73jbnSpIIjgjo+gU8M7UWYzlUk/9uRVbLC7ldQP6zHO9iycsnBc8BgUDQTkVjjLejQIIGM7xgPtosvzK7STXFF60PhSiCfOMzXZAJguRmHXWeXHhRLNdXknKrPdRwRz6ra8+K0DHwVjTvqHugO2QYZIZQ7fxaf+RGLAGjkfMdErAHGK2k/3KZKipXqMCrGgCNn1X4sonfQH1Bjx9PyTL+VD6OAeMUw1HDZsGo6MI4oH7GsIf0LkDXPqI0NjwYO93PR7qTzpAcqBwECgYEA7fPrDzrh8V01xEOmYPhI5RZiXgQ7l2BR1zFOzlxhNbrJZrheX6pgP9otPk4DTDtHJP4DGkC1D3x62b3Q4sbPq4qDPp3pdlyNNXNbOSjPtFTxKrZB5e8ShVIj9ZfVBgJ1j3N2u97ru1tRGD3ytbfUo4bIGXgJDDmBSerwi9vw5LcCgYEA7KB4F/wlkZk2aNHKATu1GZhYKhpGUbhCvPmiKlgsvvI5FPTeWVf5MO5b41+ctjoN1iIubRDYc+mYcAMNV6oCcmzFwTP6lYVFK6hpQu7x8hZ1yuehpW3azhm98/eV7bW48SMcvHl6CGEffGnpQrJ/ou52mYMhS3GaUglUmQGybHkCgYEAm5OsL1P/YBDiU4UrpiEPgADnpbK8x5dpSvppHRFXWYrbnXaT9ZZuwbDDfgYBr/jd5jjSDHscJpjrtauehHcaVn0EnI8gkoumo7jdfvzI+I3E9HkfkteB03tGGZAA7qHy/SywB9uTYvcsiV4Pb3JW6+f2snhB6iU6+/pI9hiCYvcCgYBf9V9eUqmllt1iupjR0TXK8GXohQk5QKEH47AoveM/eBk/72FwF+X9OtxWo8J4f6h2yxvKrQcqUnO4EPTLNS2S25uCkyKumgIIB17Qfvfs9cDFDRQXcypFZFkM472QTZ53Y4bWw+iCF2jeWlD29E4gc9XywSOyZZpwZEpDVlXV+QKBgAqhOA5YI3WpVJga/hpwqGoJ8bl5gab0U/1u9sXdbMKqeyyaFjXo/RaLdSOG9y4UFJP/2JMeTh1FRCWaN7rK6xTT2rrdExqjIXZTtXXFqo9A6wYQ3EWxVBWfmyG7JY08Lwuoc/zK1OZfUZmOLV+3yZDE4U3/Zkgx7gSM/Ffxw/62-----END PRIVATE KEY-----
-----BEGIN CERTIFICATE REQUEST-----MIICvDCCAaQCAQAwdzELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExFDASBgNVBAcMC0xvcyBBbmdlbGVzMRMwEQYDVQQKDApNeSBDb21wYW55MRMwEQYDVQQLDAphY2NvdW50aW5nMRMwEQYDVQQDDApkb21haW4uZXh0MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA2/IExZVFYKqD6tP75v6FKNJPcFtrwaVKd3ISEzYIzF5ItOchjDWAiUe7hwn3dF81VjouA+wyTCDJpRzDglYI53ovBYJ4h/NkAgoey8RxALHArbN9l1o0PXeHWrSzqzBsA6KY+1utrxPq4Z2TTgjNvjXir2cTdGVF00Z9hHfwk+rRg1LgrFyAaEcM/KeO6YXsGOIHt8VpqGspBDz9slaXdaHuXZZYhj0/ZGN1rkGB4mfk2pJnAv08g2U9ifEPsOUhDFcpXoRzXf/G+Zd3+zYSFudHiGbJmNMYH6VdcLB1Kf6Eb8jYEaIPgegp5kbgG/es5l3/B65p8ykBFU6nU5dOfwIDAQABoAAwDQYJKoZIhvcNAQELBQADggEBACTnkScHIA5aZ4vgrIFsrETfT5/Qa+kCFzsVDpEaJOuc2GujOYydNTwFpsQCcVdW/LR1mbsiS2CVTMTP+VrppiC/XIJ0btlXeRNzLZdQ9UaXxBgj46J79oYxXkIpnskcms3SsrKGnK/Q1bnus0jpvTlji9DnZglQt9QvzePF15AsQCERgitEUTRKzxvYjozq/LChtBbNsg5R3uXZyAVGSgn3X+ZF4P4FCd1cEfLfnHq7XM9eWSo8pWz0VPd9rF4D9kbZ4A9gGHGoZ+abghqFULmJ3iLcQkp+NkmMTncsCvW9S+WspMDNbVzLxWeBZQ5gMHDgSBdBLFlnHhCT0kYes+s=-----END CERTIFICATE REQUEST-----
Required parameters
parameter | description |
---|---|
commonNameSTRING | the Fully Qualified Domain Name (FQDN) for which you are requesting the SSL Certificate, it must contain domain you are requesting a certifacate for (e.g., domain.ext, *.domain.ext) |
countryNameSTRING | 2-digit code of the country (ISO Alpha-2) the company is based on (e.g., US) |
localityNameSTRING | the full name of the locality the company is based on (e.g., Los Angeles) |
organizationNameSTRING | the full legal company or personal name, as legally registered, that is requesting the certificate (e.g., My Company) |
organizationalUnitNameSTRING | whichever branch of the company is ordering the certificate (e.g., accounting, marketing) |
stateOrProvinceNameSTRING | the full name of the state or province the company is based on (e.g., California) |
Return values
parameter | description |
---|---|
csr | Certificate request (CSR) |
private_key | Private key |
/domains/certificates/delete
access: [WRITE]
This method deletes a certificate.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=3000
Query parameters
id = 3000
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=xml
Query parameters
id = 3000
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=txt
Query parameters
id = 3000
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=3000&format=plain
Query parameters
id = 3000
format = plain
Response
1
Example 5 (json)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=100000
Query parameters
id = 100000
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 0
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=xml
Query parameters
id = 100000
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>0</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=txt
Query parameters
id = 100000
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=0
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/certificates/delete?id=100000&format=plain
Query parameters
id = 100000
format = plain
Response
0
Required parameters
parameter | description |
---|---|
idID | ID of the certificate to delete |
Return values
parameter | description |
---|---|
deleted | 1 if the delete successes, 0 otherwise |
/domains/certificates/info
access: [READ]
This method returns information about a certificate. Required information can be passed by using fields.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
Query parameters
id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"host": "jo.my",
"cn": "jo.my",
"domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
"domains": "jo.my, www.jo.my",
"fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
"id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
"valid_from": "2018-01-23 14:58:37",
"valid_to": "2018-04-23 14:58:37",
"installed": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=xml
Query parameters
id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<host>jo.my</host>
<cn>jo.my</cn>
<domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>
<domains>jo.my, www.jo.my</domains>
<fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>
<id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>
<valid_from>2018-01-23 14:58:37</valid_from>
<valid_to>2018-04-23 14:58:37</valid_to>
<installed>0</installed>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=txt
Query parameters
id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_host=jo.my
result_cn=jo.my
result_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_domains=jo.my, www.jo.my
result_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_valid_from=2018-01-23 14:58:37
result_valid_to=2018-04-23 14:58:37
result_installed=0
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/info?id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed&format=plain
Query parameters
id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed
format = plain
Response
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed |
idID | ID of the certificate |
Return values
parameter | description |
---|---|
cn | common name of the certificate |
domain_id | ID of the domain the certificate belongs to |
domains | comma separated list of domains covered by the certificate (e.g., "domain.ext, www.domain.ext") |
fingerprint | fingerprint of the certificate |
host | domain the certificate belongs to |
id | ID of the certificate |
installed | propagation percentage of the certificate installation (e.g. 12.34%, 100%) |
valid_from | the certificate is valid from this dat, can be in the future (e.g., 2018-05-30 13:38:04) |
valid_to | the certificate is valid up to this date, can be in the past (e.g., 2020-05-29 13:38:04) |
/domains/certificates/list
access: [READ]
This method returns the certificates associated to the logged users.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
Query parameters
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"host": "jo.my",
"cn": "jo.my",
"domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
"domains": "jo.my, www.jo.my",
"fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
"id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
"valid_from": "2018-01-23 14:58:37",
"valid_to": "2018-04-23 14:58:37",
"issuer": "JotUrl S.r.l.",
"installed": 0
},
{
"host": "joturl.com",
"cn": "*.joturl.com",
"domain_id": "544a5451745446616542676449497450686f425446414d4d",
"domains": "*.joturl.com, joturl.com",
"fingerprint": "51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB",
"id": "54576e66564a74412b70596c577175424968715464414d4d",
"valid_from": "2017-04-06 00:00:00",
"valid_to": "2028-04-20 23:59:59",
"issuer": "JotUrl S.r.l.",
"installed": 100
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=xml
Query parameters
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<host>jo.my</host>
<cn>jo.my</cn>
<domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>
<domains>jo.my, www.jo.my</domains>
<fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>
<id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>
<valid_from>2018-01-23 14:58:37</valid_from>
<valid_to>2018-04-23 14:58:37</valid_to>
<issuer>JotUrl S.r.l.</issuer>
<installed>0</installed>
</i0>
<i1>
<host>joturl.com</host>
<cn>*.joturl.com</cn>
<domain_id>544a5451745446616542676449497450686f425446414d4d</domain_id>
<domains>*.joturl.com, joturl.com</domains>
<fingerprint>51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB</fingerprint>
<id>54576e66564a74412b70596c577175424968715464414d4d</id>
<valid_from>2017-04-06 00:00:00</valid_from>
<valid_to>2028-04-20 23:59:59</valid_to>
<issuer>JotUrl S.r.l.</issuer>
<installed>100</installed>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=txt
Query parameters
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_host=jo.my
result_data_0_cn=jo.my
result_data_0_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_data_0_domains=jo.my, www.jo.my
result_data_0_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_data_0_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_data_0_valid_from=2018-01-23 14:58:37
result_data_0_valid_to=2018-04-23 14:58:37
result_data_0_issuer=JotUrl S.r.l.
result_data_0_installed=0
result_data_1_host=joturl.com
result_data_1_cn=*.joturl.com
result_data_1_domain_id=544a5451745446616542676449497450686f425446414d4d
result_data_1_domains=*.joturl.com, joturl.com
result_data_1_fingerprint=51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB
result_data_1_id=54576e66564a74412b70596c577175424968715464414d4d
result_data_1_valid_from=2017-04-06 00:00:00
result_data_1_valid_to=2028-04-20 23:59:59
result_data_1_issuer=JotUrl S.r.l.
result_data_1_installed=100
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/certificates/list?fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=plain
Query parameters
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = plain
Response
2
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.
0
joturl.com
*.joturl.com
544a5451745446616542676449497450686f425446414d4d
*.joturl.com, joturl.com
51D012A79F7B9FAB1DE55015CDE19E448CBD7EDB
54576e66564a74412b70596c577175424968715464414d4d
2017-04-06 00:00:00
2028-04-20 23:59:59
JotUrl S.r.l.
100
Example 5 (json)
Request
https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"host": "jo.my",
"cn": "jo.my",
"domain_id": "6e666877484257716e798888484252472b645a4a49518d8d",
"domains": "jo.my, www.jo.my",
"fingerprint": "6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265",
"id": "69785a4b2f7676744c5a4759642f67524561584b58778d8d",
"valid_from": "2018-01-23 14:58:37",
"valid_to": "2018-04-23 14:58:37",
"issuer": "JotUrl S.r.l.",
"installed": 0
}
]
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=xml
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<host>jo.my</host>
<cn>jo.my</cn>
<domain_id>6e666877484257716e798888484252472b645a4a49518d8d</domain_id>
<domains>jo.my, www.jo.my</domains>
<fingerprint>6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265</fingerprint>
<id>69785a4b2f7676744c5a4759642f67524561584b58778d8d</id>
<valid_from>2018-01-23 14:58:37</valid_from>
<valid_to>2018-04-23 14:58:37</valid_to>
<issuer>JotUrl S.r.l.</issuer>
<installed>0</installed>
</i0>
</data>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=txt
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_host=jo.my
result_data_0_cn=jo.my
result_data_0_domain_id=6e666877484257716e798888484252472b645a4a49518d8d
result_data_0_domains=jo.my, www.jo.my
result_data_0_fingerprint=6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
result_data_0_id=69785a4b2f7676744c5a4759642f67524561584b58778d8d
result_data_0_valid_from=2018-01-23 14:58:37
result_data_0_valid_to=2018-04-23 14:58:37
result_data_0_issuer=JotUrl S.r.l.
result_data_0_installed=0
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/certificates/list?domain_id=6e666877484257716e798888484252472b645a4a49518d8d&fields=deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer&format=plain
Query parameters
domain_id = 6e666877484257716e798888484252472b645a4a49518d8d
fields = deeplink_id,host,for_trials,force_https,domain_domain_id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,cn,domain_id,domains,fingerprint,id,valid_from,valid_to,deeplink_name,installed,count,issuer
format = plain
Response
1
jo.my
jo.my
6e666877484257716e798888484252472b645a4a49518d8d
jo.my, www.jo.my
6A5ACE78B0B5604B66688AA5092B0BA0CE2FD265
69785a4b2f7676744c5a4759642f67524561584b58778d8d
2018-01-23 14:58:37
2018-04-23 14:58:37
JotUrl S.r.l.
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed, count, issuer |
Optional parameters
parameter | description |
---|---|
domain_idID | filters certificates for this domain ID |
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: deeplink_id, host, for_trials, force_https, domain_domain_id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, cn, domain_id, domains, fingerprint, id, valid_from, valid_to, deeplink_name, installed, count, issuer |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of (filtered) certificates, returned only if count is passed in fields |
data | array containing required information on certificates |
/domains/count
access: [READ]
This method returns the number of user's domains.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/count?format=plain
Query parameters
format = plain
Response
5
Example 5 (json)
Request
https://joturl.com/a/i1/domains/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Optional parameters
parameter | description |
---|---|
is_defaultBOOLEAN | if 1 this method counts only the default domain |
is_ownerBOOLEAN | if 1 this method counts only domains owned by the logged user, if 0 it returns only shared domains |
searchSTRING | count items by searching them |
Return values
parameter | description |
---|---|
count | number of domains the user has access to (filtered by search if passed) |
/domains/deeplinks
/domains/deeplinks/add
access: [WRITE]
Add a deep link configuration for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1234567890abcdef",
"name": "deep configuration domain_name",
"android": "[
{
\"relation\": [
\"delegate_permission\/common.handle_all_urls\"
],
\"target\": {
\"namespace\": \"android_app\",
\"package_name\": \"com.example.app\",
\"sha256_cert_fingerprints\": [
\"hash_of_app_certificate\"
]
}
}
]",
"ios": "{
\"applinks\": {
\"apps\": [],
\"details\": [
{
\"appID\": \"D3KQX62K1A.com.example.photoapp\",
\"paths\": [
\"\/albums\"
]
},
{
\"appID\": \"D3KQX62K1A.com.example.videoapp\",
\"paths\": [
\"\/videos\"
]
}
]
}
}"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=xml
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1234567890abcdef</id>
<name>deep configuration domain_name</name>
<android>[
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]</android>
<ios>{
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}</ios>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=txt
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=deep configuration domain_name
result_android=[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
result_ios={ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/add?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=plain
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = plain
Response
1234567890abcdef
deep configuration domain_name
[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
{ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Required parameters
parameter | description |
---|---|
nameSTRING | domain_name of the deep link configuration |
Optional parameters
parameter | description | max length |
---|---|---|
androidSTRING | JSON configuration for Android (assetlinks.json) | 4000 |
iosSTRING | JSON configuration for iOS (apple-app-site-association) | 4000 |
Return values
parameter | description |
---|---|
android | JSON configuration for Android (assetlinks.json) |
id | ID of the deep link configuration |
ios | JSON configuration for iOS (apple-app-site-association) |
name | domain_name of the deep link configuration |
/domains/deeplinks/count
access: [READ]
This method returns the number of user's deep link configurations.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/count?format=plain
Query parameters
format = plain
Response
5
Example 5 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Optional parameters
parameter | description |
---|---|
searchSTRING | count items by searching them |
Return values
parameter | description |
---|---|
count | number of deep link configurations the user has access to (filtered by search if passed) |
/domains/deeplinks/delete
access: [WRITE]
Delete a deep link configuration for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000
Query parameters
ids = 10,200,3000
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=xml
Query parameters
ids = 10,200,3000
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=txt
Query parameters
ids = 10,200,3000
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=10,200,3000&format=plain
Query parameters
ids = 10,200,3000
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000
Query parameters
ids = 4000,50000,100000
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "50000,100000",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=xml
Query parameters
ids = 4000,50000,100000
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>50000,100000</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=txt
Query parameters
ids = 4000,50000,100000
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=50000,100000
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/delete?ids=4000,50000,100000&format=plain
Query parameters
ids = 4000,50000,100000
format = plain
Response
50000,100000
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of domain IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted domains |
ids | [OPTIONAL] list of domain IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/domains/deeplinks/edit
access: [WRITE]
Edit a deep link configuration for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1234567890abcdef",
"name": "deep configuration domain_name",
"android": "[
{
\"relation\": [
\"delegate_permission\/common.handle_all_urls\"
],
\"target\": {
\"namespace\": \"android_app\",
\"package_name\": \"com.example.app\",
\"sha256_cert_fingerprints\": [
\"hash_of_app_certificate\"
]
}
}
]",
"ios": "{
\"applinks\": {
\"apps\": [],
\"details\": [
{
\"appID\": \"D3KQX62K1A.com.example.photoapp\",
\"paths\": [
\"\/albums\"
]
},
{
\"appID\": \"D3KQX62K1A.com.example.videoapp\",
\"paths\": [
\"\/videos\"
]
}
]
}
}"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=xml
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1234567890abcdef</id>
<name>deep configuration domain_name</name>
<android>[
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]</android>
<ios>{
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}</ios>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=txt
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=deep configuration domain_name
result_android=[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
result_ios={ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/edit?name=deep+configuration+domain_name&android=%5B%0A++++%7B%0A++++++++%22relation%22%3A+%5B%0A++++++++++++%22delegate_permission%2Fcommon.handle_all_urls%22%0A++++++++%5D,%0A++++++++%22target%22%3A+%7B%0A++++++++++++%22namespace%22%3A+%22android_app%22,%0A++++++++++++%22package_name%22%3A+%22com.example.app%22,%0A++++++++++++%22sha256_cert_fingerprints%22%3A+%5B%0A++++++++++++++++%22hash_of_app_certificate%22%0A++++++++++++%5D%0A++++++++%7D%0A++++%7D%0A%5D&ios=%7B%0A++++%22applinks%22%3A+%7B%0A++++++++%22apps%22%3A+%5B%5D,%0A++++++++%22details%22%3A+%5B%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.photoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Falbums%22%0A++++++++++++++++%5D%0A++++++++++++%7D,%0A++++++++++++%7B%0A++++++++++++++++%22appID%22%3A+%22D3KQX62K1A.com.example.videoapp%22,%0A++++++++++++++++%22paths%22%3A+%5B%0A++++++++++++++++++++%22%2Fvideos%22%0A++++++++++++++++%5D%0A++++++++++++%7D%0A++++++++%5D%0A++++%7D%0A%7D&format=plain
Query parameters
name = deep configuration domain_name
android = [
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]
ios = {
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}
format = plain
Response
1234567890abcdef
deep configuration domain_name
[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
{ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Required parameters
parameter | description |
---|---|
idID | ID of the deep link configuration |
Optional parameters
parameter | description | max length |
---|---|---|
androidSTRING | JSON configuration for Android (assetlinks.json) | 4000 |
iosSTRING | JSON configuration for iOS (apple-app-site-association) | 4000 |
nameSTRING | domain_name of the deep link configuration |
Return values
parameter | description |
---|---|
android | JSON configuration for Android (assetlinks.json) |
id | ID of the deep link configuration |
ios | JSON configuration for iOS (apple-app-site-association) |
name | domain_name of the deep link configuration |
/domains/deeplinks/info
access: [READ]
This method returns information on a deep link configuration.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef
Query parameters
id = 1234567890abcdef
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1234567890abcdef",
"name": "this is my domain_name",
"android": "[
{
\"relation\": [
\"delegate_permission\/common.handle_all_urls\"
],
\"target\": {
\"namespace\": \"android_app\",
\"package_name\": \"com.example.app\",
\"sha256_cert_fingerprints\": [
\"hash_of_app_certificate\"
]
}
}
]",
"ios": "{
\"applinks\": {
\"apps\": [],
\"details\": [
{
\"appID\": \"D3KQX62K1A.com.example.photoapp\",
\"paths\": [
\"\/albums\"
]
},
{
\"appID\": \"D3KQX62K1A.com.example.videoapp\",
\"paths\": [
\"\/videos\"
]
}
]
}
}"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=xml
Query parameters
id = 1234567890abcdef
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1234567890abcdef</id>
<name>this is my domain_name</name>
<android>[
{
"relation": [
"delegate_permission/common.handle_all_urls"
],
"target": {
"namespace": "android_app",
"package_name": "com.example.app",
"sha256_cert_fingerprints": [
"hash_of_app_certificate"
]
}
}
]</android>
<ios>{
"applinks": {
"apps": [],
"details": [
{
"appID": "D3KQX62K1A.com.example.photoapp",
"paths": [
"/albums"
]
},
{
"appID": "D3KQX62K1A.com.example.videoapp",
"paths": [
"/videos"
]
}
]
}
}</ios>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=txt
Query parameters
id = 1234567890abcdef
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_name=this is my domain_name
result_android=[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
result_ios={ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/info?id=1234567890abcdef&format=plain
Query parameters
id = 1234567890abcdef
format = plain
Response
1234567890abcdef
this is my domain_name
[ { "relation": [ "delegate_permission/common.handle_all_urls" ], "target": { "namespace": "android_app", "package_name": "com.example.app", "sha256_cert_fingerprints": [ "hash_of_app_certificate" ] } }]
{ "applinks": { "apps": [], "details": [ { "appID": "D3KQX62K1A.com.example.photoapp", "paths": [ "/albums" ] }, { "appID": "D3KQX62K1A.com.example.videoapp", "paths": [ "/videos" ] } ] }}
Required parameters
parameter | description |
---|---|
idID | ID of the deep link configuration |
Return values
parameter | description |
---|---|
android | JSON configuration for Android (assetlinks.json) |
id | ID of the deep link configuration |
ios | JSON configuration for iOS (apple-app-site-association) |
name | domain_name of the deep link configuration |
/domains/deeplinks/list
access: [READ]
This method returns a list of deeplink configurations.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/deeplinks/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": {
"id": "1234567890abcdef",
"name": "this is my domain_name",
"android": "[{\"relation\":[\"delegate_permission\/common.handle_all_urls\"],\"target\":{\"namespace\":\"android_app\",\"package_name\":\"com.example.app\",\"sha256_cert_fingerprints\":[\"hash_of_app_certificate\"]}}]",
"ios": "{\"applinks\":{\"apps\":[],\"details\":[{\"appID\":\"D3KQX62K1A.com.example.photoapp\",\"paths\":[\"\/albums\"]},{\"appID\":\"D3KQX62K1A.com.example.videoapp\",\"paths\":[\"\/videos\"]}]}}"
},
"android": "",
"ios": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/deeplinks/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<id>1234567890abcdef</id>
<name>this is my domain_name</name>
<android>[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]</android>
<ios>{"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}</ios>
</data>
<android></android>
<ios></ios>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/deeplinks/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_id=1234567890abcdef
result_data_name=this is my domain_name
result_data_android=[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]
result_data_ios={"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}
result_android=
result_ios=
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/deeplinks/list?format=plain
Query parameters
format = plain
Response
1
1234567890abcdef
this is my domain_name
[{"relation":["delegate_permission/common.handle_all_urls"],"target":{"namespace":"android_app","package_name":"com.example.app","sha256_cert_fingerprints":["hash_of_app_certificate"]}}]
{"applinks":{"apps":[],"details":[{"appID":"D3KQX62K1A.com.example.photoapp","paths":["/albums"]},{"appID":"D3KQX62K1A.com.example.videoapp","paths":["/videos"]}]}}
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: start, length, search, orderby, sort, format, callback |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of deep link configurations |
data | array containing information on deep link configurations the user has access to |
/domains/delete
access: [WRITE]
Delete a domain for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
Query parameters
ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=xml
Query parameters
ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=txt
Query parameters
ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/delete?ids=6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc&format=plain
Query parameters
ids = 6512bd43d9caa6e02c990b0a82652dca,757b505cfd34c64c85ca5b5690ee5293,908c9a564a86426585b29f5335b619bc
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
Query parameters
ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=xml
Query parameters
ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=txt
Query parameters
ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/delete?ids=ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143&format=plain
Query parameters
ids = ffc58105bf6f8a91aba0fa2d99e6f106,334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
format = plain
Response
334146de1b9346272cb013adf1a35aea,e2a6a1ace352668000aed191a817d143
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of domain IDs to be deleted, max number of IDs in the list: 100 |
Return values
parameter | description |
---|---|
deleted | number of deleted domains |
ids | [OPTIONAL] list of domain IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/domains/edit
access: [WRITE]
Edit a domain for logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1234567890abcdef",
"force_https": "0",
"host": "domain.ext",
"nickname": "my domain nickname",
"redirect_url": "https:\/\/redirect.users.to\/",
"logo": "data:image\/gif;base64,R0lGODlhAQABAIAAAAAAAP\/\/\/yH5BAEAAAAALAAAAAABAAEAAAIBRAA7",
"deeplink_id": "",
"domain_domains_deeplink_name": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=xml
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1234567890abcdef</id>
<force_https>0</force_https>
<host>domain.ext</host>
<nickname>my domain nickname</nickname>
<redirect_url>https://redirect.users.to/</redirect_url>
<logo>data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7</logo>
<deeplink_id></deeplink_id>
<domain_domains_deeplink_name></domain_domains_deeplink_name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=txt
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1234567890abcdef
result_force_https=0
result_host=domain.ext
result_nickname=my domain nickname
result_redirect_url=https://redirect.users.to/
result_logo=data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
result_deeplink_id=
result_domain_domains_deeplink_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/edit?id=1234567890abcdef&force_https=0&host=domain.ext&nickname=my+domain+nickname&redirect_url=https%3A%2F%2Fredirect.users.to%2F&deeplink_id=&domain_domains_deeplink_name=&input=name_of_the_form_field_that_contains_image_data&format=plain
Query parameters
id = 1234567890abcdef
force_https = 0
host = domain.ext
nickname = my domain nickname
redirect_url = https://redirect.users.to/
deeplink_id =
domain_domains_deeplink_name =
input = name_of_the_form_field_that_contains_image_data
format = plain
Response
1234567890abcdef
0
domain.ext
my domain nickname
https://redirect.users.to/
data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7
Required parameters
parameter | description |
---|---|
idID | ID of the domain to edit |
Optional parameters
parameter | description | max length |
---|---|---|
confirm_host_changeBOOLEAN | must be 1 if host is passed to confirm the intention to change the domain, its value is ignored if host is not passed | |
deeplink_idID | ID of the deep link configuration | |
favicon_urlSTRING | the default favicon URL for the branded domain (to avoid securiy issues it must be HTTPS) | 4000 |
forceBOOLEAN | 1 to disable security checks, 0 otherwise. This parameter is ignored if host is not passed or if force_https = 1 | |
force_httpsBOOLEAN | 1 to force HTTPS on HTTP requests, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain) | |
hostSTRING | the new domain (e.g., new.domain.ext), changing the domain impacts all tracking links to which it is associated, tracking links with the old domain will stop working; additionally, the change may take up to 24 hours before it actually takes effect and any SSL certificates associated with the old domain will be invalidated | 850 |
inputSTRING | name of the HTML form field that contains image data for the logo (max dimensions 120px x 50px , max size 150kB ), see notes for details | |
nicknameSTRING | the domain nickname | 50 |
redirect_urlSTRING | the default destination URL where to redirect when a user types the domain without any alias (or an invalid alias) | 4000 |
robots_txtSTRING | the robots.txt content to serve for the domain, when robots_txt = :NONE: requests to robots.txt will return a 404 error, if empty the following robots.txt will be served:user-agent: * | 4000 |
NOTES: The parameter input contains the name of the field of the HTML form that is used to send logo data to this method. Form must have
enctype = "multipart/form-data"
andmethod = "post"
.
<form
action="/a/i1/domains/edit"
method="post"
enctype="multipart/form-data">
<input name="input" value="logo" type="hidden"/>
[other form fields]
<input name="logo" type="file"/>
</form>
Return values
parameter | description |
---|---|
deeplink_id | ID of the deep link configuration |
deeplink_name | name of the associated deep link configuration |
favicon_url | default favicon URL |
force_https | 1 if the HTTPS is forced for the domain, 0 otherwise (this flag takes effect only if a valid SSL certificate is associated with the domain) |
host | the domain (e.g., domain.ext) |
id | ID of the domain |
logo | default logo for the domain (base64 encoded) |
nickname | the domain nickname |
redirect_url | default redirect URL |
robots_txt | the robots.txt content to serve for the domain |
/domains/info
access: [READ]
This method returns information on a domain, the returned information are that passed in the fields param (a comma separated list).
Example 1 (json)
Request
https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
Query parameters
id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"host": "domain.ext",
"id": "7155502b34434f6a4d52396464684d3874442b454b773d3d",
"aliases": [
"domainext"
],
"logo": "",
"redirect_url": "",
"favicon_url": "",
"is_owner": 1,
"is_default": 1,
"is_shared": 0,
"for_trials": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=xml
Query parameters
id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<host>domain.ext</host>
<id>7155502b34434f6a4d52396464684d3874442b454b773d3d</id>
<aliases>
<i0>domainext</i0>
</aliases>
<logo></logo>
<redirect_url></redirect_url>
<favicon_url></favicon_url>
<is_owner>1</is_owner>
<is_default>1</is_default>
<is_shared>0</is_shared>
<for_trials>0</for_trials>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=txt
Query parameters
id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_host=domain.ext
result_id=7155502b34434f6a4d52396464684d3874442b454b773d3d
result_aliases_0=domainext
result_logo=
result_redirect_url=
result_favicon_url=
result_is_owner=1
result_is_default=1
result_is_shared=0
result_for_trials=0
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/info?id=123145155&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared&format=plain
Query parameters
id = 123145155
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared
format = plain
Response
domain.ext
7155502b34434f6a4d52396464684d3874442b454b773d3d
domainext
1
1
0
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared |
idID | ID of the domain |
Return values
parameter | description |
---|---|
aliases | [OPTIONAL] array containing aliases of the domain, i.e., equivalent domains, returned only if aliases is passed in fields |
deeplink_id | [OPTIONAL] ID of the deep link configuration, returned only if deeplink_id is passed in fields |
deeplink_name | [OPTIONAL] ID of the deep link configuration, returned only if deeplink_name is passed in fields |
favicon_url | [OPTIONAL] default favicon URL, returned only if favicon_url is passed in fields |
for_trials | [OPTIONAL] 1 if the domain is reserved to trial plans, 0 otherwise |
force_https | [OPTIONAL] 1 if the "force HTTPS" flag is enabled for the domain, 0 otherwise; returned only if force_https is passed in fields |
has_https | [OPTIONAL] 1 if the domain has a valid SSL certificate, 0 otherwise, returned only if has_https is passed in fields |
host | [OPTIONAL] domain (e.g., domain.ext), returned only if host is passed in fields |
id | [OPTIONAL] ID of the domain, returned only if id is passed in fields |
is_default | [OPTIONAL] 1 if the domain is the default domain set in user's settings, 0 otherwise, returned only if is_default is passed in fields |
is_owner | [OPTIONAL] 1 if the logged user is owner of the domain, 0 otherwise, returned only if is_owner is passed in fields |
is_shared | [OPTIONAL] 1 if the domain is shared among all users, 0 otherwise, returned only if is_shared is passed in fields |
logo | [OPTIONAL] default logo (base64 encoded), returned only if logo is passed in fields |
nickname | [OPTIONAL] the domain nickname |
redirect_url | [OPTIONAL] default redirect URL, returned only if redirect_url is passed in fields |
robots_txt | [OPTIONAL] robots.txt configuration, see i1/domains/add for details |
/domains/list
access: [READ]
This method returns a list of domains's data, specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/list?fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
Query parameters
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"host": "domain.ext",
"id": "7155502b34434f6a4d52396464684d3874442b454b773d3d",
"aliases": [
"domainext"
],
"logo": "",
"redirect_url": "",
"favicon_url": "",
"is_owner": 1,
"is_default": 1
},
{
"host": "global.domain",
"id": "15135ea",
"aliases": [
"globaldomain"
],
"logo": "",
"redirect_url": "https:\/\/www.redirect.to\/",
"favicon_url": "",
"is_owner": 0,
"is_default": 0
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/list?fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=xml
Query parameters
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<host>domain.ext</host>
<id>7155502b34434f6a4d52396464684d3874442b454b773d3d</id>
<aliases>
<i0>domainext</i0>
</aliases>
<logo></logo>
<redirect_url></redirect_url>
<favicon_url></favicon_url>
<is_owner>1</is_owner>
<is_default>1</is_default>
</i0>
<i1>
<host>global.domain</host>
<id>15135ea</id>
<aliases>
<i0>globaldomain</i0>
</aliases>
<logo></logo>
<redirect_url>https://www.redirect.to/</redirect_url>
<favicon_url></favicon_url>
<is_owner>0</is_owner>
<is_default>0</is_default>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/list?fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=txt
Query parameters
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_host=domain.ext
result_data_0_id=7155502b34434f6a4d52396464684d3874442b454b773d3d
result_data_0_aliases_0=domainext
result_data_0_logo=
result_data_0_redirect_url=
result_data_0_favicon_url=
result_data_0_is_owner=1
result_data_0_is_default=1
result_data_1_host=global.domain
result_data_1_id=15135ea
result_data_1_aliases_0=globaldomain
result_data_1_logo=
result_data_1_redirect_url=https://www.redirect.to/
result_data_1_favicon_url=
result_data_1_is_owner=0
result_data_1_is_default=0
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/list?fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=plain
Query parameters
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = plain
Response
domain.ext
7155502b34434f6a4d52396464684d3874442b454b773d3d
domainext
1
1
global.domain
15135ea
globaldomain
https://www.redirect.to/
0
0
Example 5 (json)
Request
https://joturl.com/a/i1/domains/list?is_owner=1&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
Query parameters
is_owner = 1
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"host": "domain.ext",
"id": "7155502b34434f6a4d52396464684d3874442b454b773d3d",
"aliases": [
"domainext"
],
"logo": "",
"redirect_url": "",
"favicon_url": "",
"is_owner": 1,
"is_default": 1
}
]
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/domains/list?is_owner=1&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=xml
Query parameters
is_owner = 1
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<host>domain.ext</host>
<id>7155502b34434f6a4d52396464684d3874442b454b773d3d</id>
<aliases>
<i0>domainext</i0>
</aliases>
<logo></logo>
<redirect_url></redirect_url>
<favicon_url></favicon_url>
<is_owner>1</is_owner>
<is_default>1</is_default>
</i0>
</data>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/domains/list?is_owner=1&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=txt
Query parameters
is_owner = 1
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_host=domain.ext
result_data_0_id=7155502b34434f6a4d52396464684d3874442b454b773d3d
result_data_0_aliases_0=domainext
result_data_0_logo=
result_data_0_redirect_url=
result_data_0_favicon_url=
result_data_0_is_owner=1
result_data_0_is_default=1
Example 8 (plain)
Request
https://joturl.com/a/i1/domains/list?is_owner=1&fields=deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count&format=plain
Query parameters
is_owner = 1
fields = deeplink_id,host,for_trials,force_https,id,aliases,nickname,logo,redirect_url,favicon_url,robots_txt,deeplink_name,is_owner,is_default,is_shared,has_https,count
format = plain
Response
domain.ext
7155502b34434f6a4d52396464684d3874442b454b773d3d
domainext
1
1
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared, has_https, count |
Optional parameters
parameter | description |
---|---|
is_defaultBOOLEAN | if 1 this method returns the default domain and all shared domains, if 0 all domains are returned |
is_ownerBOOLEAN | if 1 this method returns only domains owned by the logged user, if 0 it returns only shared domains |
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: deeplink_id, host, for_trials, force_https, id, aliases, nickname, logo, redirect_url, favicon_url, robots_txt, deeplink_name, is_owner, is_default, is_shared, has_https, count |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of domains, returned only if count is passed in fields |
data | array containing required information on domains the user has access to |
/domains/property
access: [READ]
This method returns the limits for a domain logo.
Example 1 (json)
Request
https://joturl.com/a/i1/domains/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"max_size": 153600,
"max_width": 120,
"max_height": 50,
"allowed_types": [
"image\/gif",
"image\/jpeg",
"image\/jpg",
"image\/pjpeg",
"image\/x-png",
"image\/png"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/domains/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<max_size>153600</max_size>
<max_width>120</max_width>
<max_height>50</max_height>
<allowed_types>
<i0>image/gif</i0>
<i1>image/jpeg</i1>
<i2>image/jpg</i2>
<i3>image/pjpeg</i3>
<i4>image/x-png</i4>
<i5>image/png</i5>
</allowed_types>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/domains/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_max_size=153600
result_max_width=120
result_max_height=50
result_allowed_types_0=image/gif
result_allowed_types_1=image/jpeg
result_allowed_types_2=image/jpg
result_allowed_types_3=image/pjpeg
result_allowed_types_4=image/x-png
result_allowed_types_5=image/png
Example 4 (plain)
Request
https://joturl.com/a/i1/domains/property?format=plain
Query parameters
format = plain
Response
153600
120
50
image/gif
image/jpeg
image/jpg
image/pjpeg
image/x-png
image/png
Return values
parameter | description |
---|---|
allowed_types | array of allowed image types (mime types) |
max_height | maximum allowed height for the logo (pixels) |
max_size | maximum allowed size for the logo (bytes) |
max_width | maximum allowed width for the logo (pixels) |
/gdprs
/gdprs/add
access: [WRITE]
This method adds a new GDPR template.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F
Query parameters
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"company": "JotUrl",
"home_link": "https:\/\/www.joturl.com\/",
"tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
"id": "06de3a3c93ce5671d170c910bbf59a2a",
"notes": "",
"is_default": 0,
"show_refuse_button": 0,
"custom_translations": null
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=xml
Query parameters
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<company>JotUrl</company>
<home_link>https://www.joturl.com/</home_link>
<tos_link>https://www.joturl.com/terms-of-service/</tos_link>
<id>06de3a3c93ce5671d170c910bbf59a2a</id>
<notes></notes>
<is_default>0</is_default>
<show_refuse_button>0</show_refuse_button>
<custom_translations></custom_translations>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=txt
Query parameters
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_company=JotUrl
result_home_link=https://www.joturl.com/
result_tos_link=https://www.joturl.com/terms-of-service/
result_id=06de3a3c93ce5671d170c910bbf59a2a
result_notes=
result_is_default=0
result_show_refuse_button=0
result_custom_translations=
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/add?company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=plain
Query parameters
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = plain
Response
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
06de3a3c93ce5671d170c910bbf59a2a
0
0
Required parameters
parameter | description | max length |
---|---|---|
companySTRING | company name, it is also the name that identifies the template | 255 |
home_linkURL | complete URL to the home page of the company website | 4000 |
tos_linkURL | complete URL to the terms of service page of the company website | 4000 |
Optional parameters
parameter | description | max length |
---|---|---|
custom_translationsJSON | stringified JSON of the custom GDPR translations | |
notesSTRING | template notes (not shown on the GDPR page) | 255 |
show_refuse_buttonBOOLEAN | 1 to show a "refuse all cookies" button on the consent window, 0 otherwise (only available on custom domains) |
Return values
parameter | description |
---|---|
company | echo back of the company input parameter |
custom_translations | echo back of the notes input parameter |
home_link | echo back of the home_link input parameter |
id | ID of the GDPR template |
is_default | 1 if it is the default template, 0 otherwise |
notes | echo back of the notes input parameter |
show_refuse_button | 1 to show a "refuse all cookies" button, 0 otherwise |
tos_link | echo back of the tos_link input parameter |
/gdprs/count
access: [READ]
This method returns the number of GDPR templates.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 7
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>7</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=7
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
7
Optional parameters
parameter | description |
---|---|
searchSTRING | filters GDPR templates to be extracted by searching them |
Return values
parameter | description |
---|---|
count | the number of GDPR templates |
/gdprs/delete
access: [WRITE]
This method deletes one or more GDPR template(s).
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/delete?ids=a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67
Query parameters
ids = a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3,
"id": "4f4facae44db81b7f4f1960a31b4bf9f"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/delete?ids=a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67&format=xml
Query parameters
ids = a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
<id>4f4facae44db81b7f4f1960a31b4bf9f</id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/delete?ids=a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67&format=txt
Query parameters
ids = a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
result_id=4f4facae44db81b7f4f1960a31b4bf9f
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/delete?ids=a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67&format=plain
Query parameters
ids = a4cb58747bdcdfaa3a65d01eb14f08af,6b8862d820f15b76244348dda8576575,ebeb268c9472060c3257efaea425ec67
format = plain
Response
3
4f4facae44db81b7f4f1960a31b4bf9f
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of GDPR templates to remove, max number of IDs in the list: 100 |
Return values
parameter | description |
---|---|
deleted | number of deleted GDPR templates on success, 0 otherwise |
id | ID of the default GDPR template, if available |
/gdprs/edit
access: [WRITE]
This method edits a GDPR template.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/edit?id=1203e4f7ce5f3a3525ca48d4d134f8ca&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F
Query parameters
id = 1203e4f7ce5f3a3525ca48d4d134f8ca
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "1203e4f7ce5f3a3525ca48d4d134f8ca",
"company": "JotUrl",
"home_link": "https:\/\/www.joturl.com\/",
"tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/edit?id=1203e4f7ce5f3a3525ca48d4d134f8ca&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=xml
Query parameters
id = 1203e4f7ce5f3a3525ca48d4d134f8ca
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>1203e4f7ce5f3a3525ca48d4d134f8ca</id>
<company>JotUrl</company>
<home_link>https://www.joturl.com/</home_link>
<tos_link>https://www.joturl.com/terms-of-service/</tos_link>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/edit?id=1203e4f7ce5f3a3525ca48d4d134f8ca&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=txt
Query parameters
id = 1203e4f7ce5f3a3525ca48d4d134f8ca
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=1203e4f7ce5f3a3525ca48d4d134f8ca
result_company=JotUrl
result_home_link=https://www.joturl.com/
result_tos_link=https://www.joturl.com/terms-of-service/
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/edit?id=1203e4f7ce5f3a3525ca48d4d134f8ca&company=JotUrl&home_link=https%3A%2F%2Fwww.joturl.com%2F&tos_link=https%3A%2F%2Fwww.joturl.com%2Fterms-of-service%2F&format=plain
Query parameters
id = 1203e4f7ce5f3a3525ca48d4d134f8ca
company = JotUrl
home_link = https://www.joturl.com/
tos_link = https://www.joturl.com/terms-of-service/
format = plain
Response
1203e4f7ce5f3a3525ca48d4d134f8ca
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
1
Required parameters
parameter | description |
---|---|
idID | ID of the GDPR template to edit |
Optional parameters
parameter | description | max length |
---|---|---|
companySTRING | company name, it is also the name that identifies the template | 255 |
custom_translationsJSON | stringified JSON of the custom GDPR translations, see i1/gdprs/add for details | |
home_linkURL | complete URL to the home page of the company website | 4000 |
is_defaultBOOLEAN | 1 to set the GDPR template as the default, 0 to remove the default flag (the first available GDPR template will be set as default, including the template identified by id) | |
notesSTRING | template notes (not shown on the GDPR page) | 255 |
show_refuse_buttonBOOLEAN | 1 to show a "refuse all cookies" button on the consent window, 0 otherwise (only available on custom domains) | |
tos_linkURL | complete URL to the terms of service page of the company website | 4000 |
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/gdprs/info
access: [READ]
This method returns info about a GDPR template.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=d91301924282606bc608bb7c799bd3b3
Query parameters
fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
id = d91301924282606bc608bb7c799bd3b3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "d91301924282606bc608bb7c799bd3b3",
"company": "JotUrl",
"home_link": "https:\/\/www.joturl.com\/",
"tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
"notes": "",
"is_default": 1,
"show_refuse_button": 0,
"custom_translations": null
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=d91301924282606bc608bb7c799bd3b3&format=xml
Query parameters
fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
id = d91301924282606bc608bb7c799bd3b3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>d91301924282606bc608bb7c799bd3b3</id>
<company>JotUrl</company>
<home_link>https://www.joturl.com/</home_link>
<tos_link>https://www.joturl.com/terms-of-service/</tos_link>
<notes></notes>
<is_default>1</is_default>
<show_refuse_button>0</show_refuse_button>
<custom_translations></custom_translations>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=d91301924282606bc608bb7c799bd3b3&format=txt
Query parameters
fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
id = d91301924282606bc608bb7c799bd3b3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=d91301924282606bc608bb7c799bd3b3
result_data_0_company=JotUrl
result_data_0_home_link=https://www.joturl.com/
result_data_0_tos_link=https://www.joturl.com/terms-of-service/
result_data_0_notes=
result_data_0_is_default=1
result_data_0_show_refuse_button=0
result_data_0_custom_translations=
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/info?fields=id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&id=d91301924282606bc608bb7c799bd3b3&format=plain
Query parameters
fields = id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
id = d91301924282606bc608bb7c799bd3b3
format = plain
Response
d91301924282606bc608bb7c799bd3b3
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
1
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations |
idID | ID of the GDPR template |
Return values
parameter | description |
---|---|
data | array containing information on the GDPR templates, returned information depends on the fields parameter. |
/gdprs/list
access: [READ]
This method returns a list of GDPR templates.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
Query parameters
fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "c6e3cf33eb2765d6803ae9ccfd0764ff",
"company": "JotUrl",
"home_link": "https:\/\/www.joturl.com\/",
"tos_link": "https:\/\/www.joturl.com\/terms-of-service\/",
"notes": "",
"is_default": 1,
"show_refuse_button": 0,
"custom_translations": null
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=xml
Query parameters
fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>c6e3cf33eb2765d6803ae9ccfd0764ff</id>
<company>JotUrl</company>
<home_link>https://www.joturl.com/</home_link>
<tos_link>https://www.joturl.com/terms-of-service/</tos_link>
<notes></notes>
<is_default>1</is_default>
<show_refuse_button>0</show_refuse_button>
<custom_translations></custom_translations>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=txt
Query parameters
fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=c6e3cf33eb2765d6803ae9ccfd0764ff
result_data_0_company=JotUrl
result_data_0_home_link=https://www.joturl.com/
result_data_0_tos_link=https://www.joturl.com/terms-of-service/
result_data_0_notes=
result_data_0_is_default=1
result_data_0_show_refuse_button=0
result_data_0_custom_translations=
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/list?fields=count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations&format=plain
Query parameters
fields = count,id,company,home_link,tos_link,notes,is_default,show_refuse_button,custom_translations
format = plain
Response
1
c6e3cf33eb2765d6803ae9ccfd0764ff
JotUrl
https://www.joturl.com/
https://www.joturl.com/terms-of-service/
1
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of GDPR templates (maxmimum allowed: 100) |
orderbyARRAY | orders GDPR templates by field, available fields: id, company, home_link, tos_link, notes, is_default, show_refuse_button, custom_translations |
searchSTRING | filters GDPR templates to be extracted by searching them |
sortSTRING | sorts GDPR templates in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract GDPR templates from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of GDPR templates, returned only if count is passed in fields |
data | array containing information on the GDPR templates, returned information depends on the fields parameter. |
/gdprs/preview
access: [READ]
This method returns a preview for the GDPR consent page (HTML).
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/preview?id=1a332bca90629f0e50526a1cf88a674f
Query parameters
id = 1a332bca90629f0e50526a1cf88a674f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"html": "<html lang=\"en\"> [GDPR consent HTML] <\/html>"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/preview?id=1a332bca90629f0e50526a1cf88a674f&format=xml
Query parameters
id = 1a332bca90629f0e50526a1cf88a674f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<html><[CDATA[&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;]]></html>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/preview?id=1a332bca90629f0e50526a1cf88a674f&format=txt
Query parameters
id = 1a332bca90629f0e50526a1cf88a674f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_html=&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/preview?id=1a332bca90629f0e50526a1cf88a674f&format=plain
Query parameters
id = 1a332bca90629f0e50526a1cf88a674f
format = plain
Response
&lt;html lang="en"&gt; [GDPR consent HTML] &lt;/html&gt;
Optional parameters
parameter | description | max length |
---|---|---|
companySTRING | NA | 255 |
custom_translationsJSON | custom translations for the GDPR consent preview | |
home_linkURL | NA | 4000 |
idID | ID of the GDPR template | |
show_refuse_buttonBOOLEAN | NA | |
tos_linkURL | NA | 4000 |
Return values
parameter | description |
---|---|
html | GDPR consent HTML |
/gdprs/property
access: [READ]
This method returns a list of property for a custom GDPR consent.
Example 1 (json)
Request
https://joturl.com/a/i1/gdprs/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"about_cookies": {
"type": "text",
"default": "About cookies",
"notes": "label of the \"about cookies\" tab",
"max-length": 50
},
"accept_button": {
"type": "text",
"default": "Accept cookies",
"notes": "label of the accept button",
"max-length": 50
},
"agreement": {
"type": "markdown",
"default": "By clicking \"Accept cookies,\" you agree to the sto [...]",
"notes": "agreement text",
"max-length": 1000
},
"caption": {
"type": "text",
"default": "Cookies",
"notes": "title of the consent window",
"max-length": 50
},
"consent": {
"type": "markdown",
"default": "%COMPANY_WITH_LINK% uses cookies to customise cont [...]",
"notes": "consent text",
"max-length": 1000
},
"cookie_control_label": {
"type": "text",
"default": "aboutcookies.org",
"notes": "label of the aboutcookies.org link",
"max-length": 100
},
"cookie_control_link": {
"type": "url",
"default": "https:\/\/www.aboutcookies.org\/",
"notes": "URL of the aboutcookies.org page",
"max-length": 2000
},
"cookies_enabled": {
"type": "text",
"default": "Enabled",
"notes": "\"enabled\" header of the consent table",
"max-length": 30
},
"cookies_settings": {
"type": "text",
"default": "Cookies settings",
"notes": "title of the detailed cookie settings page",
"max-length": 50
},
"cookies_used": {
"type": "text",
"default": "Cookie name",
"notes": "\"cookie name\" header of the consent table",
"max-length": 30
},
"description_control_cookies": {
"type": "markdown",
"default": "You can control and\/or delete cookies as you wish [...]",
"notes": "content of the \"How to control cookies\" section",
"max-length": 1000
},
"description_cookies": {
"type": "markdown",
"default": "A cookie is a small text file that a website saves [...]",
"notes": "content of the \"What are cookies?\" section",
"max-length": 1000
},
"description_marketing_cookies": {
"type": "markdown",
"default": "Marketing cookies are used to track visitors acros [...]",
"notes": "content of the \"What are marketing cookies?\" section",
"max-length": 1000
},
"descriptions.adroll": {
"type": "markdown",
"default": "AdRoll is a retargeting and prospecting platform f [...]",
"notes": "AdRoll consent details",
"max-length": 1000
},
"descriptions.bing": {
"type": "markdown",
"default": "Bing Remarketing is a remarketing and behavioral t [...]",
"notes": "Bing consent details",
"max-length": 1000
},
"descriptions.custom": {
"type": "markdown",
"default": "Please refer to the terms of service and cookie po [...]",
"notes": "Custom consent details",
"max-length": 1000
},
"descriptions.facebook": {
"type": "markdown",
"default": "Facebook Remarketing is a remarketing and behavior [...]",
"notes": "Facebook consent details",
"max-length": 1000
},
"descriptions.google_adwords": {
"type": "markdown",
"default": "Google AdWords Remarketing is a remarketing and be [...]",
"notes": "Google AdWords consent details",
"max-length": 1000
},
"descriptions.google_analytics": {
"type": "markdown",
"default": "Google Analytics for Display Advertising is a rema [...]",
"notes": "Google Analytics consent details",
"max-length": 1000
},
"descriptions.google_tag_manager": {
"type": "markdown",
"default": "Google Tag Manager is a tag management service pro [...]",
"notes": "Google Tag Manager consent details",
"max-length": 1000
},
"descriptions.linkedin": {
"type": "markdown",
"default": "LinkedIn Website Retargeting is a remarketing and [...]",
"notes": "LinkedIn consent details",
"max-length": 1000
},
"descriptions.manychat": {
"type": "markdown",
"default": "ManyChat is a leading Facebook Messenger marketing [...]",
"notes": "ManyChat consent details",
"max-length": 1000
},
"descriptions.pinterest": {
"type": "markdown",
"default": "Pinterest Remarketing is a remarketing and behavio [...]",
"notes": "Pinterest consent details",
"max-length": 1000
},
"descriptions.quora": {
"type": "markdown",
"default": "Quora is an American social question-and-answer we [...]",
"notes": "Quora consent details",
"max-length": 1000
},
"descriptions.snapchat": {
"type": "markdown",
"default": "Snapchat is a mobile app for Android and iOS devic [...]",
"notes": "Snapchat consent details",
"max-length": 1000
},
"descriptions.tiktok": {
"type": "markdown",
"default": "TikTok (Douyin) Remarketing is a remarketing and b [...]",
"notes": "TikTok consent details",
"max-length": 1000
},
"descriptions.twitter": {
"type": "markdown",
"default": "Twitter Remarketing is a remarketing and behaviora [...]",
"notes": "Twitter consent details",
"max-length": 1000
},
"here": {
"type": "text",
"default": "here",
"notes": "text of the link that leads to the \"control and\/or delete cookies\" page",
"max-length": 50
},
"marketing_cookies": {
"type": "text",
"default": "Marketing cookies",
"notes": "label of the \"marketing cookies\" tab",
"max-length": 50
},
"noscript": {
"type": "text",
"default": "You need to enable JavaScript to run this page.",
"notes": "shown when the user's browser does not support JavaScript",
"max-length": 100
},
"refuse_button": {
"type": "text",
"default": "I refuse cookies",
"notes": "label of the refuse button",
"max-length": 50
},
"save_button": {
"type": "text",
"default": "Save & continue",
"notes": "label of the save button",
"max-length": 50
},
"see_details": {
"type": "text",
"default": "See details",
"notes": "text of the link that leads to the extended consent page (custom page)",
"max-length": 50
},
"settings_button": {
"type": "text",
"default": "Cookies settings",
"notes": "label of the settings button",
"max-length": 50
},
"title": {
"type": "text",
"default": "%COMPANY% GDPR - Cookie consent form",
"notes": "title of the HTML page consent",
"max-length": 50
},
"title_control_cookies": {
"type": "text",
"default": "How to control cookies",
"notes": "title of the \"How to control cookies\" section",
"max-length": 50
},
"title_cookies": {
"type": "text",
"default": "What are cookies?",
"notes": "title of the \"What are cookies?\" section",
"max-length": 50
},
"title_marketing_cookies": {
"type": "text",
"default": "What are marketing cookies?",
"notes": "title of the \"What are marketing cookies?\" section",
"max-length": 50
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/gdprs/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<about_cookies>
<type>text</type>
<default>About cookies</default>
<notes>label of the "about cookies" tab</notes>
<max-length>50</max-length>
</about_cookies>
<accept_button>
<type>text</type>
<default>Accept cookies</default>
<notes>label of the accept button</notes>
<max-length>50</max-length>
</accept_button>
<agreement>
<type>markdown</type>
<default>By clicking "Accept cookies," you agree to the sto [...]</default>
<notes>agreement text</notes>
<max-length>1000</max-length>
</agreement>
<caption>
<type>text</type>
<default>Cookies</default>
<notes>title of the consent window</notes>
<max-length>50</max-length>
</caption>
<consent>
<type>markdown</type>
<default>%COMPANY_WITH_LINK% uses cookies to customise cont [...]</default>
<notes>consent text</notes>
<max-length>1000</max-length>
</consent>
<cookie_control_label>
<type>text</type>
<default>aboutcookies.org</default>
<notes>label of the aboutcookies.org link</notes>
<max-length>100</max-length>
</cookie_control_label>
<cookie_control_link>
<type>url</type>
<default>https://www.aboutcookies.org/</default>
<notes>URL of the aboutcookies.org page</notes>
<max-length>2000</max-length>
</cookie_control_link>
<cookies_enabled>
<type>text</type>
<default>Enabled</default>
<notes>"enabled" header of the consent table</notes>
<max-length>30</max-length>
</cookies_enabled>
<cookies_settings>
<type>text</type>
<default>Cookies settings</default>
<notes>title of the detailed cookie settings page</notes>
<max-length>50</max-length>
</cookies_settings>
<cookies_used>
<type>text</type>
<default>Cookie name</default>
<notes>"cookie name" header of the consent table</notes>
<max-length>30</max-length>
</cookies_used>
<description_control_cookies>
<type>markdown</type>
<default>You can control and/or delete cookies as you wish [...]</default>
<notes>content of the "How to control cookies" section</notes>
<max-length>1000</max-length>
</description_control_cookies>
<description_cookies>
<type>markdown</type>
<default>A cookie is a small text file that a website saves [...]</default>
<notes>content of the "What are cookies?" section</notes>
<max-length>1000</max-length>
</description_cookies>
<description_marketing_cookies>
<type>markdown</type>
<default>Marketing cookies are used to track visitors acros [...]</default>
<notes>content of the "What are marketing cookies?" section</notes>
<max-length>1000</max-length>
</description_marketing_cookies>
<descriptions.adroll>
<type>markdown</type>
<default>AdRoll is a retargeting and prospecting platform f [...]</default>
<notes>AdRoll consent details</notes>
<max-length>1000</max-length>
</descriptions.adroll>
<descriptions.bing>
<type>markdown</type>
<default>Bing Remarketing is a remarketing and behavioral t [...]</default>
<notes>Bing consent details</notes>
<max-length>1000</max-length>
</descriptions.bing>
<descriptions.custom>
<type>markdown</type>
<default>Please refer to the terms of service and cookie po [...]</default>
<notes>Custom consent details</notes>
<max-length>1000</max-length>
</descriptions.custom>
<descriptions.facebook>
<type>markdown</type>
<default>Facebook Remarketing is a remarketing and behavior [...]</default>
<notes>Facebook consent details</notes>
<max-length>1000</max-length>
</descriptions.facebook>
<descriptions.google_adwords>
<type>markdown</type>
<default>Google AdWords Remarketing is a remarketing and be [...]</default>
<notes>Google AdWords consent details</notes>
<max-length>1000</max-length>
</descriptions.google_adwords>
<descriptions.google_analytics>
<type>markdown</type>
<default>Google Analytics for Display Advertising is a rema [...]</default>
<notes>Google Analytics consent details</notes>
<max-length>1000</max-length>
</descriptions.google_analytics>
<descriptions.google_tag_manager>
<type>markdown</type>
<default>Google Tag Manager is a tag management service pro [...]</default>
<notes>Google Tag Manager consent details</notes>
<max-length>1000</max-length>
</descriptions.google_tag_manager>
<descriptions.linkedin>
<type>markdown</type>
<default>LinkedIn Website Retargeting is a remarketing and [...]</default>
<notes>LinkedIn consent details</notes>
<max-length>1000</max-length>
</descriptions.linkedin>
<descriptions.manychat>
<type>markdown</type>
<default>ManyChat is a leading Facebook Messenger marketing [...]</default>
<notes>ManyChat consent details</notes>
<max-length>1000</max-length>
</descriptions.manychat>
<descriptions.pinterest>
<type>markdown</type>
<default>Pinterest Remarketing is a remarketing and behavio [...]</default>
<notes>Pinterest consent details</notes>
<max-length>1000</max-length>
</descriptions.pinterest>
<descriptions.quora>
<type>markdown</type>
<default>Quora is an American social question-and-answer we [...]</default>
<notes>Quora consent details</notes>
<max-length>1000</max-length>
</descriptions.quora>
<descriptions.snapchat>
<type>markdown</type>
<default>Snapchat is a mobile app for Android and iOS devic [...]</default>
<notes>Snapchat consent details</notes>
<max-length>1000</max-length>
</descriptions.snapchat>
<descriptions.tiktok>
<type>markdown</type>
<default>TikTok (Douyin) Remarketing is a remarketing and b [...]</default>
<notes>TikTok consent details</notes>
<max-length>1000</max-length>
</descriptions.tiktok>
<descriptions.twitter>
<type>markdown</type>
<default>Twitter Remarketing is a remarketing and behaviora [...]</default>
<notes>Twitter consent details</notes>
<max-length>1000</max-length>
</descriptions.twitter>
<here>
<type>text</type>
<default>here</default>
<notes>text of the link that leads to the "control and/or delete cookies" page</notes>
<max-length>50</max-length>
</here>
<marketing_cookies>
<type>text</type>
<default>Marketing cookies</default>
<notes>label of the "marketing cookies" tab</notes>
<max-length>50</max-length>
</marketing_cookies>
<noscript>
<type>text</type>
<default>You need to enable JavaScript to run this page.</default>
<notes>shown when the user's browser does not support JavaScript</notes>
<max-length>100</max-length>
</noscript>
<refuse_button>
<type>text</type>
<default>I refuse cookies</default>
<notes>label of the refuse button</notes>
<max-length>50</max-length>
</refuse_button>
<save_button>
<type>text</type>
<default><[CDATA[Save &amp; continue]]></default>
<notes>label of the save button</notes>
<max-length>50</max-length>
</save_button>
<see_details>
<type>text</type>
<default>See details</default>
<notes>text of the link that leads to the extended consent page (custom page)</notes>
<max-length>50</max-length>
</see_details>
<settings_button>
<type>text</type>
<default>Cookies settings</default>
<notes>label of the settings button</notes>
<max-length>50</max-length>
</settings_button>
<title>
<type>text</type>
<default>%COMPANY% GDPR - Cookie consent form</default>
<notes>title of the HTML page consent</notes>
<max-length>50</max-length>
</title>
<title_control_cookies>
<type>text</type>
<default>How to control cookies</default>
<notes>title of the "How to control cookies" section</notes>
<max-length>50</max-length>
</title_control_cookies>
<title_cookies>
<type>text</type>
<default>What are cookies?</default>
<notes>title of the "What are cookies?" section</notes>
<max-length>50</max-length>
</title_cookies>
<title_marketing_cookies>
<type>text</type>
<default>What are marketing cookies?</default>
<notes>title of the "What are marketing cookies?" section</notes>
<max-length>50</max-length>
</title_marketing_cookies>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/gdprs/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_about_cookies_type=text
result_about_cookies_default=About cookies
result_about_cookies_notes=label of the "about cookies" tab
result_about_cookies_max-length=50
result_accept_button_type=text
result_accept_button_default=Accept cookies
result_accept_button_notes=label of the accept button
result_accept_button_max-length=50
result_agreement_type=markdown
result_agreement_default=By clicking "Accept cookies," you agree to the sto [...]
result_agreement_notes=agreement text
result_agreement_max-length=1000
result_caption_type=text
result_caption_default=Cookies
result_caption_notes=title of the consent window
result_caption_max-length=50
result_consent_type=markdown
result_consent_default=%COMPANY_WITH_LINK% uses cookies to customise cont [...]
result_consent_notes=consent text
result_consent_max-length=1000
result_cookie_control_label_type=text
result_cookie_control_label_default=aboutcookies.org
result_cookie_control_label_notes=label of the aboutcookies.org link
result_cookie_control_label_max-length=100
result_cookie_control_link_type=url
result_cookie_control_link_default=https://www.aboutcookies.org/
result_cookie_control_link_notes=URL of the aboutcookies.org page
result_cookie_control_link_max-length=2000
result_cookies_enabled_type=text
result_cookies_enabled_default=Enabled
result_cookies_enabled_notes="enabled" header of the consent table
result_cookies_enabled_max-length=30
result_cookies_settings_type=text
result_cookies_settings_default=Cookies settings
result_cookies_settings_notes=title of the detailed cookie settings page
result_cookies_settings_max-length=50
result_cookies_used_type=text
result_cookies_used_default=Cookie name
result_cookies_used_notes="cookie name" header of the consent table
result_cookies_used_max-length=30
result_description_control_cookies_type=markdown
result_description_control_cookies_default=You can control and/or delete cookies as you wish [...]
result_description_control_cookies_notes=content of the "How to control cookies" section
result_description_control_cookies_max-length=1000
result_description_cookies_type=markdown
result_description_cookies_default=A cookie is a small text file that a website saves [...]
result_description_cookies_notes=content of the "What are cookies?" section
result_description_cookies_max-length=1000
result_description_marketing_cookies_type=markdown
result_description_marketing_cookies_default=Marketing cookies are used to track visitors acros [...]
result_description_marketing_cookies_notes=content of the "What are marketing cookies?" section
result_description_marketing_cookies_max-length=1000
result_descriptions.adroll_type=markdown
result_descriptions.adroll_default=AdRoll is a retargeting and prospecting platform f [...]
result_descriptions.adroll_notes=AdRoll consent details
result_descriptions.adroll_max-length=1000
result_descriptions.bing_type=markdown
result_descriptions.bing_default=Bing Remarketing is a remarketing and behavioral t [...]
result_descriptions.bing_notes=Bing consent details
result_descriptions.bing_max-length=1000
result_descriptions.custom_type=markdown
result_descriptions.custom_default=Please refer to the terms of service and cookie po [...]
result_descriptions.custom_notes=Custom consent details
result_descriptions.custom_max-length=1000
result_descriptions.facebook_type=markdown
result_descriptions.facebook_default=Facebook Remarketing is a remarketing and behavior [...]
result_descriptions.facebook_notes=Facebook consent details
result_descriptions.facebook_max-length=1000
result_descriptions.google_adwords_type=markdown
result_descriptions.google_adwords_default=Google AdWords Remarketing is a remarketing and be [...]
result_descriptions.google_adwords_notes=Google AdWords consent details
result_descriptions.google_adwords_max-length=1000
result_descriptions.google_analytics_type=markdown
result_descriptions.google_analytics_default=Google Analytics for Display Advertising is a rema [...]
result_descriptions.google_analytics_notes=Google Analytics consent details
result_descriptions.google_analytics_max-length=1000
result_descriptions.google_tag_manager_type=markdown
result_descriptions.google_tag_manager_default=Google Tag Manager is a tag management service pro [...]
result_descriptions.google_tag_manager_notes=Google Tag Manager consent details
result_descriptions.google_tag_manager_max-length=1000
result_descriptions.linkedin_type=markdown
result_descriptions.linkedin_default=LinkedIn Website Retargeting is a remarketing and [...]
result_descriptions.linkedin_notes=LinkedIn consent details
result_descriptions.linkedin_max-length=1000
result_descriptions.manychat_type=markdown
result_descriptions.manychat_default=ManyChat is a leading Facebook Messenger marketing [...]
result_descriptions.manychat_notes=ManyChat consent details
result_descriptions.manychat_max-length=1000
result_descriptions.pinterest_type=markdown
result_descriptions.pinterest_default=Pinterest Remarketing is a remarketing and behavio [...]
result_descriptions.pinterest_notes=Pinterest consent details
result_descriptions.pinterest_max-length=1000
result_descriptions.quora_type=markdown
result_descriptions.quora_default=Quora is an American social question-and-answer we [...]
result_descriptions.quora_notes=Quora consent details
result_descriptions.quora_max-length=1000
result_descriptions.snapchat_type=markdown
result_descriptions.snapchat_default=Snapchat is a mobile app for Android and iOS devic [...]
result_descriptions.snapchat_notes=Snapchat consent details
result_descriptions.snapchat_max-length=1000
result_descriptions.tiktok_type=markdown
result_descriptions.tiktok_default=TikTok (Douyin) Remarketing is a remarketing and b [...]
result_descriptions.tiktok_notes=TikTok consent details
result_descriptions.tiktok_max-length=1000
result_descriptions.twitter_type=markdown
result_descriptions.twitter_default=Twitter Remarketing is a remarketing and behaviora [...]
result_descriptions.twitter_notes=Twitter consent details
result_descriptions.twitter_max-length=1000
result_here_type=text
result_here_default=here
result_here_notes=text of the link that leads to the "control and/or delete cookies" page
result_here_max-length=50
result_marketing_cookies_type=text
result_marketing_cookies_default=Marketing cookies
result_marketing_cookies_notes=label of the "marketing cookies" tab
result_marketing_cookies_max-length=50
result_noscript_type=text
result_noscript_default=You need to enable JavaScript to run this page.
result_noscript_notes=shown when the user's browser does not support JavaScript
result_noscript_max-length=100
result_refuse_button_type=text
result_refuse_button_default=I refuse cookies
result_refuse_button_notes=label of the refuse button
result_refuse_button_max-length=50
result_save_button_type=text
result_save_button_default=Save &amp; continue
result_save_button_notes=label of the save button
result_save_button_max-length=50
result_see_details_type=text
result_see_details_default=See details
result_see_details_notes=text of the link that leads to the extended consent page (custom page)
result_see_details_max-length=50
result_settings_button_type=text
result_settings_button_default=Cookies settings
result_settings_button_notes=label of the settings button
result_settings_button_max-length=50
result_title_type=text
result_title_default=%COMPANY% GDPR - Cookie consent form
result_title_notes=title of the HTML page consent
result_title_max-length=50
result_title_control_cookies_type=text
result_title_control_cookies_default=How to control cookies
result_title_control_cookies_notes=title of the "How to control cookies" section
result_title_control_cookies_max-length=50
result_title_cookies_type=text
result_title_cookies_default=What are cookies?
result_title_cookies_notes=title of the "What are cookies?" section
result_title_cookies_max-length=50
result_title_marketing_cookies_type=text
result_title_marketing_cookies_default=What are marketing cookies?
result_title_marketing_cookies_notes=title of the "What are marketing cookies?" section
result_title_marketing_cookies_max-length=50
Example 4 (plain)
Request
https://joturl.com/a/i1/gdprs/property?format=plain
Query parameters
format = plain
Response
text
default:About cookies
label of the "about cookies" tab
50
text
default:Accept cookies
label of the accept button
50
markdown
default:By clicking "Accept cookies," you agree to the sto [...]
agreement text
1000
text
default:Cookies
title of the consent window
50
markdown
default:%COMPANY_WITH_LINK% uses cookies to customise cont [...]
consent text
1000
text
default:aboutcookies.org
label of the aboutcookies.org link
100
url
default:https://www.aboutcookies.org/
URL of the aboutcookies.org page
2000
text
default:Enabled
"enabled" header of the consent table
30
text
default:Cookies settings
title of the detailed cookie settings page
50
text
default:Cookie name
"cookie name" header of the consent table
30
markdown
default:You can control and/or delete cookies as you wish [...]
content of the "How to control cookies" section
1000
markdown
default:A cookie is a small text file that a website saves [...]
content of the "What are cookies?" section
1000
markdown
default:Marketing cookies are used to track visitors acros [...]
content of the "What are marketing cookies?" section
1000
markdown
default:AdRoll is a retargeting and prospecting platform f [...]
AdRoll consent details
1000
markdown
default:Bing Remarketing is a remarketing and behavioral t [...]
Bing consent details
1000
markdown
default:Please refer to the terms of service and cookie po [...]
Custom consent details
1000
markdown
default:Facebook Remarketing is a remarketing and behavior [...]
Facebook consent details
1000
markdown
default:Google AdWords Remarketing is a remarketing and be [...]
Google AdWords consent details
1000
markdown
default:Google Analytics for Display Advertising is a rema [...]
Google Analytics consent details
1000
markdown
default:Google Tag Manager is a tag management service pro [...]
Google Tag Manager consent details
1000
markdown
default:LinkedIn Website Retargeting is a remarketing and [...]
LinkedIn consent details
1000
markdown
default:ManyChat is a leading Facebook Messenger marketing [...]
ManyChat consent details
1000
markdown
default:Pinterest Remarketing is a remarketing and behavio [...]
Pinterest consent details
1000
markdown
default:Quora is an American social question-and-answer we [...]
Quora consent details
1000
markdown
default:Snapchat is a mobile app for Android and iOS devic [...]
Snapchat consent details
1000
markdown
default:TikTok (Douyin) Remarketing is a remarketing and b [...]
TikTok consent details
1000
markdown
default:Twitter Remarketing is a remarketing and behaviora [...]
Twitter consent details
1000
text
default:here
text of the link that leads to the "control and/or delete cookies" page
50
text
default:Marketing cookies
label of the "marketing cookies" tab
50
text
default:You need to enable JavaScript to run this page.
shown when the user's browser does not support JavaScript
100
text
default:I refuse cookies
label of the refuse button
50
text
default:Save &amp; continue
label of the save button
50
text
default:See details
text of the link that leads to the extended consent page (custom page)
50
text
default:Cookies settings
label of the settings button
50
text
default:%COMPANY% GDPR - Cookie consent form
title of the HTML page consent
50
text
default:How to control cookies
title of the "How to control cookies" section
50
text
default:What are cookies?
title of the "What are cookies?" section
50
text
default:What are marketing cookies?
title of the "What are marketing cookies?" section
50
Return values
parameter | description |
---|---|
about_cookies | label of the "about cookies" tab (type: text, max length: 50) |
accept_button | label of the accept button (type: text, max length: 50) |
agreement | agreement text (type: markdown, max length: 1000) |
caption | title of the consent window (type: text, max length: 50) |
consent | consent text (type: markdown, max length: 1000) |
cookie_control_label | label of the aboutcookies.org link (type: text, max length: 100) |
cookie_control_link | URL of the aboutcookies.org page (type: url, max length: 2000) |
cookies_enabled | "enabled" header of the consent table (type: text, max length: 30) |
cookies_settings | title of the detailed cookie settings page (type: text, max length: 50) |
cookies_used | "cookie name" header of the consent table (type: text, max length: 30) |
description_control_cookies | content of the "How to control cookies" section (type: markdown, max length: 1000) |
description_cookies | content of the "What are cookies?" section (type: markdown, max length: 1000) |
description_marketing_cookies | content of the "What are marketing cookies?" section (type: markdown, max length: 1000) |
descriptions.adroll | AdRoll consent details (type: markdown, max length: 1000) |
descriptions.bing | Bing consent details (type: markdown, max length: 1000) |
descriptions.custom | Custom consent details (type: markdown, max length: 1000) |
descriptions.facebook | Facebook consent details (type: markdown, max length: 1000) |
descriptions.google_adwords | Google AdWords consent details (type: markdown, max length: 1000) |
descriptions.google_analytics | Google Analytics consent details (type: markdown, max length: 1000) |
descriptions.google_tag_manager | Google Tag Manager consent details (type: markdown, max length: 1000) |
descriptions.linkedin | LinkedIn consent details (type: markdown, max length: 1000) |
descriptions.manychat | ManyChat consent details (type: markdown, max length: 1000) |
descriptions.pinterest | Pinterest consent details (type: markdown, max length: 1000) |
descriptions.quora | Quora consent details (type: markdown, max length: 1000) |
descriptions.snapchat | Snapchat consent details (type: markdown, max length: 1000) |
descriptions.tiktok | TikTok consent details (type: markdown, max length: 1000) |
descriptions.twitter | Twitter consent details (type: markdown, max length: 1000) |
here | text of the link that leads to the "control and/or delete cookies" page (type: text, max length: 50) |
marketing_cookies | label of the "marketing cookies" tab (type: text, max length: 50) |
noscript | shown when the user's browser does not support JavaScript (type: text, max length: 100) |
refuse_button | label of the refuse button (type: text, max length: 50) |
save_button | label of the save button (type: text, max length: 50) |
see_details | text of the link that leads to the extended consent page (custom page) (type: text, max length: 50) |
settings_button | label of the settings button (type: text, max length: 50) |
title | title of the HTML page consent (type: text, max length: 50) |
title_control_cookies | title of the "How to control cookies" section (type: text, max length: 50) |
title_cookies | title of the "What are cookies?" section (type: text, max length: 50) |
title_marketing_cookies | title of the "What are marketing cookies?" section (type: text, max length: 50) |
/jotbars
/jotbars/property
access: [READ]
This method returns a list of property of a jotbar.
Example 1 (json)
Request
https://joturl.com/a/i1/jotbars/property?context=url
Query parameters
context = url
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"positions": "inherit,right,left,top,bottom,empty",
"dimensions": "inherit,small,medium,big"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/jotbars/property?context=url&format=xml
Query parameters
context = url
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<positions>inherit,right,left,top,bottom,empty</positions>
<dimensions>inherit,small,medium,big</dimensions>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/jotbars/property?context=url&format=txt
Query parameters
context = url
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=inherit,right,left,top,bottom,empty
result_dimensions=inherit,small,medium,big
Example 4 (plain)
Request
https://joturl.com/a/i1/jotbars/property?context=url&format=plain
Query parameters
context = url
format = plain
Response
inherit,right,left,top,bottom,empty
inherit,small,medium,big
Example 5 (json)
Request
https://joturl.com/a/i1/jotbars/property?context=project
Query parameters
context = project
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"positions": "inherit,right,left,top,bottom,empty",
"dimensions": "inherit,small,medium,big"
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/jotbars/property?context=project&format=xml
Query parameters
context = project
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<positions>inherit,right,left,top,bottom,empty</positions>
<dimensions>inherit,small,medium,big</dimensions>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/jotbars/property?context=project&format=txt
Query parameters
context = project
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=inherit,right,left,top,bottom,empty
result_dimensions=inherit,small,medium,big
Example 8 (plain)
Request
https://joturl.com/a/i1/jotbars/property?context=project&format=plain
Query parameters
context = project
format = plain
Response
inherit,right,left,top,bottom,empty
inherit,small,medium,big
Example 9 (json)
Request
https://joturl.com/a/i1/jotbars/property?context=user
Query parameters
context = user
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"positions": "right,left,top,bottom,empty",
"dimensions": "small,medium,big"
}
}
Example 10 (xml)
Request
https://joturl.com/a/i1/jotbars/property?context=user&format=xml
Query parameters
context = user
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<positions>right,left,top,bottom,empty</positions>
<dimensions>small,medium,big</dimensions>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/jotbars/property?context=user&format=txt
Query parameters
context = user
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_positions=right,left,top,bottom,empty
result_dimensions=small,medium,big
Example 12 (plain)
Request
https://joturl.com/a/i1/jotbars/property?context=user&format=plain
Query parameters
context = user
format = plain
Response
right,left,top,bottom,empty
small,medium,big
Required parameters
parameter | description |
---|---|
contextSTRING | it can be url , project or user and specifies the context for which positions and dimensions are requested |
Return values
parameter | description |
---|---|
dimensions | comma separated list of dimensions for the context, available dimensions: big, inherit, medium, small |
positions | comma separated list of positions for context, available positions: bottom, empty, inherit, left, right, top |
/locations
/locations/list
access: [READ]
This method returns a list of available locations.
Example 1 (json)
Request
https://joturl.com/a/i1/locations/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"locations": [
{
"label": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
"code": "AF"
},
{
"label": "Aland Islands",
"code": "AX"
},
{
"label": "Albania (Shqipëria)",
"code": "AL"
},
{
"label": "Algeria (\u0627\u0644\u062c\u0632\u0627\u0626\u0631)",
"code": "DZ"
},
{
"label": "American Samoa",
"code": "AS"
},
{
"label": "Andorra",
"code": "AD"
},
{
"label": "Angola",
"code": "AO"
},
{
"label": "Anguilla",
"code": "AI"
},
{
"label": "Antarctica",
"code": "AQ"
},
{
"label": "Antigua and Barbuda",
"code": "AG"
},
{
"label": "Argentina",
"code": "AR"
},
{
"label": "Armenia (\u0540\u0561\u0575\u0561\u057d\u057f\u0561\u0576)",
"code": "AM"
},
{
"label": "Aruba",
"code": "AW"
},
{
"label": "Australia",
"code": "AU"
},
{
"label": "Austria (Österreich)",
"code": "AT"
},
{
"label": "Azerbaijan (Az\u0259rbaycan)",
"code": "AZ"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/locations/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<locations>
<i0>
<label>Afghanistan (افغانستان)</label>
<code>AF</code>
</i0>
<i1>
<label>Aland Islands</label>
<code>AX</code>
</i1>
<i2>
<label><[CDATA[Albania (Shqip&euml;ria)]]></label>
<code>AL</code>
</i2>
<i3>
<label>Algeria (الجزائر)</label>
<code>DZ</code>
</i3>
<i4>
<label>American Samoa</label>
<code>AS</code>
</i4>
<i5>
<label>Andorra</label>
<code>AD</code>
</i5>
<i6>
<label>Angola</label>
<code>AO</code>
</i6>
<i7>
<label>Anguilla</label>
<code>AI</code>
</i7>
<i8>
<label>Antarctica</label>
<code>AQ</code>
</i8>
<i9>
<label>Antigua and Barbuda</label>
<code>AG</code>
</i9>
<i10>
<label>Argentina</label>
<code>AR</code>
</i10>
<i11>
<label>Armenia (Հայաստան)</label>
<code>AM</code>
</i11>
<i12>
<label>Aruba</label>
<code>AW</code>
</i12>
<i13>
<label>Australia</label>
<code>AU</code>
</i13>
<i14>
<label><[CDATA[Austria (&Ouml;sterreich)]]></label>
<code>AT</code>
</i14>
<i15>
<label>Azerbaijan (Azərbaycan)</label>
<code>AZ</code>
</i15>
</locations>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/locations/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_locations_0_label=Afghanistan (افغانستان)
result_locations_0_code=AF
result_locations_1_label=Aland Islands
result_locations_1_code=AX
result_locations_2_label=Albania (Shqip&euml;ria)
result_locations_2_code=AL
result_locations_3_label=Algeria (الجزائر)
result_locations_3_code=DZ
result_locations_4_label=American Samoa
result_locations_4_code=AS
result_locations_5_label=Andorra
result_locations_5_code=AD
result_locations_6_label=Angola
result_locations_6_code=AO
result_locations_7_label=Anguilla
result_locations_7_code=AI
result_locations_8_label=Antarctica
result_locations_8_code=AQ
result_locations_9_label=Antigua and Barbuda
result_locations_9_code=AG
result_locations_10_label=Argentina
result_locations_10_code=AR
result_locations_11_label=Armenia (Հայաստան)
result_locations_11_code=AM
result_locations_12_label=Aruba
result_locations_12_code=AW
result_locations_13_label=Australia
result_locations_13_code=AU
result_locations_14_label=Austria (&Ouml;sterreich)
result_locations_14_code=AT
result_locations_15_label=Azerbaijan (Azərbaycan)
result_locations_15_code=AZ
Example 4 (plain)
Request
https://joturl.com/a/i1/locations/list?format=plain
Query parameters
format = plain
Response
Afghanistan (افغانستان)
AF
Aland Islands
AX
Albania (Shqip&euml;ria)
AL
Algeria (الجزائر)
DZ
American Samoa
AS
Andorra
AD
Angola
AO
Anguilla
AI
Antarctica
AQ
Antigua and Barbuda
AG
Argentina
AR
Armenia (Հայաստան)
AM
Aruba
AW
Australia
AU
Austria (&Ouml;sterreich)
AT
Azerbaijan (Azərbaycan)
AZ
Return values
parameter | description |
---|---|
locations | list of available locations |
/oauth
/oauth/access_token
access: [WRITE]
Get OAUTH 2.0 access token.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=5731b7f036f403b11e56a869ff1bd73b&client_secret=fd14aa1e714dba3109f9f89ea4dde897&code=1bba730b9d831907e4b787612f91eca2
Query parameters
grant_type = authorization_code
client_id = 5731b7f036f403b11e56a869ff1bd73b
client_secret = fd14aa1e714dba3109f9f89ea4dde897
code = 1bba730b9d831907e4b787612f91eca2
Response
{
"token_type": "bearer",
"expires_in": 864000,
"access_token": "700d66291b483ec1f4bdff8de8ff9aba",
"refresh_token": "f2f8ea527b044160de33cbd03e7b280d"
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=5731b7f036f403b11e56a869ff1bd73b&client_secret=fd14aa1e714dba3109f9f89ea4dde897&code=1bba730b9d831907e4b787612f91eca2&format=xml
Query parameters
grant_type = authorization_code
client_id = 5731b7f036f403b11e56a869ff1bd73b
client_secret = fd14aa1e714dba3109f9f89ea4dde897
code = 1bba730b9d831907e4b787612f91eca2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<token_type>bearer</token_type>
<expires_in>864000</expires_in>
<access_token>700d66291b483ec1f4bdff8de8ff9aba</access_token>
<refresh_token>f2f8ea527b044160de33cbd03e7b280d</refresh_token>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=5731b7f036f403b11e56a869ff1bd73b&client_secret=fd14aa1e714dba3109f9f89ea4dde897&code=1bba730b9d831907e4b787612f91eca2&format=txt
Query parameters
grant_type = authorization_code
client_id = 5731b7f036f403b11e56a869ff1bd73b
client_secret = fd14aa1e714dba3109f9f89ea4dde897
code = 1bba730b9d831907e4b787612f91eca2
format = txt
Response
token_type=bearer
expires_in=864000
access_token=700d66291b483ec1f4bdff8de8ff9aba
refresh_token=f2f8ea527b044160de33cbd03e7b280d
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/access_token?grant_type=authorization_code&client_id=5731b7f036f403b11e56a869ff1bd73b&client_secret=fd14aa1e714dba3109f9f89ea4dde897&code=1bba730b9d831907e4b787612f91eca2&format=plain
Query parameters
grant_type = authorization_code
client_id = 5731b7f036f403b11e56a869ff1bd73b
client_secret = fd14aa1e714dba3109f9f89ea4dde897
code = 1bba730b9d831907e4b787612f91eca2
format = plain
Response
bearer
864000
700d66291b483ec1f4bdff8de8ff9aba
f2f8ea527b044160de33cbd03e7b280d
Required parameters
parameter | description |
---|---|
client_idSTRING | is the public identifier for the app |
client_secretSTRING | secret identifier for the app for mode = secret (see i1/oauth/authorize) or the nonce for mode = secretless (see i1/oauth/authorize) |
grant_typeSTRING | requested authorization type, supported grand types: authorization_code, refresh_token |
Optional parameters
parameter | description |
---|---|
codeSTRING | the code returned from the authorization flow, this parameter is mandatory if grant_type = authorization_code |
refresh_tokenSTRING | refresh token returned by this method in the authorization flow, this parameter is mandatory if grant_type = refresh_token |
std_errorsBOOLEAN | 1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use std_errors = 1 |
Return values
parameter | description |
---|---|
access_token | the access token string as issued by the authorization flow |
expires_in | the duration of time (in seconds) the access token is granted for |
nonce | it is returned only if mode = secretless is passed in the request to i1/oauth/authorize and must be used to call all successive calls to JotUrl's APIs, its value is temporary and must be used within few minutes |
refresh_token | the refresh token can be used to obtain another access token after the issued one has expired, this token is empty if mode = secretless is passed to i1/oauth/authorize |
token_type | The type of token this is, it is just the string bearer |
/oauth/authorize
access: [WRITE]
OAUTH 2.0 Authorization.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=5091c084e5b051842ed9252822500c29&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=c9b833377cdfc2c19ae8a3605fdd5b37
Query parameters
response_type = code
client_id = 5091c084e5b051842ed9252822500c29
redirect_uri = https://www.joturl.com/
scope = rw
state = c9b833377cdfc2c19ae8a3605fdd5b37
Response
{
"code": "a734507446240c7e3437f0209b93d25c",
"state": "c9b833377cdfc2c19ae8a3605fdd5b37",
"mode": "secret"
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=5091c084e5b051842ed9252822500c29&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=c9b833377cdfc2c19ae8a3605fdd5b37&format=xml
Query parameters
response_type = code
client_id = 5091c084e5b051842ed9252822500c29
redirect_uri = https://www.joturl.com/
scope = rw
state = c9b833377cdfc2c19ae8a3605fdd5b37
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<code>a734507446240c7e3437f0209b93d25c</code>
<state>c9b833377cdfc2c19ae8a3605fdd5b37</state>
<mode>secret</mode>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=5091c084e5b051842ed9252822500c29&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=c9b833377cdfc2c19ae8a3605fdd5b37&format=txt
Query parameters
response_type = code
client_id = 5091c084e5b051842ed9252822500c29
redirect_uri = https://www.joturl.com/
scope = rw
state = c9b833377cdfc2c19ae8a3605fdd5b37
format = txt
Response
code=a734507446240c7e3437f0209b93d25c
state=c9b833377cdfc2c19ae8a3605fdd5b37
mode=secret
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/authorize?response_type=code&client_id=5091c084e5b051842ed9252822500c29&redirect_uri=https%3A%2F%2Fwww.joturl.com%2F&scope=rw&state=c9b833377cdfc2c19ae8a3605fdd5b37&format=plain
Query parameters
response_type = code
client_id = 5091c084e5b051842ed9252822500c29
redirect_uri = https://www.joturl.com/
scope = rw
state = c9b833377cdfc2c19ae8a3605fdd5b37
format = plain
Response
a734507446240c7e3437f0209b93d25c
c9b833377cdfc2c19ae8a3605fdd5b37
secret
Required parameters
parameter | description |
---|---|
client_idSTRING | is the public identifier for the app |
redirect_uriSTRING | tells the authorization server where to send the user back to after they approve the request |
response_typeSTRING | have be set to code, indicating that the application expects to receive an authorization code if successful. |
scopeSTRING | one or more space-separated strings indicating which permissions the application is requesting, supported scopes are: rw = read/write access |
stateSTRING | this parameter is used to prevent CSRF attacks |
Optional parameters
parameter | description |
---|---|
modeSTRING | can be secret to use the OAuth 2.0 flow that requires server-to-server communications or secretless for the flow that does not require the client secret (default: secret) |
std_errorsBOOLEAN | 1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use std_errors = 1 |
Return values
parameter | description |
---|---|
[NODATA] | this method does not return any data but redirects to the OAuth 2.0 server to complete the OAuth 2.0 flow |
/oauth/check
access: [WRITE]
Checks if an OAuth 2.0 Authorization was requested.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/check
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "00254c2ba14388c379eef88d1e4db88e",
"app_name": "OAuth 2.0 App Name",
"app_logo": "https:\/\/www.joturl.com\/reserved\/res\/ju2.0\/img\/header\/logo.svg",
"redirect_url": "https:\/\/redirect.to\/?code=2c3662863b751fac3daf76ead88666b9&state=cfb2f9a2cc75535f172c47389afa1603&mode=secret"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/check?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>00254c2ba14388c379eef88d1e4db88e</id>
<app_name>OAuth 2.0 App Name</app_name>
<app_logo>https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg</app_logo>
<redirect_url><[CDATA[https://redirect.to/?code=2c3662863b751fac3daf76ead88666b9&amp;state=cfb2f9a2cc75535f172c47389afa1603&amp;mode=secret]]></redirect_url>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/check?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=00254c2ba14388c379eef88d1e4db88e
result_app_name=OAuth 2.0 App Name
result_app_logo=https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg
result_redirect_url=https://redirect.to/?code=2c3662863b751fac3daf76ead88666b9&amp;state=cfb2f9a2cc75535f172c47389afa1603&amp;mode=secret
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/check?format=plain
Query parameters
format = plain
Response
00254c2ba14388c379eef88d1e4db88e
OAuth 2.0 App Name
https://www.joturl.com/reserved/res/ju2.0/img/header/logo.svg
https://redirect.to/?code=2c3662863b751fac3daf76ead88666b9&amp;state=cfb2f9a2cc75535f172c47389afa1603&amp;mode=secret
Return values
parameter | description |
---|---|
app_logo | the URL to the logo of the application, empty if no authorization request has been made |
app_name | the name of the OAuth 2.0 application, empty if no authorization request has been made |
id | the ID of the OAuth 2.0 application, empty if no authorization request has been made |
nonce | [OPTIONAL] it is returned only if mode = secretless is passed in the request to i1/oauth/authorize |
redirect_url | it has the same value passed in the request to i1/oauth/authorize with parameters code, state and mode appended, empty if no authorization request has been made |
/oauth/granted
/oauth/granted/count
access: [READ]
This method returns the number of granted OAuth 2.0 clients.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/granted/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/granted/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/granted/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/granted/count?format=plain
Query parameters
format = plain
Response
5
Optional parameters
parameter | description |
---|---|
searchSTRING | count OAuth 2.0 clients by searching them |
Return values
parameter | description |
---|---|
count | number of OAuth 2.0 clients the user has granted access to (filtered by search if passed) |
/oauth/granted/list
access: [READ]
This method returns a list of granted OAuth 2.0 clients.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/granted/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"app_name": "OAuth 2.0 Client Name",
"app_logo": "https:\/\/oauth.client\/logo.png"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/granted/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<app_name>OAuth 2.0 Client Name</app_name>
<app_logo>https://oauth.client/logo.png</app_logo>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/granted/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_app_name=OAuth 2.0 Client Name
result_data_0_app_logo=https://oauth.client/logo.png
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/granted/list?format=plain
Query parameters
format = plain
Response
OAuth 2.0 Client Name
https://oauth.client/logo.png
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of OAuth 2.0 clients |
data | array containing required information on clients the user has granted access to |
/oauth/granted/revoke
access: [WRITE]
Revoke granted access to OAuth 2.0 clients.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
Query parameters
ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=xml
Query parameters
ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=txt
Query parameters
ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d&format=plain
Query parameters
ids = d3d9446802a44259755d38e6d163e820,3644a684f98ea8fe223c713b77189a77,e93028bdc1aacdfb3687181f2031765d
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
Query parameters
ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=xml
Query parameters
ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=txt
Query parameters
ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/oauth/granted/revoke?ids=1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b&format=plain
Query parameters
ids = 1bd69c7df3112fb9a584fbd9edfc6c90,1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
format = plain
Response
1017bfd4673955ffee4641ad3d481b1c,14ee22eaba297944c96afdbe5b16c65b
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of OAuth 2.0 client IDs to be revoked |
Return values
parameter | description |
---|---|
deleted | number of revoked OAuth 2.0 clients |
ids | [OPTIONAL] list of OAuth 2.0 client IDs whose revoke has failed, this parameter is returned only when at least one revoke error has occurred |
/oauth/test
access: [WRITE]
Call this endpoint to test OAuth 2.0 authentication credentials.
Example 1 (json)
Request
https://joturl.com/a/i1/oauth/test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"success": "1"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/oauth/test?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<success>1</success>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/oauth/test?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_success=1
Example 4 (plain)
Request
https://joturl.com/a/i1/oauth/test?format=plain
Query parameters
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
std_errorsBOOLEAN | 1 to return standard OAuth 2.0 errors, otherwise errors that respect this documentation will be returned (default: 0 for backward compatibility, this will be changed in the near future, so it is advisable to use std_errors = 1 |
Return values
parameter | description |
---|---|
success | 1 on success, otherwise an authentication error is returned |
/permissions
/permissions/add
access: [WRITE]
Define a new permission.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%2217f0a32af31cb0f1529257d6273fcdf1%22,%22e1f626f76a5dc3ba8ad932d1a3079124%22,%225885a357645375684eb46fcebc2cd64e%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D
Query parameters
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["17f0a32af31cb0f1529257d6273fcdf1","e1f626f76a5dc3ba8ad932d1a3079124","5885a357645375684eb46fcebc2cd64e"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "f3367a99803208019f00df60e2666f00",
"name": "name of the permission",
"notes": "",
"info": {
"apis": {
"access_to": {
"all_except": []
}
},
"conversions": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"ctas": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"domains": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to": {
"all_except": []
},
"all_except": [
{
"id": "17f0a32af31cb0f1529257d6273fcdf1",
"name": "domain_0"
},
{
"id": "e1f626f76a5dc3ba8ad932d1a3079124",
"name": "domain_1"
},
{
"id": "5885a357645375684eb46fcebc2cd64e",
"name": "domain_2"
}
]
},
"plans": {
"can_manage_plans": 0,
"can_manage_billing": 0
},
"projects": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to_default": 1
},
"remarketings": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"security": {
"inactivity_timeout": 0,
"inactivity_timeout_value": 15,
"force_change_password": 0,
"force_change_password_interval": 3,
"do_not_allow_old_passwords": 0,
"do_not_allow_old_passwords_value": 4,
"disable_inactive_account": 0,
"disable_inactive_account_value": 6,
"warning_on_anomalous_logins": 0
},
"subusers": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%2217f0a32af31cb0f1529257d6273fcdf1%22,%22e1f626f76a5dc3ba8ad932d1a3079124%22,%225885a357645375684eb46fcebc2cd64e%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=xml
Query parameters
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["17f0a32af31cb0f1529257d6273fcdf1","e1f626f76a5dc3ba8ad932d1a3079124","5885a357645375684eb46fcebc2cd64e"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>f3367a99803208019f00df60e2666f00</id>
<name>name of the permission</name>
<notes></notes>
<info>
<apis>
<access_to>
<all_except>
</all_except>
</access_to>
</apis>
<conversions>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</conversions>
<ctas>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</ctas>
<domains>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to>
<all_except>
</all_except>
</access_to>
<all_except>
<i0>
<id>17f0a32af31cb0f1529257d6273fcdf1</id>
<name>domain_0</name>
</i0>
<i1>
<id>e1f626f76a5dc3ba8ad932d1a3079124</id>
<name>domain_1</name>
</i1>
<i2>
<id>5885a357645375684eb46fcebc2cd64e</id>
<name>domain_2</name>
</i2>
</all_except>
</domains>
<plans>
<can_manage_plans>0</can_manage_plans>
<can_manage_billing>0</can_manage_billing>
</plans>
<projects>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to_default>1</access_to_default>
</projects>
<remarketings>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</remarketings>
<security>
<inactivity_timeout>0</inactivity_timeout>
<inactivity_timeout_value>15</inactivity_timeout_value>
<force_change_password>0</force_change_password>
<force_change_password_interval>3</force_change_password_interval>
<do_not_allow_old_passwords>0</do_not_allow_old_passwords>
<do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>
<disable_inactive_account>0</disable_inactive_account>
<disable_inactive_account_value>6</disable_inactive_account_value>
<warning_on_anomalous_logins>0</warning_on_anomalous_logins>
</security>
<subusers>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
</subusers>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%2217f0a32af31cb0f1529257d6273fcdf1%22,%22e1f626f76a5dc3ba8ad932d1a3079124%22,%225885a357645375684eb46fcebc2cd64e%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=txt
Query parameters
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["17f0a32af31cb0f1529257d6273fcdf1","e1f626f76a5dc3ba8ad932d1a3079124","5885a357645375684eb46fcebc2cd64e"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=f3367a99803208019f00df60e2666f00
result_name=name of the permission
result_notes=
result_info_apis_access_to_all_except=
result_info_conversions_can_add=1
result_info_conversions_can_edit=1
result_info_conversions_can_delete=1
result_info_conversions_can_link=1
result_info_conversions_can_unlink=1
result_info_conversions_access_to_all_except=
result_info_ctas_can_add=1
result_info_ctas_can_edit=1
result_info_ctas_can_delete=1
result_info_ctas_can_link=1
result_info_ctas_can_unlink=1
result_info_ctas_access_to_all_except=
result_info_domains_can_add=1
result_info_domains_can_edit=1
result_info_domains_can_delete=1
result_info_domains_access_to_all_except=
result_info_domains_all_except_0_id=17f0a32af31cb0f1529257d6273fcdf1
result_info_domains_all_except_0_name=domain_0
result_info_domains_all_except_1_id=e1f626f76a5dc3ba8ad932d1a3079124
result_info_domains_all_except_1_name=domain_1
result_info_domains_all_except_2_id=5885a357645375684eb46fcebc2cd64e
result_info_domains_all_except_2_name=domain_2
result_info_plans_can_manage_plans=0
result_info_plans_can_manage_billing=0
result_info_projects_can_add=1
result_info_projects_can_edit=1
result_info_projects_can_delete=1
result_info_projects_access_to_default=1
result_info_remarketings_can_add=1
result_info_remarketings_can_edit=1
result_info_remarketings_can_delete=1
result_info_remarketings_can_link=1
result_info_remarketings_can_unlink=1
result_info_remarketings_access_to_all_except=
result_info_security_inactivity_timeout=0
result_info_security_inactivity_timeout_value=15
result_info_security_force_change_password=0
result_info_security_force_change_password_interval=3
result_info_security_do_not_allow_old_passwords=0
result_info_security_do_not_allow_old_passwords_value=4
result_info_security_disable_inactive_account=0
result_info_security_disable_inactive_account_value=6
result_info_security_warning_on_anomalous_logins=0
result_info_subusers_can_add=1
result_info_subusers_can_edit=1
result_info_subusers_can_delete=1
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/add?name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%2217f0a32af31cb0f1529257d6273fcdf1%22,%22e1f626f76a5dc3ba8ad932d1a3079124%22,%225885a357645375684eb46fcebc2cd64e%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=plain
Query parameters
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["17f0a32af31cb0f1529257d6273fcdf1","e1f626f76a5dc3ba8ad932d1a3079124","5885a357645375684eb46fcebc2cd64e"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = plain
Response
f3367a99803208019f00df60e2666f00
name of the permission
1
1
1
1
1
1
1
1
1
1
1
1
1
17f0a32af31cb0f1529257d6273fcdf1
domain_0
e1f626f76a5dc3ba8ad932d1a3079124
domain_1
5885a357645375684eb46fcebc2cd64e
domain_2
0
0
1
1
1
1
1
1
1
1
1
0
15
0
3
0
4
0
6
0
1
1
1
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | name of the permission | 100 |
Optional parameters
parameter | description | max length |
---|---|---|
infoJSON | information on access rights, see i1/permissions/property for details | |
notesSTRING | notes for the permission | 255 |
Return values
parameter | description |
---|---|
id | ID of the permission |
info | information on access rights |
name | echo back of the input parameter name |
notes | echo back of the input parameter notes |
/permissions/count
access: [READ]
This method returns the number of user's permissions.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 954
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>954</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=954
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/count?format=plain
Query parameters
format = plain
Response
954
Example 5 (json)
Request
https://joturl.com/a/i1/permissions/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 323
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/permissions/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>323</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/permissions/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=323
Example 8 (plain)
Request
https://joturl.com/a/i1/permissions/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
323
Optional parameters
parameter | description |
---|---|
searchSTRING | count permissions by searching them |
Return values
parameter | description |
---|---|
count | number of permissions (filtered by search if passed) |
/permissions/delete
access: [WRITE]
Delete one or more permissions.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
Query parameters
ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=xml
Query parameters
ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=txt
Query parameters
ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/delete?ids=37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1&format=plain
Query parameters
ids = 37693cfc748049e45d87b8c7d8b9aacd,e92ea2e30768f2fda96f7e9eba39c6eb,f569c3d708a7558b3049d2896d2b6ce1
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
Query parameters
ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=xml
Query parameters
ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=txt
Query parameters
ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/permissions/delete?ids=2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898&format=plain
Query parameters
ids = 2e0aca891f2a8aedf265edf533a6d9a8,3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
format = plain
Response
3d324c2883882b15fa8fbe8f025a3a99,a330238f5e5026982abe38b8f2215898
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of permission IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted permissions |
ids | [OPTIONAL] list of permission IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/permissions/edit
access: [WRITE]
Edit a permission.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/edit?id=94b5e56792de9b180533442190d68e8a&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c80cfbff6c7506bbdd12efefad32ed98%22,%22e0b787abe87ce9e4e92910ecdce602cc%22,%22cfadd95dd15f281b24909d2fd7b5fa96%22,%22dc77a64dcc2ba900a743798cb8a4908c%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D
Query parameters
id = 94b5e56792de9b180533442190d68e8a
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c80cfbff6c7506bbdd12efefad32ed98","e0b787abe87ce9e4e92910ecdce602cc","cfadd95dd15f281b24909d2fd7b5fa96","dc77a64dcc2ba900a743798cb8a4908c"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "94b5e56792de9b180533442190d68e8a",
"info": {
"apis": {
"access_to": {
"all_except": []
}
},
"conversions": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"ctas": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"domains": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to": {
"all_except": []
},
"all_except": [
{
"id": "c80cfbff6c7506bbdd12efefad32ed98",
"name": "domain_0"
},
{
"id": "e0b787abe87ce9e4e92910ecdce602cc",
"name": "domain_1"
},
{
"id": "cfadd95dd15f281b24909d2fd7b5fa96",
"name": "domain_2"
},
{
"id": "dc77a64dcc2ba900a743798cb8a4908c",
"name": "domain_3"
}
]
},
"plans": {
"can_manage_plans": 0,
"can_manage_billing": 0
},
"projects": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to_default": 1
},
"remarketings": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"security": {
"inactivity_timeout": 0,
"inactivity_timeout_value": 15,
"force_change_password": 0,
"force_change_password_interval": 3,
"do_not_allow_old_passwords": 0,
"do_not_allow_old_passwords_value": 4,
"disable_inactive_account": 0,
"disable_inactive_account_value": 6,
"warning_on_anomalous_logins": 0
},
"subusers": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/edit?id=94b5e56792de9b180533442190d68e8a&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c80cfbff6c7506bbdd12efefad32ed98%22,%22e0b787abe87ce9e4e92910ecdce602cc%22,%22cfadd95dd15f281b24909d2fd7b5fa96%22,%22dc77a64dcc2ba900a743798cb8a4908c%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=xml
Query parameters
id = 94b5e56792de9b180533442190d68e8a
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c80cfbff6c7506bbdd12efefad32ed98","e0b787abe87ce9e4e92910ecdce602cc","cfadd95dd15f281b24909d2fd7b5fa96","dc77a64dcc2ba900a743798cb8a4908c"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>94b5e56792de9b180533442190d68e8a</id>
<info>
<apis>
<access_to>
<all_except>
</all_except>
</access_to>
</apis>
<conversions>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</conversions>
<ctas>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</ctas>
<domains>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to>
<all_except>
</all_except>
</access_to>
<all_except>
<i0>
<id>c80cfbff6c7506bbdd12efefad32ed98</id>
<name>domain_0</name>
</i0>
<i1>
<id>e0b787abe87ce9e4e92910ecdce602cc</id>
<name>domain_1</name>
</i1>
<i2>
<id>cfadd95dd15f281b24909d2fd7b5fa96</id>
<name>domain_2</name>
</i2>
<i3>
<id>dc77a64dcc2ba900a743798cb8a4908c</id>
<name>domain_3</name>
</i3>
</all_except>
</domains>
<plans>
<can_manage_plans>0</can_manage_plans>
<can_manage_billing>0</can_manage_billing>
</plans>
<projects>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to_default>1</access_to_default>
</projects>
<remarketings>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</remarketings>
<security>
<inactivity_timeout>0</inactivity_timeout>
<inactivity_timeout_value>15</inactivity_timeout_value>
<force_change_password>0</force_change_password>
<force_change_password_interval>3</force_change_password_interval>
<do_not_allow_old_passwords>0</do_not_allow_old_passwords>
<do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>
<disable_inactive_account>0</disable_inactive_account>
<disable_inactive_account_value>6</disable_inactive_account_value>
<warning_on_anomalous_logins>0</warning_on_anomalous_logins>
</security>
<subusers>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
</subusers>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/edit?id=94b5e56792de9b180533442190d68e8a&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c80cfbff6c7506bbdd12efefad32ed98%22,%22e0b787abe87ce9e4e92910ecdce602cc%22,%22cfadd95dd15f281b24909d2fd7b5fa96%22,%22dc77a64dcc2ba900a743798cb8a4908c%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=txt
Query parameters
id = 94b5e56792de9b180533442190d68e8a
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c80cfbff6c7506bbdd12efefad32ed98","e0b787abe87ce9e4e92910ecdce602cc","cfadd95dd15f281b24909d2fd7b5fa96","dc77a64dcc2ba900a743798cb8a4908c"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=94b5e56792de9b180533442190d68e8a
result_info_apis_access_to_all_except=
result_info_conversions_can_add=1
result_info_conversions_can_edit=1
result_info_conversions_can_delete=1
result_info_conversions_can_link=1
result_info_conversions_can_unlink=1
result_info_conversions_access_to_all_except=
result_info_ctas_can_add=1
result_info_ctas_can_edit=1
result_info_ctas_can_delete=1
result_info_ctas_can_link=1
result_info_ctas_can_unlink=1
result_info_ctas_access_to_all_except=
result_info_domains_can_add=1
result_info_domains_can_edit=1
result_info_domains_can_delete=1
result_info_domains_access_to_all_except=
result_info_domains_all_except_0_id=c80cfbff6c7506bbdd12efefad32ed98
result_info_domains_all_except_0_name=domain_0
result_info_domains_all_except_1_id=e0b787abe87ce9e4e92910ecdce602cc
result_info_domains_all_except_1_name=domain_1
result_info_domains_all_except_2_id=cfadd95dd15f281b24909d2fd7b5fa96
result_info_domains_all_except_2_name=domain_2
result_info_domains_all_except_3_id=dc77a64dcc2ba900a743798cb8a4908c
result_info_domains_all_except_3_name=domain_3
result_info_plans_can_manage_plans=0
result_info_plans_can_manage_billing=0
result_info_projects_can_add=1
result_info_projects_can_edit=1
result_info_projects_can_delete=1
result_info_projects_access_to_default=1
result_info_remarketings_can_add=1
result_info_remarketings_can_edit=1
result_info_remarketings_can_delete=1
result_info_remarketings_can_link=1
result_info_remarketings_can_unlink=1
result_info_remarketings_access_to_all_except=
result_info_security_inactivity_timeout=0
result_info_security_inactivity_timeout_value=15
result_info_security_force_change_password=0
result_info_security_force_change_password_interval=3
result_info_security_do_not_allow_old_passwords=0
result_info_security_do_not_allow_old_passwords_value=4
result_info_security_disable_inactive_account=0
result_info_security_disable_inactive_account_value=6
result_info_security_warning_on_anomalous_logins=0
result_info_subusers_can_add=1
result_info_subusers_can_edit=1
result_info_subusers_can_delete=1
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/edit?id=94b5e56792de9b180533442190d68e8a&name=name+of+the+permission&info=%7B%22apis%22%3A%7B%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22conversions%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22ctas%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22domains%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D,%22all_except%22%3A%5B%22c80cfbff6c7506bbdd12efefad32ed98%22,%22e0b787abe87ce9e4e92910ecdce602cc%22,%22cfadd95dd15f281b24909d2fd7b5fa96%22,%22dc77a64dcc2ba900a743798cb8a4908c%22%5D%7D,%22plans%22%3A%7B%22can_manage_plans%22%3A0,%22can_manage_billing%22%3A0%7D,%22projects%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22access_to_default%22%3A1%7D,%22remarketings%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1,%22can_link%22%3A1,%22can_unlink%22%3A1,%22access_to%22%3A%7B%22all_except%22%3A%5B%5D%7D%7D,%22security%22%3A%7B%22inactivity_timeout%22%3A0,%22inactivity_timeout_value%22%3A15,%22force_change_password%22%3A0,%22force_change_password_interval%22%3A3,%22do_not_allow_old_passwords%22%3A0,%22do_not_allow_old_passwords_value%22%3A4,%22disable_inactive_account%22%3A0,%22disable_inactive_account_value%22%3A6,%22warning_on_anomalous_logins%22%3A0%7D,%22subusers%22%3A%7B%22can_add%22%3A1,%22can_edit%22%3A1,%22can_delete%22%3A1%7D%7D&format=plain
Query parameters
id = 94b5e56792de9b180533442190d68e8a
name = name of the permission
info = {"apis":{"access_to":{"all_except":[]}},"conversions":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"ctas":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"domains":{"can_add":1,"can_edit":1,"can_delete":1,"access_to":{"all_except":[]},"all_except":["c80cfbff6c7506bbdd12efefad32ed98","e0b787abe87ce9e4e92910ecdce602cc","cfadd95dd15f281b24909d2fd7b5fa96","dc77a64dcc2ba900a743798cb8a4908c"]},"plans":{"can_manage_plans":0,"can_manage_billing":0},"projects":{"can_add":1,"can_edit":1,"can_delete":1,"access_to_default":1},"remarketings":{"can_add":1,"can_edit":1,"can_delete":1,"can_link":1,"can_unlink":1,"access_to":{"all_except":[]}},"security":{"inactivity_timeout":0,"inactivity_timeout_value":15,"force_change_password":0,"force_change_password_interval":3,"do_not_allow_old_passwords":0,"do_not_allow_old_passwords_value":4,"disable_inactive_account":0,"disable_inactive_account_value":6,"warning_on_anomalous_logins":0},"subusers":{"can_add":1,"can_edit":1,"can_delete":1}}
format = plain
Response
94b5e56792de9b180533442190d68e8a
1
1
1
1
1
1
1
1
1
1
1
1
1
c80cfbff6c7506bbdd12efefad32ed98
domain_0
e0b787abe87ce9e4e92910ecdce602cc
domain_1
cfadd95dd15f281b24909d2fd7b5fa96
domain_2
dc77a64dcc2ba900a743798cb8a4908c
domain_3
0
0
1
1
1
1
1
1
1
1
1
0
15
0
3
0
4
0
6
0
1
1
1
Required parameters
parameter | description |
---|---|
idID | ID of the permission |
Optional parameters
parameter | description | max length |
---|---|---|
infoJSON | information on access rights, see i1/permissions/property for details | |
nameSTRING | name of the permission | 100 |
notesSTRING | notes of the permission | 255 |
Return values
parameter | description |
---|---|
id | ID of the permission |
info | information on access rights |
name | name of the permission |
notes | notes of the permission |
/permissions/info
access: [READ]
This method returns information on a permission.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/info?id=4e82227f3b4a149e56ae01d0c7f4bd3d
Query parameters
id = 4e82227f3b4a149e56ae01d0c7f4bd3d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"id": "4e82227f3b4a149e56ae01d0c7f4bd3d",
"name": "name of the permission",
"notes": "notes for the permission",
"info": {
"apis": {
"access_to": {
"all_except": []
}
},
"conversions": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"ctas": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"domains": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to": {
"all_except": []
},
"all_except": [
{
"id": "362764b96f5f2ac51c39054e24876b31",
"name": "domain_0"
},
{
"id": "d586642a6a8669270774fe83a0f1226c",
"name": "domain_1"
},
{
"id": "15290ee14f13669c7076a296228c4af9",
"name": "domain_2"
},
{
"id": "f2f7446204e926c06cae959d006b3110",
"name": "domain_3"
}
]
},
"plans": {
"can_manage_plans": 0,
"can_manage_billing": 0
},
"projects": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"access_to_default": 1
},
"remarketings": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1,
"can_link": 1,
"can_unlink": 1,
"access_to": {
"all_except": []
}
},
"security": {
"inactivity_timeout": 0,
"inactivity_timeout_value": 15,
"force_change_password": 0,
"force_change_password_interval": 3,
"do_not_allow_old_passwords": 0,
"do_not_allow_old_passwords_value": 4,
"disable_inactive_account": 0,
"disable_inactive_account_value": 6,
"warning_on_anomalous_logins": 0
},
"subusers": {
"can_add": 1,
"can_edit": 1,
"can_delete": 1
}
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/info?id=4e82227f3b4a149e56ae01d0c7f4bd3d&format=xml
Query parameters
id = 4e82227f3b4a149e56ae01d0c7f4bd3d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<id>4e82227f3b4a149e56ae01d0c7f4bd3d</id>
<name>name of the permission</name>
<notes>notes for the permission</notes>
<info>
<apis>
<access_to>
<all_except>
</all_except>
</access_to>
</apis>
<conversions>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</conversions>
<ctas>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</ctas>
<domains>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to>
<all_except>
</all_except>
</access_to>
<all_except>
<i0>
<id>362764b96f5f2ac51c39054e24876b31</id>
<name>domain_0</name>
</i0>
<i1>
<id>d586642a6a8669270774fe83a0f1226c</id>
<name>domain_1</name>
</i1>
<i2>
<id>15290ee14f13669c7076a296228c4af9</id>
<name>domain_2</name>
</i2>
<i3>
<id>f2f7446204e926c06cae959d006b3110</id>
<name>domain_3</name>
</i3>
</all_except>
</domains>
<plans>
<can_manage_plans>0</can_manage_plans>
<can_manage_billing>0</can_manage_billing>
</plans>
<projects>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<access_to_default>1</access_to_default>
</projects>
<remarketings>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
<can_link>1</can_link>
<can_unlink>1</can_unlink>
<access_to>
<all_except>
</all_except>
</access_to>
</remarketings>
<security>
<inactivity_timeout>0</inactivity_timeout>
<inactivity_timeout_value>15</inactivity_timeout_value>
<force_change_password>0</force_change_password>
<force_change_password_interval>3</force_change_password_interval>
<do_not_allow_old_passwords>0</do_not_allow_old_passwords>
<do_not_allow_old_passwords_value>4</do_not_allow_old_passwords_value>
<disable_inactive_account>0</disable_inactive_account>
<disable_inactive_account_value>6</disable_inactive_account_value>
<warning_on_anomalous_logins>0</warning_on_anomalous_logins>
</security>
<subusers>
<can_add>1</can_add>
<can_edit>1</can_edit>
<can_delete>1</can_delete>
</subusers>
</info>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/info?id=4e82227f3b4a149e56ae01d0c7f4bd3d&format=txt
Query parameters
id = 4e82227f3b4a149e56ae01d0c7f4bd3d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_id=4e82227f3b4a149e56ae01d0c7f4bd3d
result_data_name=name of the permission
result_data_notes=notes for the permission
result_data_info_apis_access_to_all_except=
result_data_info_conversions_can_add=1
result_data_info_conversions_can_edit=1
result_data_info_conversions_can_delete=1
result_data_info_conversions_can_link=1
result_data_info_conversions_can_unlink=1
result_data_info_conversions_access_to_all_except=
result_data_info_ctas_can_add=1
result_data_info_ctas_can_edit=1
result_data_info_ctas_can_delete=1
result_data_info_ctas_can_link=1
result_data_info_ctas_can_unlink=1
result_data_info_ctas_access_to_all_except=
result_data_info_domains_can_add=1
result_data_info_domains_can_edit=1
result_data_info_domains_can_delete=1
result_data_info_domains_access_to_all_except=
result_data_info_domains_all_except_0_id=362764b96f5f2ac51c39054e24876b31
result_data_info_domains_all_except_0_name=domain_0
result_data_info_domains_all_except_1_id=d586642a6a8669270774fe83a0f1226c
result_data_info_domains_all_except_1_name=domain_1
result_data_info_domains_all_except_2_id=15290ee14f13669c7076a296228c4af9
result_data_info_domains_all_except_2_name=domain_2
result_data_info_domains_all_except_3_id=f2f7446204e926c06cae959d006b3110
result_data_info_domains_all_except_3_name=domain_3
result_data_info_plans_can_manage_plans=0
result_data_info_plans_can_manage_billing=0
result_data_info_projects_can_add=1
result_data_info_projects_can_edit=1
result_data_info_projects_can_delete=1
result_data_info_projects_access_to_default=1
result_data_info_remarketings_can_add=1
result_data_info_remarketings_can_edit=1
result_data_info_remarketings_can_delete=1
result_data_info_remarketings_can_link=1
result_data_info_remarketings_can_unlink=1
result_data_info_remarketings_access_to_all_except=
result_data_info_security_inactivity_timeout=0
result_data_info_security_inactivity_timeout_value=15
result_data_info_security_force_change_password=0
result_data_info_security_force_change_password_interval=3
result_data_info_security_do_not_allow_old_passwords=0
result_data_info_security_do_not_allow_old_passwords_value=4
result_data_info_security_disable_inactive_account=0
result_data_info_security_disable_inactive_account_value=6
result_data_info_security_warning_on_anomalous_logins=0
result_data_info_subusers_can_add=1
result_data_info_subusers_can_edit=1
result_data_info_subusers_can_delete=1
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/info?id=4e82227f3b4a149e56ae01d0c7f4bd3d&format=plain
Query parameters
id = 4e82227f3b4a149e56ae01d0c7f4bd3d
format = plain
Response
4e82227f3b4a149e56ae01d0c7f4bd3d
name of the permission
notes for the permission
1
1
1
1
1
1
1
1
1
1
1
1
1
362764b96f5f2ac51c39054e24876b31
domain_0
d586642a6a8669270774fe83a0f1226c
domain_1
15290ee14f13669c7076a296228c4af9
domain_2
f2f7446204e926c06cae959d006b3110
domain_3
0
0
1
1
1
1
1
1
1
1
1
0
15
0
3
0
4
0
6
0
1
1
1
Required parameters
parameter | description |
---|---|
idID | ID of the permission |
Return values
parameter | description |
---|---|
data | array containing information on the permission, see i1/permissions/list and i1/permissions/property for details |
/permissions/list
access: [READ]
This method returns a list of user-defined permissions.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "e8e6276e183f77adbfe28977567a7619",
"name": "name of the permission",
"notes": "notes for the permission"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>e8e6276e183f77adbfe28977567a7619</id>
<name>name of the permission</name>
<notes>notes for the permission</notes>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=e8e6276e183f77adbfe28977567a7619
result_data_0_name=name of the permission
result_data_0_notes=notes for the permission
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/list?format=plain
Query parameters
format = plain
Response
1
e8e6276e183f77adbfe28977567a7619
name of the permission
notes for the permission
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of permissions |
data | array containing information on permissions |
/permissions/property
access: [READ]
This method returns access rights you can use to create a permission. Each access right is grouped by contexts.
Example 1 (json)
Request
https://joturl.com/a/i1/permissions/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"apis": {
"access_to": {
"type": "complementary_ids",
"default": {
"all_except": []
},
"available": 1
}
},
"conversions": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
},
"can_link": {
"type": "bool",
"default": 1,
"available": 1
},
"can_unlink": {
"type": "bool",
"default": 1,
"available": 1
},
"access_to": {
"type": "complementary_ids",
"default": {
"all_except": []
},
"available": 1
}
},
"ctas": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
},
"can_link": {
"type": "bool",
"default": 1,
"available": 1
},
"can_unlink": {
"type": "bool",
"default": 1,
"available": 1
},
"access_to": {
"type": "complementary_ids",
"default": {
"all_except": []
},
"available": 1
}
},
"domains": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
},
"access_to": {
"type": "complementary_ids",
"default": {
"all_except": []
},
"available": 1
}
},
"plans": {
"can_manage_plans": {
"type": "bool",
"default": 0,
"available": 1
},
"can_manage_billing": {
"type": "bool",
"default": 0,
"available": 1
}
},
"projects": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
},
"access_to_default": {
"type": "bool",
"default": 1,
"available": 1
}
},
"remarketings": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
},
"can_link": {
"type": "bool",
"default": 1,
"available": 1
},
"can_unlink": {
"type": "bool",
"default": 1,
"available": 1
},
"access_to": {
"type": "complementary_ids",
"default": {
"all_except": []
},
"available": 1
}
},
"security": {
"inactivity_timeout": {
"ref_value": "inactivity_timeout_value",
"type": "bool_with_value",
"default": 0,
"available": 1
},
"inactivity_timeout_value": {
"type": "int",
"default": 15,
"min": 15,
"max": 43200,
"available": 1
},
"force_change_password": {
"ref_value": "force_change_password_interval",
"type": "bool_with_value",
"default": 0,
"available": 1
},
"force_change_password_interval": {
"type": "int",
"default": 3,
"min": 2,
"max": 60,
"available": 1
},
"do_not_allow_old_passwords": {
"ref_value": "do_not_allow_old_passwords_value",
"type": "bool_with_value",
"default": 0,
"available": 1
},
"do_not_allow_old_passwords_value": {
"type": "int",
"default": 4,
"min": 2,
"max": 10,
"available": 1
},
"disable_inactive_account": {
"ref_value": "disable_inactive_account_value",
"type": "bool_with_value",
"default": 0,
"available": 1
},
"disable_inactive_account_value": {
"type": "int",
"default": 6,
"min": 2,
"max": 36,
"available": 1
},
"warning_on_anomalous_logins": {
"type": "bool",
"default": 0,
"available": 1
}
},
"subusers": {
"can_add": {
"type": "bool",
"default": 1,
"available": 1
},
"can_edit": {
"type": "bool",
"default": 1,
"available": 1
},
"can_delete": {
"type": "bool",
"default": 1,
"available": 1
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/permissions/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<apis>
<access_to>
<type>complementary_ids</type>
<default>
<all_except>
</all_except>
</default>
<available>1</available>
</access_to>
</apis>
<conversions>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
<can_link>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_link>
<can_unlink>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_unlink>
<access_to>
<type>complementary_ids</type>
<default>
<all_except>
</all_except>
</default>
<available>1</available>
</access_to>
</conversions>
<ctas>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
<can_link>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_link>
<can_unlink>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_unlink>
<access_to>
<type>complementary_ids</type>
<default>
<all_except>
</all_except>
</default>
<available>1</available>
</access_to>
</ctas>
<domains>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
<access_to>
<type>complementary_ids</type>
<default>
<all_except>
</all_except>
</default>
<available>1</available>
</access_to>
</domains>
<plans>
<can_manage_plans>
<type>bool</type>
<default>0</default>
<available>1</available>
</can_manage_plans>
<can_manage_billing>
<type>bool</type>
<default>0</default>
<available>1</available>
</can_manage_billing>
</plans>
<projects>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
<access_to_default>
<type>bool</type>
<default>1</default>
<available>1</available>
</access_to_default>
</projects>
<remarketings>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
<can_link>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_link>
<can_unlink>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_unlink>
<access_to>
<type>complementary_ids</type>
<default>
<all_except>
</all_except>
</default>
<available>1</available>
</access_to>
</remarketings>
<security>
<inactivity_timeout>
<ref_value>inactivity_timeout_value</ref_value>
<type>bool_with_value</type>
<default>0</default>
<available>1</available>
</inactivity_timeout>
<inactivity_timeout_value>
<type>int</type>
<default>15</default>
<min>15</min>
<max>43200</max>
<available>1</available>
</inactivity_timeout_value>
<force_change_password>
<ref_value>force_change_password_interval</ref_value>
<type>bool_with_value</type>
<default>0</default>
<available>1</available>
</force_change_password>
<force_change_password_interval>
<type>int</type>
<default>3</default>
<min>2</min>
<max>60</max>
<available>1</available>
</force_change_password_interval>
<do_not_allow_old_passwords>
<ref_value>do_not_allow_old_passwords_value</ref_value>
<type>bool_with_value</type>
<default>0</default>
<available>1</available>
</do_not_allow_old_passwords>
<do_not_allow_old_passwords_value>
<type>int</type>
<default>4</default>
<min>2</min>
<max>10</max>
<available>1</available>
</do_not_allow_old_passwords_value>
<disable_inactive_account>
<ref_value>disable_inactive_account_value</ref_value>
<type>bool_with_value</type>
<default>0</default>
<available>1</available>
</disable_inactive_account>
<disable_inactive_account_value>
<type>int</type>
<default>6</default>
<min>2</min>
<max>36</max>
<available>1</available>
</disable_inactive_account_value>
<warning_on_anomalous_logins>
<type>bool</type>
<default>0</default>
<available>1</available>
</warning_on_anomalous_logins>
</security>
<subusers>
<can_add>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_add>
<can_edit>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_edit>
<can_delete>
<type>bool</type>
<default>1</default>
<available>1</available>
</can_delete>
</subusers>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/permissions/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_apis_access_to_type=complementary_ids
result_apis_access_to_default_all_except=
result_apis_access_to_available=1
result_conversions_can_add_type=bool
result_conversions_can_add_default=1
result_conversions_can_add_available=1
result_conversions_can_edit_type=bool
result_conversions_can_edit_default=1
result_conversions_can_edit_available=1
result_conversions_can_delete_type=bool
result_conversions_can_delete_default=1
result_conversions_can_delete_available=1
result_conversions_can_link_type=bool
result_conversions_can_link_default=1
result_conversions_can_link_available=1
result_conversions_can_unlink_type=bool
result_conversions_can_unlink_default=1
result_conversions_can_unlink_available=1
result_conversions_access_to_type=complementary_ids
result_conversions_access_to_default_all_except=
result_conversions_access_to_available=1
result_ctas_can_add_type=bool
result_ctas_can_add_default=1
result_ctas_can_add_available=1
result_ctas_can_edit_type=bool
result_ctas_can_edit_default=1
result_ctas_can_edit_available=1
result_ctas_can_delete_type=bool
result_ctas_can_delete_default=1
result_ctas_can_delete_available=1
result_ctas_can_link_type=bool
result_ctas_can_link_default=1
result_ctas_can_link_available=1
result_ctas_can_unlink_type=bool
result_ctas_can_unlink_default=1
result_ctas_can_unlink_available=1
result_ctas_access_to_type=complementary_ids
result_ctas_access_to_default_all_except=
result_ctas_access_to_available=1
result_domains_can_add_type=bool
result_domains_can_add_default=1
result_domains_can_add_available=1
result_domains_can_edit_type=bool
result_domains_can_edit_default=1
result_domains_can_edit_available=1
result_domains_can_delete_type=bool
result_domains_can_delete_default=1
result_domains_can_delete_available=1
result_domains_access_to_type=complementary_ids
result_domains_access_to_default_all_except=
result_domains_access_to_available=1
result_plans_can_manage_plans_type=bool
result_plans_can_manage_plans_default=0
result_plans_can_manage_plans_available=1
result_plans_can_manage_billing_type=bool
result_plans_can_manage_billing_default=0
result_plans_can_manage_billing_available=1
result_projects_can_add_type=bool
result_projects_can_add_default=1
result_projects_can_add_available=1
result_projects_can_edit_type=bool
result_projects_can_edit_default=1
result_projects_can_edit_available=1
result_projects_can_delete_type=bool
result_projects_can_delete_default=1
result_projects_can_delete_available=1
result_projects_access_to_default_type=bool
result_projects_access_to_default_default=1
result_projects_access_to_default_available=1
result_remarketings_can_add_type=bool
result_remarketings_can_add_default=1
result_remarketings_can_add_available=1
result_remarketings_can_edit_type=bool
result_remarketings_can_edit_default=1
result_remarketings_can_edit_available=1
result_remarketings_can_delete_type=bool
result_remarketings_can_delete_default=1
result_remarketings_can_delete_available=1
result_remarketings_can_link_type=bool
result_remarketings_can_link_default=1
result_remarketings_can_link_available=1
result_remarketings_can_unlink_type=bool
result_remarketings_can_unlink_default=1
result_remarketings_can_unlink_available=1
result_remarketings_access_to_type=complementary_ids
result_remarketings_access_to_default_all_except=
result_remarketings_access_to_available=1
result_security_inactivity_timeout_ref_value=inactivity_timeout_value
result_security_inactivity_timeout_type=bool_with_value
result_security_inactivity_timeout_default=0
result_security_inactivity_timeout_available=1
result_security_inactivity_timeout_value_type=int
result_security_inactivity_timeout_value_default=15
result_security_inactivity_timeout_value_min=15
result_security_inactivity_timeout_value_max=43200
result_security_inactivity_timeout_value_available=1
result_security_force_change_password_ref_value=force_change_password_interval
result_security_force_change_password_type=bool_with_value
result_security_force_change_password_default=0
result_security_force_change_password_available=1
result_security_force_change_password_interval_type=int
result_security_force_change_password_interval_default=3
result_security_force_change_password_interval_min=2
result_security_force_change_password_interval_max=60
result_security_force_change_password_interval_available=1
result_security_do_not_allow_old_passwords_ref_value=do_not_allow_old_passwords_value
result_security_do_not_allow_old_passwords_type=bool_with_value
result_security_do_not_allow_old_passwords_default=0
result_security_do_not_allow_old_passwords_available=1
result_security_do_not_allow_old_passwords_value_type=int
result_security_do_not_allow_old_passwords_value_default=4
result_security_do_not_allow_old_passwords_value_min=2
result_security_do_not_allow_old_passwords_value_max=10
result_security_do_not_allow_old_passwords_value_available=1
result_security_disable_inactive_account_ref_value=disable_inactive_account_value
result_security_disable_inactive_account_type=bool_with_value
result_security_disable_inactive_account_default=0
result_security_disable_inactive_account_available=1
result_security_disable_inactive_account_value_type=int
result_security_disable_inactive_account_value_default=6
result_security_disable_inactive_account_value_min=2
result_security_disable_inactive_account_value_max=36
result_security_disable_inactive_account_value_available=1
result_security_warning_on_anomalous_logins_type=bool
result_security_warning_on_anomalous_logins_default=0
result_security_warning_on_anomalous_logins_available=1
result_subusers_can_add_type=bool
result_subusers_can_add_default=1
result_subusers_can_add_available=1
result_subusers_can_edit_type=bool
result_subusers_can_edit_default=1
result_subusers_can_edit_available=1
result_subusers_can_delete_type=bool
result_subusers_can_delete_default=1
result_subusers_can_delete_available=1
Example 4 (plain)
Request
https://joturl.com/a/i1/permissions/property?format=plain
Query parameters
format = plain
Response
complementary_ids
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids
1
bool
default:0
1
bool
default:0
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
complementary_ids
1
inactivity_timeout_value
bool_with_value
default:0
1
int
default:15
15
43200
1
force_change_password_interval
bool_with_value
default:0
1
int
default:3
2
60
1
do_not_allow_old_passwords_value
bool_with_value
default:0
1
int
default:4
2
10
1
disable_inactive_account_value
bool_with_value
default:0
1
int
default:6
2
36
1
bool
default:0
1
bool
default:1
1
bool
default:1
1
bool
default:1
1
Return values
parameter | description |
---|---|
data | object containing available access permissions and their descriptions |
/plans
/plans/addresses
/plans/addresses/add
access: [WRITE]
This method adds address information about the user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2025-05-11+13%3A18%3A50
Query parameters
is_business = 1
name = John Smith
address = 72 Sussex St.
postal_code = 21122
city = Pasadena
country_code = US
responsibility_check = 2025-05-11 13:18:50
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2025-05-11+13%3A18%3A50&format=xml
Query parameters
is_business = 1
name = John Smith
address = 72 Sussex St.
postal_code = 21122
city = Pasadena
country_code = US
responsibility_check = 2025-05-11 13:18:50
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2025-05-11+13%3A18%3A50&format=txt
Query parameters
is_business = 1
name = John Smith
address = 72 Sussex St.
postal_code = 21122
city = Pasadena
country_code = US
responsibility_check = 2025-05-11 13:18:50
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/addresses/add?is_business=1&name=John+Smith&address=72+Sussex+St.&postal_code=21122&city=Pasadena&country_code=US&responsibility_check=2025-05-11+13%3A18%3A50&format=plain
Query parameters
is_business = 1
name = John Smith
address = 72 Sussex St.
postal_code = 21122
city = Pasadena
country_code = US
responsibility_check = 2025-05-11 13:18:50
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
addressSTRING | billing address | 255 |
citySTRING | billing city | 255 |
country_codeSTRING | billing country code | 2 |
is_businessBOOLEAN | 1 for business accounts, 0 for private | |
nameSTRING | billing name | 255 |
postal_codeSTRING | billing postal code | 50 |
responsibility_checkDATE_TIME | date/time (UTC) in which the declaration of correctness of the address information was signed, the value passed is mandatory and must be a valid date/time, but it is always overwritten with the date/time of the call to this endpoint |
Optional parameters
parameter | description | max length |
---|---|---|
cfSTRING | fiscal code for private Italian users | 16 |
pecSTRING | certified email address for Italian users | 255 |
provinceSTRING | province for Italian users, see i1/provinces/list for details | 2 |
recipient_codeSTRING | recipient code for Italian users | 15 |
vat_idSTRING | VAT ID for business users | 50 |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/plans/addresses/info
access: [READ]
This method returns address information about the user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/addresses/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"is_business": 1,
"name": "John Smith",
"address": "72 Sussex St.",
"postal_code": "21122",
"city": "Pasadena",
"country_code": "US",
"vat_treatment": "EXTRA_EU_BUSINESS",
"vat_id": "",
"cf": "",
"pec": "",
"recipient_code": "",
"province": "",
"responsibility_check": "2025-05-11 13:18:50"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/addresses/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<is_business>1</is_business>
<name>John Smith</name>
<address>72 Sussex St.</address>
<postal_code>21122</postal_code>
<city>Pasadena</city>
<country_code>US</country_code>
<vat_treatment>EXTRA_EU_BUSINESS</vat_treatment>
<vat_id></vat_id>
<cf></cf>
<pec></pec>
<recipient_code></recipient_code>
<province></province>
<responsibility_check>2025-05-11 13:18:50</responsibility_check>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/addresses/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_is_business=1
result_name=John Smith
result_address=72 Sussex St.
result_postal_code=21122
result_city=Pasadena
result_country_code=US
result_vat_treatment=EXTRA_EU_BUSINESS
result_vat_id=
result_cf=
result_pec=
result_recipient_code=
result_province=
result_responsibility_check=2025-05-11 13:18:50
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/addresses/info?format=plain
Query parameters
format = plain
Response
1
John Smith
72 Sussex St.
21122
Pasadena
US
EXTRA_EU_BUSINESS
2025-05-11 13:18:50
Return values
parameter | description |
---|---|
address | billing address |
cf | fiscal code for private Italian users |
city | billing city |
country_code | billing country code |
is_business | 1 for business accounts, 0 for private |
name | billing name |
pec | certified email address for private Italian users |
postal_code | billing postal code |
province | province for private Italian users |
recipient_code | recipient code for private Italian users |
responsibility_check | date/time (UTC) when the declaration of correctness of the address information was signed |
vat_id | VAT ID for business users |
vat_treatment | NA |
/plans/addresses/locations
/plans/addresses/locations/list
access: [READ]
This method returns a list of available countries/localities for the user's billing addresses.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/addresses/locations/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"locations": [
{
"label": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
"code": "AF",
"other": 0
},
{
"label": "Aland Islands",
"code": "AX",
"other": 0
},
{
"label": "Albania (Shqipëria)",
"code": "AL",
"other": 0
},
{
"label": "Algeria (\u0627\u0644\u062c\u0632\u0627\u0626\u0631)",
"code": "DZ",
"other": 0
},
{
"label": "American Samoa",
"code": "AS",
"other": 0
},
{
"label": "Andorra",
"code": "AD",
"other": 0
},
{
"label": "Angola",
"code": "AO",
"other": 0
},
{
"label": "Anguilla",
"code": "AI",
"other": 0
},
{
"label": "Antarctica",
"code": "AQ",
"other": 0
},
{
"label": "Antigua and Barbuda",
"code": "AG",
"other": 0
},
{
"label": "Argentina",
"code": "AR",
"other": 0
},
{
"label": "Armenia (\u0540\u0561\u0575\u0561\u057d\u057f\u0561\u0576)",
"code": "AM",
"other": 0
},
{
"label": "Aruba",
"code": "AW",
"other": 0
},
{
"label": "Australia",
"code": "AU",
"other": 0
},
{
"label": "Austria (Österreich)",
"code": "AT",
"other": 0
},
{
"label": "Azerbaijan (Az\u0259rbaycan)",
"code": "AZ",
"other": 0
},
{
"label": "[....]",
"code": "..",
"other": 0
},
{
"label": "Canary Islands",
"code": "_C",
"other": 1
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/addresses/locations/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<locations>
<i0>
<label>Afghanistan (افغانستان)</label>
<code>AF</code>
<other>0</other>
</i0>
<i1>
<label>Aland Islands</label>
<code>AX</code>
<other>0</other>
</i1>
<i2>
<label><[CDATA[Albania (Shqip&euml;ria)]]></label>
<code>AL</code>
<other>0</other>
</i2>
<i3>
<label>Algeria (الجزائر)</label>
<code>DZ</code>
<other>0</other>
</i3>
<i4>
<label>American Samoa</label>
<code>AS</code>
<other>0</other>
</i4>
<i5>
<label>Andorra</label>
<code>AD</code>
<other>0</other>
</i5>
<i6>
<label>Angola</label>
<code>AO</code>
<other>0</other>
</i6>
<i7>
<label>Anguilla</label>
<code>AI</code>
<other>0</other>
</i7>
<i8>
<label>Antarctica</label>
<code>AQ</code>
<other>0</other>
</i8>
<i9>
<label>Antigua and Barbuda</label>
<code>AG</code>
<other>0</other>
</i9>
<i10>
<label>Argentina</label>
<code>AR</code>
<other>0</other>
</i10>
<i11>
<label>Armenia (Հայաստան)</label>
<code>AM</code>
<other>0</other>
</i11>
<i12>
<label>Aruba</label>
<code>AW</code>
<other>0</other>
</i12>
<i13>
<label>Australia</label>
<code>AU</code>
<other>0</other>
</i13>
<i14>
<label><[CDATA[Austria (&Ouml;sterreich)]]></label>
<code>AT</code>
<other>0</other>
</i14>
<i15>
<label>Azerbaijan (Azərbaycan)</label>
<code>AZ</code>
<other>0</other>
</i15>
<i16>
<label>[....]</label>
<code>..</code>
<other>0</other>
</i16>
<i17>
<label>Canary Islands</label>
<code>_C</code>
<other>1</other>
</i17>
</locations>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/addresses/locations/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_locations_0_label=Afghanistan (افغانستان)
result_locations_0_code=AF
result_locations_0_other=0
result_locations_1_label=Aland Islands
result_locations_1_code=AX
result_locations_1_other=0
result_locations_2_label=Albania (Shqip&euml;ria)
result_locations_2_code=AL
result_locations_2_other=0
result_locations_3_label=Algeria (الجزائر)
result_locations_3_code=DZ
result_locations_3_other=0
result_locations_4_label=American Samoa
result_locations_4_code=AS
result_locations_4_other=0
result_locations_5_label=Andorra
result_locations_5_code=AD
result_locations_5_other=0
result_locations_6_label=Angola
result_locations_6_code=AO
result_locations_6_other=0
result_locations_7_label=Anguilla
result_locations_7_code=AI
result_locations_7_other=0
result_locations_8_label=Antarctica
result_locations_8_code=AQ
result_locations_8_other=0
result_locations_9_label=Antigua and Barbuda
result_locations_9_code=AG
result_locations_9_other=0
result_locations_10_label=Argentina
result_locations_10_code=AR
result_locations_10_other=0
result_locations_11_label=Armenia (Հայաստան)
result_locations_11_code=AM
result_locations_11_other=0
result_locations_12_label=Aruba
result_locations_12_code=AW
result_locations_12_other=0
result_locations_13_label=Australia
result_locations_13_code=AU
result_locations_13_other=0
result_locations_14_label=Austria (&Ouml;sterreich)
result_locations_14_code=AT
result_locations_14_other=0
result_locations_15_label=Azerbaijan (Azərbaycan)
result_locations_15_code=AZ
result_locations_15_other=0
result_locations_16_label=[....]
result_locations_16_code=..
result_locations_16_other=0
result_locations_17_label=Canary Islands
result_locations_17_code=_C
result_locations_17_other=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/addresses/locations/list?format=plain
Query parameters
format = plain
Response
Afghanistan (افغانستان)
AF
0
Aland Islands
AX
0
Albania (Shqip&euml;ria)
AL
0
Algeria (الجزائر)
DZ
0
American Samoa
AS
0
Andorra
AD
0
Angola
AO
0
Anguilla
AI
0
Antarctica
AQ
0
Antigua and Barbuda
AG
0
Argentina
AR
0
Armenia (Հայաստան)
AM
0
Aruba
AW
0
Australia
AU
0
Austria (&Ouml;sterreich)
AT
0
Azerbaijan (Azərbaycan)
AZ
0
[....]
..
0
Canary Islands
_C
1
Return values
parameter | description |
---|---|
locations | list of available countries/locations |
/plans/addresses/property
access: [READ]
This method returns requirements for the user info.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US
Query parameters
is_business = 0
country_code = US
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"vat_treatment": "EXTRA_EU_PRIVATE",
"vat_id": {
"mandatory": 0,
"show": 0
},
"cf": {
"mandatory": 0,
"show": 0
},
"pec": {
"mandatory": 0,
"show": 0
},
"recipient_code": {
"mandatory": 0,
"show": 0
},
"province": {
"mandatory": 0,
"show": 0
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=xml
Query parameters
is_business = 0
country_code = US
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<vat_treatment>EXTRA_EU_PRIVATE</vat_treatment>
<vat_id>
<mandatory>0</mandatory>
<show>0</show>
</vat_id>
<cf>
<mandatory>0</mandatory>
<show>0</show>
</cf>
<pec>
<mandatory>0</mandatory>
<show>0</show>
</pec>
<recipient_code>
<mandatory>0</mandatory>
<show>0</show>
</recipient_code>
<province>
<mandatory>0</mandatory>
<show>0</show>
</province>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=txt
Query parameters
is_business = 0
country_code = US
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=EXTRA_EU_PRIVATE
result_vat_id_mandatory=0
result_vat_id_show=0
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=0
result_pec_show=0
result_recipient_code_mandatory=0
result_recipient_code_show=0
result_province_mandatory=0
result_province_show=0
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=US&format=plain
Query parameters
is_business = 0
country_code = US
format = plain
Response
EXTRA_EU_PRIVATE
0
0
0
0
0
0
0
0
0
0
Example 5 (json)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US
Query parameters
is_business = 1
country_code = US
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"vat_treatment": "EXTRA_EU_BUSINESS",
"vat_id": {
"mandatory": 0,
"show": 1
},
"cf": {
"mandatory": 0,
"show": 0
},
"pec": {
"mandatory": 1,
"show": 0
},
"recipient_code": {
"mandatory": 1,
"show": 0
},
"province": {
"mandatory": 0,
"show": 0
}
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=xml
Query parameters
is_business = 1
country_code = US
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<vat_treatment>EXTRA_EU_BUSINESS</vat_treatment>
<vat_id>
<mandatory>0</mandatory>
<show>1</show>
</vat_id>
<cf>
<mandatory>0</mandatory>
<show>0</show>
</cf>
<pec>
<mandatory>1</mandatory>
<show>0</show>
</pec>
<recipient_code>
<mandatory>1</mandatory>
<show>0</show>
</recipient_code>
<province>
<mandatory>0</mandatory>
<show>0</show>
</province>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=txt
Query parameters
is_business = 1
country_code = US
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=EXTRA_EU_BUSINESS
result_vat_id_mandatory=0
result_vat_id_show=1
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=1
result_pec_show=0
result_recipient_code_mandatory=1
result_recipient_code_show=0
result_province_mandatory=0
result_province_show=0
Example 8 (plain)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=US&format=plain
Query parameters
is_business = 1
country_code = US
format = plain
Response
EXTRA_EU_BUSINESS
0
1
0
0
1
0
1
0
0
0
Example 9 (json)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT
Query parameters
is_business = 0
country_code = IT
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"vat_treatment": "ITALY_PRIVATE",
"vat_id": {
"mandatory": 0,
"show": 0
},
"cf": {
"mandatory": 1,
"show": 1
},
"pec": {
"mandatory": 0,
"show": 1
},
"recipient_code": {
"mandatory": 0,
"show": 0
},
"province": {
"mandatory": 1,
"show": 1
}
}
}
Example 10 (xml)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=xml
Query parameters
is_business = 0
country_code = IT
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<vat_treatment>ITALY_PRIVATE</vat_treatment>
<vat_id>
<mandatory>0</mandatory>
<show>0</show>
</vat_id>
<cf>
<mandatory>1</mandatory>
<show>1</show>
</cf>
<pec>
<mandatory>0</mandatory>
<show>1</show>
</pec>
<recipient_code>
<mandatory>0</mandatory>
<show>0</show>
</recipient_code>
<province>
<mandatory>1</mandatory>
<show>1</show>
</province>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=txt
Query parameters
is_business = 0
country_code = IT
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=ITALY_PRIVATE
result_vat_id_mandatory=0
result_vat_id_show=0
result_cf_mandatory=1
result_cf_show=1
result_pec_mandatory=0
result_pec_show=1
result_recipient_code_mandatory=0
result_recipient_code_show=0
result_province_mandatory=1
result_province_show=1
Example 12 (plain)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=0&country_code=IT&format=plain
Query parameters
is_business = 0
country_code = IT
format = plain
Response
ITALY_PRIVATE
0
0
1
1
0
1
0
0
1
1
Example 13 (json)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT
Query parameters
is_business = 1
country_code = IT
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"vat_treatment": "ITALY_BUSINESS",
"vat_id": {
"mandatory": 1,
"show": 1
},
"cf": {
"mandatory": 0,
"show": 0
},
"pec": {
"mandatory": 1,
"show": 1
},
"recipient_code": {
"mandatory": 1,
"show": 1
},
"province": {
"mandatory": 1,
"show": 1
}
}
}
Example 14 (xml)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=xml
Query parameters
is_business = 1
country_code = IT
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<vat_treatment>ITALY_BUSINESS</vat_treatment>
<vat_id>
<mandatory>1</mandatory>
<show>1</show>
</vat_id>
<cf>
<mandatory>0</mandatory>
<show>0</show>
</cf>
<pec>
<mandatory>1</mandatory>
<show>1</show>
</pec>
<recipient_code>
<mandatory>1</mandatory>
<show>1</show>
</recipient_code>
<province>
<mandatory>1</mandatory>
<show>1</show>
</province>
</result>
</response>
Example 15 (txt)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=txt
Query parameters
is_business = 1
country_code = IT
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_vat_treatment=ITALY_BUSINESS
result_vat_id_mandatory=1
result_vat_id_show=1
result_cf_mandatory=0
result_cf_show=0
result_pec_mandatory=1
result_pec_show=1
result_recipient_code_mandatory=1
result_recipient_code_show=1
result_province_mandatory=1
result_province_show=1
Example 16 (plain)
Request
https://joturl.com/a/i1/plans/addresses/property?is_business=1&country_code=IT&format=plain
Query parameters
is_business = 1
country_code = IT
format = plain
Response
ITALY_BUSINESS
1
1
0
0
1
1
1
1
1
1
Required parameters
parameter | description | max length |
---|---|---|
country_codeSTRING | code of the country of the user | 2 |
is_businessBOOLEAN | 1 for business users, 0 from private |
Return values
parameter | description |
---|---|
cf | array containing mandatory and show |
pec | array containing mandatory and show |
province | array containing mandatory and show |
recipient_code | array containing mandatory and show |
vat_id | array containing mandatory and show |
vat_treatment | VAT threatment type, see i1/plans/vats/property for details |
/plans/coupons
/plans/coupons/attach
access: [READ]
This method allows to attach a coupon to the current customer.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/coupons/attach?coupon=5e5fc140cf16795dec7f7b7af0183c6a
Query parameters
coupon = 5e5fc140cf16795dec7f7b7af0183c6a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"attached": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/coupons/attach?coupon=5e5fc140cf16795dec7f7b7af0183c6a&format=xml
Query parameters
coupon = 5e5fc140cf16795dec7f7b7af0183c6a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<attached>1</attached>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/coupons/attach?coupon=5e5fc140cf16795dec7f7b7af0183c6a&format=txt
Query parameters
coupon = 5e5fc140cf16795dec7f7b7af0183c6a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_attached=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/coupons/attach?coupon=5e5fc140cf16795dec7f7b7af0183c6a&format=plain
Query parameters
coupon = 5e5fc140cf16795dec7f7b7af0183c6a
format = plain
Response
1
Required parameters
parameter | description |
---|---|
couponSTRING | The coupon code to be attached |
Optional parameters
parameter | description |
---|---|
detach_existingBOOLEAN | 1 to detach any coupons already present (default: 0) |
Return values
parameter | description |
---|---|
attached | 1 on success, an error is emitted otherwise |
/plans/coupons/check
access: [READ]
This method checks the validity of a coupon.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/coupons/check?coupon=68737f7c8c8b0eb18e0051fe5e68582d&amount=100
Query parameters
coupon = 68737f7c8c8b0eb18e0051fe5e68582d
amount = 100
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"valid": 1,
"description": "Test coupon for PayPal",
"params": {
"expiration": "2025-12-31T13:13:00+01:00",
"en": "Test coupon for PayPal",
"it": "Coupon di prova per PayPal",
"plan": "pro, business",
"charge_amount": "12",
"public_plan": "Pro, Business"
},
"amount": 100,
"amount1": 0,
"discounted": 0,
"discounted1": 0,
"is_100p_discount": 1,
"charge_amount": 12,
"charge_amount_formatted": "12.00 €",
"paypal": {
"env": "production",
"client": {
"production": "7f84eddd82fde68eab8063bf14785fe7-f290442b8152b1d54537efca0f8a94d2"
}
},
"discounted_formatted": "0.00",
"discounted1_formatted": "0.00"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/coupons/check?coupon=68737f7c8c8b0eb18e0051fe5e68582d&amount=100&format=xml
Query parameters
coupon = 68737f7c8c8b0eb18e0051fe5e68582d
amount = 100
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<valid>1</valid>
<description>Test coupon for PayPal</description>
<params>
<expiration>2025-12-31T13:13:00+01:00</expiration>
<en>Test coupon for PayPal</en>
<it>Coupon di prova per PayPal</it>
<plan>pro, business</plan>
<charge_amount>12</charge_amount>
<public_plan>Pro, Business</public_plan>
</params>
<amount>100</amount>
<amount1>0</amount1>
<discounted>0</discounted>
<discounted1>0</discounted1>
<is_100p_discount>1</is_100p_discount>
<charge_amount>12</charge_amount>
<charge_amount_formatted><[CDATA[12.00 &euro;]]></charge_amount_formatted>
<paypal>
<env>production</env>
<client>
<production>7f84eddd82fde68eab8063bf14785fe7-f290442b8152b1d54537efca0f8a94d2</production>
</client>
</paypal>
<discounted_formatted>0.00</discounted_formatted>
<discounted1_formatted>0.00</discounted1_formatted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/coupons/check?coupon=68737f7c8c8b0eb18e0051fe5e68582d&amount=100&format=txt
Query parameters
coupon = 68737f7c8c8b0eb18e0051fe5e68582d
amount = 100
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_valid=1
result_description=Test coupon for PayPal
result_params_expiration=2025-12-31T13:13:00+01:00
result_params_en=Test coupon for PayPal
result_params_it=Coupon di prova per PayPal
result_params_plan=pro, business
result_params_charge_amount=12
result_params_public_plan=Pro, Business
result_amount=100
result_amount1=0
result_discounted=0
result_discounted1=0
result_is_100p_discount=1
result_charge_amount=12
result_charge_amount_formatted=12.00 &euro;
result_paypal_env=production
result_paypal_client_production=7f84eddd82fde68eab8063bf14785fe7-f290442b8152b1d54537efca0f8a94d2
result_discounted_formatted=0.00
result_discounted1_formatted=0.00
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/coupons/check?coupon=68737f7c8c8b0eb18e0051fe5e68582d&amount=100&format=plain
Query parameters
coupon = 68737f7c8c8b0eb18e0051fe5e68582d
amount = 100
format = plain
Response
1
Test coupon for PayPal
2025-12-31T13:13:00+01:00
Test coupon for PayPal
Coupon di prova per PayPal
pro, business
12
Pro, Business
100
0
0
0
1
12
12.00 &euro;
production
7f84eddd82fde68eab8063bf14785fe7-f290442b8152b1d54537efca0f8a94d2
0.00
0.00
Required parameters
parameter | description |
---|---|
couponSTRING | Coupon code. This can be a comma separated list of coupons for stackable coupons. |
Optional parameters
parameter | description |
---|---|
amountSTRING | if this parameter is passed, the method returns the amount requested after applying the coupon |
amount1STRING | if this parameter is passed, the method returns the amount requested after applying the coupon |
Return values
parameter | description |
---|---|
amount | echo back of the input parameter amount |
amount1 | echo back of the input parameter amount1 |
charge_amount | [OPTIONAL] returned only if the coupon requires an immediate charge |
charge_amount_formatted | [OPTIONAL] formatted version of charge_amount |
description | description of the coupon if available, empty otherwise |
discounted | the amount requested after applying the coupon to parameter amount |
discounted1 | the amount requested after applying the coupon to parameter amount1 |
discounted1_formatted | formatted version of discounted1 |
discounted_formatted | formatted version of discounted |
is_100p_discount | 1 if the coupon applies a 100% discount, 0 otherwise |
params | array containing extended parameters for the coupon |
paypal | [OPTIONAL] array containing information on the PayPal client to be used to precess payments, please see PayPal API documentation for details |
valid | 1 if the coupon is valid, 0 otherwise |
/plans/customers
/plans/customers/add
access: [WRITE]
This method creates a customer on the payment gateaway.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/customers/add
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/customers/add?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/customers/add?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/customers/add?format=plain
Query parameters
format = plain
Response
1
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/plans/customers/balance_transactions
access: [READ]
This method returns the list of balance transactions for the current customer. Transactions are returned in reverse order (most recent first).
Example 1 (json)
Request
https://joturl.com/a/i1/plans/customers/balance_transactions
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/customers/balance_transactions?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/customers/balance_transactions?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/customers/balance_transactions?format=plain
Query parameters
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
startingSTRING | it is an ID (returned in data ) that defines the point in the list from which to extract transactions, to be used in pagination |
Return values
parameter | description |
---|---|
data | list of transactions |
/plans/customers/info
access: [READ]
This method returns payment information about the user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/customers/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "ef40653a5d508e282613834bba7b82df",
"created": "2018-08-07T20:33:07+02:00",
"updated": "2018-08-07T20:33:07+02:00",
"payments": [
{
"token": "562f59474275682b336c774c654c7a544d2b632b316a776e576d583454497272507133637a31653949736f636a6333596c56686c41794f566573664e4749746b",
"country": "US",
"created": "2018-12-06T23:31:24+01:00",
"updated": "2018-12-06T23:31:24+01:00",
"default": 1,
"image": "",
"subscriptions": 0,
"brand": "Visa",
"type": "visa",
"last4": "4242",
"expiration": {
"month": 4,
"year": 2024
}
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/customers/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>ef40653a5d508e282613834bba7b82df</id>
<created>2018-08-07T20:33:07+02:00</created>
<updated>2018-08-07T20:33:07+02:00</updated>
<payments>
<i0>
<token>562f59474275682b336c774c654c7a544d2b632b316a776e576d583454497272507133637a31653949736f636a6333596c56686c41794f566573664e4749746b</token>
<country>US</country>
<created>2018-12-06T23:31:24+01:00</created>
<updated>2018-12-06T23:31:24+01:00</updated>
<default>1</default>
<image></image>
<subscriptions>0</subscriptions>
<brand>Visa</brand>
<type>visa</type>
<last4>4242</last4>
<expiration>
<month>4</month>
<year>2024</year>
</expiration>
</i0>
</payments>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/customers/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=ef40653a5d508e282613834bba7b82df
result_created=2018-08-07T20:33:07+02:00
result_updated=2018-08-07T20:33:07+02:00
result_payments_0_token=562f59474275682b336c774c654c7a544d2b632b316a776e576d583454497272507133637a31653949736f636a6333596c56686c41794f566573664e4749746b
result_payments_0_country=US
result_payments_0_created=2018-12-06T23:31:24+01:00
result_payments_0_updated=2018-12-06T23:31:24+01:00
result_payments_0_default=1
result_payments_0_image=
result_payments_0_subscriptions=0
result_payments_0_brand=Visa
result_payments_0_type=visa
result_payments_0_last4=4242
result_payments_0_expiration_month=4
result_payments_0_expiration_year=2024
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/customers/info?format=plain
Query parameters
format = plain
Response
ef40653a5d508e282613834bba7b82df
2018-08-07T20:33:07+02:00
2018-08-07T20:33:07+02:00
562f59474275682b336c774c654c7a544d2b632b316a776e576d583454497272507133637a31653949736f636a6333596c56686c41794f566573664e4749746b
US
2018-12-06T23:31:24+01:00
2018-12-06T23:31:24+01:00
default:1
0
Visa
visa
4242
4
2024
Return values
parameter | description |
---|---|
created | date on which the customer was created |
id | customer ID on the payment gateway |
payments | object containing payment information |
updated | date on which the customer was updated |
/plans/info
access: [READ]
This method returns information about the user's plan.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/info
Response
{
"id": "5ca44d23d3c4aa6c5b72ec6b4f9fae94",
"name": "business",
"annually_cost": 135,
"monthly_cost": 169,
"events_per_month": 500000,
"tracking_links": 100000,
"stats_permanency_days": 730,
"max_users": 30,
"max_permissions": 6,
"max_brands": 70,
"has_smart_balancer": 1,
"has_split_testing": 1,
"has_smart_redirector": 1,
"max_qrcode_templates": 100,
"max_projects": "",
"has_conversions": 1,
"has_timed_urls": 1,
"force_brand_on_ctas": 0,
"has_watchdog_ping": 1,
"has_watchdog_advanced": 1,
"number_of_ctas": "",
"max_banners": "",
"custom_domains": 30,
"email_support": 1,
"priority_email_support": 1,
"has_security_monitor": 1,
"has_cfm": 1,
"has_custom_aliases": 1,
"has_masking": 1,
"has_jotbar": 1,
"has_custom_logo_in_reports": 1,
"has_custom_css_cta": 1,
"has_setup_assistance_and_training": 0,
"has_custom_invoicing": 0,
"has_enterprise_sla": 0,
"has_customizations_and_integrations": 0,
"has_digital_marketing_advice": 0,
"has_minipages": 1,
"has_deeplinks": 1,
"has_easydeeplinks": 1,
"has_preview": 1,
"public_name": "Business",
"has_utm_builder": 1,
"max_utm_templates": 30,
"has_remarketing": "",
"has_whatsapp": 1,
"has_instaurl": 0,
"has_selfdestruction": 0,
"has_cloaking": 1,
"has_advanced_security": 0,
"is_monthly": 1,
"status": "green",
"trial_left_days": 30,
"events": "",
"is_monitored": 1,
"can_manage_plans": 1,
"can_manage_billing": 1,
"email_sent": 0,
"subscription_status": "ACTIVE",
"subscription_creation": "2018-08-13T23:16:14+02:00",
"subscription_next_billing_date": "2018-12-27T11:58:57+01:00",
"subscription_billing_end_date": "2018-12-27T11:58:57+01:00",
"subscription_never_expires": 1,
"subscription_trial_period": 0,
"subscription_first_billing_date": "2018-12-27T11:58:57+01:00",
"subscription_balance": 0,
"max_gdpr_templates": 10,
"has_gdpr_custom_consent": 1,
"max_media": 100000,
"max_media_size": 10000000,
"cdnbytes_per_month": 100000000000,
"api_rate_limits": {
"primary": {
"limit": 500,
"unit": "HOUR"
},
"secondary": {
"limit": 50000,
"unit": "DAY"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<id>5ca44d23d3c4aa6c5b72ec6b4f9fae94</id>
<name>business</name>
<annually_cost>135</annually_cost>
<monthly_cost>169</monthly_cost>
<events_per_month>500000</events_per_month>
<tracking_links>100000</tracking_links>
<stats_permanency_days>730</stats_permanency_days>
<max_users>30</max_users>
<max_permissions>6</max_permissions>
<max_brands>70</max_brands>
<has_smart_balancer>1</has_smart_balancer>
<has_split_testing>1</has_split_testing>
<has_smart_redirector>1</has_smart_redirector>
<max_qrcode_templates>100</max_qrcode_templates>
<max_projects></max_projects>
<has_conversions>1</has_conversions>
<has_timed_urls>1</has_timed_urls>
<force_brand_on_ctas>0</force_brand_on_ctas>
<has_watchdog_ping>1</has_watchdog_ping>
<has_watchdog_advanced>1</has_watchdog_advanced>
<number_of_ctas></number_of_ctas>
<max_banners></max_banners>
<custom_domains>30</custom_domains>
<email_support>1</email_support>
<priority_email_support>1</priority_email_support>
<has_security_monitor>1</has_security_monitor>
<has_cfm>1</has_cfm>
<has_custom_aliases>1</has_custom_aliases>
<has_masking>1</has_masking>
<has_jotbar>1</has_jotbar>
<has_custom_logo_in_reports>1</has_custom_logo_in_reports>
<has_custom_css_cta>1</has_custom_css_cta>
<has_setup_assistance_and_training>0</has_setup_assistance_and_training>
<has_custom_invoicing>0</has_custom_invoicing>
<has_enterprise_sla>0</has_enterprise_sla>
<has_customizations_and_integrations>0</has_customizations_and_integrations>
<has_digital_marketing_advice>0</has_digital_marketing_advice>
<has_minipages>1</has_minipages>
<has_deeplinks>1</has_deeplinks>
<has_easydeeplinks>1</has_easydeeplinks>
<has_preview>1</has_preview>
<public_name>Business</public_name>
<has_utm_builder>1</has_utm_builder>
<max_utm_templates>30</max_utm_templates>
<has_remarketing></has_remarketing>
<has_whatsapp>1</has_whatsapp>
<has_instaurl>0</has_instaurl>
<has_selfdestruction>0</has_selfdestruction>
<has_cloaking>1</has_cloaking>
<has_advanced_security>0</has_advanced_security>
<is_monthly>1</is_monthly>
<status>green</status>
<trial_left_days>30</trial_left_days>
<events></events>
<is_monitored>1</is_monitored>
<can_manage_plans>1</can_manage_plans>
<can_manage_billing>1</can_manage_billing>
<email_sent>0</email_sent>
<subscription_status>ACTIVE</subscription_status>
<subscription_creation>2018-08-13T23:16:14+02:00</subscription_creation>
<subscription_next_billing_date>2018-12-27T11:58:57+01:00</subscription_next_billing_date>
<subscription_billing_end_date>2018-12-27T11:58:57+01:00</subscription_billing_end_date>
<subscription_never_expires>1</subscription_never_expires>
<subscription_trial_period>0</subscription_trial_period>
<subscription_first_billing_date>2018-12-27T11:58:57+01:00</subscription_first_billing_date>
<subscription_balance>0</subscription_balance>
<max_gdpr_templates>10</max_gdpr_templates>
<has_gdpr_custom_consent>1</has_gdpr_custom_consent>
<max_media>100000</max_media>
<max_media_size>10000000</max_media_size>
<cdnbytes_per_month>100000000000</cdnbytes_per_month>
<api_rate_limits>
<primary>
<limit>500</limit>
<unit>HOUR</unit>
</primary>
<secondary>
<limit>50000</limit>
<unit>DAY</unit>
</secondary>
</api_rate_limits>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/info?format=txt
Query parameters
format = txt
Response
id=5ca44d23d3c4aa6c5b72ec6b4f9fae94
name=business
annually_cost=135
monthly_cost=169
events_per_month=500000
tracking_links=100000
stats_permanency_days=730
max_users=30
max_permissions=6
max_brands=70
has_smart_balancer=1
has_split_testing=1
has_smart_redirector=1
max_qrcode_templates=100
max_projects=
has_conversions=1
has_timed_urls=1
force_brand_on_ctas=0
has_watchdog_ping=1
has_watchdog_advanced=1
number_of_ctas=
max_banners=
custom_domains=30
email_support=1
priority_email_support=1
has_security_monitor=1
has_cfm=1
has_custom_aliases=1
has_masking=1
has_jotbar=1
has_custom_logo_in_reports=1
has_custom_css_cta=1
has_setup_assistance_and_training=0
has_custom_invoicing=0
has_enterprise_sla=0
has_customizations_and_integrations=0
has_digital_marketing_advice=0
has_minipages=1
has_deeplinks=1
has_easydeeplinks=1
has_preview=1
public_name=Business
has_utm_builder=1
max_utm_templates=30
has_remarketing=
has_whatsapp=1
has_instaurl=0
has_selfdestruction=0
has_cloaking=1
has_advanced_security=0
is_monthly=1
status=green
trial_left_days=30
events=
is_monitored=1
can_manage_plans=1
can_manage_billing=1
email_sent=0
subscription_status=ACTIVE
subscription_creation=2018-08-13T23:16:14+02:00
subscription_next_billing_date=2018-12-27T11:58:57+01:00
subscription_billing_end_date=2018-12-27T11:58:57+01:00
subscription_never_expires=1
subscription_trial_period=0
subscription_first_billing_date=2018-12-27T11:58:57+01:00
subscription_balance=0
max_gdpr_templates=10
has_gdpr_custom_consent=1
max_media=100000
max_media_size=10000000
cdnbytes_per_month=100000000000
api_rate_limits_primary_limit=500
api_rate_limits_primary_unit=HOUR
api_rate_limits_secondary_limit=50000
api_rate_limits_secondary_unit=DAY
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/info?format=plain
Query parameters
format = plain
Response
5ca44d23d3c4aa6c5b72ec6b4f9fae94
business
135
169
500000
100000
730
30
6
70
1
1
1
100
1
1
0
1
1
30
1
1
1
1
1
1
1
1
1
0
0
0
0
0
1
1
1
1
Business
1
30
1
0
0
1
0
1
green
30
1
1
1
0
ACTIVE
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
1
0
2018-12-27T11:58:57+01:00
0
10
1
100000
10000000
100000000000
500
HOUR
50000
DAY
Return values
parameter | description |
---|---|
annually_cost | cost if paid annually |
api_rate_limits | API rate limits, see i1/apis/limits for details |
can_manage_billing | 1 if the user can change the billing information and download invoices, 0 otherwise |
can_manage_plans | 1 if the user can change the current plan and subscription, 0 otherwise |
cdnbytes_per_month | available CDN bytes per month |
custom_domains | maximum number of custom domains |
email_sent | if an email was sent after a change of status, in any case emails are sent with a frequency of no less than 72 hours |
email_support | 1 if email support is available, 0 otherwise |
events | events used in the last 30 days |
events_per_month | available events per month |
force_brand_on_ctas | 1 if the JotUrl brand is forced to be shown on CTAs, 0 otherwise |
has_advanced_security | 1 if the advanced security (permissions) is available, 0 otherwise |
has_cfm | 1 if click fraud protection is available, 0 otherwise |
has_cloaking | 1 if the cloaking option is available, 0 otherwise |
has_conversions | 1 if conversions are available, 0 otherwise |
has_custom_aliases | 1 if custom aliases are available, 0 otherwise |
has_custom_css_cta | 1 if custom CSS on CTAs is available, 0 otherwise |
has_custom_invoicing | 1 if custom invoicing is available, 0 otherwise |
has_custom_logo_in_reports | 1 if custom logo in reports is available, 0 otherwise |
has_customizations_and_integrations | 1 if customizations and integrations is available, 0 otherwise |
has_deeplinks | 1 if deep links are available, 0 otherwise |
has_digital_marketing_advice | 1 if digital marketing advice is available, 0 otherwise |
has_easydeeplinks | 1 if the option easy deep links is available, 0 otherwise |
has_enterprise_sla | 1 if enterprise SLA is available, 0 otherwise |
has_gdpr_custom_consent | 1 if GDPR consent can be customized, 0 otherwise |
has_instaurl | 1 if JotBio (InstaUrl) is available, 0 otherwise |
has_jotbar | 1 if JotBar is available, 0 otherwise |
has_masking | 1 if masking is available, 0 otherwise |
has_minipages | 1 if minipages are available, 0 otherwise |
has_preview | 1 if link preview edit (Open Graph tags) is available, 0 otherwise |
has_remarketing | number of available remarketing pixels, empty means "unlimited", 0 means no remarketing pixel available |
has_security_monitor | 1 if security monitor is available, 0 otherwise |
has_selfdestruction | 1 if the self destruction option is available, 0 otherwise |
has_setup_assistance_and_training | 1 if setup assistance and training is available, 0 otherwise |
has_smart_balancer | 1 if smart balanger is available, 0 otherwise |
has_smart_redirector | 1 if smart redirector is available, 0 otherwise |
has_split_testing | 1 if split testing is available, 0 otherwise |
has_timed_urls | 1 if timed urls is available, 0 otherwise |
has_utm_builder | 1 if UTM builder is available, 0 otherwise |
has_watchdog_advanced | 1 if advanced Watchdog is available, 0 otherwise |
has_watchdog_ping | 1 if basic Watchdog is available, 0 otherwise |
has_whatsapp | 1 if WhatsUrl is available, 0 otherwise |
id | ID of the subscribed profile |
is_monitored | 1 if the user profile is automatically monitored, 0 otherwise |
is_monthly | 1 billing is made monthly, 0 for annually billing |
max_brands | maximum number of brands |
max_gdpr_templates | maximum available GDPR templates |
max_media | maximum number of media in the media library |
max_media_size | maximum size of the the media library (in bytes) |
max_permissions | maximum number of permissions for your team members |
max_qrcode_templates | maximum number of QR-Code templates |
max_users | maximum number of users (including the admin user) |
max_utm_templates | maximum number of UTM templates |
monthly_cost | cost per month if paid monthly |
name | name of the profile |
priority_email_support | 1 if priority email support is available, 0 otherwise |
public_name | user-friendly name of the profile |
stats_permanency_days | analytics are stored for this number of days |
status | status for the user, it can be: green if the user is using less than 80% of the available events, yellow if the user is using between the 80% (included) and 110% (excluded) of the available events, red if the user is using between the 110% (included) and 150% (excluded) of the available events, black if the user is using more than the 150% (included) of the available events or if the user is continuosly in the red status for at least 144 hours |
subscription_balance | [OPTIONAL] any remaining credit that will be used for future payments, available only for monitored and paid profile |
subscription_billing_end_date | [OPTIONAL] end of the current period that the subscription has been invoiced for; at the end of this period, a new invoice will be created, available only for monitored and paid profile |
subscription_creation | [OPTIONAL] time at which the subscription was created, available only for monitored and paid profile |
subscription_first_billing_date | [OPTIONAL] date at which a new invoice will be generated for the subscription (for trialing subscriptions), available only for monitored and paid profile |
subscription_never_expires | [OPTIONAL] 0 if the subscription is scheduled to be canceled at the end of the current billing period, 1 otherwise, available only for monitored and paid profile |
subscription_next_billing_date | [OPTIONAL] date at which a new invoice will be generated for the subscription, available only for monitored and paid profile |
subscription_status | [subscription status, it can be one of [TRIALING, INCOMPLETE, INCOMPLETE_EXPIRED, ACTIVE, PAST_DUE, CANCELED, UNPAID] |
subscription_trial_period | [OPTIONAL] 1 if the subscription is in its trial period, 0 otherwise, available only for monitored and paid profile |
tracking_links | maximum number of tracking links |
trial_left_days | available maximum trial days for the user |
/plans/invoices
/plans/invoices/count
access: [READ]
This method returns the number of invoices issued to the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/invoices/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 911
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/invoices/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>911</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/invoices/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=911
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/invoices/count?format=plain
Query parameters
format = plain
Response
911
Optional parameters
parameter | description |
---|---|
is_credit_noteSTRING | count only credit notes |
searchSTRING | filters invoices to be extracted by searching them |
vat_treatmentSTRING | filter invoices by VAT treatment |
yearINTEGER | filter invoices by year |
Return values
parameter | description |
---|---|
count | the total number of invoices issued to the logged user |
/plans/invoices/get
access: [READ]
This method returns an invoice for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/invoices/get?id=6f68c809865d3761b16bba8e6a0fe445&pdf=1
Query parameters
id = 6f68c809865d3761b16bba8e6a0fe445
pdf = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "10C-CC\/2019",
"pdf": "[PDF]"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/invoices/get?id=6f68c809865d3761b16bba8e6a0fe445&pdf=1&format=xml
Query parameters
id = 6f68c809865d3761b16bba8e6a0fe445
pdf = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>10C-CC/2019</id>
<pdf>[PDF]</pdf>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/invoices/get?id=6f68c809865d3761b16bba8e6a0fe445&pdf=1&format=txt
Query parameters
id = 6f68c809865d3761b16bba8e6a0fe445
pdf = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=10C-CC/2019
result_pdf=[PDF]
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/invoices/get?id=6f68c809865d3761b16bba8e6a0fe445&pdf=1&format=plain
Query parameters
id = 6f68c809865d3761b16bba8e6a0fe445
pdf = 1
format = plain
Response
10C-CC/2019
[PDF]
Required parameters
parameter | description |
---|---|
idID | internal ID of the invoice |
Optional parameters
parameter | description |
---|---|
pdfBOOLEAN | 1 to generate a PDF (returned as binary string), 0 to generate the corresponding HTML (default value: 0) |
Return values
parameter | description |
---|---|
html | HTML for the invoice if pdf = 0 |
id | ID of the invoice |
PDF for the invoice if pdf = 1 |
/plans/invoices/list
access: [READ]
This method returns a list of invoices associated to the user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/invoices/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "862ef2c7e3a4c31b2b843df5887e50ec",
"profile_id": "185855bffca3d4bbda5adae51d915230",
"profile_name": "planname",
"public_name": "Plan Name",
"amount": "9.00",
"created": "2019-06-20 08:57:21",
"invoice_datetime": "2019-06-20 09:57:38",
"billing_period_start": "2019-06-20 08:57:21",
"billing_period_end": "2019-07-20 08:57:21",
"vat_treatment": "INTRA_EU_BUSINESS",
"year": 2019,
"sequence": 11,
"address": {
"is_business": 1,
"name": "Company name",
"address_address": "Company address",
"postal_code": "DH8 6ZL",
"city": "MEDOMSLEY",
"country_code": "UK",
"vat_id": "2380238238E123",
"cf": "",
"pec": "",
"recipient_code": ""
},
"promo_code": "",
"promo_amount": "",
"invoice_template": "",
"invoice_description": "",
"refund_amount": "",
"refund_invoice_id": "",
"refund_vat_treatment": "",
"refund_year": "",
"refund_sequence": "",
"refund_datetime": "",
"invoice_id": "11B-EU\/2019",
"is_credit_note": 0
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/invoices/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>862ef2c7e3a4c31b2b843df5887e50ec</id>
<profile_id>185855bffca3d4bbda5adae51d915230</profile_id>
<profile_name>planname</profile_name>
<public_name>Plan Name</public_name>
<amount>9.00</amount>
<created>2019-06-20 08:57:21</created>
<invoice_datetime>2019-06-20 09:57:38</invoice_datetime>
<billing_period_start>2019-06-20 08:57:21</billing_period_start>
<billing_period_end>2019-07-20 08:57:21</billing_period_end>
<vat_treatment>INTRA_EU_BUSINESS</vat_treatment>
<year>2019</year>
<sequence>11</sequence>
<address>
<is_business>1</is_business>
<name>Company name</name>
<address_address>Company address</address_address>
<postal_code>DH8 6ZL</postal_code>
<city>MEDOMSLEY</city>
<country_code>UK</country_code>
<vat_id>2380238238E123</vat_id>
<cf></cf>
<pec></pec>
<recipient_code></recipient_code>
</address>
<promo_code></promo_code>
<promo_amount></promo_amount>
<invoice_template></invoice_template>
<invoice_description></invoice_description>
<refund_amount></refund_amount>
<refund_invoice_id></refund_invoice_id>
<refund_vat_treatment></refund_vat_treatment>
<refund_year></refund_year>
<refund_sequence></refund_sequence>
<refund_datetime></refund_datetime>
<invoice_id>11B-EU/2019</invoice_id>
<is_credit_note>0</is_credit_note>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/invoices/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=862ef2c7e3a4c31b2b843df5887e50ec
result_data_0_profile_id=185855bffca3d4bbda5adae51d915230
result_data_0_profile_name=planname
result_data_0_public_name=Plan Name
result_data_0_amount=9.00
result_data_0_created=2019-06-20 08:57:21
result_data_0_invoice_datetime=2019-06-20 09:57:38
result_data_0_billing_period_start=2019-06-20 08:57:21
result_data_0_billing_period_end=2019-07-20 08:57:21
result_data_0_vat_treatment=INTRA_EU_BUSINESS
result_data_0_year=2019
result_data_0_sequence=11
result_data_0_address_is_business=1
result_data_0_address_name=Company name
result_data_0_address_address_address=Company address
result_data_0_address_postal_code=DH8 6ZL
result_data_0_address_city=MEDOMSLEY
result_data_0_address_country_code=UK
result_data_0_address_vat_id=2380238238E123
result_data_0_address_cf=
result_data_0_address_pec=
result_data_0_address_recipient_code=
result_data_0_promo_code=
result_data_0_promo_amount=
result_data_0_invoice_template=
result_data_0_invoice_description=
result_data_0_refund_amount=
result_data_0_refund_invoice_id=
result_data_0_refund_vat_treatment=
result_data_0_refund_year=
result_data_0_refund_sequence=
result_data_0_refund_datetime=
result_data_0_invoice_id=11B-EU/2019
result_data_0_is_credit_note=0
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/invoices/list?format=plain
Query parameters
format = plain
Response
1
862ef2c7e3a4c31b2b843df5887e50ec
185855bffca3d4bbda5adae51d915230
planname
Plan Name
9.00
2019-06-20 08:57:21
2019-06-20 09:57:38
2019-06-20 08:57:21
2019-07-20 08:57:21
INTRA_EU_BUSINESS
2019
11
1
Company name
Company address
DH8 6ZL
MEDOMSLEY
UK
2380238238E123
11B-EU/2019
0
Optional parameters
parameter | description |
---|---|
idID | filter invoice by ID |
is_credit_noteSTRING | show only credit notes |
lengthINTEGER | extracts this number of invoices (maxmimum allowed: 100) |
searchSTRING | filters invoices to be extracted by searching them |
startINTEGER | starts to extract invoices from this position |
vat_treatmentSTRING | filter invoices by VAT treatment |
yearINTEGER | filter invoices by year |
Return values
parameter | description |
---|---|
count | [OPTIONAL] the total number of invoices available for the user, only returned if id is not passed |
data | |
next | [OPTIONAL] the URL to call to retrieve the next page of invoices when they are paged, returned only if at least one more invoice is available |
/plans/invoices/next
access: [READ]
This method returns the next upcoming invoice for the logged user and, if available, information about discounts that will applied.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/invoices/next
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"upcoming_amount_due": 9,
"upcoming_invoice_date": "2025-06-11 13:18:50"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/invoices/next?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<upcoming_amount_due>9</upcoming_amount_due>
<upcoming_invoice_date>2025-06-11 13:18:50</upcoming_invoice_date>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/invoices/next?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_upcoming_amount_due=9
result_upcoming_invoice_date=2025-06-11 13:18:50
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/invoices/next?format=plain
Query parameters
format = plain
Response
9
2025-06-11 13:18:50
Return values
parameter | description |
---|---|
coupon_amount_off | discount amout that will applied to the invoice, if available |
coupon_description | description for the coupon, if available |
coupon_end | the date/time that the coupon will end, if available |
coupon_id | coupon code that will applied to the invoice, if available |
coupon_percent_off | percentage discount that will applied to the invoice, if available |
coupon_start | date/time that the coupon was applied, if available |
scheduled_amount_due | the amount of the next scheduled invoice (in case of a recent payment waiting to be completed) |
scheduled_invoice_date | the date/time at which the scheduled invoice will be issued |
upcoming_amount_due | the amount of the upcoming invoice |
upcoming_invoice_date | the date/time at which the invoice will be issued |
/plans/list
access: [READ]
This method returns a list of available plans for the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"id": "a350e628370df4c537c77f4308b4f64d",
"is_preferred": 0,
"name": "free",
"reference_name": "",
"annually_cost": 0,
"monthly_cost": 0,
"events_per_month": 1000,
"tracking_links": 200,
"stats_permanency_days": 30,
"max_users": 1,
"max_brands": 1,
"has_smart_balancer": 0,
"has_split_testing": 0,
"has_smart_redirector": 0,
"max_qrcode_templates": 1,
"max_projects": 5,
"has_conversions": 0,
"has_timed_urls": 0,
"force_brand_on_ctas": 1,
"has_watchdog_ping": 1,
"has_watchdog_advanced": 0,
"number_of_ctas": "",
"max_banners": 0,
"custom_domains": 0,
"email_support": 1,
"priority_email_support": 0,
"has_security_monitor": 0,
"has_cfm": 0,
"has_custom_aliases": 1,
"has_masking": 0,
"has_jotbar": 0,
"has_custom_logo_in_reports": 0,
"has_custom_css_cta": 0,
"has_setup_assistance_and_training": 0,
"has_custom_invoicing": 0,
"has_enterprise_sla": 0,
"has_customizations_and_integrations": 0,
"has_digital_marketing_advice": 0,
"trial_days": 0,
"has_minipages": 0,
"has_deeplinks": 0,
"has_easydeeplinks": 0,
"has_preview": 0,
"public_name": "Free",
"has_utm_builder": 0,
"has_remarketing": 1,
"has_whatsapp": 0,
"has_instaurl": 0,
"has_selfdestruction": 0,
"user_profile": 0,
"reserved_for_user": 0,
"max_media": 0,
"max_media_size": 0,
"cdnbytes_per_month": 0
},
{
"id": "9f43a5cc19048a9afb94095fb782f924",
"is_preferred": 0,
"name": "growth",
"reference_name": "",
"annually_cost": 7,
"monthly_cost": 9,
"events_per_month": 5000,
"tracking_links": 2000,
"stats_permanency_days": 365,
"max_users": 3,
"max_brands": 5,
"has_smart_balancer": 1,
"has_split_testing": 1,
"has_smart_redirector": 1,
"max_qrcode_templates": 10,
"max_projects": "",
"has_conversions": 1,
"has_timed_urls": 1,
"force_brand_on_ctas": 0,
"has_watchdog_ping": 1,
"has_watchdog_advanced": 0,
"number_of_ctas": "",
"max_banners": "",
"custom_domains": 3,
"email_support": 1,
"priority_email_support": 0,
"has_security_monitor": 1,
"has_cfm": 1,
"has_custom_aliases": 1,
"has_masking": 1,
"has_jotbar": 1,
"has_custom_logo_in_reports": 0,
"has_custom_css_cta": 0,
"has_setup_assistance_and_training": 0,
"has_custom_invoicing": 0,
"has_enterprise_sla": 0,
"has_customizations_and_integrations": 0,
"has_digital_marketing_advice": 0,
"trial_days": 14,
"has_minipages": 1,
"has_deeplinks": 1,
"has_easydeeplinks": 1,
"has_preview": 1,
"public_name": "Growth",
"has_utm_builder": 1,
"has_remarketing": 5,
"has_whatsapp": 1,
"has_instaurl": 0,
"has_selfdestruction": 0,
"user_profile": 0,
"reserved_for_user": 0,
"max_media": 100000,
"max_media_size": 10000000,
"cdnbytes_per_month": 100000000000
}
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<id>a350e628370df4c537c77f4308b4f64d</id>
<is_preferred>0</is_preferred>
<name>free</name>
<reference_name></reference_name>
<annually_cost>0</annually_cost>
<monthly_cost>0</monthly_cost>
<events_per_month>1000</events_per_month>
<tracking_links>200</tracking_links>
<stats_permanency_days>30</stats_permanency_days>
<max_users>1</max_users>
<max_brands>1</max_brands>
<has_smart_balancer>0</has_smart_balancer>
<has_split_testing>0</has_split_testing>
<has_smart_redirector>0</has_smart_redirector>
<max_qrcode_templates>1</max_qrcode_templates>
<max_projects>5</max_projects>
<has_conversions>0</has_conversions>
<has_timed_urls>0</has_timed_urls>
<force_brand_on_ctas>1</force_brand_on_ctas>
<has_watchdog_ping>1</has_watchdog_ping>
<has_watchdog_advanced>0</has_watchdog_advanced>
<number_of_ctas></number_of_ctas>
<max_banners>0</max_banners>
<custom_domains>0</custom_domains>
<email_support>1</email_support>
<priority_email_support>0</priority_email_support>
<has_security_monitor>0</has_security_monitor>
<has_cfm>0</has_cfm>
<has_custom_aliases>1</has_custom_aliases>
<has_masking>0</has_masking>
<has_jotbar>0</has_jotbar>
<has_custom_logo_in_reports>0</has_custom_logo_in_reports>
<has_custom_css_cta>0</has_custom_css_cta>
<has_setup_assistance_and_training>0</has_setup_assistance_and_training>
<has_custom_invoicing>0</has_custom_invoicing>
<has_enterprise_sla>0</has_enterprise_sla>
<has_customizations_and_integrations>0</has_customizations_and_integrations>
<has_digital_marketing_advice>0</has_digital_marketing_advice>
<trial_days>0</trial_days>
<has_minipages>0</has_minipages>
<has_deeplinks>0</has_deeplinks>
<has_easydeeplinks>0</has_easydeeplinks>
<has_preview>0</has_preview>
<public_name>Free</public_name>
<has_utm_builder>0</has_utm_builder>
<has_remarketing>1</has_remarketing>
<has_whatsapp>0</has_whatsapp>
<has_instaurl>0</has_instaurl>
<has_selfdestruction>0</has_selfdestruction>
<user_profile>0</user_profile>
<reserved_for_user>0</reserved_for_user>
<max_media>0</max_media>
<max_media_size>0</max_media_size>
<cdnbytes_per_month>0</cdnbytes_per_month>
</i0>
<i1>
<id>9f43a5cc19048a9afb94095fb782f924</id>
<is_preferred>0</is_preferred>
<name>growth</name>
<reference_name></reference_name>
<annually_cost>7</annually_cost>
<monthly_cost>9</monthly_cost>
<events_per_month>5000</events_per_month>
<tracking_links>2000</tracking_links>
<stats_permanency_days>365</stats_permanency_days>
<max_users>3</max_users>
<max_brands>5</max_brands>
<has_smart_balancer>1</has_smart_balancer>
<has_split_testing>1</has_split_testing>
<has_smart_redirector>1</has_smart_redirector>
<max_qrcode_templates>10</max_qrcode_templates>
<max_projects></max_projects>
<has_conversions>1</has_conversions>
<has_timed_urls>1</has_timed_urls>
<force_brand_on_ctas>0</force_brand_on_ctas>
<has_watchdog_ping>1</has_watchdog_ping>
<has_watchdog_advanced>0</has_watchdog_advanced>
<number_of_ctas></number_of_ctas>
<max_banners></max_banners>
<custom_domains>3</custom_domains>
<email_support>1</email_support>
<priority_email_support>0</priority_email_support>
<has_security_monitor>1</has_security_monitor>
<has_cfm>1</has_cfm>
<has_custom_aliases>1</has_custom_aliases>
<has_masking>1</has_masking>
<has_jotbar>1</has_jotbar>
<has_custom_logo_in_reports>0</has_custom_logo_in_reports>
<has_custom_css_cta>0</has_custom_css_cta>
<has_setup_assistance_and_training>0</has_setup_assistance_and_training>
<has_custom_invoicing>0</has_custom_invoicing>
<has_enterprise_sla>0</has_enterprise_sla>
<has_customizations_and_integrations>0</has_customizations_and_integrations>
<has_digital_marketing_advice>0</has_digital_marketing_advice>
<trial_days>14</trial_days>
<has_minipages>1</has_minipages>
<has_deeplinks>1</has_deeplinks>
<has_easydeeplinks>1</has_easydeeplinks>
<has_preview>1</has_preview>
<public_name>Growth</public_name>
<has_utm_builder>1</has_utm_builder>
<has_remarketing>5</has_remarketing>
<has_whatsapp>1</has_whatsapp>
<has_instaurl>0</has_instaurl>
<has_selfdestruction>0</has_selfdestruction>
<user_profile>0</user_profile>
<reserved_for_user>0</reserved_for_user>
<max_media>100000</max_media>
<max_media_size>10000000</max_media_size>
<cdnbytes_per_month>100000000000</cdnbytes_per_month>
</i1>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=a350e628370df4c537c77f4308b4f64d
result_0_is_preferred=0
result_0_name=free
result_0_reference_name=
result_0_annually_cost=0
result_0_monthly_cost=0
result_0_events_per_month=1000
result_0_tracking_links=200
result_0_stats_permanency_days=30
result_0_max_users=1
result_0_max_brands=1
result_0_has_smart_balancer=0
result_0_has_split_testing=0
result_0_has_smart_redirector=0
result_0_max_qrcode_templates=1
result_0_max_projects=5
result_0_has_conversions=0
result_0_has_timed_urls=0
result_0_force_brand_on_ctas=1
result_0_has_watchdog_ping=1
result_0_has_watchdog_advanced=0
result_0_number_of_ctas=
result_0_max_banners=0
result_0_custom_domains=0
result_0_email_support=1
result_0_priority_email_support=0
result_0_has_security_monitor=0
result_0_has_cfm=0
result_0_has_custom_aliases=1
result_0_has_masking=0
result_0_has_jotbar=0
result_0_has_custom_logo_in_reports=0
result_0_has_custom_css_cta=0
result_0_has_setup_assistance_and_training=0
result_0_has_custom_invoicing=0
result_0_has_enterprise_sla=0
result_0_has_customizations_and_integrations=0
result_0_has_digital_marketing_advice=0
result_0_trial_days=0
result_0_has_minipages=0
result_0_has_deeplinks=0
result_0_has_easydeeplinks=0
result_0_has_preview=0
result_0_public_name=Free
result_0_has_utm_builder=0
result_0_has_remarketing=1
result_0_has_whatsapp=0
result_0_has_instaurl=0
result_0_has_selfdestruction=0
result_0_user_profile=0
result_0_reserved_for_user=0
result_0_max_media=0
result_0_max_media_size=0
result_0_cdnbytes_per_month=0
result_1_id=9f43a5cc19048a9afb94095fb782f924
result_1_is_preferred=0
result_1_name=growth
result_1_reference_name=
result_1_annually_cost=7
result_1_monthly_cost=9
result_1_events_per_month=5000
result_1_tracking_links=2000
result_1_stats_permanency_days=365
result_1_max_users=3
result_1_max_brands=5
result_1_has_smart_balancer=1
result_1_has_split_testing=1
result_1_has_smart_redirector=1
result_1_max_qrcode_templates=10
result_1_max_projects=
result_1_has_conversions=1
result_1_has_timed_urls=1
result_1_force_brand_on_ctas=0
result_1_has_watchdog_ping=1
result_1_has_watchdog_advanced=0
result_1_number_of_ctas=
result_1_max_banners=
result_1_custom_domains=3
result_1_email_support=1
result_1_priority_email_support=0
result_1_has_security_monitor=1
result_1_has_cfm=1
result_1_has_custom_aliases=1
result_1_has_masking=1
result_1_has_jotbar=1
result_1_has_custom_logo_in_reports=0
result_1_has_custom_css_cta=0
result_1_has_setup_assistance_and_training=0
result_1_has_custom_invoicing=0
result_1_has_enterprise_sla=0
result_1_has_customizations_and_integrations=0
result_1_has_digital_marketing_advice=0
result_1_trial_days=14
result_1_has_minipages=1
result_1_has_deeplinks=1
result_1_has_easydeeplinks=1
result_1_has_preview=1
result_1_public_name=Growth
result_1_has_utm_builder=1
result_1_has_remarketing=5
result_1_has_whatsapp=1
result_1_has_instaurl=0
result_1_has_selfdestruction=0
result_1_user_profile=0
result_1_reserved_for_user=0
result_1_max_media=100000
result_1_max_media_size=10000000
result_1_cdnbytes_per_month=100000000000
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/list?format=plain
Query parameters
format = plain
Response
a350e628370df4c537c77f4308b4f64d
0
free
0
0
1000
200
30
1
1
0
0
0
1
5
0
0
1
1
0
0
0
1
0
0
0
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Free
0
1
0
0
0
0
0
0
0
0
9f43a5cc19048a9afb94095fb782f924
0
growth
7
9
5000
2000
365
3
5
1
1
1
10
1
1
0
1
0
3
1
0
1
1
1
1
1
0
0
0
0
0
0
0
14
1
1
1
1
Growth
1
5
1
0
0
0
0
100000
10000000
100000000000
Optional parameters
parameter | description | max length |
---|---|---|
idID | filter by using the plan ID | |
is_preferredBOOLEAN | 1 to return preferred plan(s) | |
nameSTRING | filter by using the plan name | 150 |
public_nameSTRING | filter by using the plan user-friendly name | 150 |
Return values
parameter | description |
---|---|
data | list of available plans for the current user |
/plans/payments
/plans/payments/add
access: [WRITE]
This method add a payment method.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/payments/add?nonce=c1d0d315c465eaeadf884b7c18fa5b26
Query parameters
nonce = c1d0d315c465eaeadf884b7c18fa5b26
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/payments/add?nonce=c1d0d315c465eaeadf884b7c18fa5b26&format=xml
Query parameters
nonce = c1d0d315c465eaeadf884b7c18fa5b26
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/payments/add?nonce=c1d0d315c465eaeadf884b7c18fa5b26&format=txt
Query parameters
nonce = c1d0d315c465eaeadf884b7c18fa5b26
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/payments/add?nonce=c1d0d315c465eaeadf884b7c18fa5b26&format=plain
Query parameters
nonce = c1d0d315c465eaeadf884b7c18fa5b26
format = plain
Response
1
Required parameters
parameter | description |
---|---|
nonceSTRING | nonce that identifies the payment method, it comes from the payment gateway API |
Optional parameters
parameter | description |
---|---|
forceBOOLEAN | force the attachment of the payment method |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/plans/payments/authorization
access: [READ]
This method returns an authorization code for the payment gateway.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/payments/authorization
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"secret": "737165745f9aca7a029efaf6b08d58b5",
"authorization": "b93903b4817d7e50b27843bac222bc65"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/payments/authorization?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<secret>737165745f9aca7a029efaf6b08d58b5</secret>
<authorization>b93903b4817d7e50b27843bac222bc65</authorization>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/payments/authorization?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_secret=737165745f9aca7a029efaf6b08d58b5
result_authorization=b93903b4817d7e50b27843bac222bc65
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/payments/authorization?format=plain
Query parameters
format = plain
Response
737165745f9aca7a029efaf6b08d58b5
b93903b4817d7e50b27843bac222bc65
Return values
parameter | description |
---|---|
authorization | public API key of the payment gateway |
secret | secret key for the Strong Customer Authentication (SCA) |
/plans/payments/default
access: [WRITE]
This method make a payment method the default one.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/payments/default?token=f5c4eb61c0a4ce777b4b33e44bb41a08
Query parameters
token = f5c4eb61c0a4ce777b4b33e44bb41a08
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"default": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/payments/default?token=f5c4eb61c0a4ce777b4b33e44bb41a08&format=xml
Query parameters
token = f5c4eb61c0a4ce777b4b33e44bb41a08
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<default>1</default>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/payments/default?token=f5c4eb61c0a4ce777b4b33e44bb41a08&format=txt
Query parameters
token = f5c4eb61c0a4ce777b4b33e44bb41a08
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_default=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/payments/default?token=f5c4eb61c0a4ce777b4b33e44bb41a08&format=plain
Query parameters
token = f5c4eb61c0a4ce777b4b33e44bb41a08
format = plain
Response
default:1
Required parameters
parameter | description |
---|---|
tokenSTRING | token that uniquely identifies the payment method |
Return values
parameter | description |
---|---|
default | 1 on success, 0 otherwise |
/plans/payments/delete
access: [WRITE]
This method deletes a payment method.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/payments/delete?token=383cdd1cd791ae3136eb92ad831e7259
Query parameters
token = 383cdd1cd791ae3136eb92ad831e7259
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/payments/delete?token=383cdd1cd791ae3136eb92ad831e7259&format=xml
Query parameters
token = 383cdd1cd791ae3136eb92ad831e7259
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/payments/delete?token=383cdd1cd791ae3136eb92ad831e7259&format=txt
Query parameters
token = 383cdd1cd791ae3136eb92ad831e7259
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/payments/delete?token=383cdd1cd791ae3136eb92ad831e7259&format=plain
Query parameters
token = 383cdd1cd791ae3136eb92ad831e7259
format = plain
Response
1
Required parameters
parameter | description |
---|---|
tokenSTRING | token that uniquely identifies the payment method |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/plans/payments/paypals
/plans/payments/paypals/check
access: [WRITE]
This method checks a PayPal payment.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/payments/paypals/check?id=bf70bb1a60f982a926655120f31a3fa1
Query parameters
id = bf70bb1a60f982a926655120f31a3fa1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "bf70bb1a60f982a926655120f31a3fa1",
"valid": 1,
"total": 12.34,
"currency": "EUR",
"email": "this.is.your.email@pay.pal.com",
"transaction_id": "8bd4db8a369cbc0d1d"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/payments/paypals/check?id=bf70bb1a60f982a926655120f31a3fa1&format=xml
Query parameters
id = bf70bb1a60f982a926655120f31a3fa1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>bf70bb1a60f982a926655120f31a3fa1</id>
<valid>1</valid>
<total>12.34</total>
<currency>EUR</currency>
<email>this.is.your.email@pay.pal.com</email>
<transaction_id>8bd4db8a369cbc0d1d</transaction_id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/payments/paypals/check?id=bf70bb1a60f982a926655120f31a3fa1&format=txt
Query parameters
id = bf70bb1a60f982a926655120f31a3fa1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=bf70bb1a60f982a926655120f31a3fa1
result_valid=1
result_total=12.34
result_currency=EUR
result_email=this.is.your.email@pay.pal.com
result_transaction_id=8bd4db8a369cbc0d1d
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/payments/paypals/check?id=bf70bb1a60f982a926655120f31a3fa1&format=plain
Query parameters
id = bf70bb1a60f982a926655120f31a3fa1
format = plain
Response
bf70bb1a60f982a926655120f31a3fa1
1
12.34
EUR
this.is.your.email@pay.pal.com
8bd4db8a369cbc0d1d
Required parameters
parameter | description |
---|---|
idSTRING | ID of the PayPal payment to check |
Return values
parameter | description |
---|---|
currency | currency of the payment, see https://developer.paypal.com/docs/api/reference/currency-codes/ for a list of payment codes |
id | echo back of the id input parameter |
total | amount of the payment |
valid | 1 if the PayPal payment is valid, 0 otherwise |
/plans/subscriptions
/plans/subscriptions/delete
access: [WRITE]
This method cancels the plan (main) subscription associated with the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/subscriptions/delete
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"canceled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/subscriptions/delete?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<canceled>1</canceled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/subscriptions/delete?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_canceled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/subscriptions/delete?format=plain
Query parameters
format = plain
Response
1
Return values
parameter | description |
---|---|
canceled | 1 on success (i.e., the subscription was canceled), 0 otherwise |
/plans/subscriptions/estimate
access: [READ]
This method returns an estimate of the upcoming invoice for the logged user and, if available, information about discounts that will applied.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2025-06-11+13%3A18%3A50
Query parameters
start_datetime = 2025-06-11 13:18:50
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"estimate_amount_due": 9,
"estimate_invoice_date": "2025-06-11 13:18:50",
"estimate_coupon": "",
"estimate_balance": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2025-06-11+13%3A18%3A50&format=xml
Query parameters
start_datetime = 2025-06-11 13:18:50
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<estimate_amount_due>9</estimate_amount_due>
<estimate_invoice_date>2025-06-11 13:18:50</estimate_invoice_date>
<estimate_coupon></estimate_coupon>
<estimate_balance>0</estimate_balance>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2025-06-11+13%3A18%3A50&format=txt
Query parameters
start_datetime = 2025-06-11 13:18:50
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_estimate_amount_due=9
result_estimate_invoice_date=2025-06-11 13:18:50
result_estimate_coupon=
result_estimate_balance=0
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/subscriptions/estimate?start_datetime=2025-06-11+13%3A18%3A50&format=plain
Query parameters
start_datetime = 2025-06-11 13:18:50
format = plain
Response
9
2025-06-11 13:18:50
0
Required parameters
parameter | description |
---|---|
idID | ID of the plan to switch to in the estimate |
periodSTRING | the subscription billing period to be used in the estimate, it can be monthly or annually |
Optional parameters
parameter | description |
---|---|
couponSTRING | coupon ID to be applied to calculate the estimate |
start_datetimeDATE_TIME | the estimate will be calculated as though the update was done at the specified date/time, if not specified, it will be equal to 3 minutes from the request |
Return values
parameter | description |
---|---|
estimate_amount_due | the amount of the estimate |
estimate_balance | estimate user balance after the plan switch (negative means a credit, positive a debit) |
estimate_coupon | coupon code applied to the estimate, if available |
estimate_invoice_date | the date/time at which the estimate was calculated |
/plans/subscriptions/info
access: [READ]
This method returns information about the user's subscription.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/subscriptions/info
Response
{
"status": "ACTIVE",
"balance": 0,
"createdAt": "2018-08-13T23:16:14+02:00",
"updatedAt": "2018-08-13T23:16:14+02:00",
"nextBillingDate": "2018-12-27T11:58:57+01:00",
"firstBillingDate": "2018-12-27T11:58:57+01:00",
"billingPeriodEndDate": "2018-12-27T11:58:57+01:00",
"trialPeriod": 0,
"neverExpires": 1
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/subscriptions/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>ACTIVE</status>
<balance>0</balance>
<createdAt>2018-08-13T23:16:14+02:00</createdAt>
<updatedAt>2018-08-13T23:16:14+02:00</updatedAt>
<nextBillingDate>2018-12-27T11:58:57+01:00</nextBillingDate>
<firstBillingDate>2018-12-27T11:58:57+01:00</firstBillingDate>
<billingPeriodEndDate>2018-12-27T11:58:57+01:00</billingPeriodEndDate>
<trialPeriod>0</trialPeriod>
<neverExpires>1</neverExpires>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/subscriptions/info?format=txt
Query parameters
format = txt
Response
status=ACTIVE
balance=0
createdAt=2018-08-13T23:16:14+02:00
updatedAt=2018-08-13T23:16:14+02:00
nextBillingDate=2018-12-27T11:58:57+01:00
firstBillingDate=2018-12-27T11:58:57+01:00
billingPeriodEndDate=2018-12-27T11:58:57+01:00
trialPeriod=0
neverExpires=1
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/subscriptions/info?format=plain
Query parameters
format = plain
Response
ACTIVE
0
2018-08-13T23:16:14+02:00
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
0
1
Optional parameters
parameter | description |
---|---|
idSTRING | NA |
Return values
parameter | description |
---|---|
balance | any remaining credit that will be used for future payments |
billingPeriodEndDate | end of the current period that the subscription has been invoiced for; at the end of this period, a new invoice will be created |
createdAt | time at which the subscription was created |
firstBillingDate | date at which a new invoice will be generated for the subscription (for trialing subscriptions) |
neverExpires | 0 if the subscription is scheduled to be canceled at the end of the current billing period, 1 otherwise |
nextBillingDate | date at which a new invoice will be generated for the subscription |
status | subscription status, see notes for details |
trialPeriod | 1 if the subscription is in its trial period, 0 otherwise |
updatedAt | time at which the subscription was updated |
/plans/subscriptions/set
access: [WRITE]
This method sets the primary subscription (plan) for the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=6bc15b15b78fb211a9c48270a86b19ec&type=buy&period=monthly&id=7c6e4921f1ab49d3227707f41bd659ed&coupon=8E0E79EE3096541DAA97186D4F918F4E
Query parameters
paypal = 0
nonce = 6bc15b15b78fb211a9c48270a86b19ec
type = buy
period = monthly
id = 7c6e4921f1ab49d3227707f41bd659ed
coupon = 8E0E79EE3096541DAA97186D4F918F4E
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1,
"nonce": "86280ddcafccf1b11438893445118fe9b1b0d0b39931f9301f0fc451efa89f49",
"ref": "81e053233ed3e70d39e3cf92007eb25aaaeca5a666cf94a5de2792e479b507f3b90f4584e235e5a2ebe7aadef398507c"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=6bc15b15b78fb211a9c48270a86b19ec&type=buy&period=monthly&id=7c6e4921f1ab49d3227707f41bd659ed&coupon=8E0E79EE3096541DAA97186D4F918F4E&format=xml
Query parameters
paypal = 0
nonce = 6bc15b15b78fb211a9c48270a86b19ec
type = buy
period = monthly
id = 7c6e4921f1ab49d3227707f41bd659ed
coupon = 8E0E79EE3096541DAA97186D4F918F4E
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
<nonce>86280ddcafccf1b11438893445118fe9b1b0d0b39931f9301f0fc451efa89f49</nonce>
<ref>81e053233ed3e70d39e3cf92007eb25aaaeca5a666cf94a5de2792e479b507f3b90f4584e235e5a2ebe7aadef398507c</ref>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=6bc15b15b78fb211a9c48270a86b19ec&type=buy&period=monthly&id=7c6e4921f1ab49d3227707f41bd659ed&coupon=8E0E79EE3096541DAA97186D4F918F4E&format=txt
Query parameters
paypal = 0
nonce = 6bc15b15b78fb211a9c48270a86b19ec
type = buy
period = monthly
id = 7c6e4921f1ab49d3227707f41bd659ed
coupon = 8E0E79EE3096541DAA97186D4F918F4E
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
result_nonce=86280ddcafccf1b11438893445118fe9b1b0d0b39931f9301f0fc451efa89f49
result_ref=81e053233ed3e70d39e3cf92007eb25aaaeca5a666cf94a5de2792e479b507f3b90f4584e235e5a2ebe7aadef398507c
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/subscriptions/set?paypal=0&nonce=6bc15b15b78fb211a9c48270a86b19ec&type=buy&period=monthly&id=7c6e4921f1ab49d3227707f41bd659ed&coupon=8E0E79EE3096541DAA97186D4F918F4E&format=plain
Query parameters
paypal = 0
nonce = 6bc15b15b78fb211a9c48270a86b19ec
type = buy
period = monthly
id = 7c6e4921f1ab49d3227707f41bd659ed
coupon = 8E0E79EE3096541DAA97186D4F918F4E
format = plain
Response
1
86280ddcafccf1b11438893445118fe9b1b0d0b39931f9301f0fc451efa89f49
81e053233ed3e70d39e3cf92007eb25aaaeca5a666cf94a5de2792e479b507f3b90f4584e235e5a2ebe7aadef398507c
Required parameters
parameter | description |
---|---|
idID | ID of the plan to subscribe to |
periodSTRING | the subscription billing period, it can be monthly or annually |
typeSTRING | it can be try if you want to activate a trial period or buy if you want to buy a subscriptionn |
Optional parameters
parameter | description |
---|---|
couponSTRING | coupon ID to be applied to the subscription |
nonceSTRING | a unique disposable identifier used to identify the payment methods, this parameter is mandatory if a coupon code with 100% discount is not specified |
paypalBOOLEAN | 1 if PayPal was used to pay the subscription, 0 otherwise |
Return values
parameter | description |
---|---|
added | 1 if the subscription has been activated, 0 otherwise |
nonce | unique identifier to be used where requested |
ref | unique reference for the transaction to be used where requested |
/plans/suggest
access: [READ]
This method suggests a plan suitable for the number of events generated by the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/suggest
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"estimated_events_per_month": 350000,
"suggested_plan": {
"id": "b06f62e8bdf180631acaa8deae47850a",
"name": "business",
"annually_cost": 135,
"monthly_cost": 169,
"events_per_month": 500000,
"tracking_links": 100000,
"stats_permanency_days": 730,
"max_users": 30,
"max_brands": 70,
"has_smart_balancer": 1,
"has_split_testing": 1,
"has_smart_redirector": 1,
"max_qrcode_templates": 100,
"max_projects": "",
"has_conversions": 1,
"has_timed_urls": 1,
"force_brand_on_ctas": 0,
"has_watchdog_ping": 1,
"has_watchdog_advanced": 1,
"number_of_ctas": "",
"max_banners": "",
"custom_domains": 30,
"email_support": 1,
"priority_email_support": 1,
"has_security_monitor": 1,
"has_cfm": 1,
"has_custom_aliases": 1,
"has_masking": 1,
"has_jotbar": 1,
"has_custom_logo_in_reports": 1,
"has_custom_css_cta": 1,
"has_setup_assistance_and_training": 0,
"has_custom_invoicing": 0,
"has_enterprise_sla": 0,
"has_customizations_and_integrations": 0,
"has_digital_marketing_advice": 0,
"has_minipages": 1,
"has_deeplinks": 1,
"has_easydeeplinks": 1,
"has_preview": 1,
"public_name": "Business",
"has_utm_builder": 1,
"max_utm_templates": 30,
"has_remarketing": "",
"has_whatsapp": 1,
"has_instaurl": 0,
"has_selfdestruction": 0,
"is_monthly": 1,
"status": "green",
"trial_left_days": 30,
"events": "",
"is_monitored": 1,
"email_sent": 0,
"subscription_status": "ACTIVE",
"subscription_creation": "2018-08-13T23:16:14+02:00",
"subscription_next_billing_date": "2018-12-27T11:58:57+01:00",
"subscription_billing_end_date": "2018-12-27T11:58:57+01:00",
"subscription_never_expires": 1,
"subscription_trial_period": 0,
"subscription_first_billing_date": "2018-12-27T11:58:57+01:00",
"subscription_balance": 0,
"max_gdpr_templates": 10
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/suggest?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<estimated_events_per_month>350000</estimated_events_per_month>
<suggested_plan>
<id>b06f62e8bdf180631acaa8deae47850a</id>
<name>business</name>
<annually_cost>135</annually_cost>
<monthly_cost>169</monthly_cost>
<events_per_month>500000</events_per_month>
<tracking_links>100000</tracking_links>
<stats_permanency_days>730</stats_permanency_days>
<max_users>30</max_users>
<max_brands>70</max_brands>
<has_smart_balancer>1</has_smart_balancer>
<has_split_testing>1</has_split_testing>
<has_smart_redirector>1</has_smart_redirector>
<max_qrcode_templates>100</max_qrcode_templates>
<max_projects></max_projects>
<has_conversions>1</has_conversions>
<has_timed_urls>1</has_timed_urls>
<force_brand_on_ctas>0</force_brand_on_ctas>
<has_watchdog_ping>1</has_watchdog_ping>
<has_watchdog_advanced>1</has_watchdog_advanced>
<number_of_ctas></number_of_ctas>
<max_banners></max_banners>
<custom_domains>30</custom_domains>
<email_support>1</email_support>
<priority_email_support>1</priority_email_support>
<has_security_monitor>1</has_security_monitor>
<has_cfm>1</has_cfm>
<has_custom_aliases>1</has_custom_aliases>
<has_masking>1</has_masking>
<has_jotbar>1</has_jotbar>
<has_custom_logo_in_reports>1</has_custom_logo_in_reports>
<has_custom_css_cta>1</has_custom_css_cta>
<has_setup_assistance_and_training>0</has_setup_assistance_and_training>
<has_custom_invoicing>0</has_custom_invoicing>
<has_enterprise_sla>0</has_enterprise_sla>
<has_customizations_and_integrations>0</has_customizations_and_integrations>
<has_digital_marketing_advice>0</has_digital_marketing_advice>
<has_minipages>1</has_minipages>
<has_deeplinks>1</has_deeplinks>
<has_easydeeplinks>1</has_easydeeplinks>
<has_preview>1</has_preview>
<public_name>Business</public_name>
<has_utm_builder>1</has_utm_builder>
<max_utm_templates>30</max_utm_templates>
<has_remarketing></has_remarketing>
<has_whatsapp>1</has_whatsapp>
<has_instaurl>0</has_instaurl>
<has_selfdestruction>0</has_selfdestruction>
<is_monthly>1</is_monthly>
<status>green</status>
<trial_left_days>30</trial_left_days>
<events></events>
<is_monitored>1</is_monitored>
<email_sent>0</email_sent>
<subscription_status>ACTIVE</subscription_status>
<subscription_creation>2018-08-13T23:16:14+02:00</subscription_creation>
<subscription_next_billing_date>2018-12-27T11:58:57+01:00</subscription_next_billing_date>
<subscription_billing_end_date>2018-12-27T11:58:57+01:00</subscription_billing_end_date>
<subscription_never_expires>1</subscription_never_expires>
<subscription_trial_period>0</subscription_trial_period>
<subscription_first_billing_date>2018-12-27T11:58:57+01:00</subscription_first_billing_date>
<subscription_balance>0</subscription_balance>
<max_gdpr_templates>10</max_gdpr_templates>
</suggested_plan>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/suggest?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_estimated_events_per_month=350000
result_suggested_plan_id=b06f62e8bdf180631acaa8deae47850a
result_suggested_plan_name=business
result_suggested_plan_annually_cost=135
result_suggested_plan_monthly_cost=169
result_suggested_plan_events_per_month=500000
result_suggested_plan_tracking_links=100000
result_suggested_plan_stats_permanency_days=730
result_suggested_plan_max_users=30
result_suggested_plan_max_brands=70
result_suggested_plan_has_smart_balancer=1
result_suggested_plan_has_split_testing=1
result_suggested_plan_has_smart_redirector=1
result_suggested_plan_max_qrcode_templates=100
result_suggested_plan_max_projects=
result_suggested_plan_has_conversions=1
result_suggested_plan_has_timed_urls=1
result_suggested_plan_force_brand_on_ctas=0
result_suggested_plan_has_watchdog_ping=1
result_suggested_plan_has_watchdog_advanced=1
result_suggested_plan_number_of_ctas=
result_suggested_plan_max_banners=
result_suggested_plan_custom_domains=30
result_suggested_plan_email_support=1
result_suggested_plan_priority_email_support=1
result_suggested_plan_has_security_monitor=1
result_suggested_plan_has_cfm=1
result_suggested_plan_has_custom_aliases=1
result_suggested_plan_has_masking=1
result_suggested_plan_has_jotbar=1
result_suggested_plan_has_custom_logo_in_reports=1
result_suggested_plan_has_custom_css_cta=1
result_suggested_plan_has_setup_assistance_and_training=0
result_suggested_plan_has_custom_invoicing=0
result_suggested_plan_has_enterprise_sla=0
result_suggested_plan_has_customizations_and_integrations=0
result_suggested_plan_has_digital_marketing_advice=0
result_suggested_plan_has_minipages=1
result_suggested_plan_has_deeplinks=1
result_suggested_plan_has_easydeeplinks=1
result_suggested_plan_has_preview=1
result_suggested_plan_public_name=Business
result_suggested_plan_has_utm_builder=1
result_suggested_plan_max_utm_templates=30
result_suggested_plan_has_remarketing=
result_suggested_plan_has_whatsapp=1
result_suggested_plan_has_instaurl=0
result_suggested_plan_has_selfdestruction=0
result_suggested_plan_is_monthly=1
result_suggested_plan_status=green
result_suggested_plan_trial_left_days=30
result_suggested_plan_events=
result_suggested_plan_is_monitored=1
result_suggested_plan_email_sent=0
result_suggested_plan_subscription_status=ACTIVE
result_suggested_plan_subscription_creation=2018-08-13T23:16:14+02:00
result_suggested_plan_subscription_next_billing_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_billing_end_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_never_expires=1
result_suggested_plan_subscription_trial_period=0
result_suggested_plan_subscription_first_billing_date=2018-12-27T11:58:57+01:00
result_suggested_plan_subscription_balance=0
result_suggested_plan_max_gdpr_templates=10
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/suggest?format=plain
Query parameters
format = plain
Response
350000
b06f62e8bdf180631acaa8deae47850a
business
135
169
500000
100000
730
30
70
1
1
1
100
1
1
0
1
1
30
1
1
1
1
1
1
1
1
1
0
0
0
0
0
1
1
1
1
Business
1
30
1
0
0
1
green
30
1
0
ACTIVE
2018-08-13T23:16:14+02:00
2018-12-27T11:58:57+01:00
2018-12-27T11:58:57+01:00
1
0
2018-12-27T11:58:57+01:00
0
10
Return values
parameter | description |
---|---|
estimated_events_per_month | estimated events per month |
suggested_plan | [OPTIONAL] array containing info for the suggested plan, it is returned only if this method can find a suitable plan for the user |
/plans/update
access: [READ]
This method updates information about the user's plan. It should be called after a change of the user plan.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/update
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"new_plan": "Basic",
"old_plan": "Basic"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/update?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<new_plan>Basic</new_plan>
<old_plan>Basic</old_plan>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/update?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_new_plan=Basic
result_old_plan=Basic
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/update?format=plain
Query parameters
format = plain
Response
Basic
Basic
Return values
parameter | description |
---|---|
new_plan | the new plan name for the user, it can be the equal to old_plan if no change takes place |
old_plan | the old plan name for the user |
/plans/vats
/plans/vats/property
access: [READ]
This method returns the list of available VAT treatments.
Example 1 (json)
Request
https://joturl.com/a/i1/plans/vats/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"ITALY_PRIVATE",
"ITALY_BUSINESS",
"INTRA_EU_PRIVATE",
"INTRA_EU_BUSINESS",
"EXTRA_EU_PRIVATE",
"EXTRA_EU_BUSINESS"
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/plans/vats/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>ITALY_PRIVATE</i0>
<i1>ITALY_BUSINESS</i1>
<i2>INTRA_EU_PRIVATE</i2>
<i3>INTRA_EU_BUSINESS</i3>
<i4>EXTRA_EU_PRIVATE</i4>
<i5>EXTRA_EU_BUSINESS</i5>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/plans/vats/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=ITALY_PRIVATE
result_1=ITALY_BUSINESS
result_2=INTRA_EU_PRIVATE
result_3=INTRA_EU_BUSINESS
result_4=EXTRA_EU_PRIVATE
result_5=EXTRA_EU_BUSINESS
Example 4 (plain)
Request
https://joturl.com/a/i1/plans/vats/property?format=plain
Query parameters
format = plain
Response
ITALY_PRIVATE
ITALY_BUSINESS
INTRA_EU_PRIVATE
INTRA_EU_BUSINESS
EXTRA_EU_PRIVATE
EXTRA_EU_BUSINESS
Return values
parameter | description |
---|---|
[ARRAY] | array of available VAT treatment |
/projects
/projects/add
access: [WRITE]
Add a project with a specified name.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1
Query parameters
name = name for the project name
client = this is a sample note
has_utm_parameters = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "950cc8daf6027ceb47e3e6f57656afd1",
"name": "name for the project name",
"client": "this is a sample note",
"has_utm_parameters": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=xml
Query parameters
name = name for the project name
client = this is a sample note
has_utm_parameters = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>950cc8daf6027ceb47e3e6f57656afd1</id>
<name>name for the project name</name>
<client>this is a sample note</client>
<has_utm_parameters>1</has_utm_parameters>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=txt
Query parameters
name = name for the project name
client = this is a sample note
has_utm_parameters = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=950cc8daf6027ceb47e3e6f57656afd1
result_name=name for the project name
result_client=this is a sample note
result_has_utm_parameters=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/add?name=name+for+the+project+name&client=this+is+a+sample+note&has_utm_parameters=1&format=plain
Query parameters
name = name for the project name
client = this is a sample note
has_utm_parameters = 1
format = plain
Response
950cc8daf6027ceb47e3e6f57656afd1
name for the project name
this is a sample note
1
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | project name | 255 |
Optional parameters
parameter | description | max length |
---|---|---|
clientSTRING | name of the client to whom the project is dedicated and/or the notes for the project | 255 |
has_utm_parametersBOOLEAN | 1 to enable the UTM view, 0 otherwise |
Return values
parameter | description |
---|---|
client | echo back of the client parameter |
id | ID of the project |
name | echo back of the name parameter |
/projects/count
access: [READ]
This method returns the number of user's projects.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 73
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>73</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=73
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/count?format=plain
Query parameters
format = plain
Response
73
Optional parameters
parameter | description |
---|---|
accountSTRING | if 1 this methods returns the total number of projects (other parameters are ignored) |
end_dateSTRING | filter projects created up to this date (inclusive) |
searchSTRING | filter projects by searching them |
start_dateSTRING | filter projects created from this date (inclusive) |
with_alertsBOOLEAN | filter projects with security alerts |
Return values
parameter | description |
---|---|
count | number of projects |
/projects/defaults
/projects/defaults/get
access: [READ]
Get a default setting for the project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/defaults/get?project_id=5f02a8c09962c0a920c62d637bef04a3&setting=default_tl
Query parameters
project_id = 5f02a8c09962c0a920c62d637bef04a3
setting = default_tl
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"value": "6ac67f2a31bf6cd164f5c2fc458aa7ea"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/defaults/get?project_id=5f02a8c09962c0a920c62d637bef04a3&setting=default_tl&format=xml
Query parameters
project_id = 5f02a8c09962c0a920c62d637bef04a3
setting = default_tl
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<value>6ac67f2a31bf6cd164f5c2fc458aa7ea</value>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/defaults/get?project_id=5f02a8c09962c0a920c62d637bef04a3&setting=default_tl&format=txt
Query parameters
project_id = 5f02a8c09962c0a920c62d637bef04a3
setting = default_tl
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_value=6ac67f2a31bf6cd164f5c2fc458aa7ea
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/defaults/get?project_id=5f02a8c09962c0a920c62d637bef04a3&setting=default_tl&format=plain
Query parameters
project_id = 5f02a8c09962c0a920c62d637bef04a3
setting = default_tl
format = plain
Response
6ac67f2a31bf6cd164f5c2fc458aa7ea
Required parameters
parameter | description | max length |
---|---|---|
project_idID | ID of the project | |
settingSTRING | setting to obtain, see i1/projects/defaults/set for details | 50 |
Return values
parameter | description |
---|---|
value | the value of the required setting |
/projects/defaults/set
access: [WRITE]
Set/unset a default setting for the project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/defaults/set?project_id=3ee45b56f04ed15fc9ec62fc7f334a82&setting=default_tl&value=1965a659cb3145cbacf2a98b41fe50a4
Query parameters
project_id = 3ee45b56f04ed15fc9ec62fc7f334a82
setting = default_tl
value = 1965a659cb3145cbacf2a98b41fe50a4
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"set": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/defaults/set?project_id=3ee45b56f04ed15fc9ec62fc7f334a82&setting=default_tl&value=1965a659cb3145cbacf2a98b41fe50a4&format=xml
Query parameters
project_id = 3ee45b56f04ed15fc9ec62fc7f334a82
setting = default_tl
value = 1965a659cb3145cbacf2a98b41fe50a4
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<set>1</set>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/defaults/set?project_id=3ee45b56f04ed15fc9ec62fc7f334a82&setting=default_tl&value=1965a659cb3145cbacf2a98b41fe50a4&format=txt
Query parameters
project_id = 3ee45b56f04ed15fc9ec62fc7f334a82
setting = default_tl
value = 1965a659cb3145cbacf2a98b41fe50a4
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_set=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/defaults/set?project_id=3ee45b56f04ed15fc9ec62fc7f334a82&setting=default_tl&value=1965a659cb3145cbacf2a98b41fe50a4&format=plain
Query parameters
project_id = 3ee45b56f04ed15fc9ec62fc7f334a82
setting = default_tl
value = 1965a659cb3145cbacf2a98b41fe50a4
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
project_idID | ID of the project | |
settingSTRING | setting to be set/unset, settings available: default_tl , default_domain | 50 |
Optional parameters
parameter | description | max length |
---|---|---|
valueID | the value to be setted, empty to unset | 50 |
Return values
parameter | description |
---|---|
set | 1 on set, 0 otherwise |
/projects/delete
access: [WRITE]
This method deletes a set of projects using the ids. Return 1 if the operation succeeds or 0 otherwise.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/delete?ids=9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660
Query parameters
ids = 9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/delete?ids=9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660&format=xml
Query parameters
ids = 9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/delete?ids=9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660&format=txt
Query parameters
ids = 9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/delete?ids=9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660&format=plain
Query parameters
ids = 9d69840b8580c639602fcba2d2d2037c,13a565d2a2a8707ebcc97a1b01e98f4a,80cc575463aeeea0fcb60214e9122660
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/projects/delete?ids=bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140
Query parameters
ids = bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": [
"aae9b9877d73548f0c606d78d9a3ec00",
"1c6ea3cdbb4eb6ec13bd3f42d635a140"
],
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/projects/delete?ids=bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140&format=xml
Query parameters
ids = bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>
<i0>aae9b9877d73548f0c606d78d9a3ec00</i0>
<i1>1c6ea3cdbb4eb6ec13bd3f42d635a140</i1>
</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/projects/delete?ids=bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140&format=txt
Query parameters
ids = bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=aae9b9877d73548f0c606d78d9a3ec00
result_ids_1=1c6ea3cdbb4eb6ec13bd3f42d635a140
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/projects/delete?ids=bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140&format=plain
Query parameters
ids = bcc8c2a6f98ef256f6a56a3906f36b39,aae9b9877d73548f0c606d78d9a3ec00,1c6ea3cdbb4eb6ec13bd3f42d635a140
format = plain
Response
aae9b9877d73548f0c606d78d9a3ec00
1c6ea3cdbb4eb6ec13bd3f42d635a140
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of project IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted projects |
ids | [OPTIONAL] list of project IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/projects/edit
access: [WRITE]
Edit a project data for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/edit?id=b979017a30babacd7ed76b108b1554cb&name=new+name+for+the+project&client=new+notes+for+the+project
Query parameters
id = b979017a30babacd7ed76b108b1554cb
name = new name for the project
client = new notes for the project
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "b979017a30babacd7ed76b108b1554cb",
"name": "new name for the project",
"client": "new notes for the project"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/edit?id=b979017a30babacd7ed76b108b1554cb&name=new+name+for+the+project&client=new+notes+for+the+project&format=xml
Query parameters
id = b979017a30babacd7ed76b108b1554cb
name = new name for the project
client = new notes for the project
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>b979017a30babacd7ed76b108b1554cb</id>
<name>new name for the project</name>
<client>new notes for the project</client>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/edit?id=b979017a30babacd7ed76b108b1554cb&name=new+name+for+the+project&client=new+notes+for+the+project&format=txt
Query parameters
id = b979017a30babacd7ed76b108b1554cb
name = new name for the project
client = new notes for the project
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=b979017a30babacd7ed76b108b1554cb
result_name=new name for the project
result_client=new notes for the project
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/edit?id=b979017a30babacd7ed76b108b1554cb&name=new+name+for+the+project&client=new+notes+for+the+project&format=plain
Query parameters
id = b979017a30babacd7ed76b108b1554cb
name = new name for the project
client = new notes for the project
format = plain
Response
b979017a30babacd7ed76b108b1554cb
new name for the project
new notes for the project
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Optional parameters
parameter | description | max length |
---|---|---|
clientSTRING | new name of the client to whom the project is dedicated and/or new notes for the project | 255 |
has_utm_parametersBOOLEAN | 1 to enable the UTM view, 0 otherwise | |
nameSTRING | new name for the project | 255 |
Return values
parameter | description |
---|---|
client | [OPTIONAL] echo back of the name of the client to whom the project is dedicated and/or the notes for the project |
has_utm_parameters | [OPTIONAL] echo back of has_utm_parameters parameter |
id | ID of the project |
name | [OPTIONAL] echo back of the name of the project |
/projects/info
access: [READ]
This method returns information on a project, the returned information depends on input parameter fields
.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/info?id=48a7de6b7cbad79e20fbadc406832939&fields=name,id
Query parameters
id = 48a7de6b7cbad79e20fbadc406832939
fields = name,id
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "project 1",
"id": "48a7de6b7cbad79e20fbadc406832939"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/info?id=48a7de6b7cbad79e20fbadc406832939&fields=name,id&format=xml
Query parameters
id = 48a7de6b7cbad79e20fbadc406832939
fields = name,id
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>project 1</name>
<id>48a7de6b7cbad79e20fbadc406832939</id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/info?id=48a7de6b7cbad79e20fbadc406832939&fields=name,id&format=txt
Query parameters
id = 48a7de6b7cbad79e20fbadc406832939
fields = name,id
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=project 1
result_id=48a7de6b7cbad79e20fbadc406832939
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/info?id=48a7de6b7cbad79e20fbadc406832939&fields=name,id&format=plain
Query parameters
id = 48a7de6b7cbad79e20fbadc406832939
fields = name,id
format = plain
Response
project 1
48a7de6b7cbad79e20fbadc406832939
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: name, client, id, creation, urls_count, conversions_visits, remarketings_visits, ctas_visits, qrcodes_visits, unique_visits, visits, has_utm_parameters, is_default |
idID | ID of the project |
Return values
parameter | description |
---|---|
client | [OPTIONAL] name of the client to whom the project is dedicated and/or the notes for the project |
conversions_visits | [OPTIONAL] number of conversions clicks on tracking links in the project |
creation | [OPTIONAL] date of creation of the project |
ctas_visits | [OPTIONAL] number of CTA clicks on tracking links in the project |
has_utm_parameters | [OPTIONAL] 1 if the project has UTM view enabled, 0 otherwise |
id | [OPTIONAL] ID of the project |
is_default | [OPTIONAL] 1 if it is the default project, 0 otherwise |
name | [OPTIONAL] name of the project |
qrcodes_visits | [OPTIONAL] number of visits on tracking links in the project coming from QR codes |
remarketings_visits | [OPTIONAL] number of remarketings clicks on tracking links in the project |
unique_visits | [OPTIONAL] number of unique visits on tracking links in the project |
urls_count | [OPTIONAL] number of tracking links in the project |
visits | [OPTIONAL] number of visits on tracking links in the project |
/projects/jotbars
/projects/jotbars/edit
access: [WRITE]
Set a jotbar option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/jotbars/edit?id=78c793baf5212093953257d855dc2203&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D
Query parameters
id = 78c793baf5212093953257d855dc2203
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/jotbars/edit?id=78c793baf5212093953257d855dc2203&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml
Query parameters
id = 78c793baf5212093953257d855dc2203
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/jotbars/edit?id=78c793baf5212093953257d855dc2203&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt
Query parameters
id = 78c793baf5212093953257d855dc2203
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/jotbars/edit?id=78c793baf5212093953257d855dc2203&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain
Query parameters
id = 78c793baf5212093953257d855dc2203
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the project |
languagesARRAY | comma-separated list of the languages selected for the jotbar, the jotbar will be shown to the user in the language the user has chosen in his/hers browser, if the user has an unsupported language the default language will be used (i.e., default_language if not empty, user_default_language otherwise) |
Optional parameters
parameter | description |
---|---|
default_languageSTRING | default language within languages, empty or null to inherit the configuration from the account-level settings |
infoJSON | JSON containing page_title, description_title, description, questions_title, questions for each language in languages, see i1/projects/jotbars/info for details on info |
logoSTRING | it can be: |
- 0 to disable logo
- the URL of the logo to be shown
- empty or
null
to inherit the configuration from the account-level settings logo_urlSTRING|when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo show_feedbackSTRING|1 to show feedback, 0 to do not show it, empty ornull
to inherit the configuration from the account-level settings templateSTRING|position of the jotbar, empty ornull
to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property template_sizeSTRING|dimension of the jotbar, empty ornull
to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/projects/jotbars/info
access: [READ]
Get jotbar information for the project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/jotbars/info?id=323ca4bc8ba9da4cc0bcb5faff773d5f
Query parameters
id = 323ca4bc8ba9da4cc0bcb5faff773d5f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"logo": "https:\/\/joturl.com\/logo.svg",
"logo_url": "https:\/\/joturl.com\/",
"template": "right",
"template_size": "big",
"show_feedback": null,
"languages": "en,it",
"default_language": "",
"user_default_language": "en",
"info": {
"en": {
"page_title": "English page title",
"description_title": null,
"description": "<p>[EN] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[EN] HTML questions<\/p>"
},
"it": {
"page_title": "Titolo pagina in italiano",
"description_title": null,
"description": "<p>[IT] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[IT] HTML questions<\/p>"
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/jotbars/info?id=323ca4bc8ba9da4cc0bcb5faff773d5f&format=xml
Query parameters
id = 323ca4bc8ba9da4cc0bcb5faff773d5f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<logo>https://joturl.com/logo.svg</logo>
<logo_url>https://joturl.com/</logo_url>
<template>right</template>
<template_size>big</template_size>
<show_feedback></show_feedback>
<languages>en,it</languages>
<default_language></default_language>
<user_default_language>en</user_default_language>
<info>
<en>
<page_title>English page title</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>
</en>
<it>
<page_title>Titolo pagina in italiano</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>
</it>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/jotbars/info?id=323ca4bc8ba9da4cc0bcb5faff773d5f&format=txt
Query parameters
id = 323ca4bc8ba9da4cc0bcb5faff773d5f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_languages=en,it
result_default_language=
result_user_default_language=en
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/jotbars/info?id=323ca4bc8ba9da4cc0bcb5faff773d5f&format=plain
Query parameters
id = 323ca4bc8ba9da4cc0bcb5faff773d5f
format = plain
Response
https://joturl.com/logo.svg
https://joturl.com/
right
big
en,it
en
English page title
&lt;p&gt;[EN] HTML description&lt;/p&gt;
&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano
&lt;p&gt;[IT] HTML description&lt;/p&gt;
&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Return values
parameter | description |
---|---|
default_language | default language within languages, empty or null to inherit the configuration from the account-level settings |
info | for each language in languages, it contains page_title, description_title, description, questions_title, questions, see the following notes for details |
languages | comma-separated list of the languages selected for the jotbar, the jotbar will be shown to the user in the language the user has chosen in his/hers browser, if the user has an unsupported language the default language will be used (i.e., default_language if not empty, user_default_language otherwise) |
logo | it can be: |
- 0 to disable logo
- the URL of the logo to be shown
- empty or
null
to inherit the configuration from the account-level settings logo_url|when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo show_feedback|1 to show feedback, 0 to do not show it, empty ornull
to inherit the configuration from the account-level settings template|position of the jotbar, empty ornull
to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property template_size|dimension of the jotbar, empty ornull
to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property user_default_language|account-level default language
/projects/languages
/projects/languages/list
access: [READ]
This method returns a list of available languages for specific options (e.g., jotBar) of a project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/languages/list?id=1e18e10ca3d7f4d186dca8fc019704b6
Query parameters
id = 1e18e10ca3d7f4d186dca8fc019704b6
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"languages": [
{
"name": "en",
"label": "English"
},
{
"name": "it",
"label": "Italiano"
}
],
"selected": [
"en",
"it"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/languages/list?id=1e18e10ca3d7f4d186dca8fc019704b6&format=xml
Query parameters
id = 1e18e10ca3d7f4d186dca8fc019704b6
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<languages>
<i0>
<name>en</name>
<label>English</label>
</i0>
<i1>
<name>it</name>
<label>Italiano</label>
</i1>
</languages>
<selected>
<i0>en</i0>
<i1>it</i1>
</selected>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/languages/list?id=1e18e10ca3d7f4d186dca8fc019704b6&format=txt
Query parameters
id = 1e18e10ca3d7f4d186dca8fc019704b6
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_languages_0_name=en
result_languages_0_label=English
result_languages_1_name=it
result_languages_1_label=Italiano
result_selected_0=en
result_selected_1=it
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/languages/list?id=1e18e10ca3d7f4d186dca8fc019704b6&format=plain
Query parameters
id = 1e18e10ca3d7f4d186dca8fc019704b6
format = plain
Response
en
English
it
Italiano
en
it
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Return values
parameter | description |
---|---|
languages | available languages |
selected | array of names of enabled languages |
/projects/list
access: [READ]
This method returns a list of projects data, specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/list?fields=name,id
Query parameters
fields = name,id
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"name": "project 1",
"id": "6a29c0b195e99f71b91dc20810a24b72"
},
{
"name": "project 2",
"id": "346eac44754a185e46ec86018ac5256e"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/list?fields=name,id&format=xml
Query parameters
fields = name,id
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<name>project 1</name>
<id>6a29c0b195e99f71b91dc20810a24b72</id>
</i0>
<i1>
<name>project 2</name>
<id>346eac44754a185e46ec86018ac5256e</id>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/list?fields=name,id&format=txt
Query parameters
fields = name,id
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_name=project 1
result_data_0_id=6a29c0b195e99f71b91dc20810a24b72
result_data_1_name=project 2
result_data_1_id=346eac44754a185e46ec86018ac5256e
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/list?fields=name,id&format=plain
Query parameters
fields = name,id
format = plain
Response
project 1
6a29c0b195e99f71b91dc20810a24b72
project 2
346eac44754a185e46ec86018ac5256e
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: client, conversions_visits, creation, ctas_visits, has_utm_parameters, id, name, qrcodes_visits, remarketings_visits, unique_visits, urls_count, visits, is_default, count |
Optional parameters
parameter | description |
---|---|
creatorSTRING | filter projects by creator, available values: ID , all , me , others , only available for administrator users, see notes for details |
end_dateSTRING | filter projects created up to this date (inclusive) |
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: client, conversions_visits, creation, ctas_visits, has_utm_parameters, id, name, qrcodes_visits, remarketings_visits, unique_visits, urls_count, visits, is_default |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
start_dateSTRING | filter projects created from this date (inclusive) |
subuser_idID | ID of the team member, when passed the field has_access is returned for each project, has_access = 1 if the team member has access to the project, has_access = 0 otherwise |
whereSTRING | to be used in conjunction with search, specifies where to search and it can be both , projects or links ; where = projects : search for projects matching the name or the notes (default); where = links : search for tracking links matching the short url or the destination URL where = both : search for both tracking links and projects; |
with_alertsBOOLEAN | filter projects with security alerts |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of projects, returned only if count is passed in fields |
data | array containing required information on projects the user has access to |
/projects/options
/projects/options/info
access: [READ]
Returns the list of available options for a specific project. Further, this method returns the exclusion list and active options.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/options/info?id=08738711ee84782504a88d2b4fe4abeb
Query parameters
id = 08738711ee84782504a88d2b4fe4abeb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"options": [
"users",
"jotbar",
"defaults"
],
"exclusions": [],
"disabled": [],
"active": [
"defaults"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/options/info?id=08738711ee84782504a88d2b4fe4abeb&format=xml
Query parameters
id = 08738711ee84782504a88d2b4fe4abeb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<options>
<i0>users</i0>
<i1>jotbar</i1>
<i2>defaults</i2>
</options>
<exclusions>
</exclusions>
<disabled>
</disabled>
<active>
<i0>defaults</i0>
</active>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/options/info?id=08738711ee84782504a88d2b4fe4abeb&format=txt
Query parameters
id = 08738711ee84782504a88d2b4fe4abeb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=users
result_options_1=jotbar
result_options_2=defaults
result_exclusions=
result_disabled=
result_active_0=defaults
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/options/info?id=08738711ee84782504a88d2b4fe4abeb&format=plain
Query parameters
id = 08738711ee84782504a88d2b4fe4abeb
format = plain
Response
users
jotbar
defaults
defaults
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Return values
parameter | description |
---|---|
active | currently active options for the project |
disabled | disabled options for the project |
exclusions | exclusion map between options, a list of pairs (option, list of incompatible options) |
options | available options for the project |
/projects/subusers
/projects/subusers/grant
access: [WRITE]
Grants access to the project to specified team members.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/subusers/grant?id=b2ee46552be82a5451ab532e30a13d83&add_ids=c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5&delete_ids=481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2
Query parameters
id = b2ee46552be82a5451ab532e30a13d83
add_ids = c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5
delete_ids = 481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 2,
"deleted": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/subusers/grant?id=b2ee46552be82a5451ab532e30a13d83&add_ids=c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5&delete_ids=481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2&format=xml
Query parameters
id = b2ee46552be82a5451ab532e30a13d83
add_ids = c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5
delete_ids = 481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>2</added>
<deleted>5</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/subusers/grant?id=b2ee46552be82a5451ab532e30a13d83&add_ids=c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5&delete_ids=481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2&format=txt
Query parameters
id = b2ee46552be82a5451ab532e30a13d83
add_ids = c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5
delete_ids = 481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=2
result_deleted=5
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/subusers/grant?id=b2ee46552be82a5451ab532e30a13d83&add_ids=c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5&delete_ids=481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2&format=plain
Query parameters
id = b2ee46552be82a5451ab532e30a13d83
add_ids = c8930b71fc7aca7a2283363dc4040662,cc422c6d2b14a8654459d044f43022c5
delete_ids = 481c670db614d42276bbc699e1af19db,0e1cd7cda35c4ebafa3fe3681937d725,c546416d350d4840ff698410d538775f,228ed46bd8226a9f7d438985f88de640,95df0172b4ba93f2f294761d55b9d5c2
format = plain
Response
2
5
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Optional parameters
parameter | description |
---|---|
add_idsARRAY_OF_IDS | comma-separated list of team members to grant access to the project |
delete_idsARRAY_OF_IDS | comma-separated list of team members to deny access to the project |
Return values
parameter | description |
---|---|
added | number of team members who have been granted access to the project |
deleted | number of team members who were denied access to the project |
/projects/watchdogs
/projects/watchdogs/alerts
/projects/watchdogs/alerts/delete
access: [WRITE]
Reset watchdog alerts for a given array of project IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2
Query parameters
ids = 181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 15,
"ids": [
"181464635df0cca19bd799abe5d98af0",
"6bde458cabceec212808654ffbdff603",
"87ea878dd697bc1b8a3cb731863797d2"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2&format=xml
Query parameters
ids = 181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>15</count>
<ids>
<i0>181464635df0cca19bd799abe5d98af0</i0>
<i1>6bde458cabceec212808654ffbdff603</i1>
<i2>87ea878dd697bc1b8a3cb731863797d2</i2>
</ids>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2&format=txt
Query parameters
ids = 181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=15
result_ids_0=181464635df0cca19bd799abe5d98af0
result_ids_1=6bde458cabceec212808654ffbdff603
result_ids_2=87ea878dd697bc1b8a3cb731863797d2
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/watchdogs/alerts/delete?ids=181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2&format=plain
Query parameters
ids = 181464635df0cca19bd799abe5d98af0,6bde458cabceec212808654ffbdff603,87ea878dd697bc1b8a3cb731863797d2
format = plain
Response
15
181464635df0cca19bd799abe5d98af0
6bde458cabceec212808654ffbdff603
87ea878dd697bc1b8a3cb731863797d2
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of project IDs |
Return values
parameter | description |
---|---|
count | number of resetted alerts, a maximum of 10000 alerts will be processed |
ids | array containing IDs passed in the ids input parameter |
/projects/webhooks
/projects/webhooks/info
access: [READ]
This method return information on a webhook.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/webhooks/info?id=5bbc20c1c17c4fc7c7303ca5992da496
Query parameters
id = 5bbc20c1c17c4fc7c7303ca5992da496
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "5bbc20c1c17c4fc7c7303ca5992da496",
"url": "https:\/\/my.custom.webhook\/",
"type": "custom",
"info": [],
"notes": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/webhooks/info?id=5bbc20c1c17c4fc7c7303ca5992da496&format=xml
Query parameters
id = 5bbc20c1c17c4fc7c7303ca5992da496
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>5bbc20c1c17c4fc7c7303ca5992da496</id>
<url>https://my.custom.webhook/</url>
<type>custom</type>
<info>
</info>
<notes></notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/webhooks/info?id=5bbc20c1c17c4fc7c7303ca5992da496&format=txt
Query parameters
id = 5bbc20c1c17c4fc7c7303ca5992da496
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=5bbc20c1c17c4fc7c7303ca5992da496
result_url=https://my.custom.webhook/
result_type=custom
result_info=
result_notes=
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/webhooks/info?id=5bbc20c1c17c4fc7c7303ca5992da496&format=plain
Query parameters
id = 5bbc20c1c17c4fc7c7303ca5992da496
format = plain
Response
5bbc20c1c17c4fc7c7303ca5992da496
https://my.custom.webhook/
custom
Required parameters
parameter | description |
---|---|
idID | ID of the project from which to remove the webhook |
Return values
parameter | description |
---|---|
id | echo back of the id input parameter |
info | extended info of the webhook |
notes | notes for the webhook |
type | webhook type, see i1/ctas/webhooks/property for details |
url | URL of the webhook |
/projects/webhooks/property
access: [READ]
Return available webhook types and their parameters.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier
Query parameters
types = custom,zapier
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"custom": {
"name": "Custom webhook",
"private": 0,
"url_required": 1,
"info": {
"home": "https:\/\/joturl.zendesk.com\/hc\/en-us\/articles\/360012882199",
"logo": "data:image\/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg=="
},
"parameters": [
{
"name": "fields",
"type": "json",
"maxlength": 2000,
"description": "couples key\/values",
"mandatory": 0,
"example": "{\"source\":\"joturl\",\"test\":1}"
}
]
},
"zapier": {
"name": "Zapier",
"private": 1,
"url_required": 0,
"info": {
"home": "https:\/\/zapier.com\/",
"logo": "https:\/\/cdn.zapier.com\/zapier\/images\/logos\/zapier-logo.png"
},
"parameters": []
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=xml
Query parameters
types = custom,zapier
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<custom>
<name>Custom webhook</name>
<private>0</private>
<url_required>1</url_required>
<info>
<home>https://joturl.zendesk.com/hc/en-us/articles/360012882199</home>
<logo>data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==</logo>
</info>
<parameters>
<i0>
<name>fields</name>
<type>json</type>
<maxlength>2000</maxlength>
<description>couples key/values</description>
<mandatory>0</mandatory>
<example>{"source":"joturl","test":1}</example>
</i0>
</parameters>
</custom>
<zapier>
<name>Zapier</name>
<private>1</private>
<url_required>0</url_required>
<info>
<home>https://zapier.com/</home>
<logo>https://cdn.zapier.com/zapier/images/logos/zapier-logo.png</logo>
</info>
<parameters>
</parameters>
</zapier>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=txt
Query parameters
types = custom,zapier
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_custom_name=Custom webhook
result_data_custom_private=0
result_data_custom_url_required=1
result_data_custom_info_home=https://joturl.zendesk.com/hc/en-us/articles/360012882199
result_data_custom_info_logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
result_data_custom_parameters_0_name=fields
result_data_custom_parameters_0_type=json
result_data_custom_parameters_0_maxlength=2000
result_data_custom_parameters_0_description=couples key/values
result_data_custom_parameters_0_mandatory=0
result_data_custom_parameters_0_example={"source":"joturl","test":1}
result_data_zapier_name=Zapier
result_data_zapier_private=1
result_data_zapier_url_required=0
result_data_zapier_info_home=https://zapier.com/
result_data_zapier_info_logo=https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
result_data_zapier_parameters=
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/webhooks/property?types=custom,zapier&format=plain
Query parameters
types = custom,zapier
format = plain
Response
Custom webhook
0
1
https://joturl.zendesk.com/hc/en-us/articles/360012882199
data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyB2ZXJzaW9uPSIxLjEiIHZpZXdCb3g9IjAgMCA1MTIgNTEyIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgo8cGF0aCBkPSJtMjU2IDcuMzZjLTY1LjI1OSAwLTExOC40IDUzLjE0MS0xMTguNCAxMTguNCAwIDM4Ljk0MyAxOS4zMzMgNzMuMTIxIDQ4LjQ3IDk0LjcybC01OC40NiA5Ni41N2MtMC40NjItMC4xMzktMC45NzEtMC4yMzEtMS40OC0wLjM3LTEyLjIxLTMuMjg0LTI0LjkyOS0xLjQ4LTM1Ljg5IDQuODEtMjIuNjE2IDEzLjA4OS0zMC40MzIgNDIuMTM0LTE3LjM5IDY0Ljc1IDguNzQxIDE1LjE3IDI0LjY5NyAyMy42OCA0MS4wNyAyMy42OCA4LjA0NyAwIDE2LjIzNC0xLjk4OSAyMy42OC02LjI5IDEwLjk2MS02LjMzNiAxOC45MTYtMTYuNjUgMjIuMi0yOC44NnMxLjUyNi0yNC45MjktNC44MS0zNS44OWMtMS45ODktMy40MjItNC43MTgtNi40NzUtNy40LTkuMjVsNzAuNjctMTE2LjE4LTEwLjM2LTUuOTJjLTI3Ljg4OS0xNi40NjUtNDYuNjItNDYuOTQ0LTQ2LjYyLTgxLjc3IDAtNTIuNDQ4IDQyLjI3My05NC43MiA5NC43Mi05NC43MnM5NC43MiA0Mi4yNzIgOTQuNzIgOTQuNzJjMCA5Ljc1OS0xLjM0MSAxOC45MTYtNC4wNyAyNy43NWwyMi41NyA3LjAzYzMuNDIyLTExLjA1NCA1LjE4LTIyLjY2MiA1LjE4LTM0Ljc4IDAtNjUuMjU5LTUzLjE0MS0xMTguNC0xMTguNC0xMTguNHptMCA3MS4wNGMtMjYuMTMxIDAtNDcuMzYgMjEuMjI5LTQ3LjM2IDQ3LjM2czIxLjIyOSA0Ny4zNiA0Ny4zNiA0Ny4zNmMzLjkzMSAwIDcuODE2LTAuNTU1IDExLjQ3LTEuNDhsNTYuOTggMTAzLjIzIDUuNTUgMTAuMzYgMTAuNzMtNS41NWMxMy41NTEtNy40OTMgMjguOTA2LTExLjg0IDQ1LjUxLTExLjg0IDUyLjQ0OCAwIDk0LjcyIDQyLjI3MiA5NC43MiA5NC43MnMtNDIuMjczIDk0LjcyLTk0LjcyIDk0LjcyYy0yNS41NzYgMC00OC43OTQtMTAuMjIxLTY1Ljg2LTI2LjY0bC0xNi4yOCAxNy4wMmMyMS4yNzUgMjAuNDg5IDUwLjMyIDMzLjMgODIuMTQgMzMuMyA2NS4yNTkgMCAxMTguNC01My4xNDEgMTE4LjQtMTE4LjRzLTUzLjE0MS0xMTguNC0xMTguNC0xMTguNGMtMTYuNDE5IDAtMzEuNjM1IDQuMzAxLTQ1Ljg4IDEwLjM2bC01Mi4xNy05NC4zNWM5LjI1LTguNjQ5IDE1LjE3LTIwLjc2NiAxNS4xNy0zNC40MSAwLTI2LjEzMS0yMS4yMjktNDcuMzYtNDcuMzYtNDcuMzZ6bS0xNzAuOTQgMTY5LjA5Yy01MS41NjkgMTIuODU3LTg5LjU0IDU5LjcwOS04OS41NCAxMTUuMDcgMCA2NS4yNTkgNTMuMTQxIDExOC40IDExOC40IDExOC40IDYxLjA1IDAgMTA5Ljk0LTQ3LjEyOSAxMTYuMTgtMTA2LjU2aDExMC42M2M1LjI3MiAyMC4zOTYgMjMuNDk1IDM1LjUyIDQ1LjUxIDM1LjUyIDI2LjEzMSAwIDQ3LjM2LTIxLjIyOSA0Ny4zNi00Ny4zNnMtMjEuMjI5LTQ3LjM2LTQ3LjM2LTQ3LjM2Yy0yMi4wMTUgMC00MC4yMzggMTUuMTI0LTQ1LjUxIDM1LjUyaC0xMzIuMDl2MTEuODRjMCA1Mi40NDgtNDIuMjczIDk0LjcyLTk0LjcyIDk0Ljcycy05NC43Mi00Mi4yNzItOTQuNzItOTQuNzJjMC00NC40OTIgMzAuNjE4LTgxLjQ5MiA3MS43OC05MS43NnoiLz4KPC9zdmc+Cg==
fields
json
2000
couples key/values
0
{"source":"joturl","test":1}
Zapier
1
0
https://zapier.com/
https://cdn.zapier.com/zapier/images/logos/zapier-logo.png
Optional parameters
parameter | description |
---|---|
typesSTRING | comma-separated list of webhook types to be returned, if empty all types are returned, available types: custom , zapier |
Return values
parameter | description |
---|---|
data | array containing information on webhook parameters by type |
/projects/webhooks/subscribe
access: [WRITE]
This method add a webhook subscription to a project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/webhooks/subscribe?id=8abb132c9f47653e0d8977b10382003c&url=https%3A%2F%2Fjoturl.com%2F
Query parameters
id = 8abb132c9f47653e0d8977b10382003c
url = https://joturl.com/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/webhooks/subscribe?id=8abb132c9f47653e0d8977b10382003c&url=https%3A%2F%2Fjoturl.com%2F&format=xml
Query parameters
id = 8abb132c9f47653e0d8977b10382003c
url = https://joturl.com/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/webhooks/subscribe?id=8abb132c9f47653e0d8977b10382003c&url=https%3A%2F%2Fjoturl.com%2F&format=txt
Query parameters
id = 8abb132c9f47653e0d8977b10382003c
url = https://joturl.com/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/webhooks/subscribe?id=8abb132c9f47653e0d8977b10382003c&url=https%3A%2F%2Fjoturl.com%2F&format=plain
Query parameters
id = 8abb132c9f47653e0d8977b10382003c
url = https://joturl.com/
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the project to which to add the webhook |
typeSTRING | webhook type, allowed types: custom , zapier |
Optional parameters
parameter | description | max length |
---|---|---|
infoJSON | info to be used with the webhook (e.g., an API key), see below for details | |
notesSTRING | notes for the webhook | 4000 |
unsubscribeBOOLEAN | 1 to unsubscribe from the current webhook (if any) and subscribe to the new one | |
urlSTRING | URL of the webhook, required for types: custom , zapier | 4000 |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/projects/webhooks/test
access: [WRITE]
This endpoint sends test data to a project webhook.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/webhooks/test?id=bd2e9934fd92cccb2f6410572c98a6c9
Query parameters
id = bd2e9934fd92cccb2f6410572c98a6c9
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ok": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/webhooks/test?id=bd2e9934fd92cccb2f6410572c98a6c9&format=xml
Query parameters
id = bd2e9934fd92cccb2f6410572c98a6c9
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ok>1</ok>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/webhooks/test?id=bd2e9934fd92cccb2f6410572c98a6c9&format=txt
Query parameters
id = bd2e9934fd92cccb2f6410572c98a6c9
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/webhooks/test?id=bd2e9934fd92cccb2f6410572c98a6c9&format=plain
Query parameters
id = bd2e9934fd92cccb2f6410572c98a6c9
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the project associated with the webhook |
Return values
parameter | description |
---|---|
ok | 1 on success, otherwise an error is returned |
/projects/webhooks/unsubscribe
access: [WRITE]
This method removes a webhook subscription to a project.
Example 1 (json)
Request
https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=19f45f58536e5e869b13d4771526eefe
Query parameters
id = 19f45f58536e5e869b13d4771526eefe
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"removed": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=19f45f58536e5e869b13d4771526eefe&format=xml
Query parameters
id = 19f45f58536e5e869b13d4771526eefe
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<removed>1</removed>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=19f45f58536e5e869b13d4771526eefe&format=txt
Query parameters
id = 19f45f58536e5e869b13d4771526eefe
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_removed=1
Example 4 (plain)
Request
https://joturl.com/a/i1/projects/webhooks/unsubscribe?id=19f45f58536e5e869b13d4771526eefe&format=plain
Query parameters
id = 19f45f58536e5e869b13d4771526eefe
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the project from which to remove the webhook |
Return values
parameter | description |
---|---|
removed | 1 on success, 0 otherwise |
/provinces
/provinces/list
access: [READ]
This method returns a list of available Italian provinces.
Example 1 (json)
Request
https://joturl.com/a/i1/provinces/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"provinces": [
{
"label": "Agrigento",
"code": "AG"
},
{
"label": "Alessandria",
"code": "AL"
},
{
"label": "Ancona",
"code": "AN"
},
{
"label": "Aosta",
"code": "AO"
},
{
"label": "Arezzo",
"code": "AR"
},
{
"label": "Ascoli Piceno",
"code": "AP"
},
{
"label": "Asti",
"code": "AT"
},
{
"label": "Avellino",
"code": "AV"
},
{
"label": "Barletta-Andria-Trani",
"code": "BT"
},
{
"label": "Belluno",
"code": "BL"
},
{
"label": "Benevento",
"code": "BN"
},
{
"label": "Bergamo",
"code": "BG"
},
{
"label": "Biella",
"code": "BI"
},
{
"label": "Bolzano",
"code": "BZ"
},
{
"label": "Brescia",
"code": "BS"
},
{
"label": "Brindisi",
"code": "BR"
},
{
"label": "Caltanissetta",
"code": "CL"
},
{
"label": "Campobasso",
"code": "CB"
},
{
"label": "Caserta",
"code": "CE"
},
{
"label": "Catanzaro",
"code": "CZ"
},
{
"label": "Chieti",
"code": "CH"
},
{
"label": "Como",
"code": "CO"
},
{
"label": "Cosenza",
"code": "CS"
},
{
"label": "Cremona",
"code": "CR"
},
{
"label": "Crotone",
"code": "KR"
},
{
"label": "Cuneo",
"code": "CN"
},
{
"label": "Enna",
"code": "EN"
},
{
"label": "Fermo",
"code": "FM"
},
{
"label": "Ferrara",
"code": "FE"
},
{
"label": "Foggia",
"code": "FG"
},
{
"label": "Forlì-Cesena",
"code": "FC"
},
{
"label": "Frosinone",
"code": "FR"
},
{
"label": "Gorizia",
"code": "GO"
},
{
"label": "Grosseto",
"code": "GR"
},
{
"label": "Imperia",
"code": "IM"
},
{
"label": "Isernia",
"code": "IS"
},
{
"label": "L'Aquila",
"code": "AQ"
},
{
"label": "LaSpezia",
"code": "SP"
},
{
"label": "Latina",
"code": "LT"
},
{
"label": "Lecce",
"code": "LE"
},
{
"label": "Lecco",
"code": "LC"
},
{
"label": "Livorno",
"code": "LI"
},
{
"label": "Lodi",
"code": "LO"
},
{
"label": "Lucca",
"code": "LU"
},
{
"label": "Macerata",
"code": "MC"
},
{
"label": "Mantova",
"code": "MN"
},
{
"label": "Massa-Carrara",
"code": "MS"
},
{
"label": "Matera",
"code": "MT"
},
{
"label": "Modena",
"code": "MO"
},
{
"label": "Monzae Brianza",
"code": "MB"
},
{
"label": "Novara",
"code": "NO"
},
{
"label": "Nuoro",
"code": "NU"
},
{
"label": "Oristano",
"code": "OR"
},
{
"label": "Padova",
"code": "PD"
},
{
"label": "Parma",
"code": "PR"
},
{
"label": "Pavia",
"code": "PV"
},
{
"label": "Perugia",
"code": "PG"
},
{
"label": "Pesaro e Urbino",
"code": "PU"
},
{
"label": "Pescara",
"code": "PE"
},
{
"label": "Piacenza",
"code": "PC"
},
{
"label": "Pisa",
"code": "PI"
},
{
"label": "Pistoia",
"code": "PT"
},
{
"label": "Pordenone",
"code": "PN"
},
{
"label": "Potenza",
"code": "PZ"
},
{
"label": "Prato",
"code": "PO"
},
{
"label": "Ragusa",
"code": "RG"
},
{
"label": "Ravenna",
"code": "RA"
},
{
"label": "Reggio Emilia",
"code": "RE"
},
{
"label": "Rieti",
"code": "RI"
},
{
"label": "Rimini",
"code": "RN"
},
{
"label": "Rovigo",
"code": "RO"
},
{
"label": "Salerno",
"code": "SA"
},
{
"label": "Sassari",
"code": "SS"
},
{
"label": "Savona",
"code": "SV"
},
{
"label": "Siena",
"code": "SI"
},
{
"label": "Siracusa",
"code": "SR"
},
{
"label": "Sondrio",
"code": "SO"
},
{
"label": "Sud Sardegna",
"code": "SU"
},
{
"label": "Taranto",
"code": "TA"
},
{
"label": "Teramo",
"code": "TE"
},
{
"label": "Terni",
"code": "TR"
},
{
"label": "Trapani",
"code": "TP"
},
{
"label": "Trento",
"code": "TN"
},
{
"label": "Treviso",
"code": "TV"
},
{
"label": "Trieste",
"code": "TS"
},
{
"label": "Udine",
"code": "UD"
},
{
"label": "Varese",
"code": "VA"
},
{
"label": "Verbano-Cusio-Ossola",
"code": "VB"
},
{
"label": "Vercelli",
"code": "VC"
},
{
"label": "Verona",
"code": "VR"
},
{
"label": "Vibo Valentia",
"code": "VV"
},
{
"label": "Vicenza",
"code": "VI"
},
{
"label": "Viterbo",
"code": "VT"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/provinces/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<provinces>
<i0>
<label>Agrigento</label>
<code>AG</code>
</i0>
<i1>
<label>Alessandria</label>
<code>AL</code>
</i1>
<i2>
<label>Ancona</label>
<code>AN</code>
</i2>
<i3>
<label>Aosta</label>
<code>AO</code>
</i3>
<i4>
<label>Arezzo</label>
<code>AR</code>
</i4>
<i5>
<label>Ascoli Piceno</label>
<code>AP</code>
</i5>
<i6>
<label>Asti</label>
<code>AT</code>
</i6>
<i7>
<label>Avellino</label>
<code>AV</code>
</i7>
<i8>
<label>Barletta-Andria-Trani</label>
<code>BT</code>
</i8>
<i9>
<label>Belluno</label>
<code>BL</code>
</i9>
<i10>
<label>Benevento</label>
<code>BN</code>
</i10>
<i11>
<label>Bergamo</label>
<code>BG</code>
</i11>
<i12>
<label>Biella</label>
<code>BI</code>
</i12>
<i13>
<label>Bolzano</label>
<code>BZ</code>
</i13>
<i14>
<label>Brescia</label>
<code>BS</code>
</i14>
<i15>
<label>Brindisi</label>
<code>BR</code>
</i15>
<i16>
<label>Caltanissetta</label>
<code>CL</code>
</i16>
<i17>
<label>Campobasso</label>
<code>CB</code>
</i17>
<i18>
<label>Caserta</label>
<code>CE</code>
</i18>
<i19>
<label>Catanzaro</label>
<code>CZ</code>
</i19>
<i20>
<label>Chieti</label>
<code>CH</code>
</i20>
<i21>
<label>Como</label>
<code>CO</code>
</i21>
<i22>
<label>Cosenza</label>
<code>CS</code>
</i22>
<i23>
<label>Cremona</label>
<code>CR</code>
</i23>
<i24>
<label>Crotone</label>
<code>KR</code>
</i24>
<i25>
<label>Cuneo</label>
<code>CN</code>
</i25>
<i26>
<label>Enna</label>
<code>EN</code>
</i26>
<i27>
<label>Fermo</label>
<code>FM</code>
</i27>
<i28>
<label>Ferrara</label>
<code>FE</code>
</i28>
<i29>
<label>Foggia</label>
<code>FG</code>
</i29>
<i30>
<label><[CDATA[Forl&igrave;-Cesena]]></label>
<code>FC</code>
</i30>
<i31>
<label>Frosinone</label>
<code>FR</code>
</i31>
<i32>
<label>Gorizia</label>
<code>GO</code>
</i32>
<i33>
<label>Grosseto</label>
<code>GR</code>
</i33>
<i34>
<label>Imperia</label>
<code>IM</code>
</i34>
<i35>
<label>Isernia</label>
<code>IS</code>
</i35>
<i36>
<label>L'Aquila</label>
<code>AQ</code>
</i36>
<i37>
<label>LaSpezia</label>
<code>SP</code>
</i37>
<i38>
<label>Latina</label>
<code>LT</code>
</i38>
<i39>
<label>Lecce</label>
<code>LE</code>
</i39>
<i40>
<label>Lecco</label>
<code>LC</code>
</i40>
<i41>
<label>Livorno</label>
<code>LI</code>
</i41>
<i42>
<label>Lodi</label>
<code>LO</code>
</i42>
<i43>
<label>Lucca</label>
<code>LU</code>
</i43>
<i44>
<label>Macerata</label>
<code>MC</code>
</i44>
<i45>
<label>Mantova</label>
<code>MN</code>
</i45>
<i46>
<label>Massa-Carrara</label>
<code>MS</code>
</i46>
<i47>
<label>Matera</label>
<code>MT</code>
</i47>
<i48>
<label>Modena</label>
<code>MO</code>
</i48>
<i49>
<label>Monzae Brianza</label>
<code>MB</code>
</i49>
<i50>
<label>Novara</label>
<code>NO</code>
</i50>
<i51>
<label>Nuoro</label>
<code>NU</code>
</i51>
<i52>
<label>Oristano</label>
<code>OR</code>
</i52>
<i53>
<label>Padova</label>
<code>PD</code>
</i53>
<i54>
<label>Parma</label>
<code>PR</code>
</i54>
<i55>
<label>Pavia</label>
<code>PV</code>
</i55>
<i56>
<label>Perugia</label>
<code>PG</code>
</i56>
<i57>
<label>Pesaro e Urbino</label>
<code>PU</code>
</i57>
<i58>
<label>Pescara</label>
<code>PE</code>
</i58>
<i59>
<label>Piacenza</label>
<code>PC</code>
</i59>
<i60>
<label>Pisa</label>
<code>PI</code>
</i60>
<i61>
<label>Pistoia</label>
<code>PT</code>
</i61>
<i62>
<label>Pordenone</label>
<code>PN</code>
</i62>
<i63>
<label>Potenza</label>
<code>PZ</code>
</i63>
<i64>
<label>Prato</label>
<code>PO</code>
</i64>
<i65>
<label>Ragusa</label>
<code>RG</code>
</i65>
<i66>
<label>Ravenna</label>
<code>RA</code>
</i66>
<i67>
<label>Reggio Emilia</label>
<code>RE</code>
</i67>
<i68>
<label>Rieti</label>
<code>RI</code>
</i68>
<i69>
<label>Rimini</label>
<code>RN</code>
</i69>
<i70>
<label>Rovigo</label>
<code>RO</code>
</i70>
<i71>
<label>Salerno</label>
<code>SA</code>
</i71>
<i72>
<label>Sassari</label>
<code>SS</code>
</i72>
<i73>
<label>Savona</label>
<code>SV</code>
</i73>
<i74>
<label>Siena</label>
<code>SI</code>
</i74>
<i75>
<label>Siracusa</label>
<code>SR</code>
</i75>
<i76>
<label>Sondrio</label>
<code>SO</code>
</i76>
<i77>
<label>Sud Sardegna</label>
<code>SU</code>
</i77>
<i78>
<label>Taranto</label>
<code>TA</code>
</i78>
<i79>
<label>Teramo</label>
<code>TE</code>
</i79>
<i80>
<label>Terni</label>
<code>TR</code>
</i80>
<i81>
<label>Trapani</label>
<code>TP</code>
</i81>
<i82>
<label>Trento</label>
<code>TN</code>
</i82>
<i83>
<label>Treviso</label>
<code>TV</code>
</i83>
<i84>
<label>Trieste</label>
<code>TS</code>
</i84>
<i85>
<label>Udine</label>
<code>UD</code>
</i85>
<i86>
<label>Varese</label>
<code>VA</code>
</i86>
<i87>
<label>Verbano-Cusio-Ossola</label>
<code>VB</code>
</i87>
<i88>
<label>Vercelli</label>
<code>VC</code>
</i88>
<i89>
<label>Verona</label>
<code>VR</code>
</i89>
<i90>
<label>Vibo Valentia</label>
<code>VV</code>
</i90>
<i91>
<label>Vicenza</label>
<code>VI</code>
</i91>
<i92>
<label>Viterbo</label>
<code>VT</code>
</i92>
</provinces>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/provinces/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_provinces_0_label=Agrigento
result_provinces_0_code=AG
result_provinces_1_label=Alessandria
result_provinces_1_code=AL
result_provinces_2_label=Ancona
result_provinces_2_code=AN
result_provinces_3_label=Aosta
result_provinces_3_code=AO
result_provinces_4_label=Arezzo
result_provinces_4_code=AR
result_provinces_5_label=Ascoli Piceno
result_provinces_5_code=AP
result_provinces_6_label=Asti
result_provinces_6_code=AT
result_provinces_7_label=Avellino
result_provinces_7_code=AV
result_provinces_8_label=Barletta-Andria-Trani
result_provinces_8_code=BT
result_provinces_9_label=Belluno
result_provinces_9_code=BL
result_provinces_10_label=Benevento
result_provinces_10_code=BN
result_provinces_11_label=Bergamo
result_provinces_11_code=BG
result_provinces_12_label=Biella
result_provinces_12_code=BI
result_provinces_13_label=Bolzano
result_provinces_13_code=BZ
result_provinces_14_label=Brescia
result_provinces_14_code=BS
result_provinces_15_label=Brindisi
result_provinces_15_code=BR
result_provinces_16_label=Caltanissetta
result_provinces_16_code=CL
result_provinces_17_label=Campobasso
result_provinces_17_code=CB
result_provinces_18_label=Caserta
result_provinces_18_code=CE
result_provinces_19_label=Catanzaro
result_provinces_19_code=CZ
result_provinces_20_label=Chieti
result_provinces_20_code=CH
result_provinces_21_label=Como
result_provinces_21_code=CO
result_provinces_22_label=Cosenza
result_provinces_22_code=CS
result_provinces_23_label=Cremona
result_provinces_23_code=CR
result_provinces_24_label=Crotone
result_provinces_24_code=KR
result_provinces_25_label=Cuneo
result_provinces_25_code=CN
result_provinces_26_label=Enna
result_provinces_26_code=EN
result_provinces_27_label=Fermo
result_provinces_27_code=FM
result_provinces_28_label=Ferrara
result_provinces_28_code=FE
result_provinces_29_label=Foggia
result_provinces_29_code=FG
result_provinces_30_label=Forl&igrave;-Cesena
result_provinces_30_code=FC
result_provinces_31_label=Frosinone
result_provinces_31_code=FR
result_provinces_32_label=Gorizia
result_provinces_32_code=GO
result_provinces_33_label=Grosseto
result_provinces_33_code=GR
result_provinces_34_label=Imperia
result_provinces_34_code=IM
result_provinces_35_label=Isernia
result_provinces_35_code=IS
result_provinces_36_label=L'Aquila
result_provinces_36_code=AQ
result_provinces_37_label=LaSpezia
result_provinces_37_code=SP
result_provinces_38_label=Latina
result_provinces_38_code=LT
result_provinces_39_label=Lecce
result_provinces_39_code=LE
result_provinces_40_label=Lecco
result_provinces_40_code=LC
result_provinces_41_label=Livorno
result_provinces_41_code=LI
result_provinces_42_label=Lodi
result_provinces_42_code=LO
result_provinces_43_label=Lucca
result_provinces_43_code=LU
result_provinces_44_label=Macerata
result_provinces_44_code=MC
result_provinces_45_label=Mantova
result_provinces_45_code=MN
result_provinces_46_label=Massa-Carrara
result_provinces_46_code=MS
result_provinces_47_label=Matera
result_provinces_47_code=MT
result_provinces_48_label=Modena
result_provinces_48_code=MO
result_provinces_49_label=Monzae Brianza
result_provinces_49_code=MB
result_provinces_50_label=Novara
result_provinces_50_code=NO
result_provinces_51_label=Nuoro
result_provinces_51_code=NU
result_provinces_52_label=Oristano
result_provinces_52_code=OR
result_provinces_53_label=Padova
result_provinces_53_code=PD
result_provinces_54_label=Parma
result_provinces_54_code=PR
result_provinces_55_label=Pavia
result_provinces_55_code=PV
result_provinces_56_label=Perugia
result_provinces_56_code=PG
result_provinces_57_label=Pesaro e Urbino
result_provinces_57_code=PU
result_provinces_58_label=Pescara
result_provinces_58_code=PE
result_provinces_59_label=Piacenza
result_provinces_59_code=PC
result_provinces_60_label=Pisa
result_provinces_60_code=PI
result_provinces_61_label=Pistoia
result_provinces_61_code=PT
result_provinces_62_label=Pordenone
result_provinces_62_code=PN
result_provinces_63_label=Potenza
result_provinces_63_code=PZ
result_provinces_64_label=Prato
result_provinces_64_code=PO
result_provinces_65_label=Ragusa
result_provinces_65_code=RG
result_provinces_66_label=Ravenna
result_provinces_66_code=RA
result_provinces_67_label=Reggio Emilia
result_provinces_67_code=RE
result_provinces_68_label=Rieti
result_provinces_68_code=RI
result_provinces_69_label=Rimini
result_provinces_69_code=RN
result_provinces_70_label=Rovigo
result_provinces_70_code=RO
result_provinces_71_label=Salerno
result_provinces_71_code=SA
result_provinces_72_label=Sassari
result_provinces_72_code=SS
result_provinces_73_label=Savona
result_provinces_73_code=SV
result_provinces_74_label=Siena
result_provinces_74_code=SI
result_provinces_75_label=Siracusa
result_provinces_75_code=SR
result_provinces_76_label=Sondrio
result_provinces_76_code=SO
result_provinces_77_label=Sud Sardegna
result_provinces_77_code=SU
result_provinces_78_label=Taranto
result_provinces_78_code=TA
result_provinces_79_label=Teramo
result_provinces_79_code=TE
result_provinces_80_label=Terni
result_provinces_80_code=TR
result_provinces_81_label=Trapani
result_provinces_81_code=TP
result_provinces_82_label=Trento
result_provinces_82_code=TN
result_provinces_83_label=Treviso
result_provinces_83_code=TV
result_provinces_84_label=Trieste
result_provinces_84_code=TS
result_provinces_85_label=Udine
result_provinces_85_code=UD
result_provinces_86_label=Varese
result_provinces_86_code=VA
result_provinces_87_label=Verbano-Cusio-Ossola
result_provinces_87_code=VB
result_provinces_88_label=Vercelli
result_provinces_88_code=VC
result_provinces_89_label=Verona
result_provinces_89_code=VR
result_provinces_90_label=Vibo Valentia
result_provinces_90_code=VV
result_provinces_91_label=Vicenza
result_provinces_91_code=VI
result_provinces_92_label=Viterbo
result_provinces_92_code=VT
Example 4 (plain)
Request
https://joturl.com/a/i1/provinces/list?format=plain
Query parameters
format = plain
Response
Agrigento
AG
Alessandria
AL
Ancona
AN
Aosta
AO
Arezzo
AR
Ascoli Piceno
AP
Asti
AT
Avellino
AV
Barletta-Andria-Trani
BT
Belluno
BL
Benevento
BN
Bergamo
BG
Biella
BI
Bolzano
BZ
Brescia
BS
Brindisi
BR
Caltanissetta
CL
Campobasso
CB
Caserta
CE
Catanzaro
CZ
Chieti
CH
Como
CO
Cosenza
CS
Cremona
CR
Crotone
KR
Cuneo
CN
Enna
EN
Fermo
FM
Ferrara
FE
Foggia
FG
Forl&igrave;-Cesena
FC
Frosinone
FR
Gorizia
GO
Grosseto
GR
Imperia
IM
Isernia
IS
L'Aquila
AQ
LaSpezia
SP
Latina
LT
Lecce
LE
Lecco
LC
Livorno
LI
Lodi
LO
Lucca
LU
Macerata
MC
Mantova
MN
Massa-Carrara
MS
Matera
MT
Modena
MO
Monzae Brianza
MB
Novara
NO
Nuoro
NU
Oristano
OR
Padova
PD
Parma
PR
Pavia
PV
Perugia
PG
Pesaro e Urbino
PU
Pescara
PE
Piacenza
PC
Pisa
PI
Pistoia
PT
Pordenone
PN
Potenza
PZ
Prato
PO
Ragusa
RG
Ravenna
RA
Reggio Emilia
RE
Rieti
RI
Rimini
RN
Rovigo
RO
Salerno
SA
Sassari
SS
Savona
SV
Siena
SI
Siracusa
SR
Sondrio
SO
Sud Sardegna
SU
Taranto
TA
Teramo
TE
Terni
TR
Trapani
TP
Trento
TN
Treviso
TV
Trieste
TS
Udine
UD
Varese
VA
Verbano-Cusio-Ossola
VB
Vercelli
VC
Verona
VR
Vibo Valentia
VV
Vicenza
VI
Viterbo
VT
Return values
parameter | description |
---|---|
provinces | list of available Italian provinces |
/qrcodes
/qrcodes/add
access: [WRITE]
Add a QR code template.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=b724ba64bb9cad4fdbf022cdef2ef20f&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=996ff31ba75756bf138a08c929b587b5&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0
Query parameters
name = QR code template
shape = square
bg_color = FFFFFF00
bg_img_id = b724ba64bb9cad4fdbf022cdef2ef20f
bg_flip_v = 0
bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
fg_color = 000000FF
fg_img_id = 996ff31ba75756bf138a08c929b587b5
fg_flip_v = 0
fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "0ac35dcbab5250c52327436c1a27a442",
"name": "QR code template"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=b724ba64bb9cad4fdbf022cdef2ef20f&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=996ff31ba75756bf138a08c929b587b5&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=xml
Query parameters
name = QR code template
shape = square
bg_color = FFFFFF00
bg_img_id = b724ba64bb9cad4fdbf022cdef2ef20f
bg_flip_v = 0
bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
fg_color = 000000FF
fg_img_id = 996ff31ba75756bf138a08c929b587b5
fg_flip_v = 0
fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>0ac35dcbab5250c52327436c1a27a442</id>
<name>QR code template</name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=b724ba64bb9cad4fdbf022cdef2ef20f&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=996ff31ba75756bf138a08c929b587b5&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=txt
Query parameters
name = QR code template
shape = square
bg_color = FFFFFF00
bg_img_id = b724ba64bb9cad4fdbf022cdef2ef20f
bg_flip_v = 0
bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
fg_color = 000000FF
fg_img_id = 996ff31ba75756bf138a08c929b587b5
fg_flip_v = 0
fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=0ac35dcbab5250c52327436c1a27a442
result_name=QR code template
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/add?name=QR+code+template&shape=square&bg_color=FFFFFF00&bg_img_id=b724ba64bb9cad4fdbf022cdef2ef20f&bg_flip_v=0&bg_flip_h=0&bg_sslider_value=0&bg_rslider_value=0&bg_tslider_value=0&fg_color=000000FF&fg_img_id=996ff31ba75756bf138a08c929b587b5&fg_flip_v=0&fg_flip_h=0&fg_sslider_value=72&fg_rslider_value=0&fg_tslider_value=0&format=plain
Query parameters
name = QR code template
shape = square
bg_color = FFFFFF00
bg_img_id = b724ba64bb9cad4fdbf022cdef2ef20f
bg_flip_v = 0
bg_flip_h = 0
bg_sslider_value = 0
bg_rslider_value = 0
bg_tslider_value = 0
fg_color = 000000FF
fg_img_id = 996ff31ba75756bf138a08c929b587b5
fg_flip_v = 0
fg_flip_h = 0
fg_sslider_value = 72
fg_rslider_value = 0
fg_tslider_value = 0
format = plain
Response
0ac35dcbab5250c52327436c1a27a442
QR code template
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | QR code template name | 50 |
Optional parameters
parameter | description |
---|---|
bg_brand_idID | NA |
bg_colorSTRING | See i1/qrcodes/list for details |
bg_flip_hSTRING | See i1/qrcodes/list for details |
bg_flip_vSTRING | See i1/qrcodes/list for details |
bg_img_idID | See i1/qrcodes/list for details |
bg_rslider_valueSTRING | See i1/qrcodes/list for details |
bg_sslider_valueSTRING | See i1/qrcodes/list for details |
bg_tslider_valueSTRING | See i1/qrcodes/list for details |
fg_brand_idID | NA |
fg_colorSTRING | See i1/qrcodes/list for details |
fg_flip_hSTRING | See i1/qrcodes/list for details |
fg_flip_vSTRING | See i1/qrcodes/list for details |
fg_img_idID | See i1/qrcodes/list for details |
fg_rslider_valueSTRING | See i1/qrcodes/list for details |
fg_sslider_valueSTRING | See i1/qrcodes/list for details |
fg_tslider_valueSTRING | See i1/qrcodes/list for details |
shapeSTRING | See i1/qrcodes/list for details |
Return values
parameter | description |
---|---|
id | ID of the QR code template |
name | echo back of the input parameter name |
/qrcodes/count
access: [READ]
This method returns the number of defined QR code templates.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Optional parameters
parameter | description |
---|---|
searchSTRING | filters QR code templates to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) QR code templates |
/qrcodes/delete
access: [WRITE]
This method deletes a set of QR code templates by using their IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691
Query parameters
ids = b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691&format=xml
Query parameters
ids = b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691&format=txt
Query parameters
ids = b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691&format=plain
Query parameters
ids = b426982c709ee330550906f964983383,77b96aaee5a02e4b6634de51d6f191e3,b53353ef371550fabe87785e0b6bc691
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c
Query parameters
ids = 8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c&format=xml
Query parameters
ids = 8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c&format=txt
Query parameters
ids = 8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/qrcodes/delete?ids=8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c&format=plain
Query parameters
ids = 8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5,3ce52e29134a23c9360a89279dac568c
format = plain
Response
8d815cd6fb444753241064481fe6fc2a,dadaa5f9da31075d71e6a4cb24991fc5
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of QR code template IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted QR code templates |
ids | [OPTIONAL] list of QR code template IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/qrcodes/edit
access: [WRITE]
Edit a QR code template.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/edit?id=7bf08117dc27792fb7164424b631e8b5&name=new+name+for+the+QR+code+template
Query parameters
id = 7bf08117dc27792fb7164424b631e8b5
name = new name for the QR code template
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "7bf08117dc27792fb7164424b631e8b5",
"name": "new name for the QR code template"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/edit?id=7bf08117dc27792fb7164424b631e8b5&name=new+name+for+the+QR+code+template&format=xml
Query parameters
id = 7bf08117dc27792fb7164424b631e8b5
name = new name for the QR code template
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>7bf08117dc27792fb7164424b631e8b5</id>
<name>new name for the QR code template</name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/edit?id=7bf08117dc27792fb7164424b631e8b5&name=new+name+for+the+QR+code+template&format=txt
Query parameters
id = 7bf08117dc27792fb7164424b631e8b5
name = new name for the QR code template
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=7bf08117dc27792fb7164424b631e8b5
result_name=new name for the QR code template
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/edit?id=7bf08117dc27792fb7164424b631e8b5&name=new+name+for+the+QR+code+template&format=plain
Query parameters
id = 7bf08117dc27792fb7164424b631e8b5
name = new name for the QR code template
format = plain
Response
7bf08117dc27792fb7164424b631e8b5
new name for the QR code template
Required parameters
parameter | description |
---|---|
idID | ID of the QR code template |
Optional parameters
parameter | description | max length |
---|---|---|
bg_brand_idID | NA | |
bg_colorSTRING | See i1/qrcodes/list for details | |
bg_flip_hSTRING | See i1/qrcodes/list for details | |
bg_flip_vSTRING | See i1/qrcodes/list for details | |
bg_img_idID | See i1/qrcodes/list for details | |
bg_rslider_valueSTRING | See i1/qrcodes/list for details | |
bg_sslider_valueSTRING | See i1/qrcodes/list for details | |
bg_tslider_valueSTRING | See i1/qrcodes/list for details | |
fg_brand_idID | NA | |
fg_colorSTRING | See i1/qrcodes/list for details | |
fg_flip_hSTRING | See i1/qrcodes/list for details | |
fg_flip_vSTRING | See i1/qrcodes/list for details | |
fg_img_idID | See i1/qrcodes/list for details | |
fg_rslider_valueSTRING | See i1/qrcodes/list for details | |
fg_sslider_valueSTRING | See i1/qrcodes/list for details | |
fg_tslider_valueSTRING | See i1/qrcodes/list for details | |
nameSTRING | See i1/qrcodes/list for details | 50 |
shapeSTRING | See i1/qrcodes/list for details |
Return values
parameter | description |
---|---|
id | ID of the QR code template |
name | echo back of the input parameter name |
/qrcodes/info
access: [READ]
This method returns information specified in a comma separated input called fields about a Qr code template.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "08b9ca70151558c05eb834233b66c87c",
"name": "QR code template",
"shape": "square",
"bg_color": "FFFFFF00",
"bg_img_id": "be1ec2c147c94e8a421ba62ce6888321",
"bg_flip_v": 0,
"bg_flip_h": 0,
"bg_sslider_value": 0,
"bg_rslider_value": 0,
"bg_tslider_value": 0,
"fg_color": "000000FF",
"fg_img_id": "0b0bf67a58ce7ff19a566f73e6d2d33f",
"fg_flip_v": 0,
"fg_flip_h": 0,
"fg_sslider_value": 72,
"fg_rslider_value": 0,
"fg_tslider_value": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=xml
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>08b9ca70151558c05eb834233b66c87c</id>
<name>QR code template</name>
<shape>square</shape>
<bg_color>FFFFFF00</bg_color>
<bg_img_id>be1ec2c147c94e8a421ba62ce6888321</bg_img_id>
<bg_flip_v>0</bg_flip_v>
<bg_flip_h>0</bg_flip_h>
<bg_sslider_value>0</bg_sslider_value>
<bg_rslider_value>0</bg_rslider_value>
<bg_tslider_value>0</bg_tslider_value>
<fg_color>000000FF</fg_color>
<fg_img_id>0b0bf67a58ce7ff19a566f73e6d2d33f</fg_img_id>
<fg_flip_v>0</fg_flip_v>
<fg_flip_h>0</fg_flip_h>
<fg_sslider_value>72</fg_sslider_value>
<fg_rslider_value>0</fg_rslider_value>
<fg_tslider_value>0</fg_tslider_value>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=txt
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=08b9ca70151558c05eb834233b66c87c
result_name=QR code template
result_shape=square
result_bg_color=FFFFFF00
result_bg_img_id=be1ec2c147c94e8a421ba62ce6888321
result_bg_flip_v=0
result_bg_flip_h=0
result_bg_sslider_value=0
result_bg_rslider_value=0
result_bg_tslider_value=0
result_fg_color=000000FF
result_fg_img_id=0b0bf67a58ce7ff19a566f73e6d2d33f
result_fg_flip_v=0
result_fg_flip_h=0
result_fg_sslider_value=72
result_fg_rslider_value=0
result_fg_tslider_value=0
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/info?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=plain
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = plain
Response
08b9ca70151558c05eb834233b66c87c
QR code template
square
FFFFFF00
be1ec2c147c94e8a421ba62ce6888321
0
0
0
0
0
000000FF
0b0bf67a58ce7ff19a566f73e6d2d33f
0
0
72
0
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, see i1/qrcodes/list for details |
idID | ID of the QR code template |
Return values
parameter | description |
---|---|
bg_color | [OPTIONAL] returned only if bg_color is passed in fields |
bg_flip_h | [OPTIONAL] returned only if bg_flip_h is passed in fields |
bg_flip_v | [OPTIONAL] returned only if bg_flip_v is passed in fields |
bg_img_id | [OPTIONAL] returned only if bg_img_id is passed in fields |
bg_rslider_value | [OPTIONAL] returned only if bg_rslider_value is passed in fields |
bg_sslider_value | [OPTIONAL] returned only if bg_sslider_value is passed in fields |
bg_tslider_value | [OPTIONAL] returned only if bg_tslider_value is passed in fields |
fg_color | [OPTIONAL] returned only if fg_color is passed in fields |
fg_flip_h | [OPTIONAL] returned only if fg_flip_h is passed in fields |
fg_flip_v | [OPTIONAL] returned only if fg_flip_v is passed in fields |
fg_img_id | [OPTIONAL] returned only if fg_img_id is passed in fields |
fg_rslider_value | [OPTIONAL] returned only if fg_rslider_value is passed in fields |
fg_sslider_value | [OPTIONAL] returned only if fg_sslider_value is passed in fields |
fg_tslider_value | [OPTIONAL] returned only if fg_tslider_value is passed in fields |
id | [OPTIONAL] returned only if id is passed in fields |
name | [OPTIONAL] returned only if name is passed in fields |
shape | [OPTIONAL] returned only if shape is passed in fields |
/qrcodes/list
access: [READ]
This method returns a list of user's Qr code templates, specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "6ab029005fb9c7d49e8d4d26f90e4880",
"name": "QR code template",
"shape": "square",
"bg_color": "FFFFFF00",
"bg_img_id": "0a31afafa52b94c550b90ec77f7e6645",
"bg_flip_v": 0,
"bg_flip_h": 0,
"bg_sslider_value": 0,
"bg_rslider_value": 0,
"bg_tslider_value": 0,
"fg_color": "000000FF",
"fg_img_id": "16dc0370d98d5cf7db75f4998bb7b0b6",
"fg_flip_v": 0,
"fg_flip_h": 0,
"fg_sslider_value": 72,
"fg_rslider_value": 0,
"fg_tslider_value": 0
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=xml
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>6ab029005fb9c7d49e8d4d26f90e4880</id>
<name>QR code template</name>
<shape>square</shape>
<bg_color>FFFFFF00</bg_color>
<bg_img_id>0a31afafa52b94c550b90ec77f7e6645</bg_img_id>
<bg_flip_v>0</bg_flip_v>
<bg_flip_h>0</bg_flip_h>
<bg_sslider_value>0</bg_sslider_value>
<bg_rslider_value>0</bg_rslider_value>
<bg_tslider_value>0</bg_tslider_value>
<fg_color>000000FF</fg_color>
<fg_img_id>16dc0370d98d5cf7db75f4998bb7b0b6</fg_img_id>
<fg_flip_v>0</fg_flip_v>
<fg_flip_h>0</fg_flip_h>
<fg_sslider_value>72</fg_sslider_value>
<fg_rslider_value>0</fg_rslider_value>
<fg_tslider_value>0</fg_tslider_value>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=txt
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=6ab029005fb9c7d49e8d4d26f90e4880
result_data_0_name=QR code template
result_data_0_shape=square
result_data_0_bg_color=FFFFFF00
result_data_0_bg_img_id=0a31afafa52b94c550b90ec77f7e6645
result_data_0_bg_flip_v=0
result_data_0_bg_flip_h=0
result_data_0_bg_sslider_value=0
result_data_0_bg_rslider_value=0
result_data_0_bg_tslider_value=0
result_data_0_fg_color=000000FF
result_data_0_fg_img_id=16dc0370d98d5cf7db75f4998bb7b0b6
result_data_0_fg_flip_v=0
result_data_0_fg_flip_h=0
result_data_0_fg_sslider_value=72
result_data_0_fg_rslider_value=0
result_data_0_fg_tslider_value=0
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/list?fields=count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value&format=plain
Query parameters
fields = count,id,name,shape,bg_color,bg_img_id,bg_flip_v,bg_flip_h,bg_sslider_value,bg_rslider_value,bg_tslider_value,fg_color,fg_img_id,fg_flip_v,fg_flip_h,fg_sslider_value,fg_rslider_value,fg_tslider_value
format = plain
Response
1
6ab029005fb9c7d49e8d4d26f90e4880
QR code template
square
FFFFFF00
0a31afafa52b94c550b90ec77f7e6645
0
0
0
0
0
000000FF
16dc0370d98d5cf7db75f4998bb7b0b6
0
0
72
0
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, bg_color, bg_img_id, fg_color, id, fg_img_id, params, name, shape |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of QR code templates (maxmimum allowed: 100) |
orderbyARRAY | orders QR code templates by field, available fields: bg_color, bg_img_id, fg_color, id, fg_img_id, params, name, shape |
searchSTRING | filters QR code templates to be extracted by searching them |
sortSTRING | sorts QR code templates in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract QR code templates from this position |
typesSTRING | NA |
Return values
parameter | description |
---|---|
data | array containing information on the QR code templates, returned information depends on the fields parameter. |
/qrcodes/preview
access: [READ]
This method returns a preview of a QR codes.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/preview?size=big&id=7ef6bbcab2bd4dbe1029074f0d583d72
Query parameters
size = big
id = 7ef6bbcab2bd4dbe1029074f0d583d72
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"img": "data:image\/png;base64,NWExMjkyYmJjMTFlOTZjNDQxMzNiOTVlZTIxMjVmNTg="
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/preview?size=big&id=7ef6bbcab2bd4dbe1029074f0d583d72&format=xml
Query parameters
size = big
id = 7ef6bbcab2bd4dbe1029074f0d583d72
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<img>data:image/png;base64,NWExMjkyYmJjMTFlOTZjNDQxMzNiOTVlZTIxMjVmNTg=</img>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/preview?size=big&id=7ef6bbcab2bd4dbe1029074f0d583d72&format=txt
Query parameters
size = big
id = 7ef6bbcab2bd4dbe1029074f0d583d72
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_img=data:image/png;base64,NWExMjkyYmJjMTFlOTZjNDQxMzNiOTVlZTIxMjVmNTg=
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/preview?size=big&id=7ef6bbcab2bd4dbe1029074f0d583d72&format=plain
Query parameters
size = big
id = 7ef6bbcab2bd4dbe1029074f0d583d72
format = plain
Response
data:image/png;base64,NWExMjkyYmJjMTFlOTZjNDQxMzNiOTVlZTIxMjVmNTg=
Optional parameters
parameter | description |
---|---|
bg_brand_idID | NA |
bg_colorSTRING | QR code background color, see i1/qrcodes/list for details, this parameter is ignored if id is passed |
bg_flip_hSTRING | 1 if the background image is flipped horizontally |
bg_flip_vSTRING | 1 if the background image is flipped vertically |
bg_img_idID | ID of the background image, see i1/qrcodes/list for details, this parameter is ignored if id is passed |
bg_rslider_valueSTRING | background image rotation [0-359 deg] |
bg_sslider_valueSTRING | background image scale [0-100%] |
bg_tslider_valueSTRING | background image transparency [0=totally opaque - 100=totally transparent] |
checkBOOLEAN | 1 to check if the QR code is readable, default value check = 0 |
customizationBOOLEAN | 1 if the QR code preview should be generated using bg_color, fg_color, shape, fg_img_id, bg_img_id, bg_flip_v, bg_flip_h, bg_sslider_value, bg_rslider_value, bg_tslider_value, fg_flip_v, fg_flip_h, fg_sslider_value, fg_rslider_value, fg_tslider_value; this parameter is ignored if id is passed |
downloadBOOLEAN | 1 to force the download of the QR code to be started by this method, default value download = 0 |
fg_brand_idID | NA |
fg_colorSTRING | QR code modules color, see i1/qrcodes/list for details, this parameter is ignored if id is passed |
fg_flip_hSTRING | 1 if the foreground image is flipped horizontally |
fg_flip_vSTRING | 1 if the foreground image is flipped vertically |
fg_img_idID | ID of the foreground image (logo), see i1/qrcodes/list for details, this parameter is ignored if id is passed |
fg_rslider_valueSTRING | foreground image rotation [0-359 deg] |
fg_sslider_valueSTRING | foreground image scale [0-100%] |
fg_tslider_valueSTRING | foreground image transparency [0=totally opaque - 100=totally transparent] |
idID | ID of the QR code template to use for the preview |
return_imageBOOLEAN | 1 to return the QR code binary data regardless the format input parameter, it is useful to show QR codes on the user interface, default value return_image = 0 |
shapeSTRING | QR code module shape, see i1/qrcodes/list for details, this parameter is ignored if id is passed |
sizeSTRING | size for the preview to be generated, see i1/qrcodes/property for available sizes, default value type = small |
typeSTRING | image type for the preview to be generated, see i1/qrcodes/property for available types, default value type = png |
urlURL | URL to which the QR code points, default value: http://joturl.com |
Return values
parameter | description |
---|---|
[BINARY DATA] | [OPTIONAL] binary data representing the QR code image are returned only if download = 1 or return_image = 1 |
check | [OPTIONAL] 1 if the QR code is readable, 0 otherwise, returned only if check = 1 , download = 0 and return_image = 0 |
check_hint | [OPTIONAL] 0 if the QR is not readable, 1 if the QR code is readable, 2 or higher if the QR might be difficult to read, the higher the number returned in this parameter, the more difficult the QR code is to read; returned only if check = 1 , download = 0 and return_image = 0 |
img | [OPTIONAL] base64 of the data representing the QR code image, returned only if download = 0 and return_image = 0 |
/qrcodes/property
access: [READ]
This method returns a list of property of QR codes.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"shapes": [
"square",
"rsquare",
"rrsquare",
"rhombus",
"ldiamond",
"rdiamond",
"dot",
"rndsquare"
],
"types": [
"svg",
"jpg"
],
"sizes": [
"small",
"medium",
"big"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<shapes>
<i0>square</i0>
<i1>rsquare</i1>
<i2>rrsquare</i2>
<i3>rhombus</i3>
<i4>ldiamond</i4>
<i5>rdiamond</i5>
<i6>dot</i6>
<i7>rndsquare</i7>
</shapes>
<types>
<i0>svg</i0>
<i1>jpg</i1>
</types>
<sizes>
<i0>small</i0>
<i1>medium</i1>
<i2>big</i2>
</sizes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_shapes_0=square
result_shapes_1=rsquare
result_shapes_2=rrsquare
result_shapes_3=rhombus
result_shapes_4=ldiamond
result_shapes_5=rdiamond
result_shapes_6=dot
result_shapes_7=rndsquare
result_types_0=svg
result_types_1=jpg
result_sizes_0=small
result_sizes_1=medium
result_sizes_2=big
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/property?format=plain
Query parameters
format = plain
Response
square
rsquare
rrsquare
rhombus
ldiamond
rdiamond
dot
rndsquare
svg
jpg
small
medium
big
Return values
parameter | description |
---|---|
shapes | available shapes for the QR code modules |
sizes | available sizes for the QR code |
types | available image types for the QR code |
/qrcodes/urls
/qrcodes/urls/count
access: [READ]
This method returns the number of tracking link associated to a specific QR code template.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=98fe208bf62de93a5bdc37d45cefd784
Query parameters
qrcode_id = 98fe208bf62de93a5bdc37d45cefd784
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=98fe208bf62de93a5bdc37d45cefd784&format=xml
Query parameters
qrcode_id = 98fe208bf62de93a5bdc37d45cefd784
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=98fe208bf62de93a5bdc37d45cefd784&format=txt
Query parameters
qrcode_id = 98fe208bf62de93a5bdc37d45cefd784
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/urls/count?qrcode_id=98fe208bf62de93a5bdc37d45cefd784&format=plain
Query parameters
qrcode_id = 98fe208bf62de93a5bdc37d45cefd784
format = plain
Response
4
Required parameters
parameter | description |
---|---|
qrcode_idID | ID of the QR code template |
Optional parameters
parameter | description |
---|---|
searchSTRING | filters tracking links to be extracted by searching them |
Return values
parameter | description |
---|---|
count | number of (filtered) tracking links associated to the QR code template |
/qrcodes/urls/list
access: [READ]
This method returns a list of tracking link associated to a specific QR code template.
Example 1 (json)
Request
https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=7b9daef6cfb4eff2a8f771920ca3ab74
Query parameters
fields = id,short_url
qrcode_id = 7b9daef6cfb4eff2a8f771920ca3ab74
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "55d836cb160d145cc74ff52eeeff5884",
"short_url": "http:\/\/jo.my\/d5d67e73"
},
{
"id": "ec4f70e97886fe5004947aeacd780bc6",
"short_url": "http:\/\/jo.my\/754a6464"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=7b9daef6cfb4eff2a8f771920ca3ab74&format=xml
Query parameters
fields = id,short_url
qrcode_id = 7b9daef6cfb4eff2a8f771920ca3ab74
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>55d836cb160d145cc74ff52eeeff5884</id>
<short_url>http://jo.my/d5d67e73</short_url>
</i0>
<i1>
<id>ec4f70e97886fe5004947aeacd780bc6</id>
<short_url>http://jo.my/754a6464</short_url>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=7b9daef6cfb4eff2a8f771920ca3ab74&format=txt
Query parameters
fields = id,short_url
qrcode_id = 7b9daef6cfb4eff2a8f771920ca3ab74
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=55d836cb160d145cc74ff52eeeff5884
result_data_0_short_url=http://jo.my/d5d67e73
result_data_1_id=ec4f70e97886fe5004947aeacd780bc6
result_data_1_short_url=http://jo.my/754a6464
Example 4 (plain)
Request
https://joturl.com/a/i1/qrcodes/urls/list?fields=id,short_url&qrcode_id=7b9daef6cfb4eff2a8f771920ca3ab74&format=plain
Query parameters
fields = id,short_url
qrcode_id = 7b9daef6cfb4eff2a8f771920ca3ab74
format = plain
Response
http://jo.my/d5d67e73
http://jo.my/754a6464
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: id, notes, short_url, long_url, project_id, project_name, domain_id, domain_host, count |
qrcode_idID | ID of the QR code template |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of tracking links (maxmimum allowed: 100) |
orderbyARRAY | orders tracking links by field, available fields: id, notes, short_url, long_url, project_id, project_name, domain_id, domain_host, count |
searchSTRING | filters tracking links to be extracted by searching them |
sortSTRING | sorts tracking links in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract tracking links from this position |
Return values
parameter | description |
---|---|
data | array containing information on the tracking links, the returned information depends on the fields parameter. |
/remarketings
/remarketings/add
access: [WRITE]
Add a remarketing pixel for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2
Query parameters
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "71636c766251733639686861436d496d58426c464f773d3d",
"name": "FB remarketing pixel",
"notes": "this is a simple note",
"code_type": "facebook",
"code_id": "132434",
"code_html": "",
"gdpr_id": "7522395a6a22633061376e672161356b3153613638213d3d",
"gdpr_enabled": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=xml
Query parameters
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>71636c766251733639686861436d496d58426c464f773d3d</id>
<name>FB remarketing pixel</name>
<notes>this is a simple note</notes>
<code_type>facebook</code_type>
<code_id>132434</code_id>
<code_html></code_html>
<gdpr_id>7522395a6a22633061376e672161356b3153613638213d3d</gdpr_id>
<gdpr_enabled>2</gdpr_enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=txt
Query parameters
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=71636c766251733639686861436d496d58426c464f773d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_code_type=facebook
result_code_id=132434
result_code_html=
result_gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d
result_gdpr_enabled=2
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/add?name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=plain
Query parameters
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = plain
Response
71636c766251733639686861436d496d58426c464f773d3d
FB remarketing pixel
this is a simple note
facebook
132434
7522395a6a22633061376e672161356b3153613638213d3d
2
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | remarketing pixel name | 100 |
Optional parameters
parameter | description | max length |
---|---|---|
code_htmlHTML | HTML code for custom remarketing script | 4000 |
code_idSTRING | pixel ID | 255 |
code_typeENUM | pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter | |
gdpr_enabledINTEGER | 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used | |
gdpr_idID | ID of the GDPR template associated with this remarketing pixel | |
notesSTRING | remarketing pixel notes | 128 |
Return values
parameter | description |
---|---|
code_html | [OPTIONAL] HTML code for custom remarketing script, returned only if code_html is passed |
code_id | [OPTIONAL] pixel ID, returned only if code_id is passed |
code_type | [OPTIONAL] pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter, returned only if code_type is passed |
gdpr_enabled | [OPTIONAL] 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used, returned only if gdpr_enabled is passed |
gdpr_id | [OPTIONAL] ID of the GDPR template associated with this remarketing pixel, returned only if gdpr_id is passed |
id | [OPTIONAL] remarketing pixel (internal) ID, returned only if id is passed |
name | [OPTIONAL] remarketing pixel name, returned only if name is passed |
/remarketings/count
access: [READ]
This method returns the number of defined remarketing pixels.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 8
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>8</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/count?format=plain
Query parameters
format = plain
Response
8
Example 5 (json)
Request
https://joturl.com/a/i1/remarketings/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/remarketings/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/remarketings/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 8 (plain)
Request
https://joturl.com/a/i1/remarketings/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Optional parameters
parameter | description |
---|---|
searchSTRING | count items by searching them |
typesARRAY | filters list by code type(s), it can be empty, all or a comma separated list of these codes: facebook, twitter, linkedin, pinterest, bing, google_analytics, google_adwords, google_tag_manager, manychat, quora, adroll, snapchat, tiktok, reddit, custom |
Return values
parameter | description |
---|---|
count | number of remarketing pixels (filtered by search if passed) |
/remarketings/delete
access: [WRITE]
This method deletes a set of remarketing pixels by using their IDs.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/delete?ids=63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb
Query parameters
ids = 63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/delete?ids=63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb&format=xml
Query parameters
ids = 63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/delete?ids=63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb&format=txt
Query parameters
ids = 63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/delete?ids=63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb&format=plain
Query parameters
ids = 63a9d06a21f5d98fad5adde3ff2080a7,353aa55c435e5b704efeee63a9b41728,8d10c2fd41703944702ac66eae3391fb
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/remarketings/delete?ids=dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883
Query parameters
ids = dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26",
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/remarketings/delete?ids=dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883&format=xml
Query parameters
ids = dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/remarketings/delete?ids=dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883&format=txt
Query parameters
ids = dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/remarketings/delete?ids=dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883&format=plain
Query parameters
ids = dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26,05f8cd6f1f9d7eaf69f3de205576a883
format = plain
Response
dbcc46b29ee6c9deec60a382c25ef857,e996c320e5fd59d8f587cfb18451ee26
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of remarketing pixel IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted remarketing pixels |
ids | [OPTIONAL] list of remarketing pixel IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/remarketings/edit
access: [WRITE]
Edit fields of a remarketing pixel.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2
Query parameters
id = 306663506735386e622f69266e366a586d6b722552513d3d
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "306663506735386e622f69266e366a586d6b722552513d3d",
"name": "FB remarketing pixel",
"notes": "this is a simple note",
"code_type": "facebook",
"code_id": "132434",
"code_html": "",
"gdpr_id": "7522395a6a22633061376e672161356b3153613638213d3d",
"gdpr_enabled": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=xml
Query parameters
id = 306663506735386e622f69266e366a586d6b722552513d3d
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>306663506735386e622f69266e366a586d6b722552513d3d</id>
<name>FB remarketing pixel</name>
<notes>this is a simple note</notes>
<code_type>facebook</code_type>
<code_id>132434</code_id>
<code_html></code_html>
<gdpr_id>7522395a6a22633061376e672161356b3153613638213d3d</gdpr_id>
<gdpr_enabled>2</gdpr_enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=txt
Query parameters
id = 306663506735386e622f69266e366a586d6b722552513d3d
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=306663506735386e622f69266e366a586d6b722552513d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_code_type=facebook
result_code_id=132434
result_code_html=
result_gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d
result_gdpr_enabled=2
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/edit?id=306663506735386e622f69266e366a586d6b722552513d3d&name=FB+remarketing+pixel¬es=this+is+a+simple+note&code_type=facebook&code_id=132434&code_html=&gdpr_id=7522395a6a22633061376e672161356b3153613638213d3d&gdpr_enabled=2&format=plain
Query parameters
id = 306663506735386e622f69266e366a586d6b722552513d3d
name = FB remarketing pixel
notes = this is a simple note
code_type = facebook
code_id = 132434
code_html =
gdpr_id = 7522395a6a22633061376e672161356b3153613638213d3d
gdpr_enabled = 2
format = plain
Response
306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
facebook
132434
7522395a6a22633061376e672161356b3153613638213d3d
2
Required parameters
parameter | description |
---|---|
idID | remarketing pixel (internal) ID |
Optional parameters
parameter | description | max length |
---|---|---|
code_htmlHTML | HTML code for custom remarketing script | 4000 |
code_idSTRING | pixel ID | 255 |
code_typeENUM | pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter | |
gdpr_enabledINTEGER | 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used | |
gdpr_idID | ID of the GDPR template associated with this remarketing pixel | |
nameSTRING | remarketing pixel name | 100 |
notesSTRING | remarketing pixel notes | 128 |
Return values
parameter | description |
---|---|
code_html | [OPTIONAL] HTML code for custom remarketing script, returned only if code_html is passed |
code_id | [OPTIONAL] pixel ID, returned only if code_id is passed |
code_type | [OPTIONAL] pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter, returned only if code_type is passed |
gdpr_enabled | [OPTIONAL] 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used, returned only if gdpr_enabled is passed |
gdpr_id | [OPTIONAL] ID of the GDPR template associated with this remarketing pixel, returned only if gdpr_id is passed |
id | [OPTIONAL] remarketing pixel (internal) ID, returned only if id is passed |
name | [OPTIONAL] remarketing pixel name, returned only if name is passed |
notes | [OPTIONAL] remarketing pixel notes, returned only if notes is passed |
/remarketings/info
access: [READ]
This method returns information on a remarketing pixel, the returned information are that passed in the fields param (a comma separated list).
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"clicks": 31234,
"code_id": "132434",
"code_type": "facebook",
"creation": "2018-06-06 23:25:31.703",
"gdpr_enabled": 1,
"gdpr_id": "",
"id": "306663506735386e622f69266e366a586d6b722552513d3d",
"name": "FB remarketing pixel",
"notes": "this is a simple note",
"performance": ".000000000000"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=xml
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<clicks>31234</clicks>
<code_id>132434</code_id>
<code_type>facebook</code_type>
<creation>2018-06-06 23:25:31.703</creation>
<gdpr_enabled>1</gdpr_enabled>
<gdpr_id></gdpr_id>
<id>306663506735386e622f69266e366a586d6b722552513d3d</id>
<name>FB remarketing pixel</name>
<notes>this is a simple note</notes>
<performance>.000000000000</performance>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=txt
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_clicks=31234
result_code_id=132434
result_code_type=facebook
result_creation=2018-06-06 23:25:31.703
result_gdpr_enabled=1
result_gdpr_id=
result_id=306663506735386e622f69266e366a586d6b722552513d3d
result_name=FB remarketing pixel
result_notes=this is a simple note
result_performance=.000000000000
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/info?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=plain
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = plain
Response
31234
132434
facebook
2018-06-06 23:25:31.703
1
306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
.000000000000
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count |
idID | ID of the remarketing pixel |
Return values
parameter | description |
---|---|
clicks | click generated on the remarketing pixel |
code_id | pixel ID |
code_type | pixel type, available codes: adroll, bing, custom, facebook, google_adwords, google_analytics, google_tag_manager, linkedin, manychat, pinterest, quora, reddit, snapchat, tiktok, twitter |
creation | creation date time (e.g., 2018-06-06 23:25:31.703) |
gdpr_enabled | 0 if GDPR is disabled, 1 if GDPR is enabled and the default model is used, 2 if GDPR is enabled and the model with ID gdpr_id is used |
gdpr_id | ID of the GDPR template associated with this remarketing pixel |
id | remarketing pixel (internal) ID |
name | remarketing pixel name |
notes | remarketing pixel notes |
performance | performance meter of this remarking code, 0 if the remarketing pixel has 0 clicks or if is was created by less than 3 hours, otherwise it is the average number of clicks per hour |
/remarketings/list
access: [READ]
This method returns a list of remarking code's data, specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"clicks": 31234,
"code_id": "132434",
"user_retargeting_code_html": "",
"code_type": "facebook",
"creation": "2018-06-06 23:25:31.703",
"gdpr_enabled": 1,
"gdpr_id": "",
"id": "306663506735386e622f69266e366a586d6b722552513d3d",
"name": "FB remarketing pixel",
"notes": "this is a simple note",
"performance": ".000000000000"
},
{
"clicks": 123,
"code_id": "4568468",
"user_retargeting_code_html": "",
"code_type": "twitter",
"creation": "2017-01-18 13:28:42.543",
"gdpr_enabled": 1,
"gdpr_id": "",
"id": "806668506785886e642f69466e866a586d6b744552518d8d",
"name": "TW remarketing pixel",
"notes": "",
"performance": ".000000000000"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=xml
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<clicks>31234</clicks>
<code_id>132434</code_id>
<user_retargeting_code_html></user_retargeting_code_html>
<code_type>facebook</code_type>
<creation>2018-06-06 23:25:31.703</creation>
<gdpr_enabled>1</gdpr_enabled>
<gdpr_id></gdpr_id>
<id>306663506735386e622f69266e366a586d6b722552513d3d</id>
<name>FB remarketing pixel</name>
<notes>this is a simple note</notes>
<performance>.000000000000</performance>
</i0>
<i1>
<clicks>123</clicks>
<code_id>4568468</code_id>
<user_retargeting_code_html></user_retargeting_code_html>
<code_type>twitter</code_type>
<creation>2017-01-18 13:28:42.543</creation>
<gdpr_enabled>1</gdpr_enabled>
<gdpr_id></gdpr_id>
<id>806668506785886e642f69466e866a586d6b744552518d8d</id>
<name>TW remarketing pixel</name>
<notes></notes>
<performance>.000000000000</performance>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=txt
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_clicks=31234
result_data_0_code_id=132434
result_data_0_user_retargeting_code_html=
result_data_0_code_type=facebook
result_data_0_creation=2018-06-06 23:25:31.703
result_data_0_gdpr_enabled=1
result_data_0_gdpr_id=
result_data_0_id=306663506735386e622f69266e366a586d6b722552513d3d
result_data_0_name=FB remarketing pixel
result_data_0_notes=this is a simple note
result_data_0_performance=.000000000000
result_data_1_clicks=123
result_data_1_code_id=4568468
result_data_1_user_retargeting_code_html=
result_data_1_code_type=twitter
result_data_1_creation=2017-01-18 13:28:42.543
result_data_1_gdpr_enabled=1
result_data_1_gdpr_id=
result_data_1_id=806668506785886e642f69466e866a586d6b744552518d8d
result_data_1_name=TW remarketing pixel
result_data_1_notes=
result_data_1_performance=.000000000000
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/list?fields=clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count&format=plain
Query parameters
fields = clicks,code_id,code_type,creation,gdpr_enabled,gdpr_id,code_html,id,name,notes,performance,count
format = plain
Response
31234
132434
facebook
2018-06-06 23:25:31.703
1
306663506735386e622f69266e366a586d6b722552513d3d
FB remarketing pixel
this is a simple note
.000000000000
123
4568468
twitter
2017-01-18 13:28:42.543
1
806668506785886e642f69466e866a586d6b744552518d8d
TW remarketing pixel
.000000000000
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of remarketing pixels (maxmimum allowed: 100) |
orderbyARRAY | orders remarketing pixels by field, available fields: clicks, code_id, code_type, creation, gdpr_enabled, gdpr_id, code_html, id, name, notes, performance, count |
searchSTRING | filters remarketing pixels to be extracted by searching them |
sortSTRING | sorts remarketing pixels in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract remarketing pixels from this position |
typesARRAY | filters list by code type(s), it can be empty, all or a comma separated list of these codes: facebook, twitter, linkedin, pinterest, bing, google_analytics, google_adwords, google_tag_manager, manychat, quora, adroll, snapchat, tiktok, reddit, custom |
Return values
parameter | description |
---|---|
data | array containing required information on remarketing pixels |
/remarketings/property
access: [READ]
This method returns a list of supported remarketing pixels.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"adroll": {
"enabled": 1,
"label": "Adroll Pixel",
"title": "Advertiser ID|Pixel ID",
"helper": "",
"abbr": "AR"
},
"bing": {
"enabled": 1,
"label": "Bing Universal Event Tracking",
"title": "UET Pixel ID",
"helper": "",
"abbr": "BNG"
},
"custom": {
"enabled": 1,
"label": "Custom remarketing code",
"title": "Remarketing code (including opening and closing tags)",
"helper": "",
"abbr": "CSTM"
},
"facebook": {
"enabled": 1,
"label": "Facebook Pixel",
"title": "Pixel ID",
"helper": "",
"abbr": "FB"
},
"google_adwords": {
"enabled": 1,
"label": "AdWords tag for websites",
"title": "Conversion ID",
"helper": "",
"abbr": "ADWS"
},
"google_analytics": {
"enabled": 1,
"label": "Google Analytics Tracking code",
"title": "Tracking ID",
"helper": "",
"abbr": "GA"
},
"google_tag_manager": {
"enabled": 1,
"label": "Google Tag Manager",
"title": "GTM ID",
"helper": "",
"abbr": "GTAG"
},
"linkedin": {
"enabled": 1,
"label": "LinkedIn Insight Tag",
"title": "Partner ID (linkedin_data_partner_id)",
"helper": "",
"abbr": "LI"
},
"manychat": {
"enabled": 1,
"label": "ManyChat Pixel\/Widget",
"title": "Pixel\/Widget ID",
"helper": "",
"abbr": "MC"
},
"pinterest": {
"enabled": 1,
"label": "Pinterest Conversion Tag",
"title": "Pinterest Pixel ID",
"helper": "",
"abbr": "PIN"
},
"quora": {
"enabled": 1,
"label": "Quora Pixel ID",
"title": "Pixel ID",
"helper": "",
"abbr": "Q"
},
"reddit": {
"enabled": 1,
"label": "Reddit Pixel",
"title": "ID Inserzionista",
"helper": "",
"abbr": "R"
},
"snapchat": {
"enabled": 1,
"label": "Snapchat Pixel",
"title": "Pixel ID",
"helper": "",
"abbr": "SC"
},
"tiktok": {
"enabled": 1,
"label": "TikTok Pixel",
"title": "Pixel ID",
"helper": "",
"abbr": "TT"
},
"twitter": {
"enabled": 1,
"label": "Twitter conversion tracking",
"title": "Website Tag ID",
"helper": "",
"abbr": "TW"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<adroll>
<enabled>1</enabled>
<label>Adroll Pixel</label>
<title>Advertiser ID|Pixel ID</title>
<helper></helper>
<abbr>AR</abbr>
</adroll>
<bing>
<enabled>1</enabled>
<label>Bing Universal Event Tracking</label>
<title>UET Pixel ID</title>
<helper></helper>
<abbr>BNG</abbr>
</bing>
<custom>
<enabled>1</enabled>
<label>Custom remarketing code</label>
<title>Remarketing code (including opening and closing tags)</title>
<helper></helper>
<abbr>CSTM</abbr>
</custom>
<facebook>
<enabled>1</enabled>
<label>Facebook Pixel</label>
<title>Pixel ID</title>
<helper></helper>
<abbr>FB</abbr>
</facebook>
<google_adwords>
<enabled>1</enabled>
<label>AdWords tag for websites</label>
<title>Conversion ID</title>
<helper></helper>
<abbr>ADWS</abbr>
</google_adwords>
<google_analytics>
<enabled>1</enabled>
<label>Google Analytics Tracking code</label>
<title>Tracking ID</title>
<helper></helper>
<abbr>GA</abbr>
</google_analytics>
<google_tag_manager>
<enabled>1</enabled>
<label>Google Tag Manager</label>
<title>GTM ID</title>
<helper></helper>
<abbr>GTAG</abbr>
</google_tag_manager>
<linkedin>
<enabled>1</enabled>
<label>LinkedIn Insight Tag</label>
<title>Partner ID (linkedin_data_partner_id)</title>
<helper></helper>
<abbr>LI</abbr>
</linkedin>
<manychat>
<enabled>1</enabled>
<label>ManyChat Pixel/Widget</label>
<title>Pixel/Widget ID</title>
<helper></helper>
<abbr>MC</abbr>
</manychat>
<pinterest>
<enabled>1</enabled>
<label>Pinterest Conversion Tag</label>
<title>Pinterest Pixel ID</title>
<helper></helper>
<abbr>PIN</abbr>
</pinterest>
<quora>
<enabled>1</enabled>
<label>Quora Pixel ID</label>
<title>Pixel ID</title>
<helper></helper>
<abbr>Q</abbr>
</quora>
<reddit>
<enabled>1</enabled>
<label>Reddit Pixel</label>
<title>ID Inserzionista</title>
<helper></helper>
<abbr>R</abbr>
</reddit>
<snapchat>
<enabled>1</enabled>
<label>Snapchat Pixel</label>
<title>Pixel ID</title>
<helper></helper>
<abbr>SC</abbr>
</snapchat>
<tiktok>
<enabled>1</enabled>
<label>TikTok Pixel</label>
<title>Pixel ID</title>
<helper></helper>
<abbr>TT</abbr>
</tiktok>
<twitter>
<enabled>1</enabled>
<label>Twitter conversion tracking</label>
<title>Website Tag ID</title>
<helper></helper>
<abbr>TW</abbr>
</twitter>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_adroll_enabled=1
result_adroll_label=Adroll Pixel
result_adroll_title=Advertiser ID|Pixel ID
result_adroll_helper=
result_adroll_abbr=AR
result_bing_enabled=1
result_bing_label=Bing Universal Event Tracking
result_bing_title=UET Pixel ID
result_bing_helper=
result_bing_abbr=BNG
result_custom_enabled=1
result_custom_label=Custom remarketing code
result_custom_title=Remarketing code (including opening and closing tags)
result_custom_helper=
result_custom_abbr=CSTM
result_facebook_enabled=1
result_facebook_label=Facebook Pixel
result_facebook_title=Pixel ID
result_facebook_helper=
result_facebook_abbr=FB
result_google_adwords_enabled=1
result_google_adwords_label=AdWords tag for websites
result_google_adwords_title=Conversion ID
result_google_adwords_helper=
result_google_adwords_abbr=ADWS
result_google_analytics_enabled=1
result_google_analytics_label=Google Analytics Tracking code
result_google_analytics_title=Tracking ID
result_google_analytics_helper=
result_google_analytics_abbr=GA
result_google_tag_manager_enabled=1
result_google_tag_manager_label=Google Tag Manager
result_google_tag_manager_title=GTM ID
result_google_tag_manager_helper=
result_google_tag_manager_abbr=GTAG
result_linkedin_enabled=1
result_linkedin_label=LinkedIn Insight Tag
result_linkedin_title=Partner ID (linkedin_data_partner_id)
result_linkedin_helper=
result_linkedin_abbr=LI
result_manychat_enabled=1
result_manychat_label=ManyChat Pixel/Widget
result_manychat_title=Pixel/Widget ID
result_manychat_helper=
result_manychat_abbr=MC
result_pinterest_enabled=1
result_pinterest_label=Pinterest Conversion Tag
result_pinterest_title=Pinterest Pixel ID
result_pinterest_helper=
result_pinterest_abbr=PIN
result_quora_enabled=1
result_quora_label=Quora Pixel ID
result_quora_title=Pixel ID
result_quora_helper=
result_quora_abbr=Q
result_reddit_enabled=1
result_reddit_label=Reddit Pixel
result_reddit_title=ID Inserzionista
result_reddit_helper=
result_reddit_abbr=R
result_snapchat_enabled=1
result_snapchat_label=Snapchat Pixel
result_snapchat_title=Pixel ID
result_snapchat_helper=
result_snapchat_abbr=SC
result_tiktok_enabled=1
result_tiktok_label=TikTok Pixel
result_tiktok_title=Pixel ID
result_tiktok_helper=
result_tiktok_abbr=TT
result_twitter_enabled=1
result_twitter_label=Twitter conversion tracking
result_twitter_title=Website Tag ID
result_twitter_helper=
result_twitter_abbr=TW
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/property?format=plain
Query parameters
format = plain
Response
1
Adroll Pixel
Advertiser ID|Pixel ID
AR
1
Bing Universal Event Tracking
UET Pixel ID
BNG
1
Custom remarketing code
Remarketing code (including opening and closing tags)
CSTM
1
Facebook Pixel
Pixel ID
FB
1
AdWords tag for websites
Conversion ID
ADWS
1
Google Analytics Tracking code
Tracking ID
GA
1
Google Tag Manager
GTM ID
GTAG
1
LinkedIn Insight Tag
Partner ID (linkedin_data_partner_id)
LI
1
ManyChat Pixel/Widget
Pixel/Widget ID
MC
1
Pinterest Conversion Tag
Pinterest Pixel ID
PIN
1
Quora Pixel ID
Pixel ID
Q
1
Reddit Pixel
ID Inserzionista
R
1
Snapchat Pixel
Pixel ID
SC
1
TikTok Pixel
Pixel ID
TT
1
Twitter conversion tracking
Website Tag ID
TW
Return values
parameter | description |
---|---|
data | array containing supported remarketing pixels |
/remarketings/urls
/remarketings/urls/count
access: [READ]
This method returns the number of user's tracking links linked to a remarketing pixel.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/urls/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 8
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/urls/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>8</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/urls/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/urls/count?format=plain
Query parameters
format = plain
Response
8
Example 5 (json)
Request
https://joturl.com/a/i1/remarketings/urls/count?search=test
Query parameters
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/remarketings/urls/count?search=test&format=xml
Query parameters
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/remarketings/urls/count?search=test&format=txt
Query parameters
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 8 (plain)
Request
https://joturl.com/a/i1/remarketings/urls/count?search=test&format=plain
Query parameters
search = test
format = plain
Response
3
Required parameters
parameter | description |
---|---|
remarketing_idID | remarketing pixel (internal) ID |
Optional parameters
parameter | description |
---|---|
searchSTRING | count tracking links by searching them |
Return values
parameter | description |
---|---|
count | number of tracking links (filtered by search if passed) |
/remarketings/urls/list
access: [READ]
This method returns a list of user's tracking links data linked to a remarketing pixel.
Example 1 (json)
Request
https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits
Query parameters
fields = count,id,project_name,long_url,project_id,short_url,visits
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "6dcf1443f2a22c8b1731638a2c84443e",
"project_name": "project name 1",
"long_url": "https:\/\/google.com\/",
"project_id": "90ff4307387a016c6336982a858eb0ba",
"short_url": "https:\/\/my.domain.ext\/alias1",
"visits": 1234
},
{
"id": "cebf3ee233fb5b919cb8b450d25e99a8",
"project_name": "project name 2",
"long_url": "https:\/\/google.com\/",
"project_id": "3381c88dc1d94dbdad9425259e1a4f84",
"short_url": "https:\/\/my.domain.ext\/alias2",
"visits": 4321
}
],
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=xml
Query parameters
fields = count,id,project_name,long_url,project_id,short_url,visits
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>6dcf1443f2a22c8b1731638a2c84443e</id>
<project_name>project name 1</project_name>
<long_url>https://google.com/</long_url>
<project_id>90ff4307387a016c6336982a858eb0ba</project_id>
<short_url>https://my.domain.ext/alias1</short_url>
<visits>1234</visits>
</i0>
<i1>
<id>cebf3ee233fb5b919cb8b450d25e99a8</id>
<project_name>project name 2</project_name>
<long_url>https://google.com/</long_url>
<project_id>3381c88dc1d94dbdad9425259e1a4f84</project_id>
<short_url>https://my.domain.ext/alias2</short_url>
<visits>4321</visits>
</i1>
</data>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=txt
Query parameters
fields = count,id,project_name,long_url,project_id,short_url,visits
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=6dcf1443f2a22c8b1731638a2c84443e
result_data_0_project_name=project name 1
result_data_0_long_url=https://google.com/
result_data_0_project_id=90ff4307387a016c6336982a858eb0ba
result_data_0_short_url=https://my.domain.ext/alias1
result_data_0_visits=1234
result_data_1_id=cebf3ee233fb5b919cb8b450d25e99a8
result_data_1_project_name=project name 2
result_data_1_long_url=https://google.com/
result_data_1_project_id=3381c88dc1d94dbdad9425259e1a4f84
result_data_1_short_url=https://my.domain.ext/alias2
result_data_1_visits=4321
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/remarketings/urls/list?fields=count,id,project_name,long_url,project_id,short_url,visits&format=plain
Query parameters
fields = count,id,project_name,long_url,project_id,short_url,visits
format = plain
Response
https://my.domain.ext/alias1
https://my.domain.ext/alias2
2
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: project_name, long_url, id, project_id, short_url, visits, count |
remarketing_idID | remarketing pixel (internal) ID |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
orderbyARRAY | orders items by field, available fields: project_name, long_url, id, project_id, short_url, visits, count |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of (filtered) urls, returned only if count is passed in fields |
data | array containing information on the tracking link associated with the remarketing pixel |
/stats
/stats/conversions
/stats/conversions/get
access: [READ]
This method returns information about stats.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=0c4be7b2b0e245e89e96b7224e9e9041&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13
Query parameters
conversion_id = 0c4be7b2b0e245e89e96b7224e9e9041
charts = tl_snapshot
start_date = 2020-01-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"tl_snapshot": {
"type": "line",
"series": [
"visits",
"unique_visits",
"mobile",
"unique_mobile",
"qrcode_scans"
],
"types": {
"x": "Ym",
"count": "int"
},
"data": {
"visits": {
"2020-03": {
"count": 2
}
},
"unique_visits": {
"2020-03": {
"count": 0
}
},
"mobile": {
"2020-03": {
"count": 0
}
},
"unique_mobile": {
"2020-03": {
"count": 0
}
},
"qrcode_scans": {
"2020-03": {
"count": 0
}
}
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=0c4be7b2b0e245e89e96b7224e9e9041&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=xml
Query parameters
conversion_id = 0c4be7b2b0e245e89e96b7224e9e9041
charts = tl_snapshot
start_date = 2020-01-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<tl_snapshot>
<type>line</type>
<series>
<i0>visits</i0>
<i1>unique_visits</i1>
<i2>mobile</i2>
<i3>unique_mobile</i3>
<i4>qrcode_scans</i4>
</series>
<types>
<x>Ym</x>
<count>int</count>
</types>
<data>
<visits>
<2020-03>
<count>2</count>
</2020-03>
</visits>
<unique_visits>
<2020-03>
<count>0</count>
</2020-03>
</unique_visits>
<mobile>
<2020-03>
<count>0</count>
</2020-03>
</mobile>
<unique_mobile>
<2020-03>
<count>0</count>
</2020-03>
</unique_mobile>
<qrcode_scans>
<2020-03>
<count>0</count>
</2020-03>
</qrcode_scans>
</data>
</tl_snapshot>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=0c4be7b2b0e245e89e96b7224e9e9041&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=txt
Query parameters
conversion_id = 0c4be7b2b0e245e89e96b7224e9e9041
charts = tl_snapshot
start_date = 2020-01-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_snapshot_type=line
result_tl_snapshot_series_0=visits
result_tl_snapshot_series_1=unique_visits
result_tl_snapshot_series_2=mobile
result_tl_snapshot_series_3=unique_mobile
result_tl_snapshot_series_4=qrcode_scans
result_tl_snapshot_types_x=Ym
result_tl_snapshot_types_count=int
result_tl_snapshot_data_visits_2020-03_count=2
result_tl_snapshot_data_unique_visits_2020-03_count=0
result_tl_snapshot_data_mobile_2020-03_count=0
result_tl_snapshot_data_unique_mobile_2020-03_count=0
result_tl_snapshot_data_qrcode_scans_2020-03_count=0
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=0c4be7b2b0e245e89e96b7224e9e9041&charts=tl_snapshot&start_date=2020-01-01&end_date=2020-10-13&format=plain
Query parameters
conversion_id = 0c4be7b2b0e245e89e96b7224e9e9041
charts = tl_snapshot
start_date = 2020-01-01
end_date = 2020-10-13
format = plain
Response
line
visits
unique_visits
mobile
unique_mobile
qrcode_scans
Ym
int
2
0
0
0
0
Example 5 (json)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=73b10bb9df528c1af1b65261d83ecdf2&url_id=cfd1138a84a4fabfdae7b063ec20c799&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13
Query parameters
conversion_id = 73b10bb9df528c1af1b65261d83ecdf2
url_id = cfd1138a84a4fabfdae7b063ec20c799
charts = tl_countries
start_date = 2020-10-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"type": "doughnut",
"series": [
"countries"
],
"types": {
"count": "int"
},
"data": {
"countries": {
"Italia": {
"count": 2
}
}
},
"table": {
"Italia": {
"visits": 2,
"unique_visits": 0,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
}
}
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=73b10bb9df528c1af1b65261d83ecdf2&url_id=cfd1138a84a4fabfdae7b063ec20c799&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=xml
Query parameters
conversion_id = 73b10bb9df528c1af1b65261d83ecdf2
url_id = cfd1138a84a4fabfdae7b063ec20c799
charts = tl_countries
start_date = 2020-10-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<type>doughnut</type>
<series>
<i0>countries</i0>
</series>
<types>
<count>int</count>
</types>
<data>
<countries>
<Italia>
<count>2</count>
</Italia>
</countries>
</data>
<table>
<Italia>
<visits>2</visits>
<unique_visits>0</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</Italia>
</table>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=73b10bb9df528c1af1b65261d83ecdf2&url_id=cfd1138a84a4fabfdae7b063ec20c799&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=txt
Query parameters
conversion_id = 73b10bb9df528c1af1b65261d83ecdf2
url_id = cfd1138a84a4fabfdae7b063ec20c799
charts = tl_countries
start_date = 2020-10-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_type=doughnut
result_series_0=countries
result_types_count=int
result_data_countries_Italia_count=2
result_table_Italia_visits=2
result_table_Italia_unique_visits=0
result_table_Italia_mobile=0
result_table_Italia_unique_mobile=0
result_table_Italia_qrcode_scans=0
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/conversions/get?conversion_id=73b10bb9df528c1af1b65261d83ecdf2&url_id=cfd1138a84a4fabfdae7b063ec20c799&charts=tl_countries&start_date=2020-10-01&end_date=2020-10-13&format=plain
Query parameters
conversion_id = 73b10bb9df528c1af1b65261d83ecdf2
url_id = cfd1138a84a4fabfdae7b063ec20c799
charts = tl_countries
start_date = 2020-10-01
end_date = 2020-10-13
format = plain
Response
doughnut
countries
int
2
2
0
0
0
0
Required parameters
parameter | description |
---|---|
chartsARRAY | comma separated list of charts, for a detailed list of charts see i1/stats/conversions/info |
Optional parameters
parameter | description |
---|---|
conversion_idID | ID of the conversion for which to extract statistics |
end_dateDATE | extract statistics up to this date (included) |
ep00_idID | filter conversion data by using the ID of the extended parameter ep00, see i1/conversions/codes/params/list for details |
ep01_idID | filter conversion data by using the ID of the extended parameter ep01, see i1/conversions/codes/params/list for details |
ep02_idID | filter conversion data by using the ID of the extended parameter ep02, see i1/conversions/codes/params/list for details |
ep03_idID | filter conversion data by using the ID of the extended parameter ep03, see i1/conversions/codes/params/list for details |
ep04_idID | filter conversion data by using the ID of the extended parameter ep04, see i1/conversions/codes/params/list for details |
ep05_idID | filter conversion data by using the ID of the extended parameter ep05, see i1/conversions/codes/params/list for details |
ep06_idID | filter conversion data by using the ID of the extended parameter ep06, see i1/conversions/codes/params/list for details |
ep07_idID | filter conversion data by using the ID of the extended parameter ep07, see i1/conversions/codes/params/list for details |
ep08_idID | filter conversion data by using the ID of the extended parameter ep08, see i1/conversions/codes/params/list for details |
ep09_idID | filter conversion data by using the ID of the extended parameter ep09, see i1/conversions/codes/params/list for details |
ep10_idID | filter conversion data by using the ID of the extended parameter ep10, see i1/conversions/codes/params/list for details |
ep11_idID | filter conversion data by using the ID of the extended parameter ep11, see i1/conversions/codes/params/list for details |
ep12_idID | filter conversion data by using the ID of the extended parameter ep12, see i1/conversions/codes/params/list for details |
ep13_idID | filter conversion data by using the ID of the extended parameter ep13, see i1/conversions/codes/params/list for details |
ep14_idID | filter conversion data by using the ID of the extended parameter ep14, see i1/conversions/codes/params/list for details |
map_typeSTRING | used only when charts contains tl_map , see i1/stats/projects/get for details |
param_idID | filter conversion data by using the ID of the parameter, see i1/conversions/codes/params/list for details |
start_dateDATE | extract statistics from this date (included) |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | JSON object in the format {"chart": {[CHART INFO]}} |
/stats/conversions/info
access: [READ]
This method returns information about stats.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=65cdff0affd0c9a037a6c27f3a993152&url_id=009eba7555299fe968fc05e628c13f73
Query parameters
conversion_id = 65cdff0affd0c9a037a6c27f3a993152
url_id = 009eba7555299fe968fc05e628c13f73
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"tl_snapshot",
"tl_map",
"tl_countries",
"tl_regions",
"tl_cities",
"tl_languages",
"tl_referrers",
"tl_devices",
"tl_browsers",
"tl_platforms",
"tl_operating_systems",
"tl_ips",
"tl_bots",
"tl_conversions",
"tl_commissions"
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=65cdff0affd0c9a037a6c27f3a993152&url_id=009eba7555299fe968fc05e628c13f73&format=xml
Query parameters
conversion_id = 65cdff0affd0c9a037a6c27f3a993152
url_id = 009eba7555299fe968fc05e628c13f73
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>tl_snapshot</i0>
<i1>tl_map</i1>
<i2>tl_countries</i2>
<i3>tl_regions</i3>
<i4>tl_cities</i4>
<i5>tl_languages</i5>
<i6>tl_referrers</i6>
<i7>tl_devices</i7>
<i8>tl_browsers</i8>
<i9>tl_platforms</i9>
<i10>tl_operating_systems</i10>
<i11>tl_ips</i11>
<i12>tl_bots</i12>
<i13>tl_conversions</i13>
<i14>tl_commissions</i14>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=65cdff0affd0c9a037a6c27f3a993152&url_id=009eba7555299fe968fc05e628c13f73&format=txt
Query parameters
conversion_id = 65cdff0affd0c9a037a6c27f3a993152
url_id = 009eba7555299fe968fc05e628c13f73
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=tl_conversions
result_14=tl_commissions
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=65cdff0affd0c9a037a6c27f3a993152&url_id=009eba7555299fe968fc05e628c13f73&format=plain
Query parameters
conversion_id = 65cdff0affd0c9a037a6c27f3a993152
url_id = 009eba7555299fe968fc05e628c13f73
format = plain
Response
tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
tl_conversions
tl_commissions
Example 5 (json)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=23918b343b711fe8cc0f7f82be8eae1c
Query parameters
conversion_id = 23918b343b711fe8cc0f7f82be8eae1c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"tl_snapshot",
"tl_map",
"tl_countries",
"tl_regions",
"tl_cities",
"tl_languages",
"tl_referrers",
"tl_devices",
"tl_browsers",
"tl_platforms",
"tl_operating_systems",
"tl_ips",
"tl_bots",
"summary_snapshot_value",
"summary_snapshot_commission"
]
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=23918b343b711fe8cc0f7f82be8eae1c&format=xml
Query parameters
conversion_id = 23918b343b711fe8cc0f7f82be8eae1c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>tl_snapshot</i0>
<i1>tl_map</i1>
<i2>tl_countries</i2>
<i3>tl_regions</i3>
<i4>tl_cities</i4>
<i5>tl_languages</i5>
<i6>tl_referrers</i6>
<i7>tl_devices</i7>
<i8>tl_browsers</i8>
<i9>tl_platforms</i9>
<i10>tl_operating_systems</i10>
<i11>tl_ips</i11>
<i12>tl_bots</i12>
<i13>summary_snapshot_value</i13>
<i14>summary_snapshot_commission</i14>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=23918b343b711fe8cc0f7f82be8eae1c&format=txt
Query parameters
conversion_id = 23918b343b711fe8cc0f7f82be8eae1c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=summary_snapshot_value
result_14=summary_snapshot_commission
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/conversions/info?conversion_id=23918b343b711fe8cc0f7f82be8eae1c&format=plain
Query parameters
conversion_id = 23918b343b711fe8cc0f7f82be8eae1c
format = plain
Response
tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
summary_snapshot_value
summary_snapshot_commission
Example 9 (json)
Request
https://joturl.com/a/i1/stats/conversions/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"summary_snapshot_value",
"summary_snapshot_commission"
]
}
Example 10 (xml)
Request
https://joturl.com/a/i1/stats/conversions/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>summary_snapshot_value</i0>
<i1>summary_snapshot_commission</i1>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/stats/conversions/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot_value
result_1=summary_snapshot_commission
Example 12 (plain)
Request
https://joturl.com/a/i1/stats/conversions/info?format=plain
Query parameters
format = plain
Response
summary_snapshot_value
summary_snapshot_commission
Optional parameters
parameter | description |
---|---|
conversion_idID | ID of the conversion for which to extract statistics |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | array of available charts for the given conversion_id and url_id |
/stats/ctas
/stats/ctas/get
access: [READ]
This method returns information about stats.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13
Query parameters
charts = summary_snapshot
start_date = 2018-09-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"summary_snapshot": {
"type": "line",
"series": [
"ctas_visits",
"ctas_clicks"
],
"types": {
"x": "Ym",
"visits": "int",
"clicks": "int"
},
"data": {
"ctas_visits": {
"2018-09": {
"visits": 27
},
"2019-03": {
"visits": 27
},
"2020-02": {
"visits": 8
},
"2020-03": {
"visits": 6
},
"2020-05": {
"visits": 17
},
"2020-10": {
"visits": 17
}
},
"ctas_clicks": {
"2018-09": {
"clicks": 2
},
"2019-03": {
"clicks": 2
},
"2020-02": {
"clicks": 1
},
"2020-03": {
"clicks": 1
},
"2020-05": {
"clicks": 9
},
"2020-10": {
"clicks": 2
}
}
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=xml
Query parameters
charts = summary_snapshot
start_date = 2018-09-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<summary_snapshot>
<type>line</type>
<series>
<i0>ctas_visits</i0>
<i1>ctas_clicks</i1>
</series>
<types>
<x>Ym</x>
<visits>int</visits>
<clicks>int</clicks>
</types>
<data>
<ctas_visits>
<2018-09>
<visits>27</visits>
</2018-09>
<2019-03>
<visits>27</visits>
</2019-03>
<2020-02>
<visits>8</visits>
</2020-02>
<2020-03>
<visits>6</visits>
</2020-03>
<2020-05>
<visits>17</visits>
</2020-05>
<2020-10>
<visits>17</visits>
</2020-10>
</ctas_visits>
<ctas_clicks>
<2018-09>
<clicks>2</clicks>
</2018-09>
<2019-03>
<clicks>2</clicks>
</2019-03>
<2020-02>
<clicks>1</clicks>
</2020-02>
<2020-03>
<clicks>1</clicks>
</2020-03>
<2020-05>
<clicks>9</clicks>
</2020-05>
<2020-10>
<clicks>2</clicks>
</2020-10>
</ctas_clicks>
</data>
</summary_snapshot>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=txt
Query parameters
charts = summary_snapshot
start_date = 2018-09-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_summary_snapshot_type=line
result_summary_snapshot_series_0=ctas_visits
result_summary_snapshot_series_1=ctas_clicks
result_summary_snapshot_types_x=Ym
result_summary_snapshot_types_visits=int
result_summary_snapshot_types_clicks=int
result_summary_snapshot_data_ctas_visits_2018-09_visits=27
result_summary_snapshot_data_ctas_visits_2019-03_visits=27
result_summary_snapshot_data_ctas_visits_2020-02_visits=8
result_summary_snapshot_data_ctas_visits_2020-03_visits=6
result_summary_snapshot_data_ctas_visits_2020-05_visits=17
result_summary_snapshot_data_ctas_visits_2020-10_visits=17
result_summary_snapshot_data_ctas_clicks_2018-09_clicks=2
result_summary_snapshot_data_ctas_clicks_2019-03_clicks=2
result_summary_snapshot_data_ctas_clicks_2020-02_clicks=1
result_summary_snapshot_data_ctas_clicks_2020-03_clicks=1
result_summary_snapshot_data_ctas_clicks_2020-05_clicks=9
result_summary_snapshot_data_ctas_clicks_2020-10_clicks=2
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/ctas/get?charts=summary_snapshot&start_date=2018-09-01&end_date=2020-10-13&format=plain
Query parameters
charts = summary_snapshot
start_date = 2018-09-01
end_date = 2020-10-13
format = plain
Response
line
ctas_visits
ctas_clicks
Ym
int
int
27
27
8
6
17
17
2
2
1
1
9
2
Example 5 (json)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=bccbecbad7686b1c9e4d7bd783552eb5&url_id=82f5d80f99654f6c80ce11a980f6cd8f&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13
Query parameters
cta_id = bccbecbad7686b1c9e4d7bd783552eb5
url_id = 82f5d80f99654f6c80ce11a980f6cd8f
charts = tl_cities
start_date = 2020-10-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"tl_cities": {
"type": "doughnut",
"series": [
"cities"
],
"types": {
"count": "int"
},
"data": {
"cities": {
"Akko": {
"count": 2
},
"Florence": {
"count": 2
}
}
},
"table": {
"Akko": {
"visits": 2,
"unique_visits": 0,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
},
"Florence": {
"visits": 2,
"unique_visits": 0,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
}
}
}
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=bccbecbad7686b1c9e4d7bd783552eb5&url_id=82f5d80f99654f6c80ce11a980f6cd8f&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=xml
Query parameters
cta_id = bccbecbad7686b1c9e4d7bd783552eb5
url_id = 82f5d80f99654f6c80ce11a980f6cd8f
charts = tl_cities
start_date = 2020-10-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<tl_cities>
<type>doughnut</type>
<series>
<i0>cities</i0>
</series>
<types>
<count>int</count>
</types>
<data>
<cities>
<Akko>
<count>2</count>
</Akko>
<Florence>
<count>2</count>
</Florence>
</cities>
</data>
<table>
<Akko>
<visits>2</visits>
<unique_visits>0</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</Akko>
<Florence>
<visits>2</visits>
<unique_visits>0</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</Florence>
</table>
</tl_cities>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=bccbecbad7686b1c9e4d7bd783552eb5&url_id=82f5d80f99654f6c80ce11a980f6cd8f&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=txt
Query parameters
cta_id = bccbecbad7686b1c9e4d7bd783552eb5
url_id = 82f5d80f99654f6c80ce11a980f6cd8f
charts = tl_cities
start_date = 2020-10-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_cities_type=doughnut
result_tl_cities_series_0=cities
result_tl_cities_types_count=int
result_tl_cities_data_cities_Akko_count=2
result_tl_cities_data_cities_Florence_count=2
result_tl_cities_table_Akko_visits=2
result_tl_cities_table_Akko_unique_visits=0
result_tl_cities_table_Akko_mobile=0
result_tl_cities_table_Akko_unique_mobile=0
result_tl_cities_table_Akko_qrcode_scans=0
result_tl_cities_table_Florence_visits=2
result_tl_cities_table_Florence_unique_visits=0
result_tl_cities_table_Florence_mobile=0
result_tl_cities_table_Florence_unique_mobile=0
result_tl_cities_table_Florence_qrcode_scans=0
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=bccbecbad7686b1c9e4d7bd783552eb5&url_id=82f5d80f99654f6c80ce11a980f6cd8f&charts=tl_cities&start_date=2020-10-01&end_date=2020-10-13&format=plain
Query parameters
cta_id = bccbecbad7686b1c9e4d7bd783552eb5
url_id = 82f5d80f99654f6c80ce11a980f6cd8f
charts = tl_cities
start_date = 2020-10-01
end_date = 2020-10-13
format = plain
Response
doughnut
cities
int
2
2
2
0
0
0
0
2
0
0
0
0
Example 9 (json)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=992093d00ed3f690e050270015ab0b47&url_id=a404d15f20a1d9751b64549aa3e7f6c6&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13
Query parameters
cta_id = 992093d00ed3f690e050270015ab0b47
url_id = a404d15f20a1d9751b64549aa3e7f6c6
charts = tl_ips
start_date = 2020-10-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"tl_ips": {
"nodata": 1
}
}
}
Example 10 (xml)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=992093d00ed3f690e050270015ab0b47&url_id=a404d15f20a1d9751b64549aa3e7f6c6&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=xml
Query parameters
cta_id = 992093d00ed3f690e050270015ab0b47
url_id = a404d15f20a1d9751b64549aa3e7f6c6
charts = tl_ips
start_date = 2020-10-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<tl_ips>
<nodata>1</nodata>
</tl_ips>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=992093d00ed3f690e050270015ab0b47&url_id=a404d15f20a1d9751b64549aa3e7f6c6&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=txt
Query parameters
cta_id = 992093d00ed3f690e050270015ab0b47
url_id = a404d15f20a1d9751b64549aa3e7f6c6
charts = tl_ips
start_date = 2020-10-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_ips_nodata=1
Example 12 (plain)
Request
https://joturl.com/a/i1/stats/ctas/get?cta_id=992093d00ed3f690e050270015ab0b47&url_id=a404d15f20a1d9751b64549aa3e7f6c6&charts=tl_ips&start_date=2020-10-01&end_date=2020-10-13&format=plain
Query parameters
cta_id = 992093d00ed3f690e050270015ab0b47
url_id = a404d15f20a1d9751b64549aa3e7f6c6
charts = tl_ips
start_date = 2020-10-01
end_date = 2020-10-13
format = plain
Response
1
Required parameters
parameter | description |
---|---|
chartsARRAY | comma separated list of charts, for a detailed list of charts see i1/stats/ctas/info |
Optional parameters
parameter | description |
---|---|
cta_idID | ID of the CTA for which to extract statistics |
end_dateDATE | extract statistics up to this date (included) |
map_typeSTRING | used only when charts contains tl_map , see i1/stats/projects/get for details |
start_dateDATE | extract statistics from this date (included) |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | JSON object in the format {"chart": {[CHART INFO]}} |
/stats/ctas/info
access: [READ]
This method returns information about stats.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=597278f8868a4049219a6452514650dd&url_id=1224b60377ddf55fdb6f4ab560e1e766
Query parameters
cta_id = 597278f8868a4049219a6452514650dd
url_id = 1224b60377ddf55fdb6f4ab560e1e766
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"tl_snapshot",
"tl_map",
"tl_countries",
"tl_regions",
"tl_cities",
"tl_languages",
"tl_referrers",
"tl_devices",
"tl_browsers",
"tl_platforms",
"tl_operating_systems",
"tl_ips",
"tl_bots",
"tl_ctas_conversions",
"tl_ctas_metrics"
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=597278f8868a4049219a6452514650dd&url_id=1224b60377ddf55fdb6f4ab560e1e766&format=xml
Query parameters
cta_id = 597278f8868a4049219a6452514650dd
url_id = 1224b60377ddf55fdb6f4ab560e1e766
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>tl_snapshot</i0>
<i1>tl_map</i1>
<i2>tl_countries</i2>
<i3>tl_regions</i3>
<i4>tl_cities</i4>
<i5>tl_languages</i5>
<i6>tl_referrers</i6>
<i7>tl_devices</i7>
<i8>tl_browsers</i8>
<i9>tl_platforms</i9>
<i10>tl_operating_systems</i10>
<i11>tl_ips</i11>
<i12>tl_bots</i12>
<i13>tl_ctas_conversions</i13>
<i14>tl_ctas_metrics</i14>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=597278f8868a4049219a6452514650dd&url_id=1224b60377ddf55fdb6f4ab560e1e766&format=txt
Query parameters
cta_id = 597278f8868a4049219a6452514650dd
url_id = 1224b60377ddf55fdb6f4ab560e1e766
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
result_13=tl_ctas_conversions
result_14=tl_ctas_metrics
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=597278f8868a4049219a6452514650dd&url_id=1224b60377ddf55fdb6f4ab560e1e766&format=plain
Query parameters
cta_id = 597278f8868a4049219a6452514650dd
url_id = 1224b60377ddf55fdb6f4ab560e1e766
format = plain
Response
tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
tl_ctas_conversions
tl_ctas_metrics
Example 5 (json)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=4845ccbb80d6af424b358c06296c5c6a
Query parameters
cta_id = 4845ccbb80d6af424b358c06296c5c6a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"summary_snapshot",
"summary_conversions",
"summary_commissions",
"summary_ctas",
"summary_cta_forms",
"summary_cta_social_connects",
"summary_clicks_to_destination",
"tl_ctas_conversions",
"tl_ctas_metrics"
]
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=4845ccbb80d6af424b358c06296c5c6a&format=xml
Query parameters
cta_id = 4845ccbb80d6af424b358c06296c5c6a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>summary_snapshot</i0>
<i1>summary_conversions</i1>
<i2>summary_commissions</i2>
<i3>summary_ctas</i3>
<i4>summary_cta_forms</i4>
<i5>summary_cta_social_connects</i5>
<i6>summary_clicks_to_destination</i6>
<i7>tl_ctas_conversions</i7>
<i8>tl_ctas_metrics</i8>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=4845ccbb80d6af424b358c06296c5c6a&format=txt
Query parameters
cta_id = 4845ccbb80d6af424b358c06296c5c6a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination
result_7=tl_ctas_conversions
result_8=tl_ctas_metrics
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/ctas/info?cta_id=4845ccbb80d6af424b358c06296c5c6a&format=plain
Query parameters
cta_id = 4845ccbb80d6af424b358c06296c5c6a
format = plain
Response
summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination
tl_ctas_conversions
tl_ctas_metrics
Example 9 (json)
Request
https://joturl.com/a/i1/stats/ctas/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"summary_snapshot"
]
}
Example 10 (xml)
Request
https://joturl.com/a/i1/stats/ctas/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>summary_snapshot</i0>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/stats/ctas/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
Example 12 (plain)
Request
https://joturl.com/a/i1/stats/ctas/info?format=plain
Query parameters
format = plain
Response
summary_snapshot
Optional parameters
parameter | description |
---|---|
cta_idID | ID of the CTA for which to extract statistics |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | array of available charts for the given cta_id and url_id |
/stats/projects
/stats/projects/get
access: [READ]
This method returns the charts requested in the charts parameter.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11
Query parameters
charts = summary_snapshot
start_date = 2020-10-05
end_date = 2020-10-11
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"summary_snapshot": {
"type": "line",
"series": [
"visits",
"unique_visits",
"mobile",
"unique_mobile",
"qrcode_scans"
],
"types": {
"x": "Ymd",
"count": "int"
},
"data": {
"visits": {
"2020-10-05": {
"count": 2
},
...: {
"count": 3
},
"2020-10-11": {
"count": 19
}
},
"unique_visits": {
"2020-10-05": {
"count": 2
},
...: {
"count": 3
},
"2020-10-11": {
"count": 5
}
},
"mobile": {
"2020-10-05": {
"count": 0
},
...: {
"count": 2
},
"2020-10-11": {
"count": 0
}
},
"unique_mobile": {
"2020-10-05": {
"count": 0
},
...: {
"count": 2
},
"2020-10-11": {
"count": 0
}
},
"qrcode_scans": {
"2020-10-05": {
"count": 0
},
...: {
"count": 0
},
"2020-10-11": {
"count": 0
}
}
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=xml
Query parameters
charts = summary_snapshot
start_date = 2020-10-05
end_date = 2020-10-11
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<summary_snapshot>
<type>line</type>
<series>
<i0>visits</i0>
<i1>unique_visits</i1>
<i2>mobile</i2>
<i3>unique_mobile</i3>
<i4>qrcode_scans</i4>
</series>
<types>
<x>Ymd</x>
<count>int</count>
</types>
<data>
<visits>
<2020-10-05>
<count>2</count>
</2020-10-05>
<...>
<count>3</count>
</...>
<2020-10-11>
<count>19</count>
</2020-10-11>
</visits>
<unique_visits>
<2020-10-05>
<count>2</count>
</2020-10-05>
<...>
<count>3</count>
</...>
<2020-10-11>
<count>5</count>
</2020-10-11>
</unique_visits>
<mobile>
<2020-10-05>
<count>0</count>
</2020-10-05>
<...>
<count>2</count>
</...>
<2020-10-11>
<count>0</count>
</2020-10-11>
</mobile>
<unique_mobile>
<2020-10-05>
<count>0</count>
</2020-10-05>
<...>
<count>2</count>
</...>
<2020-10-11>
<count>0</count>
</2020-10-11>
</unique_mobile>
<qrcode_scans>
<2020-10-05>
<count>0</count>
</2020-10-05>
<...>
<count>0</count>
</...>
<2020-10-11>
<count>0</count>
</2020-10-11>
</qrcode_scans>
</data>
</summary_snapshot>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=txt
Query parameters
charts = summary_snapshot
start_date = 2020-10-05
end_date = 2020-10-11
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_summary_snapshot_type=line
result_summary_snapshot_series_0=visits
result_summary_snapshot_series_1=unique_visits
result_summary_snapshot_series_2=mobile
result_summary_snapshot_series_3=unique_mobile
result_summary_snapshot_series_4=qrcode_scans
result_summary_snapshot_types_x=Ymd
result_summary_snapshot_types_count=int
result_summary_snapshot_data_visits_2020-10-05_count=2
result_summary_snapshot_data_visits_..._count=3
result_summary_snapshot_data_visits_2020-10-11_count=19
result_summary_snapshot_data_unique_visits_2020-10-05_count=2
result_summary_snapshot_data_unique_visits_..._count=3
result_summary_snapshot_data_unique_visits_2020-10-11_count=5
result_summary_snapshot_data_mobile_2020-10-05_count=0
result_summary_snapshot_data_mobile_..._count=2
result_summary_snapshot_data_mobile_2020-10-11_count=0
result_summary_snapshot_data_unique_mobile_2020-10-05_count=0
result_summary_snapshot_data_unique_mobile_..._count=2
result_summary_snapshot_data_unique_mobile_2020-10-11_count=0
result_summary_snapshot_data_qrcode_scans_2020-10-05_count=0
result_summary_snapshot_data_qrcode_scans_..._count=0
result_summary_snapshot_data_qrcode_scans_2020-10-11_count=0
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_snapshot&start_date=2020-10-05&end_date=2020-10-11&format=plain
Query parameters
charts = summary_snapshot
start_date = 2020-10-05
end_date = 2020-10-11
format = plain
Response
line
visits
unique_visits
mobile
unique_mobile
qrcode_scans
Ymd
int
2
3
19
2
3
5
0
2
0
0
2
0
0
0
0
Example 5 (json)
Request
https://joturl.com/a/i1/stats/projects/get?project_id=24e1dd1e995c6387899e56179b556a85&url_id=29329bde3713e3cbe54eb0a54a60e4ef&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12
Query parameters
project_id = 24e1dd1e995c6387899e56179b556a85
url_id = 29329bde3713e3cbe54eb0a54a60e4ef
charts = tl_browsers
start_date = 2017-10-12
end_date = 2020-10-12
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"tl_browsers": {
"type": "doughnut",
"series": [
"stats_browsers"
],
"types": {
"count": "int"
},
"data": {
"stats_browsers": {
"Internet Explorer": {
"count": 15
},
"Mozilla": {
"count": 14
},
...: {
"count": 13
},
"Internet Explorer Mobile": {
"count": 4
}
}
},
"table": {
"Internet Explorer": {
"visits": 15,
"unique_visits": 15,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
},
"Mozilla": {
"visits": 14,
"unique_visits": 14,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
},
...: {
"visits": 13,
"unique_visits": 13,
"mobile": 0,
"unique_mobile": 0,
"qrcode_scans": 0
},
"Internet Explorer Mobile": {
"visits": 4,
"unique_visits": 3,
"mobile": 2,
"unique_mobile": 1,
"qrcode_scans": 1
}
}
}
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/projects/get?project_id=24e1dd1e995c6387899e56179b556a85&url_id=29329bde3713e3cbe54eb0a54a60e4ef&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=xml
Query parameters
project_id = 24e1dd1e995c6387899e56179b556a85
url_id = 29329bde3713e3cbe54eb0a54a60e4ef
charts = tl_browsers
start_date = 2017-10-12
end_date = 2020-10-12
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<tl_browsers>
<type>doughnut</type>
<series>
<i0>stats_browsers</i0>
</series>
<types>
<count>int</count>
</types>
<data>
<stats_browsers>
<Internet Explorer>
<count>15</count>
</Internet Explorer>
<Mozilla>
<count>14</count>
</Mozilla>
<...>
<count>13</count>
</...>
<Internet Explorer Mobile>
<count>4</count>
</Internet Explorer Mobile>
</stats_browsers>
</data>
<table>
<Internet Explorer>
<visits>15</visits>
<unique_visits>15</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</Internet Explorer>
<Mozilla>
<visits>14</visits>
<unique_visits>14</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</Mozilla>
<...>
<visits>13</visits>
<unique_visits>13</unique_visits>
<mobile>0</mobile>
<unique_mobile>0</unique_mobile>
<qrcode_scans>0</qrcode_scans>
</...>
<Internet Explorer Mobile>
<visits>4</visits>
<unique_visits>3</unique_visits>
<mobile>2</mobile>
<unique_mobile>1</unique_mobile>
<qrcode_scans>1</qrcode_scans>
</Internet Explorer Mobile>
</table>
</tl_browsers>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/projects/get?project_id=24e1dd1e995c6387899e56179b556a85&url_id=29329bde3713e3cbe54eb0a54a60e4ef&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=txt
Query parameters
project_id = 24e1dd1e995c6387899e56179b556a85
url_id = 29329bde3713e3cbe54eb0a54a60e4ef
charts = tl_browsers
start_date = 2017-10-12
end_date = 2020-10-12
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_browsers_type=doughnut
result_tl_browsers_series_0=stats_browsers
result_tl_browsers_types_count=int
result_tl_browsers_data_stats_browsers_Internet Explorer_count=15
result_tl_browsers_data_stats_browsers_Mozilla_count=14
result_tl_browsers_data_stats_browsers_..._count=13
result_tl_browsers_data_stats_browsers_Internet Explorer Mobile_count=4
result_tl_browsers_table_Internet Explorer_visits=15
result_tl_browsers_table_Internet Explorer_unique_visits=15
result_tl_browsers_table_Internet Explorer_mobile=0
result_tl_browsers_table_Internet Explorer_unique_mobile=0
result_tl_browsers_table_Internet Explorer_qrcode_scans=0
result_tl_browsers_table_Mozilla_visits=14
result_tl_browsers_table_Mozilla_unique_visits=14
result_tl_browsers_table_Mozilla_mobile=0
result_tl_browsers_table_Mozilla_unique_mobile=0
result_tl_browsers_table_Mozilla_qrcode_scans=0
result_tl_browsers_table_..._visits=13
result_tl_browsers_table_..._unique_visits=13
result_tl_browsers_table_..._mobile=0
result_tl_browsers_table_..._unique_mobile=0
result_tl_browsers_table_..._qrcode_scans=0
result_tl_browsers_table_Internet Explorer Mobile_visits=4
result_tl_browsers_table_Internet Explorer Mobile_unique_visits=3
result_tl_browsers_table_Internet Explorer Mobile_mobile=2
result_tl_browsers_table_Internet Explorer Mobile_unique_mobile=1
result_tl_browsers_table_Internet Explorer Mobile_qrcode_scans=1
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/projects/get?project_id=24e1dd1e995c6387899e56179b556a85&url_id=29329bde3713e3cbe54eb0a54a60e4ef&charts=tl_browsers&start_date=2017-10-12&end_date=2020-10-12&format=plain
Query parameters
project_id = 24e1dd1e995c6387899e56179b556a85
url_id = 29329bde3713e3cbe54eb0a54a60e4ef
charts = tl_browsers
start_date = 2017-10-12
end_date = 2020-10-12
format = plain
Response
doughnut
stats_browsers
int
15
14
13
4
15
15
0
0
0
14
14
0
0
0
13
13
0
0
0
4
3
2
1
1
Example 9 (json)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11
Query parameters
charts = summary_clicks_to_destination
start_date = 2017-10-12
end_date = 2020-10-11
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": []
}
Example 10 (xml)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=xml
Query parameters
charts = summary_clicks_to_destination
start_date = 2017-10-12
end_date = 2020-10-11
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=txt
Query parameters
charts = summary_clicks_to_destination
start_date = 2017-10-12
end_date = 2020-10-11
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result=
Example 12 (plain)
Request
https://joturl.com/a/i1/stats/projects/get?charts=summary_clicks_to_destination&start_date=2017-10-12&end_date=2020-10-11&format=plain
Query parameters
charts = summary_clicks_to_destination
start_date = 2017-10-12
end_date = 2020-10-11
format = plain
Response
Example 13 (json)
Request
https://joturl.com/a/i1/stats/projects/get?cta_id=f04b0bc7ba645ccad4f91f04cbccc6dd&url_id=51ad21be30927f431c338fbd4661f89a&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13
Query parameters
cta_id = f04b0bc7ba645ccad4f91f04cbccc6dd
url_id = 51ad21be30927f431c338fbd4661f89a
charts = tl_referrers
start_date = 2020-10-01
end_date = 2020-10-13
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"tl_referrers": {
"nodata": 1
}
}
}
Example 14 (xml)
Request
https://joturl.com/a/i1/stats/projects/get?cta_id=f04b0bc7ba645ccad4f91f04cbccc6dd&url_id=51ad21be30927f431c338fbd4661f89a&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=xml
Query parameters
cta_id = f04b0bc7ba645ccad4f91f04cbccc6dd
url_id = 51ad21be30927f431c338fbd4661f89a
charts = tl_referrers
start_date = 2020-10-01
end_date = 2020-10-13
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<tl_referrers>
<nodata>1</nodata>
</tl_referrers>
</result>
</response>
Example 15 (txt)
Request
https://joturl.com/a/i1/stats/projects/get?cta_id=f04b0bc7ba645ccad4f91f04cbccc6dd&url_id=51ad21be30927f431c338fbd4661f89a&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=txt
Query parameters
cta_id = f04b0bc7ba645ccad4f91f04cbccc6dd
url_id = 51ad21be30927f431c338fbd4661f89a
charts = tl_referrers
start_date = 2020-10-01
end_date = 2020-10-13
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_tl_referrers_nodata=1
Example 16 (plain)
Request
https://joturl.com/a/i1/stats/projects/get?cta_id=f04b0bc7ba645ccad4f91f04cbccc6dd&url_id=51ad21be30927f431c338fbd4661f89a&charts=tl_referrers&start_date=2020-10-01&end_date=2020-10-13&format=plain
Query parameters
cta_id = f04b0bc7ba645ccad4f91f04cbccc6dd
url_id = 51ad21be30927f431c338fbd4661f89a
charts = tl_referrers
start_date = 2020-10-01
end_date = 2020-10-13
format = plain
Response
1
Required parameters
parameter | description |
---|---|
chartsARRAY | comma separated list of charts, for a detailed list of charts see i1/stats/projects/info |
Optional parameters
parameter | description |
---|---|
end_dateDATE | extract statistics up to this date (included) |
map_typeSTRING | used only when charts contains tl_map , see before for details |
mu_idxINTEGER | only valid for tracking links with the InstaUrl option enabled, it allows you to specify the extraction of a specific URL: this value is the index of the corresponding URL in the option (in the same order in which they appear) |
project_idID | ID of the project for which to extract statistics |
start_dateDATE | extract statistics from this date (included) |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | JSON object in the format {"chart": {[CHART INFO]}} |
/stats/projects/info
access: [READ]
This method returns available charts for the given inputs.
Example 1 (json)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=643ad3ca1597ab37b71592ec89e9a29b&url_id=b57ed731e83f86a491232ff3eb2a3a89
Query parameters
project_id = 643ad3ca1597ab37b71592ec89e9a29b
url_id = b57ed731e83f86a491232ff3eb2a3a89
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"tl_snapshot",
"tl_map",
"tl_countries",
"tl_regions",
"tl_cities",
"tl_languages",
"tl_referrers",
"tl_devices",
"tl_browsers",
"tl_platforms",
"tl_operating_systems",
"tl_ips",
"tl_bots"
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=643ad3ca1597ab37b71592ec89e9a29b&url_id=b57ed731e83f86a491232ff3eb2a3a89&format=xml
Query parameters
project_id = 643ad3ca1597ab37b71592ec89e9a29b
url_id = b57ed731e83f86a491232ff3eb2a3a89
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>tl_snapshot</i0>
<i1>tl_map</i1>
<i2>tl_countries</i2>
<i3>tl_regions</i3>
<i4>tl_cities</i4>
<i5>tl_languages</i5>
<i6>tl_referrers</i6>
<i7>tl_devices</i7>
<i8>tl_browsers</i8>
<i9>tl_platforms</i9>
<i10>tl_operating_systems</i10>
<i11>tl_ips</i11>
<i12>tl_bots</i12>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=643ad3ca1597ab37b71592ec89e9a29b&url_id=b57ed731e83f86a491232ff3eb2a3a89&format=txt
Query parameters
project_id = 643ad3ca1597ab37b71592ec89e9a29b
url_id = b57ed731e83f86a491232ff3eb2a3a89
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=tl_snapshot
result_1=tl_map
result_2=tl_countries
result_3=tl_regions
result_4=tl_cities
result_5=tl_languages
result_6=tl_referrers
result_7=tl_devices
result_8=tl_browsers
result_9=tl_platforms
result_10=tl_operating_systems
result_11=tl_ips
result_12=tl_bots
Example 4 (plain)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=643ad3ca1597ab37b71592ec89e9a29b&url_id=b57ed731e83f86a491232ff3eb2a3a89&format=plain
Query parameters
project_id = 643ad3ca1597ab37b71592ec89e9a29b
url_id = b57ed731e83f86a491232ff3eb2a3a89
format = plain
Response
tl_snapshot
tl_map
tl_countries
tl_regions
tl_cities
tl_languages
tl_referrers
tl_devices
tl_browsers
tl_platforms
tl_operating_systems
tl_ips
tl_bots
Example 5 (json)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=bb6bcaf16ada51bcd15fe6e8b5387749
Query parameters
project_id = bb6bcaf16ada51bcd15fe6e8b5387749
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"summary_snapshot",
"summary_conversions",
"summary_commissions",
"summary_ctas",
"summary_cta_forms",
"summary_cta_social_connects",
"summary_clicks_to_destination"
]
}
Example 6 (xml)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=bb6bcaf16ada51bcd15fe6e8b5387749&format=xml
Query parameters
project_id = bb6bcaf16ada51bcd15fe6e8b5387749
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>summary_snapshot</i0>
<i1>summary_conversions</i1>
<i2>summary_commissions</i2>
<i3>summary_ctas</i3>
<i4>summary_cta_forms</i4>
<i5>summary_cta_social_connects</i5>
<i6>summary_clicks_to_destination</i6>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=bb6bcaf16ada51bcd15fe6e8b5387749&format=txt
Query parameters
project_id = bb6bcaf16ada51bcd15fe6e8b5387749
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination
Example 8 (plain)
Request
https://joturl.com/a/i1/stats/projects/info?project_id=bb6bcaf16ada51bcd15fe6e8b5387749&format=plain
Query parameters
project_id = bb6bcaf16ada51bcd15fe6e8b5387749
format = plain
Response
summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination
Example 9 (json)
Request
https://joturl.com/a/i1/stats/projects/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"summary_snapshot",
"summary_conversions",
"summary_commissions",
"summary_ctas",
"summary_cta_forms",
"summary_cta_social_connects",
"summary_clicks_to_destination",
"summary_external_apis",
"summary_short_domain_requests"
]
}
Example 10 (xml)
Request
https://joturl.com/a/i1/stats/projects/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>summary_snapshot</i0>
<i1>summary_conversions</i1>
<i2>summary_commissions</i2>
<i3>summary_ctas</i3>
<i4>summary_cta_forms</i4>
<i5>summary_cta_social_connects</i5>
<i6>summary_clicks_to_destination</i6>
<i7>summary_external_apis</i7>
<i8>summary_short_domain_requests</i8>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/stats/projects/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=summary_snapshot
result_1=summary_conversions
result_2=summary_commissions
result_3=summary_ctas
result_4=summary_cta_forms
result_5=summary_cta_social_connects
result_6=summary_clicks_to_destination
result_7=summary_external_apis
result_8=summary_short_domain_requests
Example 12 (plain)
Request
https://joturl.com/a/i1/stats/projects/info?format=plain
Query parameters
format = plain
Response
summary_snapshot
summary_conversions
summary_commissions
summary_ctas
summary_cta_forms
summary_cta_social_connects
summary_clicks_to_destination
summary_external_apis
summary_short_domain_requests
Optional parameters
parameter | description |
---|---|
project_idID | ID of the project for which to extract statistics |
url_idID | ID of the tracking link for which to extract statistics |
Return values
parameter | description |
---|---|
data | array of available charts for the given project_id and url_id |
/subusers
/subusers/accounts
/subusers/accounts/count
access: [READ]
This method returns the number of accounts associated with the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/accounts/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/accounts/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/accounts/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/accounts/count?format=plain
Query parameters
format = plain
Response
2
Optional parameters
parameter | description |
---|---|
searchSTRING | filters associated accounts to be extracted by searching them |
Return values
parameter | description |
---|---|
count | total number of associated accounts (filtered by parameter search) |
/subusers/accounts/list
access: [READ]
This method returns a list of accounts associated with the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/accounts/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"id": "2c70e53993b40c33b9fab5c3758479b7",
"current": 1,
"full_name": "Jon Smith",
"email": "jon.smith.418@example.com",
"short_name": "JS",
"is_readonly": 0,
"is_subuser": 0,
"parent_full_name": "",
"parent_short_name": "",
"has_access_to_dashboard": 1,
"creation": "2027-02-18 13:18:50",
"domains": []
},
{
"id": "b0446f87fec82dd1cbbeac1fa8969cc1",
"current": 0,
"full_name": "Jon Smith (subuser)",
"email": "jon.smith.418@example.com",
"short_name": "JS",
"is_readonly": 0,
"is_subuser": 1,
"parent_full_name": "Maria Garcia",
"parent_short_name": "MG",
"has_access_to_dashboard": 0,
"creation": "2026-07-04 13:18:50",
"domains": [
"my.custom.domain"
]
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/accounts/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<id>2c70e53993b40c33b9fab5c3758479b7</id>
<current>1</current>
<full_name>Jon Smith</full_name>
<email>jon.smith.418@example.com</email>
<short_name>JS</short_name>
<is_readonly>0</is_readonly>
<is_subuser>0</is_subuser>
<parent_full_name></parent_full_name>
<parent_short_name></parent_short_name>
<has_access_to_dashboard>1</has_access_to_dashboard>
<creation>2027-02-18 13:18:50</creation>
<domains>
</domains>
</i0>
<i1>
<id>b0446f87fec82dd1cbbeac1fa8969cc1</id>
<current>0</current>
<full_name>Jon Smith (subuser)</full_name>
<email>jon.smith.418@example.com</email>
<short_name>JS</short_name>
<is_readonly>0</is_readonly>
<is_subuser>1</is_subuser>
<parent_full_name>Maria Garcia</parent_full_name>
<parent_short_name>MG</parent_short_name>
<has_access_to_dashboard>0</has_access_to_dashboard>
<creation>2026-07-04 13:18:50</creation>
<domains>
<i0>my.custom.domain</i0>
</domains>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/accounts/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=2c70e53993b40c33b9fab5c3758479b7
result_data_0_current=1
result_data_0_full_name=Jon Smith
result_data_0_email=jon.smith.418@example.com
result_data_0_short_name=JS
result_data_0_is_readonly=0
result_data_0_is_subuser=0
result_data_0_parent_full_name=
result_data_0_parent_short_name=
result_data_0_has_access_to_dashboard=1
result_data_0_creation=2027-02-18 13:18:50
result_data_0_domains=
result_data_1_id=b0446f87fec82dd1cbbeac1fa8969cc1
result_data_1_current=0
result_data_1_full_name=Jon Smith (subuser)
result_data_1_email=jon.smith.418@example.com
result_data_1_short_name=JS
result_data_1_is_readonly=0
result_data_1_is_subuser=1
result_data_1_parent_full_name=Maria Garcia
result_data_1_parent_short_name=MG
result_data_1_has_access_to_dashboard=0
result_data_1_creation=2026-07-04 13:18:50
result_data_1_domains_0=my.custom.domain
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/accounts/list?format=plain
Query parameters
format = plain
Response
2
2c70e53993b40c33b9fab5c3758479b7
1
Jon Smith
jon.smith.418@example.com
JS
0
0
1
2027-02-18 13:18:50
b0446f87fec82dd1cbbeac1fa8969cc1
0
Jon Smith (subuser)
jon.smith.418@example.com
JS
0
1
Maria Garcia
MG
0
2026-07-04 13:18:50
my.custom.domain
Optional parameters
parameter | description |
---|---|
searchSTRING | filters associated accounts to be extracted by searching them |
Return values
parameter | description |
---|---|
count | total number of associated accounts (filtered by parameter search) |
data | array containing information on the associated accounts |
/subusers/accounts/swap
access: [READ]
This method allows the logged in user to access another account to which he/she has access.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/accounts/swap?id=2aa5fb3a4984bdcada7d5654af4dcf12
Query parameters
id = 2aa5fb3a4984bdcada7d5654af4dcf12
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"logged": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/accounts/swap?id=2aa5fb3a4984bdcada7d5654af4dcf12&format=xml
Query parameters
id = 2aa5fb3a4984bdcada7d5654af4dcf12
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<logged>1</logged>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/accounts/swap?id=2aa5fb3a4984bdcada7d5654af4dcf12&format=txt
Query parameters
id = 2aa5fb3a4984bdcada7d5654af4dcf12
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_logged=1
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/accounts/swap?id=2aa5fb3a4984bdcada7d5654af4dcf12&format=plain
Query parameters
id = 2aa5fb3a4984bdcada7d5654af4dcf12
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idSTRING | ID of the account to swap to, this ID can be obtained by calling i1/subusers/accounts/list |
Return values
parameter | description |
---|---|
logged | 1 on success, an invalid parameter error otherwise |
/subusers/add
access: [WRITE]
This method adds a new team member.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member
Query parameters
email = email.of@the.team.member
full_name = full name of the team member
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"email": "email.of@the.team.member",
"full_name": "full name of the team member",
"added": "1 on success, 0 otherwise",
"id": "779024109eaf0fcf40e12ce45325556e",
"level": 5,
"gender": "m",
"role": "",
"group": "",
"creation": "2025-05-11 13:18:50",
"is_readonly": 0,
"is_confirmed": 0,
"permission_id": null,
"permission_name": null,
"is_alias": 0,
"alias_email": "",
"alias_full_name": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=xml
Query parameters
email = email.of@the.team.member
full_name = full name of the team member
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<email>email.of@the.team.member</email>
<full_name>full name of the team member</full_name>
<added>1 on success, 0 otherwise</added>
<id>779024109eaf0fcf40e12ce45325556e</id>
<level>5</level>
<gender>m</gender>
<role></role>
<group></group>
<creation>2025-05-11 13:18:50</creation>
<is_readonly>0</is_readonly>
<is_confirmed>0</is_confirmed>
<permission_id></permission_id>
<permission_name></permission_name>
<is_alias>0</is_alias>
<alias_email></alias_email>
<alias_full_name></alias_full_name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=txt
Query parameters
email = email.of@the.team.member
full_name = full name of the team member
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_email=email.of@the.team.member
result_full_name=full name of the team member
result_added=1 on success, 0 otherwise
result_id=779024109eaf0fcf40e12ce45325556e
result_level=5
result_gender=m
result_role=
result_group=
result_creation=2025-05-11 13:18:50
result_is_readonly=0
result_is_confirmed=0
result_permission_id=
result_permission_name=
result_is_alias=0
result_alias_email=
result_alias_full_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/add?email=email.of%40the.team.member&full_name=full+name+of+the+team+member&format=plain
Query parameters
email = email.of@the.team.member
full_name = full name of the team member
format = plain
Response
email.of@the.team.member
full name of the team member
1 on success, 0 otherwise
779024109eaf0fcf40e12ce45325556e
5
m
2025-05-11 13:18:50
0
0
0
Required parameters
parameter | description | max length |
---|---|---|
emailSTRING | email address of the team member | 255 |
full_nameSTRING | full name of the team member | 255 |
Optional parameters
parameter | description | max length |
---|---|---|
genderSTRING | gender of the team member, possible values: [m, f], default: m | 1 |
groupSTRING | group of the team member | 50 |
is_aliasBOOLEAN | 1 if the user has full access to the account of the user who created it | |
is_readonlyBOOLEAN | 1 if the team member can only read information | |
locationSTRING | 2-digit code of the country (ISO Alpha-2) the team member is based on (e.g., US) | 50 |
permission_idID | ID of the subuser permission (can only be passed by administrator/root users) | |
phone_numberSTRING | phone number | 255 |
roleSTRING | role of the team member | 50 |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
alias_email | email of the alias user if is_alias = 1 , empty othrwise |
alias_full_name | full name of the alias user if is_alias = 1 , empty othrwise |
creation | creation date/time |
echo back of the email input parameter | |
full_name | echo back of the full_name input parameter |
gender | echo back of the gender input parameter |
group | echo back of the group input parameter |
id | ID of the team member |
is_alias | echo back of the is_alias input parameter |
is_confirmed | 1 if the team member confirmed the account by clicking on the confirmation link sent by email, 0 otherwise. The return value is always 0 when adding a new team member. Read the note below for details. |
is_readonly | echo back of the is_readonly input parameter |
level | level of the team member (level represents the user hierarchy, parent users have a lower level than childrens) |
permission_id | ID of the subuser permission (only returned for administrator/root users) |
permission_name | name of the subuser permission (only returned for administrator/root users) |
role | echo back of the role input parameter |
/subusers/count
access: [READ]
This method returns the number of team members.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/count?format=plain
Query parameters
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
searchSTRING | filters team members to be extracted by searching them |
with_projectsBOOLEAN | 1 to count only team members who created projects still present in the dashboard, 0 otherwise (default) |
Return values
parameter | description |
---|---|
count | the number of team members |
/subusers/delete
access: [WRITE]
This method deletes a team member.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/delete?ids=b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae
Query parameters
ids = b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/delete?ids=b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae&format=xml
Query parameters
ids = b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>5</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/delete?ids=b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae&format=txt
Query parameters
ids = b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=5
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/delete?ids=b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae&format=plain
Query parameters
ids = b455044d535d5da15df4ed4b094d9bd7,7e00b6b7b76a74c6d594fdf3182c4b79,da55ec409b7bab24bf8bcc86875ff79c,96fa37f76096dbd7a458f5f94cdf03e7,163c15a78fcd0e817f2e87ff44445dae
format = plain
Response
5
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of team members to remove |
Return values
parameter | description |
---|---|
deleted | number of deleted team members on success, 0 otherwise |
/subusers/edit
access: [WRITE]
This method edits a team member.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member
Query parameters
full_name = new full name of the team member
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"full_name": "new full name of the team member",
"updated": "1 on success, 0 otherwise",
"id": "ca0eaedadd50422a725cc686606777c1",
"is_alias": 0,
"alias_email": "",
"alias_full_name": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=xml
Query parameters
full_name = new full name of the team member
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<full_name>new full name of the team member</full_name>
<updated>1 on success, 0 otherwise</updated>
<id>ca0eaedadd50422a725cc686606777c1</id>
<is_alias>0</is_alias>
<alias_email></alias_email>
<alias_full_name></alias_full_name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=txt
Query parameters
full_name = new full name of the team member
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_full_name=new full name of the team member
result_updated=1 on success, 0 otherwise
result_id=ca0eaedadd50422a725cc686606777c1
result_is_alias=0
result_alias_email=
result_alias_full_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/edit?full_name=new+full+name+of+the+team+member&format=plain
Query parameters
full_name = new full name of the team member
format = plain
Response
new full name of the team member
1 on success, 0 otherwise
ca0eaedadd50422a725cc686606777c1
0
Required parameters
parameter | description |
---|---|
idID | ID of the team member |
Optional parameters
parameter | description | max length |
---|---|---|
full_nameSTRING | full name of the team member | 255 |
genderSTRING | gender of the team member, possible values: [m, f], default: m | 1 |
groupSTRING | group of the team member | 50 |
is_aliasBOOLEAN | 1 if the user has full access to the account of the user who created it | |
is_confirmedBOOLEAN | 1 to enable the team member, 0 to disable | |
is_readonlyBOOLEAN | 1 if the team member can only read information | |
locationSTRING | 2-digit code of the country (ISO Alpha-2) the team member is based on (e.g., US) | 50 |
permission_idID | ID of the subuser permission (can only be passed by administrator/root users) | |
phone_numberSTRING | phone number | 255 |
roleSTRING | role of the team member | 50 |
Return values
parameter | description |
---|---|
alias_email | email of the alias user if is_alias = 1 , empty otherwise |
alias_full_name | full name of the alias user if is_alias = 1 , empty otherwise |
creation | [OPTIONAL] creation date/time |
full_name | [OPTIONAL] echo back of the full_name input parameter |
gender | [OPTIONAL] echo back of the gender input parameter |
group | [OPTIONAL] echo back of the group input parameter |
id | ID of the team member |
is_alias | echo back of the is_alias input parameter |
is_readonly | [OPTIONAL] echo back of the is_readonly input parameter |
location | [OPTIONAL] echo back of the location input parameter |
permission_id | ID of the subuser permission (only returned for administrator/root users) |
permission_name | name of the subuser permission (only returned for administrator/root users) |
phone_number | [OPTIONAL] echo back of the phone_number input parameter |
role | [OPTIONAL] echo back of the role input parameter |
updated | 1 on success, 0 otherwise |
/subusers/info
access: [READ]
This method returns info about a team member.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/info?fields=id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=a31cb5629ac446e2ea133181126d1a33
Query parameters
fields = id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
id = a31cb5629ac446e2ea133181126d1a33
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "a31cb5629ac446e2ea133181126d1a33",
"level": 1,
"email": "email.of@the.team.member",
"full_name": "full name of the team member",
"group": "",
"role": "Tester",
"is_readonly": 0,
"last_login": "2025-05-11 13:18:50",
"is_confirmed": 1,
"permission_id": "789bf92ca645416f4786ccc9fdf898d5",
"permission_name": "permission name",
"is_alias": 0,
"alias_email": "",
"alias_full_name": ""
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/info?fields=id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=a31cb5629ac446e2ea133181126d1a33&format=xml
Query parameters
fields = id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
id = a31cb5629ac446e2ea133181126d1a33
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>a31cb5629ac446e2ea133181126d1a33</id>
<level>1</level>
<email>email.of@the.team.member</email>
<full_name>full name of the team member</full_name>
<group></group>
<role>Tester</role>
<is_readonly>0</is_readonly>
<last_login>2025-05-11 13:18:50</last_login>
<is_confirmed>1</is_confirmed>
<permission_id>789bf92ca645416f4786ccc9fdf898d5</permission_id>
<permission_name>permission name</permission_name>
<is_alias>0</is_alias>
<alias_email></alias_email>
<alias_full_name></alias_full_name>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/info?fields=id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=a31cb5629ac446e2ea133181126d1a33&format=txt
Query parameters
fields = id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
id = a31cb5629ac446e2ea133181126d1a33
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=a31cb5629ac446e2ea133181126d1a33
result_data_0_level=1
result_data_0_email=email.of@the.team.member
result_data_0_full_name=full name of the team member
result_data_0_group=
result_data_0_role=Tester
result_data_0_is_readonly=0
result_data_0_last_login=2025-05-11 13:18:50
result_data_0_is_confirmed=1
result_data_0_permission_id=789bf92ca645416f4786ccc9fdf898d5
result_data_0_permission_name=permission name
result_data_0_is_alias=0
result_data_0_alias_email=
result_data_0_alias_full_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/info?fields=id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&id=a31cb5629ac446e2ea133181126d1a33&format=plain
Query parameters
fields = id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
id = a31cb5629ac446e2ea133181126d1a33
format = plain
Response
a31cb5629ac446e2ea133181126d1a33
1
email.of@the.team.member
full name of the team member
Tester
0
2025-05-11 13:18:50
1
789bf92ca645416f4786ccc9fdf898d5
permission name
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role |
idID | ID of the team member |
Return values
parameter | description |
---|---|
data | array containing information on the team members, returned information depends on the fields parameter. |
/subusers/list
access: [READ]
This method returns a list of team members.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/list?fields=count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
Query parameters
fields = count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "a9c9e2b4a563c35887ea2b895583cbec",
"level": 1,
"email": "email.of@the.team.member",
"full_name": "full name of the team member",
"group": "",
"role": "Tester",
"is_readonly": 0,
"last_login": "2025-05-11 13:18:50",
"is_confirmed": 1,
"permission_id": "33658fabb6086a71f237e129074c6211",
"permission_name": "permission name",
"is_alias": 0,
"alias_email": "",
"alias_full_name": ""
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/list?fields=count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=xml
Query parameters
fields = count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>a9c9e2b4a563c35887ea2b895583cbec</id>
<level>1</level>
<email>email.of@the.team.member</email>
<full_name>full name of the team member</full_name>
<group></group>
<role>Tester</role>
<is_readonly>0</is_readonly>
<last_login>2025-05-11 13:18:50</last_login>
<is_confirmed>1</is_confirmed>
<permission_id>33658fabb6086a71f237e129074c6211</permission_id>
<permission_name>permission name</permission_name>
<is_alias>0</is_alias>
<alias_email></alias_email>
<alias_full_name></alias_full_name>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/list?fields=count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=txt
Query parameters
fields = count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=a9c9e2b4a563c35887ea2b895583cbec
result_data_0_level=1
result_data_0_email=email.of@the.team.member
result_data_0_full_name=full name of the team member
result_data_0_group=
result_data_0_role=Tester
result_data_0_is_readonly=0
result_data_0_last_login=2025-05-11 13:18:50
result_data_0_is_confirmed=1
result_data_0_permission_id=33658fabb6086a71f237e129074c6211
result_data_0_permission_name=permission name
result_data_0_is_alias=0
result_data_0_alias_email=
result_data_0_alias_full_name=
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/list?fields=count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias&format=plain
Query parameters
fields = count,id,level,email,full_name,group,role,is_readonly,last_login,is_confirmed,permission_id,permission_name,is_alias
format = plain
Response
1
a9c9e2b4a563c35887ea2b895583cbec
1
email.of@the.team.member
full name of the team member
Tester
0
2025-05-11 13:18:50
1
33658fabb6086a71f237e129074c6211
permission name
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of team members (maxmimum allowed: 100) |
orderbyARRAY | orders team members by field, available fields: is_confirmed, creation, email, full_name, gender, group, id, is_readonly, last_login, level, location, name, phone_number, role |
project_idID | ID of the project, when passed the field has_access is returned for each team member, has_access = 1 if the team member has access to the project, has_access = 0 otherwise |
searchSTRING | filters team members to be extracted by searching them |
sortSTRING | sorts team members in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract team members from this position |
with_projectsBOOLEAN | 1 to extract only team members who created projects still present in the dashboard, 0 otherwise (default) |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of team members, returned only if count is passed in fields |
data | array containing information on the team members, returned information depends on the fields parameter. |
/subusers/projects
/subusers/projects/grant
access: [WRITE]
Grants access to projects to the team member.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/projects/grant?id=b90e595ac7814358025fc4fd70f076bb&add_ids=d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a&delete_ids=bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836
Query parameters
id = b90e595ac7814358025fc4fd70f076bb
add_ids = d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a
delete_ids = bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 3,
"deleted": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/projects/grant?id=b90e595ac7814358025fc4fd70f076bb&add_ids=d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a&delete_ids=bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836&format=xml
Query parameters
id = b90e595ac7814358025fc4fd70f076bb
add_ids = d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a
delete_ids = bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>3</added>
<deleted>5</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/projects/grant?id=b90e595ac7814358025fc4fd70f076bb&add_ids=d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a&delete_ids=bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836&format=txt
Query parameters
id = b90e595ac7814358025fc4fd70f076bb
add_ids = d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a
delete_ids = bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3
result_deleted=5
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/projects/grant?id=b90e595ac7814358025fc4fd70f076bb&add_ids=d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a&delete_ids=bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836&format=plain
Query parameters
id = b90e595ac7814358025fc4fd70f076bb
add_ids = d81f468d5fd8c8cc71056cf3055d4373,ed3427227ce762f7cdce2c63dd06ef1b,2c0222e9c5ebd5c0492c217da67c149a
delete_ids = bd93992d9e80acb81a45dce6b41d4b9c,7c4051b95e023f94aedb55cce234f65e,3c927ba82997b35c09b293d862e4f1a7,e39bfd17dd1a5305ab6bf7b551bb1836,43350ae6aeab972d1c3d3cce95b19836
format = plain
Response
3
5
Required parameters
parameter | description |
---|---|
idID | ID of the team member |
Optional parameters
parameter | description |
---|---|
add_idsARRAY_OF_IDS | comma separated list of project IDs to grant access to the team member |
delete_idsARRAY_OF_IDS | comma-separated list of project IDs to deny access to the team member |
Return values
parameter | description |
---|---|
added | number of project IDs that the team member has been granted access to |
deleted | number of project IDs that the team member was denied access to |
/subusers/roles_groups
/subusers/roles_groups/list
access: [READ]
This method returns a list of roles or groups previously used.
Example 1 (json)
Request
https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test
Query parameters
type = role
search = test
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
"test",
"Tester",
"main tester"
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=xml
Query parameters
type = role
search = test
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>test</i0>
<i1>Tester</i1>
<i2>main tester</i2>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=txt
Query parameters
type = role
search = test
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0=test
result_1=Tester
result_2=main tester
Example 4 (plain)
Request
https://joturl.com/a/i1/subusers/roles_groups/list?type=role&search=test&format=plain
Query parameters
type = role
search = test
format = plain
Response
test
Tester
main tester
Required parameters
parameter | description |
---|---|
typeSTRING | type to list, available types: [role, group] |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of roles &amp; groups (maxmimum allowed: 100) |
searchSTRING | filters roles &amp; groups to be extracted by searching them |
startINTEGER | starts to extract roles &amp; groups from this position |
Return values
parameter | description |
---|---|
[ARRAY] | array containing requested information. |
/urls
/urls/balancers
/urls/balancers/clone
access: [WRITE]
Clone the balancer configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/balancers/clone?from_url_id=39285b6ec88988e706b21ba6733c8210&to_url_id=0cc031b7704e47c0a5c4040817140dd6
Query parameters
from_url_id = 39285b6ec88988e706b21ba6733c8210
to_url_id = 0cc031b7704e47c0a5c4040817140dd6
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/balancers/clone?from_url_id=39285b6ec88988e706b21ba6733c8210&to_url_id=0cc031b7704e47c0a5c4040817140dd6&format=xml
Query parameters
from_url_id = 39285b6ec88988e706b21ba6733c8210
to_url_id = 0cc031b7704e47c0a5c4040817140dd6
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/balancers/clone?from_url_id=39285b6ec88988e706b21ba6733c8210&to_url_id=0cc031b7704e47c0a5c4040817140dd6&format=txt
Query parameters
from_url_id = 39285b6ec88988e706b21ba6733c8210
to_url_id = 0cc031b7704e47c0a5c4040817140dd6
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/balancers/clone?from_url_id=39285b6ec88988e706b21ba6733c8210&to_url_id=0cc031b7704e47c0a5c4040817140dd6&format=plain
Query parameters
from_url_id = 39285b6ec88988e706b21ba6733c8210
to_url_id = 0cc031b7704e47c0a5c4040817140dd6
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the balancer configuration from |
to_url_idID | ID of the tracking link you want to copy the balancer configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/balancers/delete
access: [WRITE]
Delete the smart balancer linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/balancers/delete?id=efdaa4c6b3a5e1ca28532ad78ff06905
Query parameters
id = efdaa4c6b3a5e1ca28532ad78ff06905
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/balancers/delete?id=efdaa4c6b3a5e1ca28532ad78ff06905&format=xml
Query parameters
id = efdaa4c6b3a5e1ca28532ad78ff06905
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/balancers/delete?id=efdaa4c6b3a5e1ca28532ad78ff06905&format=txt
Query parameters
id = efdaa4c6b3a5e1ca28532ad78ff06905
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/balancers/delete?id=efdaa4c6b3a5e1ca28532ad78ff06905&format=plain
Query parameters
id = efdaa4c6b3a5e1ca28532ad78ff06905
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove the balancer |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/balancers/edit
access: [WRITE]
Set the smart balancer for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/balancers/edit?id=66105f26e6095e8f95fd2e31c62cca7c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D
Query parameters
id = 66105f26e6095e8f95fd2e31c62cca7c
type = WEIGHTED
urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/balancers/edit?id=66105f26e6095e8f95fd2e31c62cca7c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=xml
Query parameters
id = 66105f26e6095e8f95fd2e31c62cca7c
type = WEIGHTED
urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/balancers/edit?id=66105f26e6095e8f95fd2e31c62cca7c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=txt
Query parameters
id = 66105f26e6095e8f95fd2e31c62cca7c
type = WEIGHTED
urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/balancers/edit?id=66105f26e6095e8f95fd2e31c62cca7c&type=WEIGHTED&urls=%5B%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2Fpricing%5C%2F%22,%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%22%5D&weights=%5B22.22,77.78%5D&format=plain
Query parameters
id = 66105f26e6095e8f95fd2e31c62cca7c
type = WEIGHTED
urls = ["https:\/\/www.joturl.com\/pricing\/","https:\/\/www.joturl.com\/"]
weights = [22.22,77.78]
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link on which to enable the balancer |
typeSTRING | balancer type, available types: SEQUENTIAL, WEIGHTED, WEIGHTED_FIXED, RANDOM, RANDOM_FIXED, SWITCHING, SPLIT_TEST |
urlsJSON | JSON array of destination URLs to be used with the balancer, a maximum of 5 destination URLs can be used when type = SPLIT_TEST , otherwise a maximum of 100 destination URLs is allowed |
Optional parameters
parameter | description |
---|---|
conversionsARRAY_OF_IDS | conversion codes to be used when type = SPLIT_TEST |
weightsJSON | JSON array of floats between 0.0 and 100.0, the balancer will use these floats to randomly select destination URLs, this parameter is mandatory for type = WEIGHTED and type = WEIGHTED_FIXED , it must contain the same number of items in urls |
Return values
parameter | description |
---|---|
enabled | 1 on success, 0 otherwise |
/urls/balancers/info
access: [READ]
Get the smart balancer linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/balancers/info?id=32a36293386d8b6310e1fe77a76d514a
Query parameters
id = 32a36293386d8b6310e1fe77a76d514a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "32a36293386d8b6310e1fe77a76d514a",
"type": "WEIGHTED",
"info": [
{
"url": "https:\/\/www.joturl.com\/pricing\/",
"weight": "22.22"
},
{
"url": "https:\/\/www.joturl.com\/",
"weight": "77.78"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/balancers/info?id=32a36293386d8b6310e1fe77a76d514a&format=xml
Query parameters
id = 32a36293386d8b6310e1fe77a76d514a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>32a36293386d8b6310e1fe77a76d514a</id>
<type>WEIGHTED</type>
<info>
<i0>
<url>https://www.joturl.com/pricing/</url>
<weight>22.22</weight>
</i0>
<i1>
<url>https://www.joturl.com/</url>
<weight>77.78</weight>
</i1>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/balancers/info?id=32a36293386d8b6310e1fe77a76d514a&format=txt
Query parameters
id = 32a36293386d8b6310e1fe77a76d514a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=32a36293386d8b6310e1fe77a76d514a
result_type=WEIGHTED
result_info_0_url=https://www.joturl.com/pricing/
result_info_0_weight=22.22
result_info_1_url=https://www.joturl.com/
result_info_1_weight=77.78
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/balancers/info?id=32a36293386d8b6310e1fe77a76d514a&format=plain
Query parameters
id = 32a36293386d8b6310e1fe77a76d514a
format = plain
Response
32a36293386d8b6310e1fe77a76d514a
WEIGHTED
https://www.joturl.com/pricing/
22.22
https://www.joturl.com/
77.78
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link whose balancer configuration is desired |
Return values
parameter | description |
---|---|
id | echo back of parameter id |
info | array of couples (url, weight) |
type | balancer type, see i1/urls/balancers/edit for details |
/urls/balancers/property
access: [READ]
This method returns smart balancer types that are available to the logged users.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/balancers/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"types": {
"SEQUENTIAL": {
"is_split": 0
},
"WEIGHTED": {
"is_split": 0
},
"WEIGHTED_FIXED": {
"is_split": 0
},
"RANDOM": {
"is_split": 0
},
"RANDOM_FIXED": {
"is_split": 0
},
"SWITCHING": {
"is_split": 0
},
"SPLIT_TEST": {
"is_split": 1
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/balancers/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<types>
<SEQUENTIAL>
<is_split>0</is_split>
</SEQUENTIAL>
<WEIGHTED>
<is_split>0</is_split>
</WEIGHTED>
<WEIGHTED_FIXED>
<is_split>0</is_split>
</WEIGHTED_FIXED>
<RANDOM>
<is_split>0</is_split>
</RANDOM>
<RANDOM_FIXED>
<is_split>0</is_split>
</RANDOM_FIXED>
<SWITCHING>
<is_split>0</is_split>
</SWITCHING>
<SPLIT_TEST>
<is_split>1</is_split>
</SPLIT_TEST>
</types>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/balancers/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_types_SEQUENTIAL_is_split=0
result_types_WEIGHTED_is_split=0
result_types_WEIGHTED_FIXED_is_split=0
result_types_RANDOM_is_split=0
result_types_RANDOM_FIXED_is_split=0
result_types_SWITCHING_is_split=0
result_types_SPLIT_TEST_is_split=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/balancers/property?format=plain
Query parameters
format = plain
Response
0
0
0
0
0
0
1
Return values
parameter | description |
---|---|
types | array of smart balancer types |
/urls/cloaking
/urls/cloaking/clone
access: [WRITE]
Clone a cloaking configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=03e2742269d89d5804b1f47168fbedff&to_url_id=f5354f0638c5edbc92d971b5d1d0fe39
Query parameters
from_url_id = 03e2742269d89d5804b1f47168fbedff
to_url_id = f5354f0638c5edbc92d971b5d1d0fe39
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=03e2742269d89d5804b1f47168fbedff&to_url_id=f5354f0638c5edbc92d971b5d1d0fe39&format=xml
Query parameters
from_url_id = 03e2742269d89d5804b1f47168fbedff
to_url_id = f5354f0638c5edbc92d971b5d1d0fe39
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=03e2742269d89d5804b1f47168fbedff&to_url_id=f5354f0638c5edbc92d971b5d1d0fe39&format=txt
Query parameters
from_url_id = 03e2742269d89d5804b1f47168fbedff
to_url_id = f5354f0638c5edbc92d971b5d1d0fe39
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/clone?from_url_id=03e2742269d89d5804b1f47168fbedff&to_url_id=f5354f0638c5edbc92d971b5d1d0fe39&format=plain
Query parameters
from_url_id = 03e2742269d89d5804b1f47168fbedff
to_url_id = f5354f0638c5edbc92d971b5d1d0fe39
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy cloaking configuration from |
to_url_idID | ID of the tracking link you want to copy cloaking configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/cloaking/delete
access: [WRITE]
Delete the cloaking configuration of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/cloaking/delete?id=1cfad8e79022b8322c6e6d912ee78047
Query parameters
id = 1cfad8e79022b8322c6e6d912ee78047
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/delete?id=1cfad8e79022b8322c6e6d912ee78047&format=xml
Query parameters
id = 1cfad8e79022b8322c6e6d912ee78047
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/delete?id=1cfad8e79022b8322c6e6d912ee78047&format=txt
Query parameters
id = 1cfad8e79022b8322c6e6d912ee78047
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/delete?id=1cfad8e79022b8322c6e6d912ee78047&format=plain
Query parameters
id = 1cfad8e79022b8322c6e6d912ee78047
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a cloaking configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/cloaking/edit
access: [WRITE]
Given the ID of a tracking link, sets a cloaking configuration.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=34671aced52c673e1779b1b0058bb70c&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D
Query parameters
id = 34671aced52c673e1779b1b0058bb70c
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=34671aced52c673e1779b1b0058bb70c&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=xml
Query parameters
id = 34671aced52c673e1779b1b0058bb70c
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=34671aced52c673e1779b1b0058bb70c&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=txt
Query parameters
id = 34671aced52c673e1779b1b0058bb70c
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=34671aced52c673e1779b1b0058bb70c&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Atrue%7D,%22desktop_devices%22%3A%7B%22block%22%3Atrue%7D,%22mobile_devices%22%3A%7B%22block%22%3Afalse%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22deny_all_except%22,%22list%22%3A%5B%22IT%22,%22US%22,%22FR%22%5D%7D%7D&format=plain
Query parameters
id = 34671aced52c673e1779b1b0058bb70c
settings = {"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
format = plain
Response
1
Example 5 (json)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=42b3fe1751f9517a2dcf46681a403c04&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D
Query parameters
id = 42b3fe1751f9517a2dcf46681a403c04
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=42b3fe1751f9517a2dcf46681a403c04&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=xml
Query parameters
id = 42b3fe1751f9517a2dcf46681a403c04
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=42b3fe1751f9517a2dcf46681a403c04&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=txt
Query parameters
id = 42b3fe1751f9517a2dcf46681a403c04
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/edit?id=42b3fe1751f9517a2dcf46681a403c04&settings=%7B%22block_url%22%3A%22https%3A%5C%2F%5C%2Fwww.amazon.com%5C%2F%22,%22corporate_ips_and_bots%22%3A%7B%22block%22%3Afalse%7D,%22desktop_devices%22%3A%7B%22block%22%3Afalse%7D,%22mobile_devices%22%3A%7B%22block%22%3Atrue,%22redirect_to%22%3A%22https%3A%5C%2F%5C%2Fwww.google.com%5C%2F%22%7D,%22countries%22%3A%7B%22block%22%3Atrue,%22mode%22%3A%22allow_all_except%22,%22list%22%3A%5B%22NL%22,%22ES%22%5D%7D%7D&format=plain
Query parameters
id = 42b3fe1751f9517a2dcf46681a403c04
settings = {"block_url":"https:\/\/www.amazon.com\/","corporate_ips_and_bots":{"block":false},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.google.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
settingsJSON | stringified JSON of the cloaking configuration, see i1/urls/cloaking/info for details |
Return values
parameter | description |
---|---|
enabled | 1 if the cloaking option has been successfully enabled, 0 otherwise |
/urls/cloaking/info
access: [READ]
Returns information on the cloaking configuration.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9f795b0ba46b2e283a63ff47eb494cba
Query parameters
id = 9f795b0ba46b2e283a63ff47eb494cba
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "9f795b0ba46b2e283a63ff47eb494cba",
"settings": "{\"block_url\":\"https:\\\/\\\/www.google.com\\\/\",\"corporate_ips_and_bots\":{\"block\":true},\"desktop_devices\":{\"block\":true},\"mobile_devices\":{\"block\":false},\"countries\":{\"block\":true,\"mode\":\"deny_all_except\",\"list\":[\"IT\",\"US\",\"FR\"]}}"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9f795b0ba46b2e283a63ff47eb494cba&format=xml
Query parameters
id = 9f795b0ba46b2e283a63ff47eb494cba
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>9f795b0ba46b2e283a63ff47eb494cba</id>
<settings>{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}</settings>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9f795b0ba46b2e283a63ff47eb494cba&format=txt
Query parameters
id = 9f795b0ba46b2e283a63ff47eb494cba
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=9f795b0ba46b2e283a63ff47eb494cba
result_settings={"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9f795b0ba46b2e283a63ff47eb494cba&format=plain
Query parameters
id = 9f795b0ba46b2e283a63ff47eb494cba
format = plain
Response
9f795b0ba46b2e283a63ff47eb494cba
{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":true},"mobile_devices":{"block":false},"countries":{"block":true,"mode":"deny_all_except","list":["IT","US","FR"]}}
Example 5 (json)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9ba63f5842895b66ac02cf6a2c1e2070
Query parameters
id = 9ba63f5842895b66ac02cf6a2c1e2070
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "9ba63f5842895b66ac02cf6a2c1e2070",
"settings": "{\"block_url\":\"https:\\\/\\\/www.google.com\\\/\",\"corporate_ips_and_bots\":{\"block\":true},\"desktop_devices\":{\"block\":false},\"mobile_devices\":{\"block\":true,\"redirect_to\":\"https:\\\/\\\/www.amazon.com\\\/\"},\"countries\":{\"block\":true,\"mode\":\"allow_all_except\",\"list\":[\"NL\",\"ES\"]}}"
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9ba63f5842895b66ac02cf6a2c1e2070&format=xml
Query parameters
id = 9ba63f5842895b66ac02cf6a2c1e2070
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>9ba63f5842895b66ac02cf6a2c1e2070</id>
<settings>{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}</settings>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9ba63f5842895b66ac02cf6a2c1e2070&format=txt
Query parameters
id = 9ba63f5842895b66ac02cf6a2c1e2070
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=9ba63f5842895b66ac02cf6a2c1e2070
result_settings={"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/cloaking/info?id=9ba63f5842895b66ac02cf6a2c1e2070&format=plain
Query parameters
id = 9ba63f5842895b66ac02cf6a2c1e2070
format = plain
Response
9ba63f5842895b66ac02cf6a2c1e2070
{"block_url":"https:\/\/www.google.com\/","corporate_ips_and_bots":{"block":true},"desktop_devices":{"block":false},"mobile_devices":{"block":true,"redirect_to":"https:\/\/www.amazon.com\/"},"countries":{"block":true,"mode":"allow_all_except","list":["NL","ES"]}}
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
data | [OPTIONAL] stringified JSON of the cloaking configuration, this parameter is returned only if a cloaking configuration is available for the tracking link |
/urls/clone
access: [WRITE]
This method clones options of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=3042affc0f58c006e236a52455f8814d&alias=2a064ae9&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=f0bf15495d95f473c341c49c8c2fd46f
Query parameters
fields = id,short_url
src_id = 3042affc0f58c006e236a52455f8814d
alias = 2a064ae9
long_url = https://www.joturl.com/
domain_id = f0bf15495d95f473c341c49c8c2fd46f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1,
"added": 0,
"removed": 0,
"failed": [],
"id": "5ac9a02634384b315dce1c8ab825d473",
"short_url": "http:\/\/jo.my\/2a064ae9"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=3042affc0f58c006e236a52455f8814d&alias=2a064ae9&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=f0bf15495d95f473c341c49c8c2fd46f&format=xml
Query parameters
fields = id,short_url
src_id = 3042affc0f58c006e236a52455f8814d
alias = 2a064ae9
long_url = https://www.joturl.com/
domain_id = f0bf15495d95f473c341c49c8c2fd46f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
<added>0</added>
<removed>0</removed>
<failed>
</failed>
<id>5ac9a02634384b315dce1c8ab825d473</id>
<short_url>http://jo.my/2a064ae9</short_url>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=3042affc0f58c006e236a52455f8814d&alias=2a064ae9&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=f0bf15495d95f473c341c49c8c2fd46f&format=txt
Query parameters
fields = id,short_url
src_id = 3042affc0f58c006e236a52455f8814d
alias = 2a064ae9
long_url = https://www.joturl.com/
domain_id = f0bf15495d95f473c341c49c8c2fd46f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
result_added=0
result_removed=0
result_failed=
result_id=5ac9a02634384b315dce1c8ab825d473
result_short_url=http://jo.my/2a064ae9
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/clone?fields=id,short_url&src_id=3042affc0f58c006e236a52455f8814d&alias=2a064ae9&long_url=https%3A%2F%2Fwww.joturl.com%2F&domain_id=f0bf15495d95f473c341c49c8c2fd46f&format=plain
Query parameters
fields = id,short_url
src_id = 3042affc0f58c006e236a52455f8814d
alias = 2a064ae9
long_url = https://www.joturl.com/
domain_id = f0bf15495d95f473c341c49c8c2fd46f
format = plain
Response
http://jo.my/2a064ae9
Required parameters
parameter | description |
---|---|
src_idID | ID of the tracking link to be cloned |
Optional parameters
parameter | description | max length |
---|---|---|
aliasSTRING | alias for the cloned tracking link, see i1/urls/shorten for details | 510 |
domain_idID | ID of the domain for the cloned tracking link, if not specified the domain of the source tracking link will be used | |
dst_idID | ID of the tracking link on which to clone the options | |
fieldsARRAY | comma separated list of fields to return after cloning is complete, see method i1/urls/list for reference. | |
long_urlSTRING | destination URL for the cloned tracking link, not available for tracking pixels, if empty, the destination URL of the source tracking link will be used | 4000 |
notesSTRING | notes for the cloned tracking link | 255 |
project_idID | ID of the project where the cloned tracking link will be put in, if not specified the project of the source tracking link will be used | |
tagsARRAY | comma-separated list of tags for the cloned tracking link |
Return values
parameter | description |
---|---|
[FIELDS] | [OPTIONAL] fields containing information on cloned tracking links, the information returned depends on the fields parameter, no field is returned if the fields parameter is empty. See i1/urls/list for details on fields |
added | total number of options added or changed in the destination tracking link |
cloned | total number of cloned options (removed + added/changed), this parameter can be 0 if the tracking link you cloned has no options, or if an error occurred, in the latter case the parameter failed is not empty |
failed | list of options that could not be added, modified or deleted from the destination tracking link due to an error, this parameter can be empty when the cloned tracking link has no options or when no error occurred during cloning, see i1/urls/options/list for details on returned values |
removed | total number of options removed in the destination tracking link |
/urls/conversions
/urls/conversions/add
access: [WRITE]
Add conversion codes to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/add?url_id=7db6ef8e7ca8758c9dbe1e03bb33fad1&ids=340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37
Query parameters
url_id = 7db6ef8e7ca8758c9dbe1e03bb33fad1
ids = 340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/add?url_id=7db6ef8e7ca8758c9dbe1e03bb33fad1&ids=340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37&format=xml
Query parameters
url_id = 7db6ef8e7ca8758c9dbe1e03bb33fad1
ids = 340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>2</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/add?url_id=7db6ef8e7ca8758c9dbe1e03bb33fad1&ids=340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37&format=txt
Query parameters
url_id = 7db6ef8e7ca8758c9dbe1e03bb33fad1
ids = 340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=2
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/add?url_id=7db6ef8e7ca8758c9dbe1e03bb33fad1&ids=340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37&format=plain
Query parameters
url_id = 7db6ef8e7ca8758c9dbe1e03bb33fad1
ids = 340570960a77251cbf2fc4b13b8d5272,3b00157e1786b1936b73c6494a594e37
format = plain
Response
2
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of conversion codes to add (maxmimum number of conversion codes: 5) |
url_idID | ID of the tracking link to which to add one or more conversion codes |
Return values
parameter | description |
---|---|
added | 0 on error, the number of added conversion codes otherwise |
/urls/conversions/clone
access: [WRITE]
Clone the conversions configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/clone?from_url_id=ffb9978e378db1708edc92c761dab5cf&to_url_id=79307a1b9fcf43b07ad9637b9bb86a9a
Query parameters
from_url_id = ffb9978e378db1708edc92c761dab5cf
to_url_id = 79307a1b9fcf43b07ad9637b9bb86a9a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/clone?from_url_id=ffb9978e378db1708edc92c761dab5cf&to_url_id=79307a1b9fcf43b07ad9637b9bb86a9a&format=xml
Query parameters
from_url_id = ffb9978e378db1708edc92c761dab5cf
to_url_id = 79307a1b9fcf43b07ad9637b9bb86a9a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/clone?from_url_id=ffb9978e378db1708edc92c761dab5cf&to_url_id=79307a1b9fcf43b07ad9637b9bb86a9a&format=txt
Query parameters
from_url_id = ffb9978e378db1708edc92c761dab5cf
to_url_id = 79307a1b9fcf43b07ad9637b9bb86a9a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/clone?from_url_id=ffb9978e378db1708edc92c761dab5cf&to_url_id=79307a1b9fcf43b07ad9637b9bb86a9a&format=plain
Query parameters
from_url_id = ffb9978e378db1708edc92c761dab5cf
to_url_id = 79307a1b9fcf43b07ad9637b9bb86a9a
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the conversions configuration from |
to_url_idID | ID of the tracking link you want to copy the conversions configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/conversions/count
access: [READ]
This method returns the number of conversion codes linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/count?url_id=2ad82143115603ecd1af2144a4e4911b
Query parameters
url_id = 2ad82143115603ecd1af2144a4e4911b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/count?url_id=2ad82143115603ecd1af2144a4e4911b&format=xml
Query parameters
url_id = 2ad82143115603ecd1af2144a4e4911b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/count?url_id=2ad82143115603ecd1af2144a4e4911b&format=txt
Query parameters
url_id = 2ad82143115603ecd1af2144a4e4911b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/count?url_id=2ad82143115603ecd1af2144a4e4911b&format=plain
Query parameters
url_id = 2ad82143115603ecd1af2144a4e4911b
format = plain
Response
5
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link to check |
Return values
parameter | description |
---|---|
count | the number of linked conversion codes |
/urls/conversions/delete
access: [WRITE]
Delete one or more conversion codes linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/delete?url_id=efd10c4665ac242b4caa639a1f577ecb
Query parameters
url_id = efd10c4665ac242b4caa639a1f577ecb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/delete?url_id=efd10c4665ac242b4caa639a1f577ecb&format=xml
Query parameters
url_id = efd10c4665ac242b4caa639a1f577ecb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/delete?url_id=efd10c4665ac242b4caa639a1f577ecb&format=txt
Query parameters
url_id = efd10c4665ac242b4caa639a1f577ecb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/delete?url_id=efd10c4665ac242b4caa639a1f577ecb&format=plain
Query parameters
url_id = efd10c4665ac242b4caa639a1f577ecb
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link from which to remove one or more conversion codes |
Optional parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of conversion codes to remove, if empty all conversion codes will be removed |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/conversions/edit
access: [WRITE]
Edit the list of conversion codes linked to a tracking link (all previous conversion codes are removed).
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/edit?url_id=4b47dbc26887e054863ce3853ecf7ebf&ids=c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
Query parameters
url_id = 4b47dbc26887e054863ce3853ecf7ebf
ids = c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/edit?url_id=4b47dbc26887e054863ce3853ecf7ebf&ids=c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f&format=xml
Query parameters
url_id = 4b47dbc26887e054863ce3853ecf7ebf
ids = c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f</ids>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/edit?url_id=4b47dbc26887e054863ce3853ecf7ebf&ids=c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f&format=txt
Query parameters
url_id = 4b47dbc26887e054863ce3853ecf7ebf
ids = c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/edit?url_id=4b47dbc26887e054863ce3853ecf7ebf&ids=c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f&format=plain
Query parameters
url_id = 4b47dbc26887e054863ce3853ecf7ebf
ids = c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
format = plain
Response
c947a3f3ebcd085d55ada3381b530e3a,001100f98fd0069ac027aac3344953cc,ab6e5b2776a9107a67b2e9534a8d278e,3e118e7efeb6819ceaad73c8b907957f
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of conversion codes to add (maxmimum number of conversion codes: 5) |
url_idID | ID of the tracking link to which to add one or more conversion codes |
Return values
parameter | description |
---|---|
ids | comma-separated list of added conversion codes |
/urls/conversions/list
access: [READ]
This method returns a list of conversion codes linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=4bafc85cfcc7ae64730c81dd3a3c8ccf
Query parameters
fields = count,name,id,enable_postback_url,actual_url_params
url_id = 4bafc85cfcc7ae64730c81dd3a3c8ccf
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3,
"data": [
{
"name": "conversion name 1",
"id": "3406fe8662c2ca2db0b8f21b33d8a478",
"enable_postback_url": 0,
"actual_url_params": ""
},
{
"name": "conversion name 2 (with postback URL enabled)",
"id": "b380e69ee431356d45e062756bd2eff3",
"enable_postback_url": 1,
"actual_url_params": "subid1={:CLICK_ID:}"
},
{
"name": "conversion name 3",
"id": "19528e4727b75c86243565cffbb5ff07",
"enable_postback_url": 0,
"actual_url_params": ""
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=4bafc85cfcc7ae64730c81dd3a3c8ccf&format=xml
Query parameters
fields = count,name,id,enable_postback_url,actual_url_params
url_id = 4bafc85cfcc7ae64730c81dd3a3c8ccf
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
<data>
<i0>
<name>conversion name 1</name>
<id>3406fe8662c2ca2db0b8f21b33d8a478</id>
<enable_postback_url>0</enable_postback_url>
<actual_url_params></actual_url_params>
</i0>
<i1>
<name>conversion name 2 (with postback URL enabled)</name>
<id>b380e69ee431356d45e062756bd2eff3</id>
<enable_postback_url>1</enable_postback_url>
<actual_url_params>subid1={:CLICK_ID:}</actual_url_params>
</i1>
<i2>
<name>conversion name 3</name>
<id>19528e4727b75c86243565cffbb5ff07</id>
<enable_postback_url>0</enable_postback_url>
<actual_url_params></actual_url_params>
</i2>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=4bafc85cfcc7ae64730c81dd3a3c8ccf&format=txt
Query parameters
fields = count,name,id,enable_postback_url,actual_url_params
url_id = 4bafc85cfcc7ae64730c81dd3a3c8ccf
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
result_data_0_name=conversion name 1
result_data_0_id=3406fe8662c2ca2db0b8f21b33d8a478
result_data_0_enable_postback_url=0
result_data_0_actual_url_params=
result_data_1_name=conversion name 2 (with postback URL enabled)
result_data_1_id=b380e69ee431356d45e062756bd2eff3
result_data_1_enable_postback_url=1
result_data_1_actual_url_params=subid1={:CLICK_ID:}
result_data_2_name=conversion name 3
result_data_2_id=19528e4727b75c86243565cffbb5ff07
result_data_2_enable_postback_url=0
result_data_2_actual_url_params=
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/conversions/list?fields=count,name,id,enable_postback_url,actual_url_params&url_id=4bafc85cfcc7ae64730c81dd3a3c8ccf&format=plain
Query parameters
fields = count,name,id,enable_postback_url,actual_url_params
url_id = 4bafc85cfcc7ae64730c81dd3a3c8ccf
format = plain
Response
3
conversion name 1
3406fe8662c2ca2db0b8f21b33d8a478
0
conversion name 2 (with postback URL enabled)
b380e69ee431356d45e062756bd2eff3
1
subid1={:CLICK_ID:}
conversion name 3
19528e4727b75c86243565cffbb5ff07
0
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, name, notes, enable_postback_url, actual_url_params, postback_url_params |
url_idID | ID of the liked tracking link |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of conversion codes (maxmimum allowed: 100) |
orderbyARRAY | orders conversion codes by field, available fields: id, name, notes, enable_postback_url, actual_url_params, postback_url_params |
searchSTRING | filters conversion codes to be extracted by searching them |
sortSTRING | sorts conversion codes in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract conversion codes from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of conversion codes, returned only if count is passed in fields |
data | array containing information on the conversion codes, returned information depends on the fields parameter. |
/urls/count
access: [READ]
This method returns the number of user's urls.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/count?project_id=b4b054abede48dd27dd3d91e109407a7
Query parameters
project_id = b4b054abede48dd27dd3d91e109407a7
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 8162
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/count?project_id=b4b054abede48dd27dd3d91e109407a7&format=xml
Query parameters
project_id = b4b054abede48dd27dd3d91e109407a7
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>8162</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/count?project_id=b4b054abede48dd27dd3d91e109407a7&format=txt
Query parameters
project_id = b4b054abede48dd27dd3d91e109407a7
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8162
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/count?project_id=b4b054abede48dd27dd3d91e109407a7&format=plain
Query parameters
project_id = b4b054abede48dd27dd3d91e109407a7
format = plain
Response
8162
Optional parameters
parameter | description |
---|---|
end_dateDATE | see i1/urls/list for details |
filterSTRING | see i1/urls/list for details |
optionSTRING | see i1/urls/list for details |
project_idID | see i1/urls/list for details |
searchSTRING | see i1/urls/list for details |
start_dateDATE | see i1/urls/list for details |
whereSTRING | see i1/urls/list for details |
with_alertsBOOLEAN | see i1/urls/list for details |
Return values
parameter | description |
---|---|
count | total number of tracking links |
/urls/ctas
/urls/ctas/clone
access: [WRITE]
Clone the CTA configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/clone?from_url_id=395e9163f6e3d6ae0f643dbce890d1c7&to_url_id=a225703790ed53429f0fe55f5174d06c
Query parameters
from_url_id = 395e9163f6e3d6ae0f643dbce890d1c7
to_url_id = a225703790ed53429f0fe55f5174d06c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/clone?from_url_id=395e9163f6e3d6ae0f643dbce890d1c7&to_url_id=a225703790ed53429f0fe55f5174d06c&format=xml
Query parameters
from_url_id = 395e9163f6e3d6ae0f643dbce890d1c7
to_url_id = a225703790ed53429f0fe55f5174d06c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/clone?from_url_id=395e9163f6e3d6ae0f643dbce890d1c7&to_url_id=a225703790ed53429f0fe55f5174d06c&format=txt
Query parameters
from_url_id = 395e9163f6e3d6ae0f643dbce890d1c7
to_url_id = a225703790ed53429f0fe55f5174d06c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/clone?from_url_id=395e9163f6e3d6ae0f643dbce890d1c7&to_url_id=a225703790ed53429f0fe55f5174d06c&format=plain
Query parameters
from_url_id = 395e9163f6e3d6ae0f643dbce890d1c7
to_url_id = a225703790ed53429f0fe55f5174d06c
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the CTA configuration from |
to_url_idID | ID of the tracking link you want to copy the CTA configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/ctas/delete
access: [WRITE]
Unset a call to action for a short URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/delete?url_id=746a4461d1fc0ca005b14aadfd22d0a5
Query parameters
url_id = 746a4461d1fc0ca005b14aadfd22d0a5
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/delete?url_id=746a4461d1fc0ca005b14aadfd22d0a5&format=xml
Query parameters
url_id = 746a4461d1fc0ca005b14aadfd22d0a5
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/delete?url_id=746a4461d1fc0ca005b14aadfd22d0a5&format=txt
Query parameters
url_id = 746a4461d1fc0ca005b14aadfd22d0a5
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/delete?url_id=746a4461d1fc0ca005b14aadfd22d0a5&format=plain
Query parameters
url_id = 746a4461d1fc0ca005b14aadfd22d0a5
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link from which to remove the CTA |
Optional parameters
parameter | description |
---|---|
idID | ID of the CTA to remove |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/ctas/edit
access: [WRITE]
Set a call to action for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/edit?url_id=550400afef3b290e2439a1a247d5c6e7&id=ee7cdf9fda146f2359e53a45dc7a177e
Query parameters
url_id = 550400afef3b290e2439a1a247d5c6e7
id = ee7cdf9fda146f2359e53a45dc7a177e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/edit?url_id=550400afef3b290e2439a1a247d5c6e7&id=ee7cdf9fda146f2359e53a45dc7a177e&format=xml
Query parameters
url_id = 550400afef3b290e2439a1a247d5c6e7
id = ee7cdf9fda146f2359e53a45dc7a177e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/edit?url_id=550400afef3b290e2439a1a247d5c6e7&id=ee7cdf9fda146f2359e53a45dc7a177e&format=txt
Query parameters
url_id = 550400afef3b290e2439a1a247d5c6e7
id = ee7cdf9fda146f2359e53a45dc7a177e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/edit?url_id=550400afef3b290e2439a1a247d5c6e7&id=ee7cdf9fda146f2359e53a45dc7a177e&format=plain
Query parameters
url_id = 550400afef3b290e2439a1a247d5c6e7
id = ee7cdf9fda146f2359e53a45dc7a177e
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the CTA to associate to the tracking link |
url_idID | ID of the tracking link |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/urls/ctas/info
access: [READ]
Get information for a CTA that is linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=7cac145bac823e50f7337bc030e1a578
Query parameters
fields = id,type,name
url_id = 7cac145bac823e50f7337bc030e1a578
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "50d9e3c725956c44bc3305f33047d4fb",
"type": "button",
"name": "this is a button CTA"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=7cac145bac823e50f7337bc030e1a578&format=xml
Query parameters
fields = id,type,name
url_id = 7cac145bac823e50f7337bc030e1a578
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>50d9e3c725956c44bc3305f33047d4fb</id>
<type>button</type>
<name>this is a button CTA</name>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=7cac145bac823e50f7337bc030e1a578&format=txt
Query parameters
fields = id,type,name
url_id = 7cac145bac823e50f7337bc030e1a578
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=50d9e3c725956c44bc3305f33047d4fb
result_type=button
result_name=this is a button CTA
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/info?fields=id,type,name&url_id=7cac145bac823e50f7337bc030e1a578&format=plain
Query parameters
fields = id,type,name
url_id = 7cac145bac823e50f7337bc030e1a578
format = plain
Response
50d9e3c725956c44bc3305f33047d4fb
button
this is a button CTA
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: id, type, name |
url_idID | ID of the liked tracking link |
Return values
parameter | description |
---|---|
id | [OPTIONAL] ID of the CTA, only if id is passed in fields |
name | [OPTIONAL] name of the CTA, only if name is passed in fields |
type | [OPTIONAL] type of the CTA, only if type is passed in fields |
/urls/ctas/previews
/urls/ctas/previews/check
access: [WRITE]
Check if a page preview is associated with a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/previews/check?url_id=c6a938ff465156dc26e8a132dd03b8a0
Query parameters
url_id = c6a938ff465156dc26e8a132dd03b8a0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/previews/check?url_id=c6a938ff465156dc26e8a132dd03b8a0&format=xml
Query parameters
url_id = c6a938ff465156dc26e8a132dd03b8a0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/previews/check?url_id=c6a938ff465156dc26e8a132dd03b8a0&format=txt
Query parameters
url_id = c6a938ff465156dc26e8a132dd03b8a0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/previews/check?url_id=c6a938ff465156dc26e8a132dd03b8a0&format=plain
Query parameters
url_id = c6a938ff465156dc26e8a132dd03b8a0
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Return values
parameter | description |
---|---|
enabled | 1 if a page preview is associated with the tracking link, 0 otherwise |
/urls/ctas/previews/extract
access: [WRITE]
Extract a page preview for the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=86e4b8f02011abc3636617fee4293fde
Query parameters
url_id = 86e4b8f02011abc3636617fee4293fde
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"extracted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=86e4b8f02011abc3636617fee4293fde&format=xml
Query parameters
url_id = 86e4b8f02011abc3636617fee4293fde
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<extracted>1</extracted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=86e4b8f02011abc3636617fee4293fde&format=txt
Query parameters
url_id = 86e4b8f02011abc3636617fee4293fde
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_extracted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/previews/extract?url_id=86e4b8f02011abc3636617fee4293fde&format=plain
Query parameters
url_id = 86e4b8f02011abc3636617fee4293fde
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Optional parameters
parameter | description |
---|---|
aiBOOLEAN | 1 to enable the AI extraction, default value ai = 0 |
Return values
parameter | description |
---|---|
extracted | 1 on success, 0 otherwise |
/urls/ctas/previews/info
access: [READ]
Return a page preview info for the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/previews/info?url_id=458b401f2cce4f82e2ad368c1c1da10c
Query parameters
url_id = 458b401f2cce4f82e2ad368c1c1da10c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"info": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/previews/info?url_id=458b401f2cce4f82e2ad368c1c1da10c&format=xml
Query parameters
url_id = 458b401f2cce4f82e2ad368c1c1da10c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<info>1</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/previews/info?url_id=458b401f2cce4f82e2ad368c1c1da10c&format=txt
Query parameters
url_id = 458b401f2cce4f82e2ad368c1c1da10c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_info=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/previews/info?url_id=458b401f2cce4f82e2ad368c1c1da10c&format=plain
Query parameters
url_id = 458b401f2cce4f82e2ad368c1c1da10c
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Return values
parameter | description |
---|---|
info | 1 on success, 0 otherwise |
/urls/ctas/previews/preview
access: [WRITE]
Return a page preview HTML for the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=26ba08cf634b5d95616ddd691aa23bea
Query parameters
url_id = 26ba08cf634b5d95616ddd691aa23bea
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"html": "<html><body>...<\/body><\/html>"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=26ba08cf634b5d95616ddd691aa23bea&format=xml
Query parameters
url_id = 26ba08cf634b5d95616ddd691aa23bea
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<html><[CDATA[&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;]]></html>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=26ba08cf634b5d95616ddd691aa23bea&format=txt
Query parameters
url_id = 26ba08cf634b5d95616ddd691aa23bea
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_html=&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/ctas/previews/preview?url_id=26ba08cf634b5d95616ddd691aa23bea&format=plain
Query parameters
url_id = 26ba08cf634b5d95616ddd691aa23bea
format = plain
Response
&lt;html&gt;&lt;body&gt;...&lt;/body&gt;&lt;/html&gt;
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Optional parameters
parameter | description |
---|---|
return_htmlBOOLEAN | 1 to return HTML, 0 to return JSON containing the html field, default value return_html = 0 |
Return values
parameter | description |
---|---|
[BINARY DATA] | [OPTIONAL] raw HTML content for the page preview, returned if return_html = 1 |
html | [OPTIONAL] HTML for the page preview, returned if return_html = 0 |
/urls/deeplinks
/urls/deeplinks/al
access: [READ]
Extract App Links information from a given URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F
Query parameters
url = https://www.facebook.com/groups/1234567890/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"android": {
"app_name": "Facebook",
"package": "com.facebook.katana",
"uri_scheme": "fb:\/\/group\/1234567890"
},
"ios": {
"app_name": "Facebook",
"app_store_id": "284882215",
"uri_scheme": "fb:\/\/group\/?id=1234567890"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=xml
Query parameters
url = https://www.facebook.com/groups/1234567890/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<android>
<app_name>Facebook</app_name>
<package>com.facebook.katana</package>
<uri_scheme>fb://group/1234567890</uri_scheme>
</android>
<ios>
<app_name>Facebook</app_name>
<app_store_id>284882215</app_store_id>
<uri_scheme>fb://group/?id=1234567890</uri_scheme>
</ios>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=txt
Query parameters
url = https://www.facebook.com/groups/1234567890/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_android_app_name=Facebook
result_android_package=com.facebook.katana
result_android_uri_scheme=fb://group/1234567890
result_ios_app_name=Facebook
result_ios_app_store_id=284882215
result_ios_uri_scheme=fb://group/?id=1234567890
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/al?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F1234567890%2F&format=plain
Query parameters
url = https://www.facebook.com/groups/1234567890/
format = plain
Response
Facebook
com.facebook.katana
fb://group/1234567890
Facebook
284882215
fb://group/?id=1234567890
Required parameters
parameter | description |
---|---|
urlSTRING | URL to be scraped |
Return values
parameter | description |
---|---|
data | Extracted App Link tags |
/urls/deeplinks/clone
access: [WRITE]
Clone the deep link configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=4f612c81aa235411f3de4cc77b4a2093&to_url_id=fc0a100f777aa9239e2a2d40e77e5554
Query parameters
from_url_id = 4f612c81aa235411f3de4cc77b4a2093
to_url_id = fc0a100f777aa9239e2a2d40e77e5554
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=4f612c81aa235411f3de4cc77b4a2093&to_url_id=fc0a100f777aa9239e2a2d40e77e5554&format=xml
Query parameters
from_url_id = 4f612c81aa235411f3de4cc77b4a2093
to_url_id = fc0a100f777aa9239e2a2d40e77e5554
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=4f612c81aa235411f3de4cc77b4a2093&to_url_id=fc0a100f777aa9239e2a2d40e77e5554&format=txt
Query parameters
from_url_id = 4f612c81aa235411f3de4cc77b4a2093
to_url_id = fc0a100f777aa9239e2a2d40e77e5554
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/clone?from_url_id=4f612c81aa235411f3de4cc77b4a2093&to_url_id=fc0a100f777aa9239e2a2d40e77e5554&format=plain
Query parameters
from_url_id = 4f612c81aa235411f3de4cc77b4a2093
to_url_id = fc0a100f777aa9239e2a2d40e77e5554
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the deep link configuration from |
to_url_idID | ID of the tracking link you want to the deep link configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/deeplinks/delete
access: [WRITE]
Unset (delete) a deep link for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/delete?id=bf23a40249a5eecdc4547b87bf78caf7
Query parameters
id = bf23a40249a5eecdc4547b87bf78caf7
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/delete?id=bf23a40249a5eecdc4547b87bf78caf7&format=xml
Query parameters
id = bf23a40249a5eecdc4547b87bf78caf7
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/delete?id=bf23a40249a5eecdc4547b87bf78caf7&format=txt
Query parameters
id = bf23a40249a5eecdc4547b87bf78caf7
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/delete?id=bf23a40249a5eecdc4547b87bf78caf7&format=plain
Query parameters
id = bf23a40249a5eecdc4547b87bf78caf7
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a deep link configration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/deeplinks/edit
access: [WRITE]
Set deep link settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/edit?id=b22157a76e5034e1c2f017b8922acb25
Query parameters
id = b22157a76e5034e1c2f017b8922acb25
Post parameters
settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/edit?id=b22157a76e5034e1c2f017b8922acb25&format=xml
Query parameters
id = b22157a76e5034e1c2f017b8922acb25
format = xml
Post parameters
settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/edit?id=b22157a76e5034e1c2f017b8922acb25&format=txt
Query parameters
id = b22157a76e5034e1c2f017b8922acb25
format = txt
Post parameters
settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/edit?id=b22157a76e5034e1c2f017b8922acb25&format=plain
Query parameters
id = b22157a76e5034e1c2f017b8922acb25
format = plain
Post parameters
settings=%7B%22params%22%3A%5B%5D%2C%22default_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22desktop_settings%22%3A%22default%22%2C%22desktop_redirect_url%22%3A%22%22%2C%22android_redirect_url%22%3A%22%22%2C%22android_settings%22%3A%22deeplink%22%2C%22android_uri_scheme%22%3A%22customUriScheme%3A%2F%2Fopen%22%2C%22android_package_name%22%3A%22com.joturl.example%22%2C%22android_fallback%22%3A%22redirect%22%2C%22android_fallback_redirect_url%22%3A%22https%3A%2F%2Fjoturl.com%2F%22%2C%22ios_settings%22%3A%22default%22%2C%22ios_redirect_url%22%3A%22%22%2C%22ios_uri_scheme%22%3A%22%22%2C%22ios_store_url%22%3A%22%22%2C%22ios_fallback%22%3A%22store%22%2C%22ios_fallback_redirect_url%22%3A%22%22%2C%22og_title%22%3A%22%22%3A%22%22%2C%22og_image%22%3A%22%22%7D
Response
1
Required parameters
parameter | description |
---|---|
idID | tracking link ID for which you want to edit the app deep link configuration |
settingsJSON | stringified JSON of the app deep link configuration, see i1/urls/deeplinks/info for details |
Return values
parameter | description |
---|---|
enabled | 1 if the app deep link option has been successfully enabled, 0 otherwise |
/urls/deeplinks/huawei
/urls/deeplinks/huawei/quickapps/id2package
access: [READ]
Get the package of a Huawei Quick App from its ID.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890
Query parameters
id = C1234567890
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"package": "com.example.quickapp"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=xml
Query parameters
id = C1234567890
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<package>com.example.quickapp</package>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=txt
Query parameters
id = C1234567890
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_package=com.example.quickapp
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/huawei/quickapps/id2package?id=C1234567890&format=plain
Query parameters
id = C1234567890
format = plain
Response
com.example.quickapp
Required parameters
parameter | description |
---|---|
idSTRING | ID of a Huawei Quick App |
Return values
parameter | description |
---|---|
package | The Huawei Quick App package that matches the passed id |
/urls/deeplinks/info
access: [READ]
Get a deep link settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/info?id=6462717dfaf7f6d9a9b684f6e4943e76
Query parameters
id = 6462717dfaf7f6d9a9b684f6e4943e76
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"settings": "{\"params\":[{\"key\":\"a\",\"value\":\"b\"},{\"key\":\"c\",\"value\":\"d\"}],\"default_url\":\"https:\\\/\\\/joturl.com\\\/\",\"desktop_settings\":\"default\",\"desktop_redirect_url\":\"\",\"android_redirect_url\":\"\",\"android_settings\":\"deeplink\",\"android_uri_scheme\":\"customUriScheme:\\\/\\\/open\",\"android_package_name\":\"com.joturl.example\",\"android_fallback\":\"redirect\",\"android_fallback_redirect_url\":\"https:\\\/\\\/joturl.com\\\/\",\"ios_settings\":\"default\",\"ios_redirect_url\":\"\",\"ios_uri_scheme\":\"\",\"ios_store_url\":\"\",\"ios_fallback\":\"store\",\"ios_fallback_redirect_url\":\"\",\"og_title\":\"\",\"og_description\":\"\",\"og_image\":\"\"}"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/info?id=6462717dfaf7f6d9a9b684f6e4943e76&format=xml
Query parameters
id = 6462717dfaf7f6d9a9b684f6e4943e76
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<settings>{"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}</settings>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/info?id=6462717dfaf7f6d9a9b684f6e4943e76&format=txt
Query parameters
id = 6462717dfaf7f6d9a9b684f6e4943e76
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_settings={"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/info?id=6462717dfaf7f6d9a9b684f6e4943e76&format=plain
Query parameters
id = 6462717dfaf7f6d9a9b684f6e4943e76
format = plain
Response
{"params":[{"key":"a","value":"b"},{"key":"c","value":"d"}],"default_url":"https:\/\/joturl.com\/","desktop_settings":"default","desktop_redirect_url":"","android_redirect_url":"","android_settings":"deeplink","android_uri_scheme":"customUriScheme:\/\/open","android_package_name":"com.joturl.example","android_fallback":"redirect","android_fallback_redirect_url":"https:\/\/joturl.com\/","ios_settings":"default","ios_redirect_url":"","ios_uri_scheme":"","ios_store_url":"","ios_fallback":"store","ios_fallback_redirect_url":"","og_title":"","og_description":"","og_image":""}
Required parameters
parameter | description |
---|---|
idID | tracking link ID to extract deep link configuration for |
Return values
parameter | description |
---|---|
settings | stringified JSON of the deep link configuration |
/urls/deeplinks/og
access: [READ]
Extract Open Graph information from a given URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F
Query parameters
url = https://www.facebook.com/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"site_name": "Facebook",
"url": "https:\/\/www.facebook.com\/",
"image": "https:\/\/www.facebook.com\/images\/fb_icon_325x325.png",
"locale": "en_US",
"title": "Facebook - Log In or Sign Up",
"description": "Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates."
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=xml
Query parameters
url = https://www.facebook.com/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<site_name>Facebook</site_name>
<url>https://www.facebook.com/</url>
<image>https://www.facebook.com/images/fb_icon_325x325.png</image>
<locale>en_US</locale>
<title>Facebook - Log In or Sign Up</title>
<description>Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.</description>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=txt
Query parameters
url = https://www.facebook.com/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_site_name=Facebook
result_data_url=https://www.facebook.com/
result_data_image=https://www.facebook.com/images/fb_icon_325x325.png
result_data_locale=en_US
result_data_title=Facebook - Log In or Sign Up
result_data_description=Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/deeplinks/og?url=https%3A%2F%2Fwww.facebook.com%2F&format=plain
Query parameters
url = https://www.facebook.com/
format = plain
Response
Facebook
https://www.facebook.com/
https://www.facebook.com/images/fb_icon_325x325.png
en_US
Facebook - Log In or Sign Up
Create an account or log into Facebook. Connect with friends, family and other people you know. Share photos and videos, send messages and get updates.
Required parameters
parameter | description |
---|---|
urlSTRING | URL to be scraped |
Return values
parameter | description |
---|---|
data | Extracted Open Graph tags |
/urls/delete
access: [WRITE]
This method deletes a set of tracking links by using the parameter ids.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/delete?ids=1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e
Query parameters
ids = 1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/delete?ids=1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e&format=xml
Query parameters
ids = 1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>3</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/delete?ids=1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e&format=txt
Query parameters
ids = 1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=3
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/delete?ids=1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e&format=plain
Query parameters
ids = 1ccbe61b625aff2245c0dfbe7008c40f,99f62fa657546df3f118c712d18e5595,2724106472d8e2dea72d903e85ad4e5e
format = plain
Response
3
Example 5 (json)
Request
https://joturl.com/a/i1/urls/delete?ids=f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e
Query parameters
ids = f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": [
"42d36be86581a283c870f10ba824c2b7",
"7c2451593adc2318f03a1d9a16cd5a4e"
],
"deleted": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/delete?ids=f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e&format=xml
Query parameters
ids = f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>
<i0>42d36be86581a283c870f10ba824c2b7</i0>
<i1>7c2451593adc2318f03a1d9a16cd5a4e</i1>
</ids>
<deleted>1</deleted>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/delete?ids=f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e&format=txt
Query parameters
ids = f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids_0=42d36be86581a283c870f10ba824c2b7
result_ids_1=7c2451593adc2318f03a1d9a16cd5a4e
result_deleted=1
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/delete?ids=f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e&format=plain
Query parameters
ids = f2285a5fc64587b5959a111563e13b30,42d36be86581a283c870f10ba824c2b7,7c2451593adc2318f03a1d9a16cd5a4e
format = plain
Response
42d36be86581a283c870f10ba824c2b7
7c2451593adc2318f03a1d9a16cd5a4e
1
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma separated list of tracking link IDs to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted tracking links |
ids | [OPTIONAL] list of tracking link IDs whose delete has failed, this parameter is returned only when at least one delete error has occurred |
/urls/easydeeplinks
/urls/easydeeplinks/clone
access: [WRITE]
Clone the easy deep link configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=885715ebcdfd613b9cadd18b6eae32c7&to_url_id=abf539bb541809b777a15ef455fa0051
Query parameters
from_url_id = 885715ebcdfd613b9cadd18b6eae32c7
to_url_id = abf539bb541809b777a15ef455fa0051
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=885715ebcdfd613b9cadd18b6eae32c7&to_url_id=abf539bb541809b777a15ef455fa0051&format=xml
Query parameters
from_url_id = 885715ebcdfd613b9cadd18b6eae32c7
to_url_id = abf539bb541809b777a15ef455fa0051
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=885715ebcdfd613b9cadd18b6eae32c7&to_url_id=abf539bb541809b777a15ef455fa0051&format=txt
Query parameters
from_url_id = 885715ebcdfd613b9cadd18b6eae32c7
to_url_id = abf539bb541809b777a15ef455fa0051
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/clone?from_url_id=885715ebcdfd613b9cadd18b6eae32c7&to_url_id=abf539bb541809b777a15ef455fa0051&format=plain
Query parameters
from_url_id = 885715ebcdfd613b9cadd18b6eae32c7
to_url_id = abf539bb541809b777a15ef455fa0051
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the easy deep link configuration from |
to_url_idID | ID of the tracking link you want to the easy deep link configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/easydeeplinks/delete
access: [WRITE]
Unset (delete) an easy dee link for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/delete?id=ccea31069a1792de1cdc5b0a8ad8a275
Query parameters
id = ccea31069a1792de1cdc5b0a8ad8a275
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/delete?id=ccea31069a1792de1cdc5b0a8ad8a275&format=xml
Query parameters
id = ccea31069a1792de1cdc5b0a8ad8a275
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/delete?id=ccea31069a1792de1cdc5b0a8ad8a275&format=txt
Query parameters
id = ccea31069a1792de1cdc5b0a8ad8a275
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/delete?id=ccea31069a1792de1cdc5b0a8ad8a275&format=plain
Query parameters
id = ccea31069a1792de1cdc5b0a8ad8a275
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove an easy deep link configration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/easydeeplinks/detect
access: [READ]
Find the app the passed URL is associated with (e.g., Facebook, Instagram).
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL
Query parameters
url = https://www.facebook.com/jotURL
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "Facebook",
"category": "social"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=xml
Query parameters
url = https://www.facebook.com/jotURL
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>Facebook</name>
<category>social</category>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=txt
Query parameters
url = https://www.facebook.com/jotURL
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=Facebook
result_category=social
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/detect?url=https%3A%2F%2Fwww.facebook.com%2FjotURL&format=plain
Query parameters
url = https://www.facebook.com/jotURL
format = plain
Response
Facebook
social
Optional parameters
parameter | description | max length |
---|---|---|
urlURL | URL corresponding to the app page | 4000 |
Return values
parameter | description |
---|---|
category | category of the easy deep link provider, if available, supported categories: affiliation, business, entertainment, lifestyle, music, other, shopping, social, travel, unknown, website |
name | name of the easy deep link provider, if available, supported names: Adidas, AliExpress, Amazon, Apartments.com, Apple Maps, Apple Music, Apple Podcast, Best Buy, BlueSky, Booking.com, BrandCycle, Discord, Epic Games Store, Etsy, Expedia, Facebook, Flipkart, Google Docs, Google Maps, Google Sheets, Google Slides, HSN, Howl, IKEA, Instagram, Kickstarter, Kohl's, LINE, LTK, LinkedIn, Macy's, MagicLinks, Mavely, Medium, Mercado Livre, Messenger, Microsoft Excel, Microsoft PowerPoint, Microsoft Word, Netflix, Nordstrom, OnlyFans, Pinterest, Product Hunt, QVC, Quora, Reddit, Refersion, SHEIN, Signal, Skype, Snapchat, Spotify, Steam, Target, Telegram, Temu, The Home Depot, TikTok, TripAdvisor, Trulia, Twitch TV, Unknown, Viber, Vimeo, Walmart, WhatsApp, X, YouTube, Zendesk Support, Zillow, Zulily, eBay, iFood |
real_category | [OPTIONAL] category of the real easy deep link provider, see notes |
real_name | [OPTIONAL] name of the real easy deep link provider, see notes |
/urls/easydeeplinks/edit
access: [WRITE]
Set an easy deep link settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/edit?id=6221606e28922f2d9cded60845e3ea0f
Query parameters
id = 6221606e28922f2d9cded60845e3ea0f
Post parameters
settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/edit?id=6221606e28922f2d9cded60845e3ea0f&format=xml
Query parameters
id = 6221606e28922f2d9cded60845e3ea0f
format = xml
Post parameters
settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/edit?id=6221606e28922f2d9cded60845e3ea0f&format=txt
Query parameters
id = 6221606e28922f2d9cded60845e3ea0f
format = txt
Post parameters
settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/edit?id=6221606e28922f2d9cded60845e3ea0f&format=plain
Query parameters
id = 6221606e28922f2d9cded60845e3ea0f
format = plain
Post parameters
settings=%7B%22name%22%3A%22YouTube%22%2C%22category%22%3A%22social%22%2C%22ios%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%7D%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22android%22%3A%7B%22phone%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%2C%22tablet%22%3A%7B%22enabled%22%3A1%2C%22installed%22%3A%7B%22choice%22%3A%22scheme%22%2C%22scheme%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22custom%22%3A%22%22%2C%22alternatives%22%3A%5B%5D%7D%2C%22not_installed%22%3A%7B%22choice%22%3A%22default%22%2C%22custom%22%3A%22%22%2C%22store%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%7D%2C%22force_chrome%22%3A0%2C%22deeplink_method%22%3A%22aggressive%22%7D%7D%2C%22default_url%22%3A%22https%3A%5C%2F%5C%2Fyoutu.be%5C%2FoBg0slZQt1g%22%2C%22info%22%3A%7B%22title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%2C%22ios_url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%2C%22ios_store_url%22%3A%22https%3A%5C%2F%5C%2Fitunes.apple.com%5C%2Fus%5C%2Fapp%5C%2Fyoutube%5C%2Fid544007664%22%2C%22android_url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%2C%22android_store_url%22%3A%22https%3A%5C%2F%5C%2Fplay.google.com%5C%2Fstore%5C%2Fapps%5C%2Fdetails%3Fid%3Dcom.google.android.youtube%22%2C%22info%22%3A%7B%22ios%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22app_store_id%22%3A%22544007664%22%2C%22url%22%3A%22vnd.youtube%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%22%7D%2C%22android%22%3A%7B%22app_name%22%3A%22YouTube%22%2C%22package%22%3A%22com.google.android.youtube%22%2C%22url%22%3A%22intent%3A%5C%2F%5C%2Fwww.youtube.com%5C%2Fwatch%3Fv%3DoBg0slZQt1g%26feature%3Dyoutu.be%23Intent%3Bpackage%3Dcom.google.android.youtube%3Bscheme%3Dhttps%3BS.browser_fallback_url%3D%7Bnot_installed%7D%3Bend%22%7D%7D%7D%2C%22detected%22%3A%5B%22ios%22%2C%22android%22%5D%2C%22og_title%22%3A%22JotURL+-+The+all-in-one+dream+suite+for+your+marketing+links%21%22%2C%22og_description%22%3A%22JotUrl%3A+Boost+your+inbound+marketing+results+and+conversions%2C+with+the+best+user+experience.+www.joturl.com%22%2C%22og_image%22%3A%22https%3A%5C%2F%5C%2Fi.ytimg.com%5C%2Fvi%5C%2FoBg0slZQt1g%5C%2Fmaxresdefault.jpg%22%7D
Response
1
Required parameters
parameter | description |
---|---|
idID | tracking link ID for which you want to edit the easy deep link configuration |
settingsJSON | stringified JSON of the easy deep link configuration, see i1/urls/easydeeplinks/info for details |
Return values
parameter | description |
---|---|
enabled | 1 if the easy deep link option has been successfully enabled, 0 otherwise |
/urls/easydeeplinks/info
access: [READ]
Get an easy deep link settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=2432d73845199c603918203361a53d90
Query parameters
id = 2432d73845199c603918203361a53d90
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "YouTube",
"category": "social",
"ios": {
"phone": {
"enabled": 1,
"installed": {
"choice": "scheme",
"scheme": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
"custom": "",
"alternatives": []
},
"not_installed": {
"choice": "default",
"custom": "",
"store": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"
}
},
"tablet": {
"enabled": 1,
"installed": {
"choice": "scheme",
"scheme": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
"custom": "",
"alternatives": []
},
"not_installed": {
"choice": "default",
"custom": "",
"store": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"
}
}
},
"android": {
"phone": {
"enabled": 1,
"installed": {
"choice": "scheme",
"scheme": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
"custom": "",
"alternatives": []
},
"not_installed": {
"choice": "default",
"custom": "",
"store": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"
}
},
"tablet": {
"enabled": 1,
"installed": {
"choice": "scheme",
"scheme": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
"custom": "",
"alternatives": []
},
"not_installed": {
"choice": "default",
"custom": "",
"store": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"
}
}
},
"default_url": "https:\/\/youtu.be\/oBg0slZQt1g",
"info": {
"title": "JotURL - The all-in-one dream suite for your marketing links!",
"description": "JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com",
"image": "https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg",
"ios_url": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be",
"ios_store_url": "https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664",
"android_url": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end",
"android_store_url": "https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube",
"info": {
"ios": {
"app_name": "YouTube",
"app_store_id": "544007664",
"url": "vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be"
},
"android": {
"app_name": "YouTube",
"package": "com.google.android.youtube",
"url": "intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"
}
}
},
"detected": [
"ios",
"android"
],
"autodetect": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=2432d73845199c603918203361a53d90&format=xml
Query parameters
id = 2432d73845199c603918203361a53d90
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>YouTube</name>
<category>social</category>
<ios>
<phone>
<enabled>1</enabled>
<installed>
<choice>scheme</choice>
<scheme><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></scheme>
<custom></custom>
<alternatives>
</alternatives>
</installed>
<not_installed>
<choice>default</choice>
<custom></custom>
<store>https://itunes.apple.com/us/app/youtube/id544007664</store>
</not_installed>
</phone>
<tablet>
<enabled>1</enabled>
<installed>
<choice>scheme</choice>
<scheme><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></scheme>
<custom></custom>
<alternatives>
</alternatives>
</installed>
<not_installed>
<choice>default</choice>
<custom></custom>
<store>https://itunes.apple.com/us/app/youtube/id544007664</store>
</not_installed>
</tablet>
</ios>
<android>
<phone>
<enabled>1</enabled>
<installed>
<choice>scheme</choice>
<scheme><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></scheme>
<custom></custom>
<alternatives>
</alternatives>
</installed>
<not_installed>
<choice>default</choice>
<custom></custom>
<store>https://play.google.com/store/apps/details?id=com.google.android.youtube</store>
</not_installed>
</phone>
<tablet>
<enabled>1</enabled>
<installed>
<choice>scheme</choice>
<scheme><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></scheme>
<custom></custom>
<alternatives>
</alternatives>
</installed>
<not_installed>
<choice>default</choice>
<custom></custom>
<store>https://play.google.com/store/apps/details?id=com.google.android.youtube</store>
</not_installed>
</tablet>
</android>
<default_url>https://youtu.be/oBg0slZQt1g</default_url>
<info>
<title>JotURL - The all-in-one dream suite for your marketing links!</title>
<description>JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com</description>
<image>https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg</image>
<ios_url><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></ios_url>
<ios_store_url>https://itunes.apple.com/us/app/youtube/id544007664</ios_store_url>
<android_url><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></android_url>
<android_store_url>https://play.google.com/store/apps/details?id=com.google.android.youtube</android_store_url>
<info>
<ios>
<app_name>YouTube</app_name>
<app_store_id>544007664</app_store_id>
<url><[CDATA[vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be]]></url>
</ios>
<android>
<app_name>YouTube</app_name>
<package>com.google.android.youtube</package>
<url><[CDATA[intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end]]></url>
</android>
</info>
</info>
<detected>
<i0>ios</i0>
<i1>android</i1>
</detected>
<autodetect>1</autodetect>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=2432d73845199c603918203361a53d90&format=txt
Query parameters
id = 2432d73845199c603918203361a53d90
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=YouTube
result_category=social
result_ios_phone_enabled=1
result_ios_phone_installed_choice=scheme
result_ios_phone_installed_scheme=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_ios_phone_installed_custom=
result_ios_phone_installed_alternatives=
result_ios_phone_not_installed_choice=default
result_ios_phone_not_installed_custom=
result_ios_phone_not_installed_store=https://itunes.apple.com/us/app/youtube/id544007664
result_ios_tablet_enabled=1
result_ios_tablet_installed_choice=scheme
result_ios_tablet_installed_scheme=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_ios_tablet_installed_custom=
result_ios_tablet_installed_alternatives=
result_ios_tablet_not_installed_choice=default
result_ios_tablet_not_installed_custom=
result_ios_tablet_not_installed_store=https://itunes.apple.com/us/app/youtube/id544007664
result_android_phone_enabled=1
result_android_phone_installed_choice=scheme
result_android_phone_installed_scheme=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_android_phone_installed_custom=
result_android_phone_installed_alternatives=
result_android_phone_not_installed_choice=default
result_android_phone_not_installed_custom=
result_android_phone_not_installed_store=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_android_tablet_enabled=1
result_android_tablet_installed_choice=scheme
result_android_tablet_installed_scheme=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_android_tablet_installed_custom=
result_android_tablet_installed_alternatives=
result_android_tablet_not_installed_choice=default
result_android_tablet_not_installed_custom=
result_android_tablet_not_installed_store=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_default_url=https://youtu.be/oBg0slZQt1g
result_info_title=JotURL - The all-in-one dream suite for your marketing links!
result_info_description=JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com
result_info_image=https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg
result_info_ios_url=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_info_ios_store_url=https://itunes.apple.com/us/app/youtube/id544007664
result_info_android_url=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_info_android_store_url=https://play.google.com/store/apps/details?id=com.google.android.youtube
result_info_info_ios_app_name=YouTube
result_info_info_ios_app_store_id=544007664
result_info_info_ios_url=vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
result_info_info_android_app_name=YouTube
result_info_info_android_package=com.google.android.youtube
result_info_info_android_url=intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
result_detected_0=ios
result_detected_1=android
result_autodetect=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=2432d73845199c603918203361a53d90&format=plain
Query parameters
id = 2432d73845199c603918203361a53d90
format = plain
Response
YouTube
social
1
scheme
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
default
https://itunes.apple.com/us/app/youtube/id544007664
1
scheme
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
default
https://itunes.apple.com/us/app/youtube/id544007664
1
scheme
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
default
https://play.google.com/store/apps/details?id=com.google.android.youtube
1
scheme
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
default
https://play.google.com/store/apps/details?id=com.google.android.youtube
https://youtu.be/oBg0slZQt1g
JotURL - The all-in-one dream suite for your marketing links!
JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com
https://i.ytimg.com/vi/oBg0slZQt1g/maxresdefault.jpg
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
https://itunes.apple.com/us/app/youtube/id544007664
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
https://play.google.com/store/apps/details?id=com.google.android.youtube
YouTube
544007664
vnd.youtube://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be
YouTube
com.google.android.youtube
intent://www.youtube.com/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end
ios
android
1
Example 5 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=b4cac05c8b88a8ea07289d97874415e3
Query parameters
id = b4cac05c8b88a8ea07289d97874415e3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"settings": "{\"name\":\"YouTube\",\"category\":\"social\",\"ios\":{\"phone\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\"},\"deeplink_method\":\"aggressive\"},\"tablet\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\"},\"deeplink_method\":\"aggressive\"}},\"android\":{\"phone\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\"},\"force_chrome\":0,\"deeplink_method\":\"aggressive\"},\"tablet\":{\"enabled\":1,\"installed\":{\"choice\":\"scheme\",\"scheme\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"custom\":\"\",\"alternatives\":[]},\"not_installed\":{\"choice\":\"default\",\"custom\":\"\",\"store\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\"},\"force_chrome\":0,\"deeplink_method\":\"aggressive\"}},\"default_url\":\"https:\\\/\\\/youtu.be\\\/oBg0slZQt1g\",\"info\":{\"title\":\"JotURL - The all-in-one dream suite for your marketing links!\",\"description\":\"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com\",\"image\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/oBg0slZQt1g\\\/maxresdefault.jpg\",\"ios_url\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\",\"ios_store_url\":\"https:\\\/\\\/itunes.apple.com\\\/us\\\/app\\\/youtube\\\/id544007664\",\"android_url\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\",\"android_store_url\":\"https:\\\/\\\/play.google.com\\\/store\\\/apps\\\/details?id=com.google.android.youtube\",\"info\":{\"ios\":{\"app_name\":\"YouTube\",\"app_store_id\":\"544007664\",\"url\":\"vnd.youtube:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be\"},\"android\":{\"app_name\":\"YouTube\",\"package\":\"com.google.android.youtube\",\"url\":\"intent:\\\/\\\/www.youtube.com\\\/watch?v=oBg0slZQt1g&feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end\"}}},\"detected\":[\"ios\",\"android\"],\"og_title\":\"JotURL - The all-in-one dream suite for your marketing links!\",\"og_description\":\"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com\",\"og_image\":\"https:\\\/\\\/i.ytimg.com\\\/vi\\\/oBg0slZQt1g\\\/maxresdefault.jpg\"}",
"autodetect": 0
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=b4cac05c8b88a8ea07289d97874415e3&format=xml
Query parameters
id = b4cac05c8b88a8ea07289d97874415e3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<settings><[CDATA[{"name":"YouTube","category":"social","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"detected":["ios","android"],"og_title":"JotURL - The all-in-one dream suite for your marketing links!","og_description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","og_image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg"}]]></settings>
<autodetect>0</autodetect>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=b4cac05c8b88a8ea07289d97874415e3&format=txt
Query parameters
id = b4cac05c8b88a8ea07289d97874415e3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_settings={"name":"YouTube","category":"social","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"detected":["ios","android"],"og_title":"JotURL - The all-in-one dream suite for your marketing links!","og_description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","og_image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg"}
result_autodetect=0
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/info?id=b4cac05c8b88a8ea07289d97874415e3&format=plain
Query parameters
id = b4cac05c8b88a8ea07289d97874415e3
format = plain
Response
{"name":"YouTube","category":"social","ios":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664"},"deeplink_method":"aggressive"}},"android":{"phone":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"},"tablet":{"enabled":1,"installed":{"choice":"scheme","scheme":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","custom":"","alternatives":[]},"not_installed":{"choice":"default","custom":"","store":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube"},"force_chrome":0,"deeplink_method":"aggressive"}},"default_url":"https:\/\/youtu.be\/oBg0slZQt1g","info":{"title":"JotURL - The all-in-one dream suite for your marketing links!","description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg","ios_url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be","ios_store_url":"https:\/\/itunes.apple.com\/us\/app\/youtube\/id544007664","android_url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end","android_store_url":"https:\/\/play.google.com\/store\/apps\/details?id=com.google.android.youtube","info":{"ios":{"app_name":"YouTube","app_store_id":"544007664","url":"vnd.youtube:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be"},"android":{"app_name":"YouTube","package":"com.google.android.youtube","url":"intent:\/\/www.youtube.com\/watch?v=oBg0slZQt1g&amp;feature=youtu.be#Intent;package=com.google.android.youtube;scheme=https;S.browser_fallback_url={not_installed};end"}}},"detected":["ios","android"],"og_title":"JotURL - The all-in-one dream suite for your marketing links!","og_description":"JotUrl: Boost your inbound marketing results and conversions, with the best user experience. www.joturl.com","og_image":"https:\/\/i.ytimg.com\/vi\/oBg0slZQt1g\/maxresdefault.jpg"}
0
Required parameters
parameter | description |
---|---|
idID | tracking link ID for which you want to extract the easy deep link configuration |
Return values
parameter | description |
---|---|
android | [OPTIONAL] array containing the easy deep link configuration for Android, returned only if autodetect = 1 |
autodetect | 1 if the configuration was automatically detected, 0 if it was taken from a previously set configuration |
category | [OPTIONAL] category of the easy deep link provider, returned only if autodetect = 1 , supported categories: affiliation, business, entertainment, lifestyle, music, other, shopping, social, travel, unknown, website |
default_url | [OPTIONAL] default URL for the easy deepl ink configuration, returned only if autodetect = 1 |
detected | [OPTIONAL] returned only if autodetect = 1 , array containing the extracted information, it can contain the values ios and android depending on whether our system was able to extract the deep link information for that specific operating system, it contains only one of the above values in case it is not possible to extract the information for the deep link for one of the operating systems, it can be empty in case it is not possible to extract the information for the deep link |
info | [OPTIONAL] Open Graph information extracted from default_url and raw deep link information, returned only if autodetect = 1 |
ios | [OPTIONAL] array containing the easy deep link configuration for iOS, returned only if autodetect = 1 |
name | [OPTIONAL] name of the easy deep link provider, returned only if autodetect = 1 , supported names: Adidas, AliExpress, Amazon, Apartments.com, Apple Maps, Apple Music, Apple Podcast, Best Buy, BlueSky, Booking.com, BrandCycle, Discord, eBay, Epic Games Store, Etsy, Expedia, Facebook, Flipkart, Google Docs, Google Maps, Google Sheets, Google Slides, Howl, HSN, iFood, IKEA, Instagram, Kickstarter, Kohl's, LINE, LinkedIn, LTK, Macy's, MagicLinks, Mavely, Medium, Mercado Livre, Messenger, Microsoft Excel, Microsoft PowerPoint, Microsoft Word, Netflix, Nordstrom, OnlyFans, Pinterest, Product Hunt, Quora, QVC, Reddit, Refersion, SHEIN, Signal, Skype, Snapchat, Spotify, Steam, Target, Telegram, Temu, The Home Depot, TikTok, TripAdvisor, Trulia, Twitch TV, Unknown, Viber, Vimeo, Walmart, WhatsApp, X, YouTube, Zendesk Support, Zillow, Zulily |
settings | [OPTIONAL] returned only if autodetect = 0 , stringified JSON of the easy deep link configuration, it contains the same fields returned when autodetect = 1 except autodetect plus the fields: og_title, og_description, og_image which are the corresponding custom Open Graph fields |
NOTES:
Both android and ios arrays have the following structure:
{
"phone": (DEEPLINK_INFO),
"tablet": (DEEPLINK_INFO)
}
Where (DEEPLINK_INFO) is:
{
"enabled":(ENABLED),
"installed":{
"choice":"(INSTALLED_CHOICE)",
"scheme":"(URI SCHEME)",
"custom":"(CUSTOM URI SCHEME WHEN APP INSTALLED)",
"alternatives":(ALTERNATIVES WHEN APP INSTALLED)
},
"not_installed":{
"choice":"(NOT_INSTALLED_CHOICE)",
"custom":"(CUSTOM URI SCHEME WHEN APP NOT INSTALLED)",
"store":"(STORE URL)"
},
"force_chrome":(FORCE_CHROME),
"force_redirect":(FORCE_REDIRECT),
"deeplink_method":(DEEPLINK_METHOD)
}
With
(ENABLED):
- 1: to enabled the specific configuration (phone or tablet)
- 0: to disable the specific configuration, in this case the default URL will be used to redirect the user
(INSTALLED_CHOICE):
- scheme: use the (URI SCHEME) for deep linking
- custom: use the (CUSTOM URI SCHEME WHEN APP INSTALLED) for deep linking
(ALTERNATIVES WHEN APP INSTALLED): array of alternatives for the field (CUSTOM URI SCHEME WHEN APP INSTALLED), it can be an empty array or contain elements like this:
{
"type": "[unique ID]",
"url": "[alternative custom URI scheme]"
}
(NOT_INSTALLED_CHOICE):
- default: use the default_url to redirect the user when the app is not installed
- store: use the (STORE URL) to redirect the user when the app is not installed
- custom: use the (CUSTOM URI SCHEME WHEN APP NOT INSTALLED) to redirect the user when the app is not installed
(FORCE_CHROME), may not be present and available only for Android (in all other cases it is ignored):
- 1: to try to open Chrome before deep linking (useful in all those apps that open links in the webview, e.g., Facebook)
- 0: to not try to open Chrome
(FORCE_REDIRECT), may not be present and available only for Android (in all other cases it is ignored), this flag is only used
when `(NOT_INSTALLED_CHOICE) = default`, `(FORCE_CHROME) = 0` and our engine detects a webview (in-app browser, e.g., the Facebook internal browser),
in this case and when the deep link fails:
- 1: force a redirect to default_url instead of opening the Android Play Store
- 0: open the Android Play Store
(DEEPLINK_METHOD), only available when autodetect = 0:
- aggressive: try to open the app anyway, although this may cause errors (recommended)
- conservative: our engine tries to open the app only if our engine can determine if the app is installed
/urls/easydeeplinks/list
access: [READ]
Get all supported apps for easy deep link grouped by category.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/easydeeplinks/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"shopping": [
"Adidas",
"AliExpress",
"Amazon",
"Best Buy",
"eBay",
"Etsy",
"Flipkart",
"HSN",
"IKEA",
"Kohl's",
"LTK",
"Macy's",
"Mercado Livre",
"Nordstrom",
"QVC",
"SHEIN",
"Target",
"Temu",
"The Home Depot",
"Walmart",
"Zulily"
],
"lifestyle": [
"Apartments.com",
"iFood",
"Trulia",
"Zillow"
],
"travel": [
"Apple Maps",
"Booking.com",
"Expedia",
"Google Maps",
"TripAdvisor"
],
"music": [
"Apple Music",
"Spotify"
],
"other": [
"Apple Podcast",
"Zendesk Support"
],
"social": [
"BlueSky",
"Discord",
"Facebook",
"Instagram",
"LINE",
"LinkedIn",
"Messenger",
"Pinterest",
"Product Hunt",
"Reddit",
"Signal",
"Skype",
"Snapchat",
"Telegram",
"TikTok",
"Viber",
"Vimeo",
"X",
"YouTube"
],
"affiliation": [
"BrandCycle",
"Howl",
"MagicLinks",
"Mavely",
"Refersion"
],
"entertainment": [
"Epic Games Store",
"Netflix",
"OnlyFans",
"Steam",
"Twitch TV"
],
"business": [
"Google Docs",
"Google Sheets",
"Google Slides",
"Microsoft Excel",
"Microsoft PowerPoint",
"Microsoft Word"
],
"website": [
"Kickstarter",
"Medium",
"Quora"
],
"unknown": [
"Unknown"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/easydeeplinks/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<shopping>
<i0>Adidas</i0>
<i1>AliExpress</i1>
<i2>Amazon</i2>
<i3>Best Buy</i3>
<i4>eBay</i4>
<i5>Etsy</i5>
<i6>Flipkart</i6>
<i7>HSN</i7>
<i8>IKEA</i8>
<i9>Kohl's</i9>
<i10>LTK</i10>
<i11>Macy's</i11>
<i12>Mercado Livre</i12>
<i13>Nordstrom</i13>
<i14>QVC</i14>
<i15>SHEIN</i15>
<i16>Target</i16>
<i17>Temu</i17>
<i18>The Home Depot</i18>
<i19>Walmart</i19>
<i20>Zulily</i20>
</shopping>
<lifestyle>
<i0>Apartments.com</i0>
<i1>iFood</i1>
<i2>Trulia</i2>
<i3>Zillow</i3>
</lifestyle>
<travel>
<i0>Apple Maps</i0>
<i1>Booking.com</i1>
<i2>Expedia</i2>
<i3>Google Maps</i3>
<i4>TripAdvisor</i4>
</travel>
<music>
<i0>Apple Music</i0>
<i1>Spotify</i1>
</music>
<other>
<i0>Apple Podcast</i0>
<i1>Zendesk Support</i1>
</other>
<social>
<i0>BlueSky</i0>
<i1>Discord</i1>
<i2>Facebook</i2>
<i3>Instagram</i3>
<i4>LINE</i4>
<i5>LinkedIn</i5>
<i6>Messenger</i6>
<i7>Pinterest</i7>
<i8>Product Hunt</i8>
<i9>Reddit</i9>
<i10>Signal</i10>
<i11>Skype</i11>
<i12>Snapchat</i12>
<i13>Telegram</i13>
<i14>TikTok</i14>
<i15>Viber</i15>
<i16>Vimeo</i16>
<i17>X</i17>
<i18>YouTube</i18>
</social>
<affiliation>
<i0>BrandCycle</i0>
<i1>Howl</i1>
<i2>MagicLinks</i2>
<i3>Mavely</i3>
<i4>Refersion</i4>
</affiliation>
<entertainment>
<i0>Epic Games Store</i0>
<i1>Netflix</i1>
<i2>OnlyFans</i2>
<i3>Steam</i3>
<i4>Twitch TV</i4>
</entertainment>
<business>
<i0>Google Docs</i0>
<i1>Google Sheets</i1>
<i2>Google Slides</i2>
<i3>Microsoft Excel</i3>
<i4>Microsoft PowerPoint</i4>
<i5>Microsoft Word</i5>
</business>
<website>
<i0>Kickstarter</i0>
<i1>Medium</i1>
<i2>Quora</i2>
</website>
<unknown>
<i0>Unknown</i0>
</unknown>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/easydeeplinks/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_shopping_0=Adidas
result_shopping_1=AliExpress
result_shopping_2=Amazon
result_shopping_3=Best Buy
result_shopping_4=eBay
result_shopping_5=Etsy
result_shopping_6=Flipkart
result_shopping_7=HSN
result_shopping_8=IKEA
result_shopping_9=Kohl's
result_shopping_10=LTK
result_shopping_11=Macy's
result_shopping_12=Mercado Livre
result_shopping_13=Nordstrom
result_shopping_14=QVC
result_shopping_15=SHEIN
result_shopping_16=Target
result_shopping_17=Temu
result_shopping_18=The Home Depot
result_shopping_19=Walmart
result_shopping_20=Zulily
result_lifestyle_0=Apartments.com
result_lifestyle_1=iFood
result_lifestyle_2=Trulia
result_lifestyle_3=Zillow
result_travel_0=Apple Maps
result_travel_1=Booking.com
result_travel_2=Expedia
result_travel_3=Google Maps
result_travel_4=TripAdvisor
result_music_0=Apple Music
result_music_1=Spotify
result_other_0=Apple Podcast
result_other_1=Zendesk Support
result_social_0=BlueSky
result_social_1=Discord
result_social_2=Facebook
result_social_3=Instagram
result_social_4=LINE
result_social_5=LinkedIn
result_social_6=Messenger
result_social_7=Pinterest
result_social_8=Product Hunt
result_social_9=Reddit
result_social_10=Signal
result_social_11=Skype
result_social_12=Snapchat
result_social_13=Telegram
result_social_14=TikTok
result_social_15=Viber
result_social_16=Vimeo
result_social_17=X
result_social_18=YouTube
result_affiliation_0=BrandCycle
result_affiliation_1=Howl
result_affiliation_2=MagicLinks
result_affiliation_3=Mavely
result_affiliation_4=Refersion
result_entertainment_0=Epic Games Store
result_entertainment_1=Netflix
result_entertainment_2=OnlyFans
result_entertainment_3=Steam
result_entertainment_4=Twitch TV
result_business_0=Google Docs
result_business_1=Google Sheets
result_business_2=Google Slides
result_business_3=Microsoft Excel
result_business_4=Microsoft PowerPoint
result_business_5=Microsoft Word
result_website_0=Kickstarter
result_website_1=Medium
result_website_2=Quora
result_unknown_0=Unknown
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/easydeeplinks/list?format=plain
Query parameters
format = plain
Response
Adidas
AliExpress
Amazon
Best Buy
eBay
Etsy
Flipkart
HSN
IKEA
Kohl's
LTK
Macy's
Mercado Livre
Nordstrom
QVC
SHEIN
Target
Temu
The Home Depot
Walmart
Zulily
Apartments.com
iFood
Trulia
Zillow
Apple Maps
Booking.com
Expedia
Google Maps
TripAdvisor
Apple Music
Spotify
Apple Podcast
Zendesk Support
BlueSky
Discord
Facebook
Instagram
LINE
LinkedIn
Messenger
Pinterest
Product Hunt
Reddit
Signal
Skype
Snapchat
Telegram
TikTok
Viber
Vimeo
X
YouTube
BrandCycle
Howl
MagicLinks
Mavely
Refersion
Epic Games Store
Netflix
OnlyFans
Steam
Twitch TV
Google Docs
Google Sheets
Google Slides
Microsoft Excel
Microsoft PowerPoint
Microsoft Word
Kickstarter
Medium
Quora
Unknown
Return values
parameter | description |
---|---|
data | array containing all supported apps for easy deep link grouped by category, it is in the form {"category1":[ list ], "category2":[ list ], ... } |
/urls/edit
access: [WRITE]
Edit fields of a short URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/edit?id=24dea6b7fb13657f003b8e240bf51900&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=this+is+a+sample+note
Query parameters
id = 24dea6b7fb13657f003b8e240bf51900
long_url = https://www.joturl.com/
notes = this is a sample note
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "24dea6b7fb13657f003b8e240bf51900",
"alias": "jot",
"domain_host": "jo.my",
"domain_id": "4de0a420a711e2a2cc8139187e13f05f",
"project_id": "f27b8d3bb33d1675d92148f8714834a4",
"project_name": "project name",
"long_url": "https:\/\/www.joturl.com\/",
"short_url": "http:\/\/jo.my\/jot",
"notes": "this is a sample note"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/edit?id=24dea6b7fb13657f003b8e240bf51900&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=this+is+a+sample+note&format=xml
Query parameters
id = 24dea6b7fb13657f003b8e240bf51900
long_url = https://www.joturl.com/
notes = this is a sample note
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>24dea6b7fb13657f003b8e240bf51900</id>
<alias>jot</alias>
<domain_host>jo.my</domain_host>
<domain_id>4de0a420a711e2a2cc8139187e13f05f</domain_id>
<project_id>f27b8d3bb33d1675d92148f8714834a4</project_id>
<project_name>project name</project_name>
<long_url>https://www.joturl.com/</long_url>
<short_url>http://jo.my/jot</short_url>
<notes>this is a sample note</notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/edit?id=24dea6b7fb13657f003b8e240bf51900&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=this+is+a+sample+note&format=txt
Query parameters
id = 24dea6b7fb13657f003b8e240bf51900
long_url = https://www.joturl.com/
notes = this is a sample note
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=24dea6b7fb13657f003b8e240bf51900
result_alias=jot
result_domain_host=jo.my
result_domain_id=4de0a420a711e2a2cc8139187e13f05f
result_project_id=f27b8d3bb33d1675d92148f8714834a4
result_project_name=project name
result_long_url=https://www.joturl.com/
result_short_url=http://jo.my/jot
result_notes=this is a sample note
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/edit?id=24dea6b7fb13657f003b8e240bf51900&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=this+is+a+sample+note&format=plain
Query parameters
id = 24dea6b7fb13657f003b8e240bf51900
long_url = https://www.joturl.com/
notes = this is a sample note
format = plain
Response
http://jo.my/jot
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link to be edited |
Optional parameters
parameter | description | max length |
---|---|---|
long_urlSTRING | destination URL for tracking link | 4000 |
notesSTRING | notes for tracking link | 255 |
Return values
parameter | description |
---|---|
alias | see i1/urls/list for details |
domain_host | domain (e.g., domain.ext) of the tracking link |
domain_id | ID of the domain of the tracking link |
id | see i1/urls/list for details |
long_url | see i1/urls/list for details |
notes | see i1/urls/list for details |
project_id | ID of the project |
project_name | name of the project |
short_url | see i1/urls/list for details |
/urls/embeddable
access: [READ]
This method returns 1 if the passed URL is embeddable, 0 otherwise.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F
Query parameters
u = https://www.joturl.com/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"embeddable": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=xml
Query parameters
u = https://www.joturl.com/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<embeddable>0</embeddable>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=txt
Query parameters
u = https://www.joturl.com/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_embeddable=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/embeddable?u=https%3A%2F%2Fwww.joturl.com%2F&format=plain
Query parameters
u = https://www.joturl.com/
format = plain
Response
0
Required parameters
parameter | description |
---|---|
uSTRING | URL to be checked |
Return values
parameter | description |
---|---|
embeddable | 1 if the URL is embeddable, 0 otherwise |
/urls/export
access: [READ]
This method export the list of URLs in a user account.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/export
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 13,
"remaining": 0,
"tls": {
"publication name 1": {
"custom.domain5.ext": [
{
"alias": "alias0",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=0",
"visits": 85,
"unique_visits": 40,
"qrcodes_visits": 22
},
{
"alias": "alias1",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=1",
"visits": 67,
"unique_visits": 25,
"qrcodes_visits": 13
},
{
"alias": "alias2",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=2",
"visits": 66,
"unique_visits": 30,
"qrcodes_visits": 10
}
]
},
"publication name 2": {
"custom.domain1.ext": [
{
"alias": "alias3",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=3",
"visits": 16,
"unique_visits": 9,
"qrcodes_visits": 7
},
{
"alias": "alias4",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=4",
"visits": 96,
"unique_visits": 80,
"qrcodes_visits": 50
},
{
"alias": "alias5",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=5",
"visits": 28,
"unique_visits": 28,
"qrcodes_visits": 23
},
{
"alias": "alias6",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=6",
"visits": 6,
"unique_visits": 4,
"qrcodes_visits": 3
},
{
"alias": "alias7",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=7",
"visits": 10,
"unique_visits": 1,
"qrcodes_visits": 0
}
]
},
"publication name 3": {
"custom.domain5.ext": [
{
"alias": "alias8",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=8",
"visits": 67,
"unique_visits": 5,
"qrcodes_visits": 4
},
{
"alias": "alias9",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=9",
"visits": 15,
"unique_visits": 0,
"qrcodes_visits": 0
},
{
"alias": "alias10",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=10",
"visits": 0,
"unique_visits": 0,
"qrcodes_visits": 0
},
{
"alias": "alias11",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=11",
"visits": 97,
"unique_visits": 54,
"qrcodes_visits": 40
},
{
"alias": "alias12",
"embed_code": "",
"long_url": "https:\/\/my.destination.url\/?p=12",
"visits": 3,
"unique_visits": 0,
"qrcodes_visits": 0
}
]
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/export?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>13</count>
<remaining>0</remaining>
<tls>
<publication name 1>
<custom.domain5.ext>
<i0>
<alias>alias0</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=0</long_url>
<visits>85</visits>
<unique_visits>40</unique_visits>
<qrcodes_visits>22</qrcodes_visits>
</i0>
<i1>
<alias>alias1</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=1</long_url>
<visits>67</visits>
<unique_visits>25</unique_visits>
<qrcodes_visits>13</qrcodes_visits>
</i1>
<i2>
<alias>alias2</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=2</long_url>
<visits>66</visits>
<unique_visits>30</unique_visits>
<qrcodes_visits>10</qrcodes_visits>
</i2>
</custom.domain5.ext>
</publication name 1>
<publication name 2>
<custom.domain1.ext>
<i0>
<alias>alias3</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=3</long_url>
<visits>16</visits>
<unique_visits>9</unique_visits>
<qrcodes_visits>7</qrcodes_visits>
</i0>
<i1>
<alias>alias4</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=4</long_url>
<visits>96</visits>
<unique_visits>80</unique_visits>
<qrcodes_visits>50</qrcodes_visits>
</i1>
<i2>
<alias>alias5</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=5</long_url>
<visits>28</visits>
<unique_visits>28</unique_visits>
<qrcodes_visits>23</qrcodes_visits>
</i2>
<i3>
<alias>alias6</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=6</long_url>
<visits>6</visits>
<unique_visits>4</unique_visits>
<qrcodes_visits>3</qrcodes_visits>
</i3>
<i4>
<alias>alias7</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=7</long_url>
<visits>10</visits>
<unique_visits>1</unique_visits>
<qrcodes_visits>0</qrcodes_visits>
</i4>
</custom.domain1.ext>
</publication name 2>
<publication name 3>
<custom.domain5.ext>
<i0>
<alias>alias8</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=8</long_url>
<visits>67</visits>
<unique_visits>5</unique_visits>
<qrcodes_visits>4</qrcodes_visits>
</i0>
<i1>
<alias>alias9</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=9</long_url>
<visits>15</visits>
<unique_visits>0</unique_visits>
<qrcodes_visits>0</qrcodes_visits>
</i1>
<i2>
<alias>alias10</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=10</long_url>
<visits>0</visits>
<unique_visits>0</unique_visits>
<qrcodes_visits>0</qrcodes_visits>
</i2>
<i3>
<alias>alias11</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=11</long_url>
<visits>97</visits>
<unique_visits>54</unique_visits>
<qrcodes_visits>40</qrcodes_visits>
</i3>
<i4>
<alias>alias12</alias>
<embed_code></embed_code>
<long_url>https://my.destination.url/?p=12</long_url>
<visits>3</visits>
<unique_visits>0</unique_visits>
<qrcodes_visits>0</qrcodes_visits>
</i4>
</custom.domain5.ext>
</publication name 3>
</tls>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/export?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=13
result_remaining=0
result_tls_publication name 1_custom.domain5.ext_0_alias=alias0
result_tls_publication name 1_custom.domain5.ext_0_embed_code=
result_tls_publication name 1_custom.domain5.ext_0_long_url=https://my.destination.url/?p=0
result_tls_publication name 1_custom.domain5.ext_0_visits=85
result_tls_publication name 1_custom.domain5.ext_0_unique_visits=40
result_tls_publication name 1_custom.domain5.ext_0_qrcodes_visits=22
result_tls_publication name 1_custom.domain5.ext_1_alias=alias1
result_tls_publication name 1_custom.domain5.ext_1_embed_code=
result_tls_publication name 1_custom.domain5.ext_1_long_url=https://my.destination.url/?p=1
result_tls_publication name 1_custom.domain5.ext_1_visits=67
result_tls_publication name 1_custom.domain5.ext_1_unique_visits=25
result_tls_publication name 1_custom.domain5.ext_1_qrcodes_visits=13
result_tls_publication name 1_custom.domain5.ext_2_alias=alias2
result_tls_publication name 1_custom.domain5.ext_2_embed_code=
result_tls_publication name 1_custom.domain5.ext_2_long_url=https://my.destination.url/?p=2
result_tls_publication name 1_custom.domain5.ext_2_visits=66
result_tls_publication name 1_custom.domain5.ext_2_unique_visits=30
result_tls_publication name 1_custom.domain5.ext_2_qrcodes_visits=10
result_tls_publication name 2_custom.domain1.ext_0_alias=alias3
result_tls_publication name 2_custom.domain1.ext_0_embed_code=
result_tls_publication name 2_custom.domain1.ext_0_long_url=https://my.destination.url/?p=3
result_tls_publication name 2_custom.domain1.ext_0_visits=16
result_tls_publication name 2_custom.domain1.ext_0_unique_visits=9
result_tls_publication name 2_custom.domain1.ext_0_qrcodes_visits=7
result_tls_publication name 2_custom.domain1.ext_1_alias=alias4
result_tls_publication name 2_custom.domain1.ext_1_embed_code=
result_tls_publication name 2_custom.domain1.ext_1_long_url=https://my.destination.url/?p=4
result_tls_publication name 2_custom.domain1.ext_1_visits=96
result_tls_publication name 2_custom.domain1.ext_1_unique_visits=80
result_tls_publication name 2_custom.domain1.ext_1_qrcodes_visits=50
result_tls_publication name 2_custom.domain1.ext_2_alias=alias5
result_tls_publication name 2_custom.domain1.ext_2_embed_code=
result_tls_publication name 2_custom.domain1.ext_2_long_url=https://my.destination.url/?p=5
result_tls_publication name 2_custom.domain1.ext_2_visits=28
result_tls_publication name 2_custom.domain1.ext_2_unique_visits=28
result_tls_publication name 2_custom.domain1.ext_2_qrcodes_visits=23
result_tls_publication name 2_custom.domain1.ext_3_alias=alias6
result_tls_publication name 2_custom.domain1.ext_3_embed_code=
result_tls_publication name 2_custom.domain1.ext_3_long_url=https://my.destination.url/?p=6
result_tls_publication name 2_custom.domain1.ext_3_visits=6
result_tls_publication name 2_custom.domain1.ext_3_unique_visits=4
result_tls_publication name 2_custom.domain1.ext_3_qrcodes_visits=3
result_tls_publication name 2_custom.domain1.ext_4_alias=alias7
result_tls_publication name 2_custom.domain1.ext_4_embed_code=
result_tls_publication name 2_custom.domain1.ext_4_long_url=https://my.destination.url/?p=7
result_tls_publication name 2_custom.domain1.ext_4_visits=10
result_tls_publication name 2_custom.domain1.ext_4_unique_visits=1
result_tls_publication name 2_custom.domain1.ext_4_qrcodes_visits=0
result_tls_publication name 3_custom.domain5.ext_0_alias=alias8
result_tls_publication name 3_custom.domain5.ext_0_embed_code=
result_tls_publication name 3_custom.domain5.ext_0_long_url=https://my.destination.url/?p=8
result_tls_publication name 3_custom.domain5.ext_0_visits=67
result_tls_publication name 3_custom.domain5.ext_0_unique_visits=5
result_tls_publication name 3_custom.domain5.ext_0_qrcodes_visits=4
result_tls_publication name 3_custom.domain5.ext_1_alias=alias9
result_tls_publication name 3_custom.domain5.ext_1_embed_code=
result_tls_publication name 3_custom.domain5.ext_1_long_url=https://my.destination.url/?p=9
result_tls_publication name 3_custom.domain5.ext_1_visits=15
result_tls_publication name 3_custom.domain5.ext_1_unique_visits=0
result_tls_publication name 3_custom.domain5.ext_1_qrcodes_visits=0
result_tls_publication name 3_custom.domain5.ext_2_alias=alias10
result_tls_publication name 3_custom.domain5.ext_2_embed_code=
result_tls_publication name 3_custom.domain5.ext_2_long_url=https://my.destination.url/?p=10
result_tls_publication name 3_custom.domain5.ext_2_visits=0
result_tls_publication name 3_custom.domain5.ext_2_unique_visits=0
result_tls_publication name 3_custom.domain5.ext_2_qrcodes_visits=0
result_tls_publication name 3_custom.domain5.ext_3_alias=alias11
result_tls_publication name 3_custom.domain5.ext_3_embed_code=
result_tls_publication name 3_custom.domain5.ext_3_long_url=https://my.destination.url/?p=11
result_tls_publication name 3_custom.domain5.ext_3_visits=97
result_tls_publication name 3_custom.domain5.ext_3_unique_visits=54
result_tls_publication name 3_custom.domain5.ext_3_qrcodes_visits=40
result_tls_publication name 3_custom.domain5.ext_4_alias=alias12
result_tls_publication name 3_custom.domain5.ext_4_embed_code=
result_tls_publication name 3_custom.domain5.ext_4_long_url=https://my.destination.url/?p=12
result_tls_publication name 3_custom.domain5.ext_4_visits=3
result_tls_publication name 3_custom.domain5.ext_4_unique_visits=0
result_tls_publication name 3_custom.domain5.ext_4_qrcodes_visits=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/export?format=plain
Query parameters
format = plain
Response
13
0
alias0
https://my.destination.url/?p=0
85
40
22
alias1
https://my.destination.url/?p=1
67
25
13
alias2
https://my.destination.url/?p=2
66
30
10
alias3
https://my.destination.url/?p=3
16
9
7
alias4
https://my.destination.url/?p=4
96
80
50
alias5
https://my.destination.url/?p=5
28
28
23
alias6
https://my.destination.url/?p=6
6
4
3
alias7
https://my.destination.url/?p=7
10
1
0
alias8
https://my.destination.url/?p=8
67
5
4
alias9
https://my.destination.url/?p=9
15
0
0
alias10
https://my.destination.url/?p=10
0
0
0
alias11
https://my.destination.url/?p=11
97
54
40
alias12
https://my.destination.url/?p=12
3
0
0
Optional parameters
parameter | description |
---|---|
startINTEGER | the position from which to start the extraction |
Return values
parameter | description |
---|---|
count | total number of tracking links |
next | [OPTIONAL] the URL to be called to obtain the next tracking links, the export ends if this parameter does not exist or the URL is empty |
remaining | remaining tracking links after the export call, the export ends if this parameter is 0 |
tls | array containing the exported tracking links |
/urls/hub
/urls/hub/check
access: [READ]
This method performs an advanced check of conditions in the hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/check?controller_id=de82d0da72c0e2be43681b2865ec3703
Query parameters
controller_id = de82d0da72c0e2be43681b2865ec3703
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"url_id": "eb841d1380e8d1226057a6bce3190998",
"condition": "#referrer# CON 'facebook.com'",
"warning": {
"type": "not_reached",
"message": "condition is never reached"
}
},
{
"url_id": "eb841d1380e8d1226057a6bce3190998",
"condition": "#os# == 'android'",
"warning": {
"type": "=true",
"message": "condition is always true"
}
},
{
"url_id": "cdb5123b3295797cd442ec7e3e7f2eda",
"condition": "#os# != 'android'",
"warning": {
"type": "=false",
"message": "condition is always false"
}
},
{
"url_id": "de82d0da72c0e2be43681b2865ec3703",
"condition": "",
"warning": {
"type": "controller_url",
"message": "the controller destination URL is never reached (at least one rule is always true)"
}
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/check?controller_id=de82d0da72c0e2be43681b2865ec3703&format=xml
Query parameters
controller_id = de82d0da72c0e2be43681b2865ec3703
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<url_id>eb841d1380e8d1226057a6bce3190998</url_id>
<condition>#referrer# CON 'facebook.com'</condition>
<warning>
<type>not_reached</type>
<message>condition is never reached</message>
</warning>
</i0>
<i1>
<url_id>eb841d1380e8d1226057a6bce3190998</url_id>
<condition>#os# == 'android'</condition>
<warning>
<type>=true</type>
<message>condition is always true</message>
</warning>
</i1>
<i2>
<url_id>cdb5123b3295797cd442ec7e3e7f2eda</url_id>
<condition>#os# != 'android'</condition>
<warning>
<type>=false</type>
<message>condition is always false</message>
</warning>
</i2>
<i3>
<url_id>de82d0da72c0e2be43681b2865ec3703</url_id>
<condition></condition>
<warning>
<type>controller_url</type>
<message>the controller destination URL is never reached (at least one rule is always true)</message>
</warning>
</i3>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/check?controller_id=de82d0da72c0e2be43681b2865ec3703&format=txt
Query parameters
controller_id = de82d0da72c0e2be43681b2865ec3703
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_url_id=eb841d1380e8d1226057a6bce3190998
result_data_0_condition=#referrer# CON 'facebook.com'
result_data_0_warning_type=not_reached
result_data_0_warning_message=condition is never reached
result_data_1_url_id=eb841d1380e8d1226057a6bce3190998
result_data_1_condition=#os# == 'android'
result_data_1_warning_type==true
result_data_1_warning_message=condition is always true
result_data_2_url_id=cdb5123b3295797cd442ec7e3e7f2eda
result_data_2_condition=#os# != 'android'
result_data_2_warning_type==false
result_data_2_warning_message=condition is always false
result_data_3_url_id=de82d0da72c0e2be43681b2865ec3703
result_data_3_condition=
result_data_3_warning_type=controller_url
result_data_3_warning_message=the controller destination URL is never reached (at least one rule is always true)
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/check?controller_id=de82d0da72c0e2be43681b2865ec3703&format=plain
Query parameters
controller_id = de82d0da72c0e2be43681b2865ec3703
format = plain
Response
eb841d1380e8d1226057a6bce3190998
#referrer# CON 'facebook.com'
not_reached
condition is never reached
eb841d1380e8d1226057a6bce3190998
#os# == 'android'
=true
condition is always true
cdb5123b3295797cd442ec7e3e7f2eda
#os# != 'android'
=false
condition is always false
de82d0da72c0e2be43681b2865ec3703
controller_url
the controller destination URL is never reached (at least one rule is always true)
Required parameters
parameter | description |
---|---|
controller_idID | ID of the controller tracking link |
Return values
parameter | description |
---|---|
data | array containing information about rule checks, empty if no anomalies are detected |
/urls/hub/clone
access: [WRITE]
Clone the hub configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/clone?from_url_id=dc554b9d95fa6f32c98322b00108cad9&to_url_id=d0ae4a3fe2abf68f46bf846b26f6880d
Query parameters
from_url_id = dc554b9d95fa6f32c98322b00108cad9
to_url_id = d0ae4a3fe2abf68f46bf846b26f6880d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/clone?from_url_id=dc554b9d95fa6f32c98322b00108cad9&to_url_id=d0ae4a3fe2abf68f46bf846b26f6880d&format=xml
Query parameters
from_url_id = dc554b9d95fa6f32c98322b00108cad9
to_url_id = d0ae4a3fe2abf68f46bf846b26f6880d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/clone?from_url_id=dc554b9d95fa6f32c98322b00108cad9&to_url_id=d0ae4a3fe2abf68f46bf846b26f6880d&format=txt
Query parameters
from_url_id = dc554b9d95fa6f32c98322b00108cad9
to_url_id = d0ae4a3fe2abf68f46bf846b26f6880d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/clone?from_url_id=dc554b9d95fa6f32c98322b00108cad9&to_url_id=d0ae4a3fe2abf68f46bf846b26f6880d&format=plain
Query parameters
from_url_id = dc554b9d95fa6f32c98322b00108cad9
to_url_id = d0ae4a3fe2abf68f46bf846b26f6880d
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the hub configuration from |
to_url_idID | ID of the tracking link you want to the hub configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/hub/conditions
/urls/hub/conditions/add
access: [WRITE]
Add a new condition to the URL hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/add?url_id=05ff82ec1a81c856c96dff41d91b520a&controller_id=0cd7efc691a57309f5353d7d5c7abc54&condition=%23language%23+%3D+%27DE%27
Query parameters
url_id = 05ff82ec1a81c856c96dff41d91b520a
controller_id = 0cd7efc691a57309f5353d7d5c7abc54
condition = #language# = 'DE'
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/add?url_id=05ff82ec1a81c856c96dff41d91b520a&controller_id=0cd7efc691a57309f5353d7d5c7abc54&condition=%23language%23+%3D+%27DE%27&format=xml
Query parameters
url_id = 05ff82ec1a81c856c96dff41d91b520a
controller_id = 0cd7efc691a57309f5353d7d5c7abc54
condition = #language# = 'DE'
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/add?url_id=05ff82ec1a81c856c96dff41d91b520a&controller_id=0cd7efc691a57309f5353d7d5c7abc54&condition=%23language%23+%3D+%27DE%27&format=txt
Query parameters
url_id = 05ff82ec1a81c856c96dff41d91b520a
controller_id = 0cd7efc691a57309f5353d7d5c7abc54
condition = #language# = 'DE'
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/add?url_id=05ff82ec1a81c856c96dff41d91b520a&controller_id=0cd7efc691a57309f5353d7d5c7abc54&condition=%23language%23+%3D+%27DE%27&format=plain
Query parameters
url_id = 05ff82ec1a81c856c96dff41d91b520a
controller_id = 0cd7efc691a57309f5353d7d5c7abc54
condition = #language# = 'DE'
format = plain
Response
1
Required parameters
parameter | description |
---|---|
conditionHTML | if this condition is met, the engine redirects to the tracking link identified by url_id |
controller_idID | ID of the root tracking link |
url_idID | ID of the tracking link to be used if the condition is met |
Optional parameters
parameter | description |
---|---|
old_url_idID | ID of the existing tracking link in the hub to be replaced with the new one identified by url_id |
Return values
parameter | description |
---|---|
added | 1 on success (the new condition is added/replaced), 0 otherwise |
/urls/hub/conditions/check
access: [READ]
This method check the validity of a condition to be used with the hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27
Query parameters
condition = #language# = 'FR'
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": 1
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=xml
Query parameters
condition = #language# = 'FR'
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>1</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=txt
Query parameters
condition = #language# = 'FR'
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/check?condition=%23language%23+%3D+%27FR%27&format=plain
Query parameters
condition = #language# = 'FR'
format = plain
Response
Required parameters
parameter | description |
---|---|
conditionHTML | condition to check |
Return values
parameter | description |
---|---|
result | 1 if the condition is valid, an invalid parameter error with a detailed error is returned otherwise |
/urls/hub/conditions/decompile
access: [READ]
This method decompiles a condition by exploding it into parts.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27
Query parameters
condition = #language# = 'FR'
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"parts": [
{
"level": 0,
"variable": "language",
"operator": "=",
"value": "FR"
}
],
"operators": {
"language": {
"=": "equal to",
"!=": "not equal to"
}
},
"values": {
"language": {
"AF": "Afrikaans",
"AR": "Arabic - \u0627\u0644\u0639\u0631\u0628\u064a\u0629",
"[...]": "[...]",
"*": "custom (replace * with the ISO 639-1 code of the language)"
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=xml
Query parameters
condition = #language# = 'FR'
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<parts>
<i0>
<level>0</level>
<variable>language</variable>
<operator>=</operator>
<value>FR</value>
</i0>
</parts>
<operators>
<language>
<=>equal to</=>
<!=>not equal to</!=>
</language>
</operators>
<values>
<language>
<AF>Afrikaans</AF>
<AR>Arabic - العربية</AR>
<[...]>[...]</[...]>
<*>custom (replace * with the ISO 639-1 code of the language)</*>
</language>
</values>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=txt
Query parameters
condition = #language# = 'FR'
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_parts_0_level=0
result_parts_0_variable=language
result_parts_0_operator==
result_parts_0_value=FR
result_operators_language_==equal to
result_operators_language_!==not equal to
result_values_language_AF=Afrikaans
result_values_language_AR=Arabic - العربية
result_values_language_[...]=[...]
result_values_language_*=custom (replace * with the ISO 639-1 code of the language)
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23language%23+%3D+%27FR%27&format=plain
Query parameters
condition = #language# = 'FR'
format = plain
Response
0
language
=
FR
equal to
not equal to
Afrikaans
Arabic - العربية
[...]
custom (replace * with the ISO 639-1 code of the language)
Example 5 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29
Query parameters
condition = #country# != 'AT' AND ( #language# = 'AF' OR #language# = 'DA' )
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"parts": [
{
"level": 0,
"variable": "country",
"operator": "!=",
"value": "AT"
},
{
"level": 0,
"boolean": "AND"
},
{
"level": 1,
"variable": "language",
"operator": "=",
"value": "AF"
},
{
"level": 1,
"boolean": "OR"
},
{
"level": 1,
"variable": "language",
"operator": "=",
"value": "DA"
}
],
"operators": {
"country": {
"=": "equal to",
"!=": "not equal to"
},
"language": {
"=": "equal to",
"!=": "not equal to"
}
},
"values": {
"country": {
"AF": "Afghanistan (\u0627\u0641\u063a\u0627\u0646\u0633\u062a\u0627\u0646)",
"AX": "Aland Islands",
"[...]": "[...]",
"unk": "Other or unrecognized"
},
"language": {
"AF": "Afrikaans",
"AR": "Arabic - \u0627\u0644\u0639\u0631\u0628\u064a\u0629",
"[...]": "[...]",
"*": "custom (replace * with the ISO 639-1 code of the language)"
}
}
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=xml
Query parameters
condition = #country# != 'AT' AND ( #language# = 'AF' OR #language# = 'DA' )
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<parts>
<i0>
<level>0</level>
<variable>country</variable>
<operator>!=</operator>
<value>AT</value>
</i0>
<i1>
<level>0</level>
<boolean>AND</boolean>
</i1>
<i2>
<level>1</level>
<variable>language</variable>
<operator>=</operator>
<value>AF</value>
</i2>
<i3>
<level>1</level>
<boolean>OR</boolean>
</i3>
<i4>
<level>1</level>
<variable>language</variable>
<operator>=</operator>
<value>DA</value>
</i4>
</parts>
<operators>
<country>
<=>equal to</=>
<!=>not equal to</!=>
</country>
<language>
<=>equal to</=>
<!=>not equal to</!=>
</language>
</operators>
<values>
<country>
<AF>Afghanistan (افغانستان)</AF>
<AX>Aland Islands</AX>
<[...]>[...]</[...]>
<unk>Other or unrecognized</unk>
</country>
<language>
<AF>Afrikaans</AF>
<AR>Arabic - العربية</AR>
<[...]>[...]</[...]>
<*>custom (replace * with the ISO 639-1 code of the language)</*>
</language>
</values>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=txt
Query parameters
condition = #country# != 'AT' AND ( #language# = 'AF' OR #language# = 'DA' )
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_parts_0_level=0
result_parts_0_variable=country
result_parts_0_operator=!=
result_parts_0_value=AT
result_parts_1_level=0
result_parts_1_boolean=AND
result_parts_2_level=1
result_parts_2_variable=language
result_parts_2_operator==
result_parts_2_value=AF
result_parts_3_level=1
result_parts_3_boolean=OR
result_parts_4_level=1
result_parts_4_variable=language
result_parts_4_operator==
result_parts_4_value=DA
result_operators_country_==equal to
result_operators_country_!==not equal to
result_operators_language_==equal to
result_operators_language_!==not equal to
result_values_country_AF=Afghanistan (افغانستان)
result_values_country_AX=Aland Islands
result_values_country_[...]=[...]
result_values_country_unk=Other or unrecognized
result_values_language_AF=Afrikaans
result_values_language_AR=Arabic - العربية
result_values_language_[...]=[...]
result_values_language_*=custom (replace * with the ISO 639-1 code of the language)
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/decompile?condition=%23country%23+%21%3D+%27AT%27++AND+%28+%23language%23+%3D+%27AF%27++OR++%23language%23+%3D+%27DA%27+%29&format=plain
Query parameters
condition = #country# != 'AT' AND ( #language# = 'AF' OR #language# = 'DA' )
format = plain
Response
0
country
!=
AT
0
AND
1
language
=
AF
1
OR
1
language
=
DA
equal to
not equal to
equal to
not equal to
Afghanistan (افغانستان)
Aland Islands
[...]
Other or unrecognized
Afrikaans
Arabic - العربية
[...]
custom (replace * with the ISO 639-1 code of the language)
Required parameters
parameter | description |
---|---|
conditionHTML | condition to decompile |
Return values
parameter | description |
---|---|
operators | foreach varible in parts , it contains the allowed operators |
parts | parts of the condition in the format (level,variable,operator,value) or (level,boolean), where level is the variable of the boolean level (variables/booleans with the same level must be considered in brackets), variable is its name, operator and value are its operator and value, respectively; boolean can be AND or OR |
values | foreach varible in parts , it contains the allowed values |
/urls/hub/conditions/delete
access: [WRITE]
This method allows you to remove a tracking link from the URL hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=086d9fe0bd3a416aea0f3ea61cba0ac7&controller_id=907606ed19dc7f3b23de7d12e936823e
Query parameters
url_id = 086d9fe0bd3a416aea0f3ea61cba0ac7
controller_id = 907606ed19dc7f3b23de7d12e936823e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1,
"isActive": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=086d9fe0bd3a416aea0f3ea61cba0ac7&controller_id=907606ed19dc7f3b23de7d12e936823e&format=xml
Query parameters
url_id = 086d9fe0bd3a416aea0f3ea61cba0ac7
controller_id = 907606ed19dc7f3b23de7d12e936823e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
<isActive>1</isActive>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=086d9fe0bd3a416aea0f3ea61cba0ac7&controller_id=907606ed19dc7f3b23de7d12e936823e&format=txt
Query parameters
url_id = 086d9fe0bd3a416aea0f3ea61cba0ac7
controller_id = 907606ed19dc7f3b23de7d12e936823e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
result_isActive=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/delete?url_id=086d9fe0bd3a416aea0f3ea61cba0ac7&controller_id=907606ed19dc7f3b23de7d12e936823e&format=plain
Query parameters
url_id = 086d9fe0bd3a416aea0f3ea61cba0ac7
controller_id = 907606ed19dc7f3b23de7d12e936823e
format = plain
Response
1
1
Required parameters
parameter | description |
---|---|
controller_idID | ID of the root tracking link |
url_idID | ID of the tracking link to remove |
Return values
parameter | description |
---|---|
deleted | 1 on success (the new tracking link is deleted), 0 otherwise |
isActive | 1 if the hub is still active after deleting the tracking link identified by url_id (i.e., the hub has at least 2 tracking links, including the root tracking link), 0 otherwise |
/urls/hub/conditions/order
access: [WRITE]
This method allows you to set the order for the tracking links of a hub URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=be3d24d19555a08d87d8ca5825dd3373&ids%5B0%5D=8e7ad0c714e13ec8d2537f8ae22b638b&ids%5B1%5D=d0869588824378e0b9b43614e7273852&ids%5B2%5D=0c9789355123a8f67ed6612b3b48bb22&orders%5B0%5D=3&orders%5B1%5D=2&orders%5B2%5D=1
Query parameters
controller_id = be3d24d19555a08d87d8ca5825dd3373
ids[0] = 8e7ad0c714e13ec8d2537f8ae22b638b
ids[1] = d0869588824378e0b9b43614e7273852
ids[2] = 0c9789355123a8f67ed6612b3b48bb22
orders[0] = 3
orders[1] = 2
orders[2] = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"modified": 2,
"isActive": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=be3d24d19555a08d87d8ca5825dd3373&ids%5B0%5D=8e7ad0c714e13ec8d2537f8ae22b638b&ids%5B1%5D=d0869588824378e0b9b43614e7273852&ids%5B2%5D=0c9789355123a8f67ed6612b3b48bb22&orders%5B0%5D=3&orders%5B1%5D=2&orders%5B2%5D=1&format=xml
Query parameters
controller_id = be3d24d19555a08d87d8ca5825dd3373
ids[0] = 8e7ad0c714e13ec8d2537f8ae22b638b
ids[1] = d0869588824378e0b9b43614e7273852
ids[2] = 0c9789355123a8f67ed6612b3b48bb22
orders[0] = 3
orders[1] = 2
orders[2] = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<modified>2</modified>
<isActive>1</isActive>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=be3d24d19555a08d87d8ca5825dd3373&ids%5B0%5D=8e7ad0c714e13ec8d2537f8ae22b638b&ids%5B1%5D=d0869588824378e0b9b43614e7273852&ids%5B2%5D=0c9789355123a8f67ed6612b3b48bb22&orders%5B0%5D=3&orders%5B1%5D=2&orders%5B2%5D=1&format=txt
Query parameters
controller_id = be3d24d19555a08d87d8ca5825dd3373
ids[0] = 8e7ad0c714e13ec8d2537f8ae22b638b
ids[1] = d0869588824378e0b9b43614e7273852
ids[2] = 0c9789355123a8f67ed6612b3b48bb22
orders[0] = 3
orders[1] = 2
orders[2] = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_modified=2
result_isActive=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/conditions/order?controller_id=be3d24d19555a08d87d8ca5825dd3373&ids%5B0%5D=8e7ad0c714e13ec8d2537f8ae22b638b&ids%5B1%5D=d0869588824378e0b9b43614e7273852&ids%5B2%5D=0c9789355123a8f67ed6612b3b48bb22&orders%5B0%5D=3&orders%5B1%5D=2&orders%5B2%5D=1&format=plain
Query parameters
controller_id = be3d24d19555a08d87d8ca5825dd3373
ids[0] = 8e7ad0c714e13ec8d2537f8ae22b638b
ids[1] = d0869588824378e0b9b43614e7273852
ids[2] = 0c9789355123a8f67ed6612b3b48bb22
orders[0] = 3
orders[1] = 2
orders[2] = 1
format = plain
Response
2
1
Required parameters
parameter | description |
---|---|
controller_idID | ID of the root tracking link |
idsARRAY_OF_IDS | list of tracking link IDs for which to set the order |
ordersARRAY | list of integers defining the order of tracking links identified by ids |
Return values
parameter | description |
---|---|
isActive | 1 if the hub is still active after reordering the tracking links, 0 otherwise |
modified | tracking link number whose ordering has actually changed |
/urls/hub/debug
access: [READ]
Get a debug URL for a specific hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/debug?controller_id=607d75b6f61ef596400346238c425296
Query parameters
controller_id = 607d75b6f61ef596400346238c425296
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"debug_url": "https:\/\/jo.my\/joturl?9774AA75!dbg",
"valid_until": "2025-05-11T13:18:51+00:00"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/debug?controller_id=607d75b6f61ef596400346238c425296&format=xml
Query parameters
controller_id = 607d75b6f61ef596400346238c425296
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<debug_url>https://jo.my/joturl?9774AA75!dbg</debug_url>
<valid_until>2025-05-11T13:18:51+00:00</valid_until>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/debug?controller_id=607d75b6f61ef596400346238c425296&format=txt
Query parameters
controller_id = 607d75b6f61ef596400346238c425296
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_debug_url=https://jo.my/joturl?9774AA75!dbg
result_valid_until=2025-05-11T13:18:51+00:00
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/debug?controller_id=607d75b6f61ef596400346238c425296&format=plain
Query parameters
controller_id = 607d75b6f61ef596400346238c425296
format = plain
Response
https://jo.my/joturl?9774AA75!dbg
2025-05-11T13:18:51+00:00
Required parameters
parameter | description |
---|---|
controller_idID | ID of the root tracking link |
Return values
parameter | description |
---|---|
debug_url | debug URL |
valid_until | expiration date for the debug URL (ISO 8601 date format, e.g., 2025-05-11T13:18:51+00:00) |
/urls/hub/delete
access: [WRITE]
Delete a URL hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/delete?controller_id=b5f80855df266e15fae53c57f7a2ee6a
Query parameters
controller_id = b5f80855df266e15fae53c57f7a2ee6a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/delete?controller_id=b5f80855df266e15fae53c57f7a2ee6a&format=xml
Query parameters
controller_id = b5f80855df266e15fae53c57f7a2ee6a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/delete?controller_id=b5f80855df266e15fae53c57f7a2ee6a&format=txt
Query parameters
controller_id = b5f80855df266e15fae53c57f7a2ee6a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/delete?controller_id=b5f80855df266e15fae53c57f7a2ee6a&format=plain
Query parameters
controller_id = b5f80855df266e15fae53c57f7a2ee6a
format = plain
Response
1
Required parameters
parameter | description |
---|---|
controller_idID | ID of the tracking link from which to remove a URL hub |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/hub/info
access: [READ]
Returns the URLs associated with a URL hub.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/info?controller_id=4c3eac38afb23caaeef63318834df5fb
Query parameters
controller_id = 4c3eac38afb23caaeef63318834df5fb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"url_id": "934059febb215a15fc617d9db0694c2c",
"short_url": "https:\/\/jo.my\/tracking_link_condition_1",
"condition": "#language# = 'IT'"
},
{
"url_id": "95e96014f8660867bdf09b0a75daf512",
"short_url": "https:\/\/jo.my\/tracking_link_condition_2",
"condition": "#language# = 'DE'"
}
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/info?controller_id=4c3eac38afb23caaeef63318834df5fb&format=xml
Query parameters
controller_id = 4c3eac38afb23caaeef63318834df5fb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<url_id>934059febb215a15fc617d9db0694c2c</url_id>
<short_url>https://jo.my/tracking_link_condition_1</short_url>
<condition>#language# = 'IT'</condition>
</i0>
<i1>
<url_id>95e96014f8660867bdf09b0a75daf512</url_id>
<short_url>https://jo.my/tracking_link_condition_2</short_url>
<condition>#language# = 'DE'</condition>
</i1>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/info?controller_id=4c3eac38afb23caaeef63318834df5fb&format=txt
Query parameters
controller_id = 4c3eac38afb23caaeef63318834df5fb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_url_id=934059febb215a15fc617d9db0694c2c
result_0_short_url=https://jo.my/tracking_link_condition_1
result_0_condition=#language# = 'IT'
result_1_url_id=95e96014f8660867bdf09b0a75daf512
result_1_short_url=https://jo.my/tracking_link_condition_2
result_1_condition=#language# = 'DE'
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/info?controller_id=4c3eac38afb23caaeef63318834df5fb&format=plain
Query parameters
controller_id = 4c3eac38afb23caaeef63318834df5fb
format = plain
Response
https://jo.my/tracking_link_condition_1
https://jo.my/tracking_link_condition_2
Required parameters
parameter | description |
---|---|
controller_idID | ID of the controller tracking link |
Return values
parameter | description |
---|---|
data | array of objects in the format ( url_id , short_url , condition ), where url_id is the tracking link ID, short_url is the tracking link itself and condition is the condition to be satisfied to redirect to the aforementioned tracking link. A maximum of 100 items are returned (the limit on the number of conditions that can be created) |
/urls/hub/variable
access: [READ]
This method returns a list of variables that can be used with the Smart Redirector. Furthermore, if parameter name
is passed, possible accepted operators and values are returned.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/hub/variable
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"variables": {
"language": "Language",
"country": "Country",
"os": "Operating system",
"os_version": "Operating system version",
"mobile_device": "Mobile device",
"browser": "Browser",
"browser_type": "Browser type",
"browser_version": "Main browser version",
"visits": "Visits",
"unique_visits": "Unique visits",
"is_qrcode": "QR-Code?",
"visited": "Already visited?",
"time": "Time (UTC)",
"datetime": "Date\/Time (UTC)",
"referrer": "Referrer",
"user_agent": "User agent"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/hub/variable?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<variables>
<language>Language</language>
<country>Country</country>
<os>Operating system</os>
<os_version>Operating system version</os_version>
<mobile_device>Mobile device</mobile_device>
<browser>Browser</browser>
<browser_type>Browser type</browser_type>
<browser_version>Main browser version</browser_version>
<visits>Visits</visits>
<unique_visits>Unique visits</unique_visits>
<is_qrcode>QR-Code?</is_qrcode>
<visited>Already visited?</visited>
<time>Time (UTC)</time>
<datetime>Date/Time (UTC)</datetime>
<referrer>Referrer</referrer>
<user_agent>User agent</user_agent>
</variables>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/hub/variable?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_variables_language=Language
result_variables_country=Country
result_variables_os=Operating system
result_variables_os_version=Operating system version
result_variables_mobile_device=Mobile device
result_variables_browser=Browser
result_variables_browser_type=Browser type
result_variables_browser_version=Main browser version
result_variables_visits=Visits
result_variables_unique_visits=Unique visits
result_variables_is_qrcode=QR-Code?
result_variables_visited=Already visited?
result_variables_time=Time (UTC)
result_variables_datetime=Date/Time (UTC)
result_variables_referrer=Referrer
result_variables_user_agent=User agent
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/hub/variable?format=plain
Query parameters
format = plain
Response
Language
Country
Operating system
Operating system version
Mobile device
Browser
Browser type
Main browser version
Visits
Unique visits
QR-Code?
Already visited?
Time (UTC)
Date/Time (UTC)
Referrer
User agent
Example 5 (json)
Request
https://joturl.com/a/i1/urls/hub/variable?0=8
Query parameters
0 = 8
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": []
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/hub/variable?0=8&format=xml
Query parameters
0 = 8
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/hub/variable?0=8&format=txt
Query parameters
0 = 8
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result=
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/hub/variable?0=8&format=plain
Query parameters
0 = 8
format = plain
Response
Optional parameters
parameter | description |
---|---|
nameSTRING | name of the variable for which to extract the possible operators and values |
Return values
parameter | description |
---|---|
operators | [OPTIONAL] array containing a list of available operators for the given variable name , it is passed only if name is passed |
values | [OPTIONAL] array containing a list of available values for the given variable name , it is passed only if name is passed |
variables | array containing a list of available variables |
/urls/import
access: [WRITE]
This method import tracking links into a specific project.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/import?domain_id=68e4b929e784be371653d06933627993
Query parameters
domain_id = 68e4b929e784be371653d06933627993
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"imported": 853,
"errors": []
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/import?domain_id=68e4b929e784be371653d06933627993&format=xml
Query parameters
domain_id = 68e4b929e784be371653d06933627993
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<imported>853</imported>
<errors>
</errors>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/import?domain_id=68e4b929e784be371653d06933627993&format=txt
Query parameters
domain_id = 68e4b929e784be371653d06933627993
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_imported=853
result_errors=
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/import?domain_id=68e4b929e784be371653d06933627993&format=plain
Query parameters
domain_id = 68e4b929e784be371653d06933627993
format = plain
Response
853
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain on which to import tracking links |
inputSTRING | name of the HTML form field that is used to transfer the CSV file |
Optional parameters
parameter | description |
---|---|
check_onlyBOOLEAN | if 1 only a file check is required, no tracking link will be imported, default: 0 |
csv_has_headerBOOLEAN | 1 if the CSV file has a header line, default: 0 |
csv_sepSTRING | CSV delimiter, default: ; (semicolon) |
project_idID | ID of the project on which to import tracking links, if not specified the default will be used |
Return values
parameter | description |
---|---|
_accepted_id | ID to be used to retrieve the current import status or to stop the import procedure |
_accepted_key | a string representing the current import operation |
_accepted_perc | percentage of completion of the import (floating point number) |
check_only | echo back of the input parameter check_only |
csv_has_header | echo back of the input parameter csv_has_header |
csv_sep | echo back of the input parameter csv_sep |
domain_id | echo back of the input parameter domain_id |
errors | array containing errors that occurred during the import (one element for each error) |
imported | number of imported tracking links |
project_id | echo back of the input parameter project_id |
/urls/info
access: [READ]
This method returns the info about a tracking link, returned fields are specified by parameter fields.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/info?fields=id,short_url&id=6300e98f3b0b753e644f6bf81e617511
Query parameters
fields = id,short_url
id = 6300e98f3b0b753e644f6bf81e617511
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "6300e98f3b0b753e644f6bf81e617511",
"short_url": "http:\/\/jo.my\/35442d16"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/info?fields=id,short_url&id=6300e98f3b0b753e644f6bf81e617511&format=xml
Query parameters
fields = id,short_url
id = 6300e98f3b0b753e644f6bf81e617511
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>6300e98f3b0b753e644f6bf81e617511</id>
<short_url>http://jo.my/35442d16</short_url>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/info?fields=id,short_url&id=6300e98f3b0b753e644f6bf81e617511&format=txt
Query parameters
fields = id,short_url
id = 6300e98f3b0b753e644f6bf81e617511
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=6300e98f3b0b753e644f6bf81e617511
result_data_0_short_url=http://jo.my/35442d16
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/info?fields=id,short_url&id=6300e98f3b0b753e644f6bf81e617511&format=plain
Query parameters
fields = id,short_url
id = 6300e98f3b0b753e644f6bf81e617511
format = plain
Response
http://jo.my/35442d16
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, see method i1/urls/list for reference |
idID | ID of the tracking link whose information is required |
Return values
parameter | description |
---|---|
data | array containing 1 item on success, the returned information depends on the fields parameter. |
/urls/instaurls
/urls/instaurls/clone
access: [WRITE]
Clone the InstaUrl configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=099b116642d9fd77316a2adb2c745a49&to_url_id=7dcf42ce39bdc831d1dae5978b5aeae4
Query parameters
from_url_id = 099b116642d9fd77316a2adb2c745a49
to_url_id = 7dcf42ce39bdc831d1dae5978b5aeae4
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=099b116642d9fd77316a2adb2c745a49&to_url_id=7dcf42ce39bdc831d1dae5978b5aeae4&format=xml
Query parameters
from_url_id = 099b116642d9fd77316a2adb2c745a49
to_url_id = 7dcf42ce39bdc831d1dae5978b5aeae4
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=099b116642d9fd77316a2adb2c745a49&to_url_id=7dcf42ce39bdc831d1dae5978b5aeae4&format=txt
Query parameters
from_url_id = 099b116642d9fd77316a2adb2c745a49
to_url_id = 7dcf42ce39bdc831d1dae5978b5aeae4
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/instaurls/clone?from_url_id=099b116642d9fd77316a2adb2c745a49&to_url_id=7dcf42ce39bdc831d1dae5978b5aeae4&format=plain
Query parameters
from_url_id = 099b116642d9fd77316a2adb2c745a49
to_url_id = 7dcf42ce39bdc831d1dae5978b5aeae4
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the InstaUrl configuration from |
to_url_idID | ID of the tracking link you want to the InstaUrl configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/instaurls/delete
access: [WRITE]
Delete InstaUrl settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/delete?id=9850a77e5175a689ecc37c9c3b84561b
Query parameters
id = 9850a77e5175a689ecc37c9c3b84561b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/instaurls/delete?id=9850a77e5175a689ecc37c9c3b84561b&format=xml
Query parameters
id = 9850a77e5175a689ecc37c9c3b84561b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/instaurls/delete?id=9850a77e5175a689ecc37c9c3b84561b&format=txt
Query parameters
id = 9850a77e5175a689ecc37c9c3b84561b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/instaurls/delete?id=9850a77e5175a689ecc37c9c3b84561b&format=plain
Query parameters
id = 9850a77e5175a689ecc37c9c3b84561b
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove an InstaUrl configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/instaurls/icons
/urls/instaurls/icons/info
access: [READ]
This method returns info on a SVG icon for InstaUrl.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/icons/info?id=181259f1d03409b4d3f64bab9be73ff2
Query parameters
id = 181259f1d03409b4d3f64bab9be73ff2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "181259f1d03409b4d3f64bab9be73ff2",
"svg": "<svg>[...]<\/svg>"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/instaurls/icons/info?id=181259f1d03409b4d3f64bab9be73ff2&format=xml
Query parameters
id = 181259f1d03409b4d3f64bab9be73ff2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>181259f1d03409b4d3f64bab9be73ff2</id>
<svg><[CDATA[&lt;svg&gt;[...]&lt;/svg&gt;]]></svg>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/instaurls/icons/info?id=181259f1d03409b4d3f64bab9be73ff2&format=txt
Query parameters
id = 181259f1d03409b4d3f64bab9be73ff2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=181259f1d03409b4d3f64bab9be73ff2
result_svg=&lt;svg&gt;[...]&lt;/svg&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/instaurls/icons/info?id=181259f1d03409b4d3f64bab9be73ff2&format=plain
Query parameters
id = 181259f1d03409b4d3f64bab9be73ff2
format = plain
Response
181259f1d03409b4d3f64bab9be73ff2
&lt;svg&gt;[...]&lt;/svg&gt;
Required parameters
parameter | description |
---|---|
idSTRING | ID of the icon as returned by the i1/urls/instaurls/icons/list method |
Return values
parameter | description |
---|---|
svg | SVG of the requested icon |
/urls/instaurls/icons/list
access: [READ]
This method returns a list of SVG icons for InstaUrl.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/icons/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1422,
"icons": {
"id": "3ddfb2e651291c36da63d3d0f0f53ece",
"svg": "<svg>[...]<\/svg>"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/instaurls/icons/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1422</count>
<icons>
<id>3ddfb2e651291c36da63d3d0f0f53ece</id>
<svg><[CDATA[&lt;svg&gt;[...]&lt;/svg&gt;]]></svg>
</icons>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/instaurls/icons/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1422
result_icons_id=3ddfb2e651291c36da63d3d0f0f53ece
result_icons_svg=&lt;svg&gt;[...]&lt;/svg&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/instaurls/icons/list?format=plain
Query parameters
format = plain
Response
1422
3ddfb2e651291c36da63d3d0f0f53ece
&lt;svg&gt;[...]&lt;/svg&gt;
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
searchSTRING | filters items to be extracted by searching them |
startINTEGER | starts to extract items from this position |
Return values
parameter | description |
---|---|
count | total number of icons |
icons | array containing icons in the format {"id":"[id of the icon]","svg":"[SVG of the icon"} |
/urls/jotbars
/urls/jotbars/clone
access: [WRITE]
Clone the jotbar configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=2de645a36bd96bf26d3ac76501eb1dc4&to_url_id=867744b90dfc8719fa597b4d58f952e9
Query parameters
from_url_id = 2de645a36bd96bf26d3ac76501eb1dc4
to_url_id = 867744b90dfc8719fa597b4d58f952e9
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=2de645a36bd96bf26d3ac76501eb1dc4&to_url_id=867744b90dfc8719fa597b4d58f952e9&format=xml
Query parameters
from_url_id = 2de645a36bd96bf26d3ac76501eb1dc4
to_url_id = 867744b90dfc8719fa597b4d58f952e9
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=2de645a36bd96bf26d3ac76501eb1dc4&to_url_id=867744b90dfc8719fa597b4d58f952e9&format=txt
Query parameters
from_url_id = 2de645a36bd96bf26d3ac76501eb1dc4
to_url_id = 867744b90dfc8719fa597b4d58f952e9
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/jotbars/clone?from_url_id=2de645a36bd96bf26d3ac76501eb1dc4&to_url_id=867744b90dfc8719fa597b4d58f952e9&format=plain
Query parameters
from_url_id = 2de645a36bd96bf26d3ac76501eb1dc4
to_url_id = 867744b90dfc8719fa597b4d58f952e9
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the jotbar configuration from |
to_url_idID | ID of the tracking link you want to the jotbar configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/jotbars/delete
access: [WRITE]
Remove a jotbar option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/jotbars/delete?id=10fc2ae856531767adf47263c3641552
Query parameters
id = 10fc2ae856531767adf47263c3641552
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/jotbars/delete?id=10fc2ae856531767adf47263c3641552&format=xml
Query parameters
id = 10fc2ae856531767adf47263c3641552
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/jotbars/delete?id=10fc2ae856531767adf47263c3641552&format=txt
Query parameters
id = 10fc2ae856531767adf47263c3641552
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/jotbars/delete?id=10fc2ae856531767adf47263c3641552&format=plain
Query parameters
id = 10fc2ae856531767adf47263c3641552
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a jotbar configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/jotbars/edit
access: [WRITE]
Set a jotbar option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/jotbars/edit?id=de614e53d28f7752ae83824306d50e3c&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D
Query parameters
id = de614e53d28f7752ae83824306d50e3c
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/jotbars/edit?id=de614e53d28f7752ae83824306d50e3c&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml
Query parameters
id = de614e53d28f7752ae83824306d50e3c
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/jotbars/edit?id=de614e53d28f7752ae83824306d50e3c&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt
Query parameters
id = de614e53d28f7752ae83824306d50e3c
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/jotbars/edit?id=de614e53d28f7752ae83824306d50e3c&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&user_default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain
Query parameters
id = de614e53d28f7752ae83824306d50e3c
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language =
user_default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the project |
Optional parameters
parameter | description |
---|---|
embed_codeHTML | embed code for videos (for example the YouTube embedding code <iframe ...></iframe>), if available |
infoJSON | JSON containing page_title, description_title, description, questions_title, questions for each language in languages, see i1/urls/jotbars/info for details on info |
logoSTRING | 0 to disable logo, the URL of the logo to be shown, empty or null to inherit the configuration from the account-level settings |
logo_urlSTRING | when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo |
show_feedbackSTRING | 1 to show feedback, 0 to do not show it, empty or null to inherit the configuration from the account-level settings |
templateSTRING | position of the jotbar, empty or null to inherit the configuration from the account-level settings, for available positions see i1/jotbars/property |
template_sizeSTRING | dimension of the jotbar, empty or null to inherit the configuration from the account-level settings,for available dimensions see i1/jotbars/property |
video_durationSTRING | it represents the duration of the video in embed_code, if available |
Return values
parameter | description |
---|---|
data | NA |
/urls/jotbars/info
access: [READ]
Get jotbar information of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/jotbars/info?id=0058fc2117a410242316381d0ae60a36
Query parameters
id = 0058fc2117a410242316381d0ae60a36
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"logo": "https:\/\/joturl.com\/logo.svg",
"logo_url": "https:\/\/joturl.com\/",
"template": "right",
"template_size": "big",
"show_feedback": null,
"embed_code": null,
"video_duration": null,
"info": {
"en": {
"page_title": "English page title",
"description_title": null,
"description": "<p>[EN] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[EN] HTML questions<\/p>"
},
"it": {
"page_title": "Titolo pagina in italiano",
"description_title": null,
"description": "<p>[IT] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[IT] HTML questions<\/p>"
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/jotbars/info?id=0058fc2117a410242316381d0ae60a36&format=xml
Query parameters
id = 0058fc2117a410242316381d0ae60a36
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<logo>https://joturl.com/logo.svg</logo>
<logo_url>https://joturl.com/</logo_url>
<template>right</template>
<template_size>big</template_size>
<show_feedback></show_feedback>
<embed_code></embed_code>
<video_duration></video_duration>
<info>
<en>
<page_title>English page title</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>
</en>
<it>
<page_title>Titolo pagina in italiano</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>
</it>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/jotbars/info?id=0058fc2117a410242316381d0ae60a36&format=txt
Query parameters
id = 0058fc2117a410242316381d0ae60a36
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_embed_code=
result_video_duration=
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/jotbars/info?id=0058fc2117a410242316381d0ae60a36&format=plain
Query parameters
id = 0058fc2117a410242316381d0ae60a36
format = plain
Response
https://joturl.com/logo.svg
https://joturl.com/
right
big
English page title
&lt;p&gt;[EN] HTML description&lt;/p&gt;
&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano
&lt;p&gt;[IT] HTML description&lt;/p&gt;
&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
embed_code | embed code for videos (for example the YouTube embedding code <iframe ...></iframe>), if available |
info | for each language in languages, it contains page_title, description_title, description, questions_title, questions, see the following notes for details |
logo | 0 to disable logo, the URL of the logo to be shown, empty or null to inherit the configuration from the account-level settings |
logo_url | when logo has an URL, this is the URL to which the user will be redirect when clicks on the logo |
show_feedback | 1 to show feedback, 0 to do not show it, empty or null to inherit the configuration from the account-level settings |
template | position of the jotbar, for available positions see i1/jotbars/property |
template_size | dimension of the jotbar, for available dimensions see i1/jotbars/property |
video_duration | it represents the duration of the video in embed_code, if available |
/urls/languages
/urls/languages/list
access: [READ]
This method returns a list of available languages for specific options (e.g., Masking, jotBar) of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/languages/list?id=a2f0c364b51eade7c2263b5d17461a8f
Query parameters
id = a2f0c364b51eade7c2263b5d17461a8f
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"name": "en",
"label": "English"
},
{
"name": "it",
"label": "Italiano"
}
]
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/languages/list?id=a2f0c364b51eade7c2263b5d17461a8f&format=xml
Query parameters
id = a2f0c364b51eade7c2263b5d17461a8f
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<name>en</name>
<label>English</label>
</i0>
<i1>
<name>it</name>
<label>Italiano</label>
</i1>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/languages/list?id=a2f0c364b51eade7c2263b5d17461a8f&format=txt
Query parameters
id = a2f0c364b51eade7c2263b5d17461a8f
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_name=en
result_0_label=English
result_1_name=it
result_1_label=Italiano
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/languages/list?id=a2f0c364b51eade7c2263b5d17461a8f&format=plain
Query parameters
id = a2f0c364b51eade7c2263b5d17461a8f
format = plain
Response
en
English
it
Italiano
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
[ARRAY] | array containing available languages |
/urls/last
access: [READ]
This method returns the list of the last 100 tracking links strictly created by the logged user. Returned fields are that specified in the parameter fields.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/last?fields=id,short_url,creation
Query parameters
fields = id,short_url,creation
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"creation": "2025-05-11 13:18:51",
"id": "915367deabade15436329d296fa1a80b",
"short_url": "http:\/\/jo.my\/f12b5d20"
},
{
"creation": "2025-05-11 12:18:51",
"id": "c0b03961ff3d9a59dc44e7ba82eac085",
"short_url": "http:\/\/jo.my\/f821266c"
},
{
"creation": "2025-05-11 11:18:51",
"id": "3d049ac9527c1bb097bda9ab059cff28",
"short_url": "http:\/\/jo.my\/a5fdbd92"
},
{
"creation": "2025-05-11 10:18:51",
"id": "4c36428e9246463d0a5085cd49052f48",
"short_url": "http:\/\/jo.my\/56d91528"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=xml
Query parameters
fields = id,short_url,creation
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<creation>2025-05-11 13:18:51</creation>
<id>915367deabade15436329d296fa1a80b</id>
<short_url>http://jo.my/f12b5d20</short_url>
</i0>
<i1>
<creation>2025-05-11 12:18:51</creation>
<id>c0b03961ff3d9a59dc44e7ba82eac085</id>
<short_url>http://jo.my/f821266c</short_url>
</i1>
<i2>
<creation>2025-05-11 11:18:51</creation>
<id>3d049ac9527c1bb097bda9ab059cff28</id>
<short_url>http://jo.my/a5fdbd92</short_url>
</i2>
<i3>
<creation>2025-05-11 10:18:51</creation>
<id>4c36428e9246463d0a5085cd49052f48</id>
<short_url>http://jo.my/56d91528</short_url>
</i3>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=txt
Query parameters
fields = id,short_url,creation
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_creation=2025-05-11 13:18:51
result_data_0_id=915367deabade15436329d296fa1a80b
result_data_0_short_url=http://jo.my/f12b5d20
result_data_1_creation=2025-05-11 12:18:51
result_data_1_id=c0b03961ff3d9a59dc44e7ba82eac085
result_data_1_short_url=http://jo.my/f821266c
result_data_2_creation=2025-05-11 11:18:51
result_data_2_id=3d049ac9527c1bb097bda9ab059cff28
result_data_2_short_url=http://jo.my/a5fdbd92
result_data_3_creation=2025-05-11 10:18:51
result_data_3_id=4c36428e9246463d0a5085cd49052f48
result_data_3_short_url=http://jo.my/56d91528
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/last?fields=id,short_url,creation&format=plain
Query parameters
fields = id,short_url,creation
format = plain
Response
http://jo.my/f12b5d20
http://jo.my/f821266c
http://jo.my/a5fdbd92
http://jo.my/56d91528
Required parameters
parameter | description |
---|---|
fieldsARRAY | see method i1/urls/list for reference |
Optional parameters
parameter | description |
---|---|
end_dateDATE | see method i1/urls/list for reference |
filterSTRING | see method i1/urls/list for reference |
is_tracking_pixelBOOLEAN | see method i1/urls/list for reference |
lengthINTEGER | see method i1/urls/list for reference |
optionSTRING | see method i1/urls/list for reference |
orderbyARRAY | orders items by field (see method i1/urls/list for reference). Default is orderby = creation |
project_idID | ID of the project, if empty or unspecified, this method returns last-created tracking links for the whole account |
searchSTRING | see method i1/urls/list for reference |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order. Default is sort = DESC |
startINTEGER | see method i1/urls/list for reference |
start_dateDATE | see method i1/urls/list for reference |
whereSTRING | see method i1/urls/list for reference |
with_alertsBOOLEAN | see method i1/urls/list for reference |
Return values
parameter | description |
---|---|
count | see method i1/urls/list for reference |
data | see method i1/urls/list for reference |
/urls/list
access: [READ]
This method returns a list of tracking links' data, returned fields are specified by parameter fields.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=9d14561b78962a931bdb1973ab11f097
Query parameters
fields = id,short_url
project_id = 9d14561b78962a931bdb1973ab11f097
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "626a9a536b4f395c234dbfeb5c4a361c",
"short_url": "http:\/\/jo.my\/6f0caf0e"
},
{
"id": "ecc2ad032fefc2198ba1fe5edd460468",
"short_url": "http:\/\/jo.my\/321521cc"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=9d14561b78962a931bdb1973ab11f097&format=xml
Query parameters
fields = id,short_url
project_id = 9d14561b78962a931bdb1973ab11f097
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>626a9a536b4f395c234dbfeb5c4a361c</id>
<short_url>http://jo.my/6f0caf0e</short_url>
</i0>
<i1>
<id>ecc2ad032fefc2198ba1fe5edd460468</id>
<short_url>http://jo.my/321521cc</short_url>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=9d14561b78962a931bdb1973ab11f097&format=txt
Query parameters
fields = id,short_url
project_id = 9d14561b78962a931bdb1973ab11f097
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=626a9a536b4f395c234dbfeb5c4a361c
result_data_0_short_url=http://jo.my/6f0caf0e
result_data_1_id=ecc2ad032fefc2198ba1fe5edd460468
result_data_1_short_url=http://jo.my/321521cc
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/list?fields=id,short_url&project_id=9d14561b78962a931bdb1973ab11f097&format=plain
Query parameters
fields = id,short_url
project_id = 9d14561b78962a931bdb1973ab11f097
format = plain
Response
http://jo.my/6f0caf0e
http://jo.my/321521cc
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: count, id, short_url, creation, url_tags, visits, unique_visits, qrcodes_visits, conversions_visits, long_url, notes, alias, options, is_tracking_pixel, project_id, project_name, domain_id, domain_host, domain_nickname |
Optional parameters
parameter | description |
---|---|
end_dateDATE | filter tracking links created up to this date (inclusive) |
filterSTRING | filter tracking links based on specific criteria, see notes for available filters |
is_tracking_pixelBOOLEAN | 1 to return only tracking pixels, 0 to return only tracking links, do not pass this parameter to return both |
lengthINTEGER | extracts this number of items (maxmimum allowed: 100) |
optionSTRING | filter tracking links by option, see i1/urls/options/list for a list of available options |
orderbyARRAY | orders items by field, available fields: count, id, short_url, creation, url_tags, visits, unique_visits, qrcodes_visits, conversions_visits, long_url, notes, alias, options, is_tracking_pixel, project_id, project_name, domain_id, domain_host, domain_nickname |
project_idID | ID of the project, if empty or unspecified, the default project will be assumed |
searchSTRING | filters items to be extracted by searching them |
sortSTRING | sorts items in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract items from this position |
start_dateDATE | filter tracking links created from this date (inclusive) |
whereSTRING | to be used in conjunction with search, specifies where to search and it can be [alias,domain,destination,notes,tags,utms]; |
with_alertsBOOLEAN | filter tracking links with security alerts |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of tracking links, returned only if count is passed in fields |
data | array containing information on the tracking links, the returned information depends on the fields parameter. |
/urls/masking
/urls/masking/clone
access: [WRITE]
Clone the masking configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/masking/clone?from_url_id=b10a2943df2e156c00127909fcb7a71b&to_url_id=362231b50625f093056866fb1e9f6618
Query parameters
from_url_id = b10a2943df2e156c00127909fcb7a71b
to_url_id = 362231b50625f093056866fb1e9f6618
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/masking/clone?from_url_id=b10a2943df2e156c00127909fcb7a71b&to_url_id=362231b50625f093056866fb1e9f6618&format=xml
Query parameters
from_url_id = b10a2943df2e156c00127909fcb7a71b
to_url_id = 362231b50625f093056866fb1e9f6618
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/masking/clone?from_url_id=b10a2943df2e156c00127909fcb7a71b&to_url_id=362231b50625f093056866fb1e9f6618&format=txt
Query parameters
from_url_id = b10a2943df2e156c00127909fcb7a71b
to_url_id = 362231b50625f093056866fb1e9f6618
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/masking/clone?from_url_id=b10a2943df2e156c00127909fcb7a71b&to_url_id=362231b50625f093056866fb1e9f6618&format=plain
Query parameters
from_url_id = b10a2943df2e156c00127909fcb7a71b
to_url_id = 362231b50625f093056866fb1e9f6618
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the masking configuration from |
to_url_idID | ID of the tracking link you want to copy the masking configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/masking/delete
access: [WRITE]
Delete the masking option from a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/masking/delete?id=b82527d1921eb7804b067f38c9037e18
Query parameters
id = b82527d1921eb7804b067f38c9037e18
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/masking/delete?id=b82527d1921eb7804b067f38c9037e18&format=xml
Query parameters
id = b82527d1921eb7804b067f38c9037e18
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/masking/delete?id=b82527d1921eb7804b067f38c9037e18&format=txt
Query parameters
id = b82527d1921eb7804b067f38c9037e18
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/masking/delete?id=b82527d1921eb7804b067f38c9037e18&format=plain
Query parameters
id = b82527d1921eb7804b067f38c9037e18
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a Masking configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/masking/edit
access: [WRITE]
Set a masking option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/masking/edit?id=d1c4a6a5e00e70a3c3eff4db97bcb95f&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3644641143
Query parameters
id = d1c4a6a5e00e70a3c3eff4db97bcb95f
titles[en] = This is title for the page in English
titles[it] = Questo è un titolo per la pagina in Italiano
obfuscated = 1
favicon = https://www.joturl.com/favicon.ico
otc_enabled = 1
otc_validity = 50
otc_private_key = 3644641143
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/masking/edit?id=d1c4a6a5e00e70a3c3eff4db97bcb95f&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3644641143&format=xml
Query parameters
id = d1c4a6a5e00e70a3c3eff4db97bcb95f
titles[en] = This is title for the page in English
titles[it] = Questo è un titolo per la pagina in Italiano
obfuscated = 1
favicon = https://www.joturl.com/favicon.ico
otc_enabled = 1
otc_validity = 50
otc_private_key = 3644641143
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/masking/edit?id=d1c4a6a5e00e70a3c3eff4db97bcb95f&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3644641143&format=txt
Query parameters
id = d1c4a6a5e00e70a3c3eff4db97bcb95f
titles[en] = This is title for the page in English
titles[it] = Questo è un titolo per la pagina in Italiano
obfuscated = 1
favicon = https://www.joturl.com/favicon.ico
otc_enabled = 1
otc_validity = 50
otc_private_key = 3644641143
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/masking/edit?id=d1c4a6a5e00e70a3c3eff4db97bcb95f&titles%5Ben%5D=This+is+title+for+the+page+in+English&titles%5Bit%5D=Questo+%C3%A8+un+titolo+per+la+pagina+in+Italiano&obfuscated=1&favicon=https%3A%2F%2Fwww.joturl.com%2Ffavicon.ico&otc_enabled=1&otc_validity=50&otc_private_key=3644641143&format=plain
Query parameters
id = d1c4a6a5e00e70a3c3eff4db97bcb95f
titles[en] = This is title for the page in English
titles[it] = Questo è un titolo per la pagina in Italiano
obfuscated = 1
favicon = https://www.joturl.com/favicon.ico
otc_enabled = 1
otc_validity = 50
otc_private_key = 3644641143
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Optional parameters
parameter | description | max length |
---|---|---|
faviconURL | complete URL for the favicon to be used, this URL must be in HTTPS to avoid securiy issues | 4000 |
obfuscatedBOOLEAN | 1 if the destiantion URL should be obfuscated, 0 otherwise | |
otc_enabledBOOLEAN | 1 to enable one-time code feature, 0 otherwise | |
otc_validityINTEGER | the time in seconds that the one-time code remains valid, too short times can cause malfunctions, too long times can give other users access to the one-time code. Available times: 10, 20, 30, 40, 50, 60, 180, 360, 540, 720, 1440, 2880, 4320, 5760, 7200, 8640, 10080 | |
titlesJSON | titles for the masking page, one for each supported language; it contains couples (language codes, title), each title can contain maximum 500 characters | 500 |
Return values
parameter | description |
---|---|
enabled | 1 on success, 0 otherwise |
/urls/masking/info
access: [READ]
Get masking information for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/masking/info?id=383acb284c07e00da6d95d90f99253a3
Query parameters
id = 383acb284c07e00da6d95d90f99253a3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"titles": {
"en": "This is title for the page in English",
"it": "Questo è un titolo per la pagina in Italiano"
},
"obfuscated": 1,
"favicon": "https:\/\/www.joturl.com\/favicon.ico",
"otc_enabled": 1,
"otc_validity": 50,
"otc_private_key": "1324087372"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/masking/info?id=383acb284c07e00da6d95d90f99253a3&format=xml
Query parameters
id = 383acb284c07e00da6d95d90f99253a3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<titles>
<en>This is title for the page in English</en>
<it><[CDATA[Questo &egrave; un titolo per la pagina in Italiano]]></it>
</titles>
<obfuscated>1</obfuscated>
<favicon>https://www.joturl.com/favicon.ico</favicon>
<otc_enabled>1</otc_enabled>
<otc_validity>50</otc_validity>
<otc_private_key>1324087372</otc_private_key>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/masking/info?id=383acb284c07e00da6d95d90f99253a3&format=txt
Query parameters
id = 383acb284c07e00da6d95d90f99253a3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_titles_en=This is title for the page in English
result_titles_it=Questo &egrave; un titolo per la pagina in Italiano
result_obfuscated=1
result_favicon=https://www.joturl.com/favicon.ico
result_otc_enabled=1
result_otc_validity=50
result_otc_private_key=1324087372
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/masking/info?id=383acb284c07e00da6d95d90f99253a3&format=plain
Query parameters
id = 383acb284c07e00da6d95d90f99253a3
format = plain
Response
This is title for the page in English
Questo &egrave; un titolo per la pagina in Italiano
1
https://www.joturl.com/favicon.ico
1
50
1324087372
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
favicon | [OPTIONAL] complete URL for the favicon to be used, this URL must be in HTTPS to avoid securiy issues |
obfuscated | [OPTIONAL] 1 if the destiantion URL should be obfuscated, 0 otherwise |
otc_enabled | [OPTIONAL] 1 if the one-time code feature is enabled, 0 otherwise |
otc_private_key | [OPTIONAL] one-time code private key, it is the key to be used to generate one-time codes |
otc_validity | [OPTIONAL] the time in seconds that the one-time code remains valid, see i1/urls/masking/edit for details |
titles | [OPTIONAL] titles for the masking page, one for each supported language |
/urls/minipages
/urls/minipages/clone
access: [WRITE]
Clone the minpages configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/minipages/clone?from_url_id=d3b03ec706fb858b6903cf7245e4af67&to_url_id=1772ce3aeaea7f6d4a95034b90386112
Query parameters
from_url_id = d3b03ec706fb858b6903cf7245e4af67
to_url_id = 1772ce3aeaea7f6d4a95034b90386112
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/minipages/clone?from_url_id=d3b03ec706fb858b6903cf7245e4af67&to_url_id=1772ce3aeaea7f6d4a95034b90386112&format=xml
Query parameters
from_url_id = d3b03ec706fb858b6903cf7245e4af67
to_url_id = 1772ce3aeaea7f6d4a95034b90386112
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/minipages/clone?from_url_id=d3b03ec706fb858b6903cf7245e4af67&to_url_id=1772ce3aeaea7f6d4a95034b90386112&format=txt
Query parameters
from_url_id = d3b03ec706fb858b6903cf7245e4af67
to_url_id = 1772ce3aeaea7f6d4a95034b90386112
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/minipages/clone?from_url_id=d3b03ec706fb858b6903cf7245e4af67&to_url_id=1772ce3aeaea7f6d4a95034b90386112&format=plain
Query parameters
from_url_id = d3b03ec706fb858b6903cf7245e4af67
to_url_id = 1772ce3aeaea7f6d4a95034b90386112
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the minpages configuration from |
to_url_idID | ID of the tracking link you want to the minpages configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/minipages/delete
access: [WRITE]
Unset (delete) a minipage for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/minipages/delete?id=16841cba6ce8617d244e6c6ea656cd6c
Query parameters
id = 16841cba6ce8617d244e6c6ea656cd6c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/minipages/delete?id=16841cba6ce8617d244e6c6ea656cd6c&format=xml
Query parameters
id = 16841cba6ce8617d244e6c6ea656cd6c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/minipages/delete?id=16841cba6ce8617d244e6c6ea656cd6c&format=txt
Query parameters
id = 16841cba6ce8617d244e6c6ea656cd6c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/minipages/delete?id=16841cba6ce8617d244e6c6ea656cd6c&format=plain
Query parameters
id = 16841cba6ce8617d244e6c6ea656cd6c
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a Minipage configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/move
access: [WRITE]
Moves a tracking link from a project to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/move?src_project_id=adbf9d29c72bf0c190246625b88ccca8&dst_project_id=b42fe9bea0cef33cff46fd8097bef645&id=687fc5747db0e699cbfc57d5347b5fb4
Query parameters
src_project_id = adbf9d29c72bf0c190246625b88ccca8
dst_project_id = b42fe9bea0cef33cff46fd8097bef645
id = 687fc5747db0e699cbfc57d5347b5fb4
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"moved": [
{
"src_project_id": "adbf9d29c72bf0c190246625b88ccca8",
"id": "687fc5747db0e699cbfc57d5347b5fb4"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/move?src_project_id=adbf9d29c72bf0c190246625b88ccca8&dst_project_id=b42fe9bea0cef33cff46fd8097bef645&id=687fc5747db0e699cbfc57d5347b5fb4&format=xml
Query parameters
src_project_id = adbf9d29c72bf0c190246625b88ccca8
dst_project_id = b42fe9bea0cef33cff46fd8097bef645
id = 687fc5747db0e699cbfc57d5347b5fb4
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<moved>
<i0>
<src_project_id>adbf9d29c72bf0c190246625b88ccca8</src_project_id>
<id>687fc5747db0e699cbfc57d5347b5fb4</id>
</i0>
</moved>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/move?src_project_id=adbf9d29c72bf0c190246625b88ccca8&dst_project_id=b42fe9bea0cef33cff46fd8097bef645&id=687fc5747db0e699cbfc57d5347b5fb4&format=txt
Query parameters
src_project_id = adbf9d29c72bf0c190246625b88ccca8
dst_project_id = b42fe9bea0cef33cff46fd8097bef645
id = 687fc5747db0e699cbfc57d5347b5fb4
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_moved_0_src_project_id=adbf9d29c72bf0c190246625b88ccca8
result_moved_0_id=687fc5747db0e699cbfc57d5347b5fb4
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/move?src_project_id=adbf9d29c72bf0c190246625b88ccca8&dst_project_id=b42fe9bea0cef33cff46fd8097bef645&id=687fc5747db0e699cbfc57d5347b5fb4&format=plain
Query parameters
src_project_id = adbf9d29c72bf0c190246625b88ccca8
dst_project_id = b42fe9bea0cef33cff46fd8097bef645
id = 687fc5747db0e699cbfc57d5347b5fb4
format = plain
Response
adbf9d29c72bf0c190246625b88ccca8
687fc5747db0e699cbfc57d5347b5fb4
Required parameters
parameter | description |
---|---|
dst_project_idID | ID of the project the tracking link have to be moved to |
src_project_idID | ID of the project the tracking link is currently in |
Optional parameters
parameter | description |
---|---|
fieldsARRAY | see method i1/urls/list for a list of available fields |
idID | ID of the tracking link to move |
idsARRAY_OF_IDS | comma separated list of tracking link IDs to be moved |
Return values
parameter | description |
---|---|
moved | array containing information on the moved tracking links, errors occurred while moving are ignored and this array can be empty. The information returned depends on the fields parameter. If fields is not passed, IDs of the tracking links and of the source project are returned. See method i1/urls/list for a list of return fields. |
/urls/options
/urls/options/check
access: [READ]
Checks if an option is compatible with those active on the tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/options/check?id=e9e421d464100a60264033d9b86b06c6&option=easydeeplink
Query parameters
id = e9e421d464100a60264033d9b86b06c6
option = easydeeplink
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"compatible": 0,
"incompatible": "split"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/options/check?id=e9e421d464100a60264033d9b86b06c6&option=easydeeplink&format=xml
Query parameters
id = e9e421d464100a60264033d9b86b06c6
option = easydeeplink
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<compatible>0</compatible>
<incompatible>split</incompatible>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/options/check?id=e9e421d464100a60264033d9b86b06c6&option=easydeeplink&format=txt
Query parameters
id = e9e421d464100a60264033d9b86b06c6
option = easydeeplink
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_compatible=0
result_incompatible=split
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/options/check?id=e9e421d464100a60264033d9b86b06c6&option=easydeeplink&format=plain
Query parameters
id = e9e421d464100a60264033d9b86b06c6
option = easydeeplink
format = plain
Response
0
split
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
optionSTRING | Option to be checked |
Return values
parameter | description |
---|---|
compatible | 1 if the option is compatible with the options that are active on the tracking link, 0 otherwise |
incompatible | if compatible = 0 , it contains the option that is not compatible with the passed option , if compatible = 1 it is empty. incompatible is not a list of all incompatible options, but just the first option detected |
/urls/options/info
access: [READ]
Returns the list of available options for a specific TLs. Further, this method returns the exclusion list (options that cannot be used with other options), the list of options that are disabled for the user plan and the list of options that can be used to filter tracking links.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/options/info?id=483763
Query parameters
id = 483763
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"options": [
"balancer",
"cloaking",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"parameters",
"preview",
"redirector",
"remarketings",
"selfdestruction",
"split",
"whatsapp"
],
"exclusions": {
"balancer": [
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"cloaking": [],
"conversions": [
"split"
],
"ctas": [
"balancer",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"deeplink": [
"balancer",
"ctas",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"easydeeplink": [
"balancer",
"ctas",
"deeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"instaurl": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"jotbar",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"jotbar": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"masking": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"minipage",
"redirector",
"split",
"whatsapp"
],
"minipage": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"redirector",
"split",
"whatsapp"
],
"parameters": [],
"preview": [],
"redirector": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"remarketings",
"split",
"whatsapp"
],
"remarketings": [
"balancer",
"deeplink",
"easydeeplink",
"redirector",
"split",
"whatsapp"
],
"selfdestruction": [],
"split": [
"balancer",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"whatsapp"
],
"whatsapp": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split"
]
},
"disabled": [],
"filters": [
"balancer",
"cloaking",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"parameters",
"preview",
"redirector",
"remarketings",
"selfdestruction",
"split",
"whatsapp"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/options/info?id=483763&format=xml
Query parameters
id = 483763
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<options>
<i0>balancer</i0>
<i1>cloaking</i1>
<i2>conversions</i2>
<i3>ctas</i3>
<i4>deeplink</i4>
<i5>easydeeplink</i5>
<i6>instaurl</i6>
<i7>jotbar</i7>
<i8>masking</i8>
<i9>minipage</i9>
<i10>parameters</i10>
<i11>preview</i11>
<i12>redirector</i12>
<i13>remarketings</i13>
<i14>selfdestruction</i14>
<i15>split</i15>
<i16>whatsapp</i16>
</options>
<exclusions>
<balancer>
<i0>ctas</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</balancer>
<cloaking>
</cloaking>
<conversions>
<i0>split</i0>
</conversions>
<ctas>
<i0>balancer</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</ctas>
<deeplink>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</deeplink>
<easydeeplink>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</easydeeplink>
<instaurl>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</instaurl>
<jotbar>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</jotbar>
<masking>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</masking>
<minipage>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</minipage>
<parameters>
</parameters>
<preview>
</preview>
<redirector>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>minipage</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</redirector>
<remarketings>
<i0>balancer</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>redirector</i3>
<i4>split</i4>
<i5>whatsapp</i5>
</remarketings>
<selfdestruction>
</selfdestruction>
<split>
<i0>balancer</i0>
<i1>conversions</i1>
<i2>ctas</i2>
<i3>deeplink</i3>
<i4>easydeeplink</i4>
<i5>instaurl</i5>
<i6>jotbar</i6>
<i7>masking</i7>
<i8>minipage</i8>
<i9>redirector</i9>
<i10>remarketings</i10>
<i11>whatsapp</i11>
</split>
<whatsapp>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>minipage</i7>
<i8>redirector</i8>
<i9>remarketings</i9>
<i10>split</i10>
</whatsapp>
</exclusions>
<disabled>
</disabled>
<filters>
<i0>balancer</i0>
<i1>cloaking</i1>
<i2>conversions</i2>
<i3>ctas</i3>
<i4>deeplink</i4>
<i5>easydeeplink</i5>
<i6>instaurl</i6>
<i7>jotbar</i7>
<i8>masking</i8>
<i9>minipage</i9>
<i10>parameters</i10>
<i11>preview</i11>
<i12>redirector</i12>
<i13>remarketings</i13>
<i14>selfdestruction</i14>
<i15>split</i15>
<i16>whatsapp</i16>
</filters>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/options/info?id=483763&format=txt
Query parameters
id = 483763
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=balancer
result_options_1=cloaking
result_options_2=conversions
result_options_3=ctas
result_options_4=deeplink
result_options_5=easydeeplink
result_options_6=instaurl
result_options_7=jotbar
result_options_8=masking
result_options_9=minipage
result_options_10=parameters
result_options_11=preview
result_options_12=redirector
result_options_13=remarketings
result_options_14=selfdestruction
result_options_15=split
result_options_16=whatsapp
result_exclusions_balancer_0=ctas
result_exclusions_balancer_1=deeplink
result_exclusions_balancer_2=easydeeplink
result_exclusions_balancer_3=instaurl
result_exclusions_balancer_4=jotbar
result_exclusions_balancer_5=masking
result_exclusions_balancer_6=minipage
result_exclusions_balancer_7=redirector
result_exclusions_balancer_8=remarketings
result_exclusions_balancer_9=split
result_exclusions_balancer_10=whatsapp
result_exclusions_cloaking=
result_exclusions_conversions_0=split
result_exclusions_ctas_0=balancer
result_exclusions_ctas_1=deeplink
result_exclusions_ctas_2=easydeeplink
result_exclusions_ctas_3=instaurl
result_exclusions_ctas_4=jotbar
result_exclusions_ctas_5=masking
result_exclusions_ctas_6=minipage
result_exclusions_ctas_7=redirector
result_exclusions_ctas_8=split
result_exclusions_ctas_9=whatsapp
result_exclusions_deeplink_0=balancer
result_exclusions_deeplink_1=ctas
result_exclusions_deeplink_2=easydeeplink
result_exclusions_deeplink_3=instaurl
result_exclusions_deeplink_4=jotbar
result_exclusions_deeplink_5=masking
result_exclusions_deeplink_6=minipage
result_exclusions_deeplink_7=redirector
result_exclusions_deeplink_8=remarketings
result_exclusions_deeplink_9=split
result_exclusions_deeplink_10=whatsapp
result_exclusions_easydeeplink_0=balancer
result_exclusions_easydeeplink_1=ctas
result_exclusions_easydeeplink_2=deeplink
result_exclusions_easydeeplink_3=instaurl
result_exclusions_easydeeplink_4=jotbar
result_exclusions_easydeeplink_5=masking
result_exclusions_easydeeplink_6=minipage
result_exclusions_easydeeplink_7=redirector
result_exclusions_easydeeplink_8=remarketings
result_exclusions_easydeeplink_9=split
result_exclusions_easydeeplink_10=whatsapp
result_exclusions_instaurl_0=balancer
result_exclusions_instaurl_1=ctas
result_exclusions_instaurl_2=deeplink
result_exclusions_instaurl_3=easydeeplink
result_exclusions_instaurl_4=jotbar
result_exclusions_instaurl_5=masking
result_exclusions_instaurl_6=minipage
result_exclusions_instaurl_7=redirector
result_exclusions_instaurl_8=split
result_exclusions_instaurl_9=whatsapp
result_exclusions_jotbar_0=balancer
result_exclusions_jotbar_1=ctas
result_exclusions_jotbar_2=deeplink
result_exclusions_jotbar_3=easydeeplink
result_exclusions_jotbar_4=instaurl
result_exclusions_jotbar_5=masking
result_exclusions_jotbar_6=minipage
result_exclusions_jotbar_7=redirector
result_exclusions_jotbar_8=split
result_exclusions_jotbar_9=whatsapp
result_exclusions_masking_0=balancer
result_exclusions_masking_1=ctas
result_exclusions_masking_2=deeplink
result_exclusions_masking_3=easydeeplink
result_exclusions_masking_4=instaurl
result_exclusions_masking_5=jotbar
result_exclusions_masking_6=minipage
result_exclusions_masking_7=redirector
result_exclusions_masking_8=split
result_exclusions_masking_9=whatsapp
result_exclusions_minipage_0=balancer
result_exclusions_minipage_1=ctas
result_exclusions_minipage_2=deeplink
result_exclusions_minipage_3=easydeeplink
result_exclusions_minipage_4=instaurl
result_exclusions_minipage_5=jotbar
result_exclusions_minipage_6=masking
result_exclusions_minipage_7=redirector
result_exclusions_minipage_8=split
result_exclusions_minipage_9=whatsapp
result_exclusions_parameters=
result_exclusions_preview=
result_exclusions_redirector_0=balancer
result_exclusions_redirector_1=ctas
result_exclusions_redirector_2=deeplink
result_exclusions_redirector_3=easydeeplink
result_exclusions_redirector_4=instaurl
result_exclusions_redirector_5=jotbar
result_exclusions_redirector_6=masking
result_exclusions_redirector_7=minipage
result_exclusions_redirector_8=remarketings
result_exclusions_redirector_9=split
result_exclusions_redirector_10=whatsapp
result_exclusions_remarketings_0=balancer
result_exclusions_remarketings_1=deeplink
result_exclusions_remarketings_2=easydeeplink
result_exclusions_remarketings_3=redirector
result_exclusions_remarketings_4=split
result_exclusions_remarketings_5=whatsapp
result_exclusions_selfdestruction=
result_exclusions_split_0=balancer
result_exclusions_split_1=conversions
result_exclusions_split_2=ctas
result_exclusions_split_3=deeplink
result_exclusions_split_4=easydeeplink
result_exclusions_split_5=instaurl
result_exclusions_split_6=jotbar
result_exclusions_split_7=masking
result_exclusions_split_8=minipage
result_exclusions_split_9=redirector
result_exclusions_split_10=remarketings
result_exclusions_split_11=whatsapp
result_exclusions_whatsapp_0=balancer
result_exclusions_whatsapp_1=ctas
result_exclusions_whatsapp_2=deeplink
result_exclusions_whatsapp_3=easydeeplink
result_exclusions_whatsapp_4=instaurl
result_exclusions_whatsapp_5=jotbar
result_exclusions_whatsapp_6=masking
result_exclusions_whatsapp_7=minipage
result_exclusions_whatsapp_8=redirector
result_exclusions_whatsapp_9=remarketings
result_exclusions_whatsapp_10=split
result_disabled=
result_filters_0=balancer
result_filters_1=cloaking
result_filters_2=conversions
result_filters_3=ctas
result_filters_4=deeplink
result_filters_5=easydeeplink
result_filters_6=instaurl
result_filters_7=jotbar
result_filters_8=masking
result_filters_9=minipage
result_filters_10=parameters
result_filters_11=preview
result_filters_12=redirector
result_filters_13=remarketings
result_filters_14=selfdestruction
result_filters_15=split
result_filters_16=whatsapp
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/options/info?id=483763&format=plain
Query parameters
id = 483763
format = plain
Response
balancer
cloaking
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
split
balancer
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
easydeeplink
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
remarketings
split
whatsapp
balancer
deeplink
easydeeplink
redirector
split
whatsapp
balancer
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
balancer
cloaking
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
disabled | List of options that are not available for the current user |
exclusions | List of options that are not compatible with other options. Each option of the list contains an array of incompatible options |
filters | List of options that are can be used to filter tracking links |
options | List of options available for the specified tracking link |
/urls/options/list
access: [READ]
Returns the list of available options for TLs. Further, this method returns the exlusion list (options that cannot be used in conjuction of other options), the list of options that are disabled for the user plan and the list of options that can be used to filter tracking links.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/options/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"options": [
"balancer",
"cloaking",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"parameters",
"preview",
"redirector",
"remarketings",
"selfdestruction",
"split",
"whatsapp"
],
"exclusions": {
"balancer": [
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"cloaking": [],
"conversions": [
"split"
],
"ctas": [
"balancer",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"deeplink": [
"balancer",
"ctas",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"easydeeplink": [
"balancer",
"ctas",
"deeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split",
"whatsapp"
],
"instaurl": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"jotbar",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"jotbar": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"masking",
"minipage",
"redirector",
"split",
"whatsapp"
],
"masking": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"minipage",
"redirector",
"split",
"whatsapp"
],
"minipage": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"redirector",
"split",
"whatsapp"
],
"parameters": [],
"preview": [],
"redirector": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"remarketings",
"split",
"whatsapp"
],
"remarketings": [
"balancer",
"deeplink",
"easydeeplink",
"redirector",
"split",
"whatsapp"
],
"selfdestruction": [],
"split": [
"balancer",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"whatsapp"
],
"whatsapp": [
"balancer",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"redirector",
"remarketings",
"split"
]
},
"disabled": [],
"filters": [
"balancer",
"cloaking",
"conversions",
"ctas",
"deeplink",
"easydeeplink",
"instaurl",
"jotbar",
"masking",
"minipage",
"parameters",
"preview",
"redirector",
"remarketings",
"selfdestruction",
"split",
"whatsapp"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/options/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<options>
<i0>balancer</i0>
<i1>cloaking</i1>
<i2>conversions</i2>
<i3>ctas</i3>
<i4>deeplink</i4>
<i5>easydeeplink</i5>
<i6>instaurl</i6>
<i7>jotbar</i7>
<i8>masking</i8>
<i9>minipage</i9>
<i10>parameters</i10>
<i11>preview</i11>
<i12>redirector</i12>
<i13>remarketings</i13>
<i14>selfdestruction</i14>
<i15>split</i15>
<i16>whatsapp</i16>
</options>
<exclusions>
<balancer>
<i0>ctas</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</balancer>
<cloaking>
</cloaking>
<conversions>
<i0>split</i0>
</conversions>
<ctas>
<i0>balancer</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</ctas>
<deeplink>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>easydeeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</deeplink>
<easydeeplink>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>instaurl</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</easydeeplink>
<instaurl>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>jotbar</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</instaurl>
<jotbar>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>masking</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</jotbar>
<masking>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>minipage</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</masking>
<minipage>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>redirector</i7>
<i8>split</i8>
<i9>whatsapp</i9>
</minipage>
<parameters>
</parameters>
<preview>
</preview>
<redirector>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>minipage</i7>
<i8>remarketings</i8>
<i9>split</i9>
<i10>whatsapp</i10>
</redirector>
<remarketings>
<i0>balancer</i0>
<i1>deeplink</i1>
<i2>easydeeplink</i2>
<i3>redirector</i3>
<i4>split</i4>
<i5>whatsapp</i5>
</remarketings>
<selfdestruction>
</selfdestruction>
<split>
<i0>balancer</i0>
<i1>conversions</i1>
<i2>ctas</i2>
<i3>deeplink</i3>
<i4>easydeeplink</i4>
<i5>instaurl</i5>
<i6>jotbar</i6>
<i7>masking</i7>
<i8>minipage</i8>
<i9>redirector</i9>
<i10>remarketings</i10>
<i11>whatsapp</i11>
</split>
<whatsapp>
<i0>balancer</i0>
<i1>ctas</i1>
<i2>deeplink</i2>
<i3>easydeeplink</i3>
<i4>instaurl</i4>
<i5>jotbar</i5>
<i6>masking</i6>
<i7>minipage</i7>
<i8>redirector</i8>
<i9>remarketings</i9>
<i10>split</i10>
</whatsapp>
</exclusions>
<disabled>
</disabled>
<filters>
<i0>balancer</i0>
<i1>cloaking</i1>
<i2>conversions</i2>
<i3>ctas</i3>
<i4>deeplink</i4>
<i5>easydeeplink</i5>
<i6>instaurl</i6>
<i7>jotbar</i7>
<i8>masking</i8>
<i9>minipage</i9>
<i10>parameters</i10>
<i11>preview</i11>
<i12>redirector</i12>
<i13>remarketings</i13>
<i14>selfdestruction</i14>
<i15>split</i15>
<i16>whatsapp</i16>
</filters>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/options/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_options_0=balancer
result_options_1=cloaking
result_options_2=conversions
result_options_3=ctas
result_options_4=deeplink
result_options_5=easydeeplink
result_options_6=instaurl
result_options_7=jotbar
result_options_8=masking
result_options_9=minipage
result_options_10=parameters
result_options_11=preview
result_options_12=redirector
result_options_13=remarketings
result_options_14=selfdestruction
result_options_15=split
result_options_16=whatsapp
result_exclusions_balancer_0=ctas
result_exclusions_balancer_1=deeplink
result_exclusions_balancer_2=easydeeplink
result_exclusions_balancer_3=instaurl
result_exclusions_balancer_4=jotbar
result_exclusions_balancer_5=masking
result_exclusions_balancer_6=minipage
result_exclusions_balancer_7=redirector
result_exclusions_balancer_8=remarketings
result_exclusions_balancer_9=split
result_exclusions_balancer_10=whatsapp
result_exclusions_cloaking=
result_exclusions_conversions_0=split
result_exclusions_ctas_0=balancer
result_exclusions_ctas_1=deeplink
result_exclusions_ctas_2=easydeeplink
result_exclusions_ctas_3=instaurl
result_exclusions_ctas_4=jotbar
result_exclusions_ctas_5=masking
result_exclusions_ctas_6=minipage
result_exclusions_ctas_7=redirector
result_exclusions_ctas_8=split
result_exclusions_ctas_9=whatsapp
result_exclusions_deeplink_0=balancer
result_exclusions_deeplink_1=ctas
result_exclusions_deeplink_2=easydeeplink
result_exclusions_deeplink_3=instaurl
result_exclusions_deeplink_4=jotbar
result_exclusions_deeplink_5=masking
result_exclusions_deeplink_6=minipage
result_exclusions_deeplink_7=redirector
result_exclusions_deeplink_8=remarketings
result_exclusions_deeplink_9=split
result_exclusions_deeplink_10=whatsapp
result_exclusions_easydeeplink_0=balancer
result_exclusions_easydeeplink_1=ctas
result_exclusions_easydeeplink_2=deeplink
result_exclusions_easydeeplink_3=instaurl
result_exclusions_easydeeplink_4=jotbar
result_exclusions_easydeeplink_5=masking
result_exclusions_easydeeplink_6=minipage
result_exclusions_easydeeplink_7=redirector
result_exclusions_easydeeplink_8=remarketings
result_exclusions_easydeeplink_9=split
result_exclusions_easydeeplink_10=whatsapp
result_exclusions_instaurl_0=balancer
result_exclusions_instaurl_1=ctas
result_exclusions_instaurl_2=deeplink
result_exclusions_instaurl_3=easydeeplink
result_exclusions_instaurl_4=jotbar
result_exclusions_instaurl_5=masking
result_exclusions_instaurl_6=minipage
result_exclusions_instaurl_7=redirector
result_exclusions_instaurl_8=split
result_exclusions_instaurl_9=whatsapp
result_exclusions_jotbar_0=balancer
result_exclusions_jotbar_1=ctas
result_exclusions_jotbar_2=deeplink
result_exclusions_jotbar_3=easydeeplink
result_exclusions_jotbar_4=instaurl
result_exclusions_jotbar_5=masking
result_exclusions_jotbar_6=minipage
result_exclusions_jotbar_7=redirector
result_exclusions_jotbar_8=split
result_exclusions_jotbar_9=whatsapp
result_exclusions_masking_0=balancer
result_exclusions_masking_1=ctas
result_exclusions_masking_2=deeplink
result_exclusions_masking_3=easydeeplink
result_exclusions_masking_4=instaurl
result_exclusions_masking_5=jotbar
result_exclusions_masking_6=minipage
result_exclusions_masking_7=redirector
result_exclusions_masking_8=split
result_exclusions_masking_9=whatsapp
result_exclusions_minipage_0=balancer
result_exclusions_minipage_1=ctas
result_exclusions_minipage_2=deeplink
result_exclusions_minipage_3=easydeeplink
result_exclusions_minipage_4=instaurl
result_exclusions_minipage_5=jotbar
result_exclusions_minipage_6=masking
result_exclusions_minipage_7=redirector
result_exclusions_minipage_8=split
result_exclusions_minipage_9=whatsapp
result_exclusions_parameters=
result_exclusions_preview=
result_exclusions_redirector_0=balancer
result_exclusions_redirector_1=ctas
result_exclusions_redirector_2=deeplink
result_exclusions_redirector_3=easydeeplink
result_exclusions_redirector_4=instaurl
result_exclusions_redirector_5=jotbar
result_exclusions_redirector_6=masking
result_exclusions_redirector_7=minipage
result_exclusions_redirector_8=remarketings
result_exclusions_redirector_9=split
result_exclusions_redirector_10=whatsapp
result_exclusions_remarketings_0=balancer
result_exclusions_remarketings_1=deeplink
result_exclusions_remarketings_2=easydeeplink
result_exclusions_remarketings_3=redirector
result_exclusions_remarketings_4=split
result_exclusions_remarketings_5=whatsapp
result_exclusions_selfdestruction=
result_exclusions_split_0=balancer
result_exclusions_split_1=conversions
result_exclusions_split_2=ctas
result_exclusions_split_3=deeplink
result_exclusions_split_4=easydeeplink
result_exclusions_split_5=instaurl
result_exclusions_split_6=jotbar
result_exclusions_split_7=masking
result_exclusions_split_8=minipage
result_exclusions_split_9=redirector
result_exclusions_split_10=remarketings
result_exclusions_split_11=whatsapp
result_exclusions_whatsapp_0=balancer
result_exclusions_whatsapp_1=ctas
result_exclusions_whatsapp_2=deeplink
result_exclusions_whatsapp_3=easydeeplink
result_exclusions_whatsapp_4=instaurl
result_exclusions_whatsapp_5=jotbar
result_exclusions_whatsapp_6=masking
result_exclusions_whatsapp_7=minipage
result_exclusions_whatsapp_8=redirector
result_exclusions_whatsapp_9=remarketings
result_exclusions_whatsapp_10=split
result_disabled=
result_filters_0=balancer
result_filters_1=cloaking
result_filters_2=conversions
result_filters_3=ctas
result_filters_4=deeplink
result_filters_5=easydeeplink
result_filters_6=instaurl
result_filters_7=jotbar
result_filters_8=masking
result_filters_9=minipage
result_filters_10=parameters
result_filters_11=preview
result_filters_12=redirector
result_filters_13=remarketings
result_filters_14=selfdestruction
result_filters_15=split
result_filters_16=whatsapp
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/options/list?format=plain
Query parameters
format = plain
Response
balancer
cloaking
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
split
balancer
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
whatsapp
balancer
ctas
deeplink
easydeeplink
jotbar
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
masking
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
minipage
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
redirector
split
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
remarketings
split
whatsapp
balancer
deeplink
easydeeplink
redirector
split
whatsapp
balancer
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
whatsapp
balancer
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
redirector
remarketings
split
balancer
cloaking
conversions
ctas
deeplink
easydeeplink
instaurl
jotbar
masking
minipage
parameters
preview
redirector
remarketings
selfdestruction
split
whatsapp
Return values
parameter | description |
---|---|
disabled | List of options that are not available for the current user |
exclusions | List of options that are not compatible with other options. Each option of the list contains an array of incompatible options |
filters | List of options that are can be used to filter tracking links |
options | List of options available for tracking links |
/urls/parameters
/urls/parameters/clone
access: [WRITE]
Clone the UTM paramters from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/parameters/clone?from_url_id=16fa3fcebf354a58151c3cfdb145c3ba&to_url_id=45b9f378c3bf7a54685054ce0b144541
Query parameters
from_url_id = 16fa3fcebf354a58151c3cfdb145c3ba
to_url_id = 45b9f378c3bf7a54685054ce0b144541
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/parameters/clone?from_url_id=16fa3fcebf354a58151c3cfdb145c3ba&to_url_id=45b9f378c3bf7a54685054ce0b144541&format=xml
Query parameters
from_url_id = 16fa3fcebf354a58151c3cfdb145c3ba
to_url_id = 45b9f378c3bf7a54685054ce0b144541
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/parameters/clone?from_url_id=16fa3fcebf354a58151c3cfdb145c3ba&to_url_id=45b9f378c3bf7a54685054ce0b144541&format=txt
Query parameters
from_url_id = 16fa3fcebf354a58151c3cfdb145c3ba
to_url_id = 45b9f378c3bf7a54685054ce0b144541
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/parameters/clone?from_url_id=16fa3fcebf354a58151c3cfdb145c3ba&to_url_id=45b9f378c3bf7a54685054ce0b144541&format=plain
Query parameters
from_url_id = 16fa3fcebf354a58151c3cfdb145c3ba
to_url_id = 45b9f378c3bf7a54685054ce0b144541
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the UTM paramters from |
to_url_idID | ID of the tracking link you want to copy the UTM paramters to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/parameters/delete
access: [WRITE]
Delete UTM parameters from the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/parameters/delete?url_id=5f23a73d4a810d90f16f146aeacfc655
Query parameters
url_id = 5f23a73d4a810d90f16f146aeacfc655
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/parameters/delete?url_id=5f23a73d4a810d90f16f146aeacfc655&format=xml
Query parameters
url_id = 5f23a73d4a810d90f16f146aeacfc655
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/parameters/delete?url_id=5f23a73d4a810d90f16f146aeacfc655&format=txt
Query parameters
url_id = 5f23a73d4a810d90f16f146aeacfc655
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/parameters/delete?url_id=5f23a73d4a810d90f16f146aeacfc655&format=plain
Query parameters
url_id = 5f23a73d4a810d90f16f146aeacfc655
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link from which to remove the UTM parameters |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/parameters/edit
access: [WRITE]
Set query and UTM parameters of the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/parameters/edit?url_id=69674a5837dc7c0191661d2d541bf6b9&utm_template_id=cec5418252e00144c53cee73ba2dfbf0¶ms%5Bp1%5D=v1¶ms%5Bp2%5D=v2
Query parameters
url_id = 69674a5837dc7c0191661d2d541bf6b9
utm_template_id = cec5418252e00144c53cee73ba2dfbf0
params[p1] = v1
params[p2] = v2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1,
"url_id": "69674a5837dc7c0191661d2d541bf6b9",
"enabled": 1,
"utm_template_id": "cec5418252e00144c53cee73ba2dfbf0",
"utm_source": "",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": "",
"long_url": "https:\/\/www.joturl.com\/reserved\/projects.html?p1=v1&p2=v2"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/parameters/edit?url_id=69674a5837dc7c0191661d2d541bf6b9&utm_template_id=cec5418252e00144c53cee73ba2dfbf0¶ms%5Bp1%5D=v1¶ms%5Bp2%5D=v2&format=xml
Query parameters
url_id = 69674a5837dc7c0191661d2d541bf6b9
utm_template_id = cec5418252e00144c53cee73ba2dfbf0
params[p1] = v1
params[p2] = v2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
<url_id>69674a5837dc7c0191661d2d541bf6b9</url_id>
<enabled>1</enabled>
<utm_template_id>cec5418252e00144c53cee73ba2dfbf0</utm_template_id>
<utm_source></utm_source>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
<long_url><[CDATA[https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2]]></long_url>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/parameters/edit?url_id=69674a5837dc7c0191661d2d541bf6b9&utm_template_id=cec5418252e00144c53cee73ba2dfbf0¶ms%5Bp1%5D=v1¶ms%5Bp2%5D=v2&format=txt
Query parameters
url_id = 69674a5837dc7c0191661d2d541bf6b9
utm_template_id = cec5418252e00144c53cee73ba2dfbf0
params[p1] = v1
params[p2] = v2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
result_url_id=69674a5837dc7c0191661d2d541bf6b9
result_enabled=1
result_utm_template_id=cec5418252e00144c53cee73ba2dfbf0
result_utm_source=
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
result_long_url=https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/parameters/edit?url_id=69674a5837dc7c0191661d2d541bf6b9&utm_template_id=cec5418252e00144c53cee73ba2dfbf0¶ms%5Bp1%5D=v1¶ms%5Bp2%5D=v2&format=plain
Query parameters
url_id = 69674a5837dc7c0191661d2d541bf6b9
utm_template_id = cec5418252e00144c53cee73ba2dfbf0
params[p1] = v1
params[p2] = v2
format = plain
Response
1
69674a5837dc7c0191661d2d541bf6b9
1
cec5418252e00144c53cee73ba2dfbf0
https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Optional parameters
parameter | description |
---|---|
paramsJSON | couples (key,value) to be set in the destination URL of the tracking link, this only affects the main destination URL, other destination URLs coming from other options (e.g., balancer, timing) are not changed. Old parameters are deleted or changed with the passed values. |
utm_campaignSTRING | UTM campaign parameter |
utm_contentSTRING | UTM content parameter |
utm_mediumSTRING | UTM medium parameter |
utm_sourceSTRING | UTM source parameter |
utm_template_idID | ID of the UTM template to associate to the tracking link |
utm_termSTRING | UTM term parameter |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
enabled | 1 if UTM parameters have been set for the tracking link, 0 otherwise |
long_url | [OPTIONAL] returned only if input paramter params is passed |
utm_campaign | echo back of the input utm_campaign parameter if utm_template_id is not passed, empty otherwise |
utm_content | echo back of the input utm_content parameter if utm_template_id is not passed, empty otherwise |
utm_medium | echo back of the input utm_medium parameter if utm_template_id is not passed, empty otherwise |
utm_source | echo back of the input utm_source parameter if utm_template_id is not passed, empty otherwise |
utm_template_id | echo back of the input utm_template_id parameter |
utm_term | echo back of the input utm_term parameter if utm_template_id is not passed, empty otherwise |
/urls/parameters/info
access: [READ]
Get query and UTM parameters of the destination URL of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/parameters/info?url_id=b7ea7912b94b19a69994570058064fbe
Query parameters
url_id = b7ea7912b94b19a69994570058064fbe
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"params": {
"p1": "v1",
"p2": "v2"
},
"utm_template_id": "65633a52d3a19ff5408808d652598361",
"name": "template name",
"utm_source": "",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": "",
"long_url": "https:\/\/www.joturl.com\/reserved\/projects.html?p1=v1&p2=v2"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/parameters/info?url_id=b7ea7912b94b19a69994570058064fbe&format=xml
Query parameters
url_id = b7ea7912b94b19a69994570058064fbe
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<params>
<p1>v1</p1>
<p2>v2</p2>
</params>
<utm_template_id>65633a52d3a19ff5408808d652598361</utm_template_id>
<name>template name</name>
<utm_source></utm_source>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
<long_url><[CDATA[https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2]]></long_url>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/parameters/info?url_id=b7ea7912b94b19a69994570058064fbe&format=txt
Query parameters
url_id = b7ea7912b94b19a69994570058064fbe
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_params_p1=v1
result_params_p2=v2
result_utm_template_id=65633a52d3a19ff5408808d652598361
result_name=template name
result_utm_source=
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
result_long_url=https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/parameters/info?url_id=b7ea7912b94b19a69994570058064fbe&format=plain
Query parameters
url_id = b7ea7912b94b19a69994570058064fbe
format = plain
Response
v1
v2
65633a52d3a19ff5408808d652598361
template name
https://www.joturl.com/reserved/projects.html?p1=v1&amp;p2=v2
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Return values
parameter | description |
---|---|
long_url | destination URL of the tracking link |
name | name of the UTM template if utm_template_id is not empty |
params | couples (key,value) representing query parameters of the destination URL |
utm_campaign | utm_campaign parameter, it is the utm_campaign defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_campaign defined in the tracking link (if available) |
utm_content | utm_content parameter, it is the utm_content defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_content defined in the tracking link (if available) |
utm_medium | utm_medium parameter, it is the utm_medium defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_medium defined in the tracking link (if available) |
utm_source | utm_source parameter, it is the utm_source defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_source defined in the tracking link (if available) |
utm_template_id | ID of the applied UTM template, if available |
utm_term | utm_term parameter, it is the utm_term defined in the UTM template if utm_template_id is not empty, otherwise it is the custom utm_term defined in the tracking link (if available) |
/urls/password
/urls/password/clone
access: [WRITE]
Clone a password from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/password/clone?from_url_id=b75fde56e6f776fa4fc7195e25796b53&to_url_id=ce20a89ad7bd585a13154d4cdca74b12
Query parameters
from_url_id = b75fde56e6f776fa4fc7195e25796b53
to_url_id = ce20a89ad7bd585a13154d4cdca74b12
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/password/clone?from_url_id=b75fde56e6f776fa4fc7195e25796b53&to_url_id=ce20a89ad7bd585a13154d4cdca74b12&format=xml
Query parameters
from_url_id = b75fde56e6f776fa4fc7195e25796b53
to_url_id = ce20a89ad7bd585a13154d4cdca74b12
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/password/clone?from_url_id=b75fde56e6f776fa4fc7195e25796b53&to_url_id=ce20a89ad7bd585a13154d4cdca74b12&format=txt
Query parameters
from_url_id = b75fde56e6f776fa4fc7195e25796b53
to_url_id = ce20a89ad7bd585a13154d4cdca74b12
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/password/clone?from_url_id=b75fde56e6f776fa4fc7195e25796b53&to_url_id=ce20a89ad7bd585a13154d4cdca74b12&format=plain
Query parameters
from_url_id = b75fde56e6f776fa4fc7195e25796b53
to_url_id = ce20a89ad7bd585a13154d4cdca74b12
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy password from |
to_url_idID | ID of the tracking link you want to copy password to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise (e.g., the password is empty) |
/urls/password/delete
access: [WRITE]
Delete the password of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/password/delete?id=2f7d28891cda623321f6632e0ed33340
Query parameters
id = 2f7d28891cda623321f6632e0ed33340
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/password/delete?id=2f7d28891cda623321f6632e0ed33340&format=xml
Query parameters
id = 2f7d28891cda623321f6632e0ed33340
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/password/delete?id=2f7d28891cda623321f6632e0ed33340&format=txt
Query parameters
id = 2f7d28891cda623321f6632e0ed33340
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/password/delete?id=2f7d28891cda623321f6632e0ed33340&format=plain
Query parameters
id = 2f7d28891cda623321f6632e0ed33340
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove the password |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/password/edit
access: [WRITE]
Define a password for the tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/password/edit?id=fc50981e22d4af91b1ad5f24f8a54cd6&password=a31818a
Query parameters
id = fc50981e22d4af91b1ad5f24f8a54cd6
password = a31818a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"password": "a31818a"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/password/edit?id=fc50981e22d4af91b1ad5f24f8a54cd6&password=a31818a&format=xml
Query parameters
id = fc50981e22d4af91b1ad5f24f8a54cd6
password = a31818a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<password>a31818a</password>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/password/edit?id=fc50981e22d4af91b1ad5f24f8a54cd6&password=a31818a&format=txt
Query parameters
id = fc50981e22d4af91b1ad5f24f8a54cd6
password = a31818a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_password=a31818a
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/password/edit?id=fc50981e22d4af91b1ad5f24f8a54cd6&password=a31818a&format=plain
Query parameters
id = fc50981e22d4af91b1ad5f24f8a54cd6
password = a31818a
format = plain
Response
a31818a
Required parameters
parameter | description | max length |
---|---|---|
idID | ID of the tracking link | |
passwordSTRING | password to use to protect the tracking link | 15 |
Return values
parameter | description |
---|---|
password | echo back of parameter password |
/urls/password/info
access: [READ]
Get the password of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/password/info?id=50a16f27bd495c7e1f1aae7506bc061d
Query parameters
id = 50a16f27bd495c7e1f1aae7506bc061d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"password": "6fb05063"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/password/info?id=50a16f27bd495c7e1f1aae7506bc061d&format=xml
Query parameters
id = 50a16f27bd495c7e1f1aae7506bc061d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<password>6fb05063</password>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/password/info?id=50a16f27bd495c7e1f1aae7506bc061d&format=txt
Query parameters
id = 50a16f27bd495c7e1f1aae7506bc061d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_password=6fb05063
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/password/info?id=50a16f27bd495c7e1f1aae7506bc061d&format=plain
Query parameters
id = 50a16f27bd495c7e1f1aae7506bc061d
format = plain
Response
6fb05063
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
password | password used to pretect the tracking link, empty otherwise |
/urls/preview
/urls/preview/clone
access: [WRITE]
Clone the preview configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/preview/clone?from_url_id=a3addeeffbe6def891ed6e3046fef9bb&to_url_id=a21404627a8c3ba57306c674b0e91ef0
Query parameters
from_url_id = a3addeeffbe6def891ed6e3046fef9bb
to_url_id = a21404627a8c3ba57306c674b0e91ef0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/preview/clone?from_url_id=a3addeeffbe6def891ed6e3046fef9bb&to_url_id=a21404627a8c3ba57306c674b0e91ef0&format=xml
Query parameters
from_url_id = a3addeeffbe6def891ed6e3046fef9bb
to_url_id = a21404627a8c3ba57306c674b0e91ef0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>0</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/preview/clone?from_url_id=a3addeeffbe6def891ed6e3046fef9bb&to_url_id=a21404627a8c3ba57306c674b0e91ef0&format=txt
Query parameters
from_url_id = a3addeeffbe6def891ed6e3046fef9bb
to_url_id = a21404627a8c3ba57306c674b0e91ef0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/preview/clone?from_url_id=a3addeeffbe6def891ed6e3046fef9bb&to_url_id=a21404627a8c3ba57306c674b0e91ef0&format=plain
Query parameters
from_url_id = a3addeeffbe6def891ed6e3046fef9bb
to_url_id = a21404627a8c3ba57306c674b0e91ef0
format = plain
Response
0
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the preview configuration from |
to_url_idID | ID of the tracking link you want to copy the preview configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/preview/delete
access: [WRITE]
Delete the preview option from a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/preview/delete?id=c5644ac0c1e578b468d345dfa5b046e0
Query parameters
id = c5644ac0c1e578b468d345dfa5b046e0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/preview/delete?id=c5644ac0c1e578b468d345dfa5b046e0&format=xml
Query parameters
id = c5644ac0c1e578b468d345dfa5b046e0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/preview/delete?id=c5644ac0c1e578b468d345dfa5b046e0&format=txt
Query parameters
id = c5644ac0c1e578b468d345dfa5b046e0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/preview/delete?id=c5644ac0c1e578b468d345dfa5b046e0&format=plain
Query parameters
id = c5644ac0c1e578b468d345dfa5b046e0
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a preview configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/preview/edit
access: [WRITE]
Set a preview option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/preview/edit?id=50acee88b10ee9590e7587f653b5a212&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg
Query parameters
id = 50acee88b10ee9590e7587f653b5a212
title = This is a custom title
description = This is a custom description
image = https://path.to/link/preview/image.jpg
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/preview/edit?id=50acee88b10ee9590e7587f653b5a212&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=xml
Query parameters
id = 50acee88b10ee9590e7587f653b5a212
title = This is a custom title
description = This is a custom description
image = https://path.to/link/preview/image.jpg
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/preview/edit?id=50acee88b10ee9590e7587f653b5a212&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=txt
Query parameters
id = 50acee88b10ee9590e7587f653b5a212
title = This is a custom title
description = This is a custom description
image = https://path.to/link/preview/image.jpg
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/preview/edit?id=50acee88b10ee9590e7587f653b5a212&title=This+is+a+custom+title&description=This+is+a+custom+description&image=https%3A%2F%2Fpath.to%2Flink%2Fpreview%2Fimage.jpg&format=plain
Query parameters
id = 50acee88b10ee9590e7587f653b5a212
title = This is a custom title
description = This is a custom description
image = https://path.to/link/preview/image.jpg
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Optional parameters
parameter | description | max length |
---|---|---|
cdn_imageJSON | JSON containing info on the CDN image to be used, if present it overrides the image parameter, see i1/cdns/list for details on this object | |
descriptionSTRING | Open Graph description for the preview page | 2000 |
imageURL | complete URL for the Open Graph image to be used, this URL must be in HTTPS to avoid securiy issues, alternatively you can pass a CDN image by using the cdn_image parameter | 4000 |
titleSTRING | Open Graph title for the preview page | 2000 |
Return values
parameter | description |
---|---|
enabled | 1 on success, 0 otherwise |
/urls/preview/info
access: [READ]
Get link preview information for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/preview/info?id=19650f6e0a05dd3e806c2a3e78de71d8
Query parameters
id = 19650f6e0a05dd3e806c2a3e78de71d8
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"title": "This is a custom title",
"description": "This is a custom description",
"image": "https:\/\/path.to\/link\/preview\/image.jpg"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/preview/info?id=19650f6e0a05dd3e806c2a3e78de71d8&format=xml
Query parameters
id = 19650f6e0a05dd3e806c2a3e78de71d8
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<title>This is a custom title</title>
<description>This is a custom description</description>
<image>https://path.to/link/preview/image.jpg</image>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/preview/info?id=19650f6e0a05dd3e806c2a3e78de71d8&format=txt
Query parameters
id = 19650f6e0a05dd3e806c2a3e78de71d8
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_title=This is a custom title
result_description=This is a custom description
result_image=https://path.to/link/preview/image.jpg
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/preview/info?id=19650f6e0a05dd3e806c2a3e78de71d8&format=plain
Query parameters
id = 19650f6e0a05dd3e806c2a3e78de71d8
format = plain
Response
This is a custom title
This is a custom description
https://path.to/link/preview/image.jpg
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
cdn_image | [OPTIONAL] JSON containing info on the CDN image, see i1/urls/preview/edit for details |
description | [OPTIONAL] description to be shown in the link preview |
image | [OPTIONAL] image to be shown in the link preview |
title | [OPTIONAL] title to be shown in the link preview |
/urls/preview/property
access: [READ]
Returns the list of available properties for the Preview option.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/preview/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"image": {
"max_size": 512000,
"max_width": 1200,
"max_height": 630
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/preview/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<image>
<max_size>512000</max_size>
<max_width>1200</max_width>
<max_height>630</max_height>
</image>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/preview/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_image_max_size=512000
result_image_max_width=1200
result_image_max_height=630
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/preview/property?format=plain
Query parameters
format = plain
Response
512000
1200
630
Return values
parameter | description |
---|---|
image | limits ( max_size in bytes, max_width in pixels, max_height in pixels) for the preview image |
/urls/qrcodes
/urls/qrcodes/add
access: [WRITE]
Set a Qr code template for a short URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/qrcodes/add?id=b5934f79e2fcfb1bc522a737e7af4517&qrcode_id=c1317e4b0c5f7dae5d216cee84496e79
Query parameters
id = b5934f79e2fcfb1bc522a737e7af4517
qrcode_id = c1317e4b0c5f7dae5d216cee84496e79
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/qrcodes/add?id=b5934f79e2fcfb1bc522a737e7af4517&qrcode_id=c1317e4b0c5f7dae5d216cee84496e79&format=xml
Query parameters
id = b5934f79e2fcfb1bc522a737e7af4517
qrcode_id = c1317e4b0c5f7dae5d216cee84496e79
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>1</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/qrcodes/add?id=b5934f79e2fcfb1bc522a737e7af4517&qrcode_id=c1317e4b0c5f7dae5d216cee84496e79&format=txt
Query parameters
id = b5934f79e2fcfb1bc522a737e7af4517
qrcode_id = c1317e4b0c5f7dae5d216cee84496e79
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/qrcodes/add?id=b5934f79e2fcfb1bc522a737e7af4517&qrcode_id=c1317e4b0c5f7dae5d216cee84496e79&format=plain
Query parameters
id = b5934f79e2fcfb1bc522a737e7af4517
qrcode_id = c1317e4b0c5f7dae5d216cee84496e79
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
qrcode_idID | ID of the QR code template to associate to the tracking link |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
/urls/qrcodes/clone
access: [WRITE]
Clone the qrcodes configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=0e0a91fc4f8cfcbbf000a7cbcc32dcbc&to_url_id=7062a0311853f0796c89c215a22009fc
Query parameters
from_url_id = 0e0a91fc4f8cfcbbf000a7cbcc32dcbc
to_url_id = 7062a0311853f0796c89c215a22009fc
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=0e0a91fc4f8cfcbbf000a7cbcc32dcbc&to_url_id=7062a0311853f0796c89c215a22009fc&format=xml
Query parameters
from_url_id = 0e0a91fc4f8cfcbbf000a7cbcc32dcbc
to_url_id = 7062a0311853f0796c89c215a22009fc
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=0e0a91fc4f8cfcbbf000a7cbcc32dcbc&to_url_id=7062a0311853f0796c89c215a22009fc&format=txt
Query parameters
from_url_id = 0e0a91fc4f8cfcbbf000a7cbcc32dcbc
to_url_id = 7062a0311853f0796c89c215a22009fc
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/qrcodes/clone?from_url_id=0e0a91fc4f8cfcbbf000a7cbcc32dcbc&to_url_id=7062a0311853f0796c89c215a22009fc&format=plain
Query parameters
from_url_id = 0e0a91fc4f8cfcbbf000a7cbcc32dcbc
to_url_id = 7062a0311853f0796c89c215a22009fc
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy qrcode configuration from |
to_url_idID | ID of the tracking link you want to copy qrcode configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/qrcodes/delete
access: [WRITE]
Unset a Qr code template for a short URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/qrcodes/delete?id=eeb3ad71c2da5664ca80d1d592dd1d21&qrcode_id=facd8facf6f025be750aabc3a1eb6681
Query parameters
id = eeb3ad71c2da5664ca80d1d592dd1d21
qrcode_id = facd8facf6f025be750aabc3a1eb6681
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/qrcodes/delete?id=eeb3ad71c2da5664ca80d1d592dd1d21&qrcode_id=facd8facf6f025be750aabc3a1eb6681&format=xml
Query parameters
id = eeb3ad71c2da5664ca80d1d592dd1d21
qrcode_id = facd8facf6f025be750aabc3a1eb6681
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/qrcodes/delete?id=eeb3ad71c2da5664ca80d1d592dd1d21&qrcode_id=facd8facf6f025be750aabc3a1eb6681&format=txt
Query parameters
id = eeb3ad71c2da5664ca80d1d592dd1d21
qrcode_id = facd8facf6f025be750aabc3a1eb6681
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/qrcodes/delete?id=eeb3ad71c2da5664ca80d1d592dd1d21&qrcode_id=facd8facf6f025be750aabc3a1eb6681&format=plain
Query parameters
id = eeb3ad71c2da5664ca80d1d592dd1d21
qrcode_id = facd8facf6f025be750aabc3a1eb6681
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove the QR code configuration |
Optional parameters
parameter | description |
---|---|
qrcode_idID | ID of the QR code configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/qrcodes/info
access: [READ]
Returns information on QR code customization, if present.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/qrcodes/info?id=50aada9e863040c45cc450519327fc2d&fields=id,name,shape
Query parameters
id = 50aada9e863040c45cc450519327fc2d
fields = id,name,shape
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "9056d266fe07a353494ff61621a0405f",
"name": "QR code template name",
"shape": "rhombus"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/qrcodes/info?id=50aada9e863040c45cc450519327fc2d&fields=id,name,shape&format=xml
Query parameters
id = 50aada9e863040c45cc450519327fc2d
fields = id,name,shape
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>9056d266fe07a353494ff61621a0405f</id>
<name>QR code template name</name>
<shape>rhombus</shape>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/qrcodes/info?id=50aada9e863040c45cc450519327fc2d&fields=id,name,shape&format=txt
Query parameters
id = 50aada9e863040c45cc450519327fc2d
fields = id,name,shape
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=9056d266fe07a353494ff61621a0405f
result_name=QR code template name
result_shape=rhombus
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/qrcodes/info?id=50aada9e863040c45cc450519327fc2d&fields=id,name,shape&format=plain
Query parameters
id = 50aada9e863040c45cc450519327fc2d
fields = id,name,shape
format = plain
Response
9056d266fe07a353494ff61621a0405f
QR code template name
rhombus
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, see i1/qrcodes/info for details |
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
data | see i1/qrcodes/info for details |
/urls/qrcodes/preview
access: [READ]
This method returns a preview of the QR code associated to the tracking link (if any).
Example 1 (json)
Request
https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=d0888660d84b6841707a550d938f204e
Query parameters
size = big
id = d0888660d84b6841707a550d938f204e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"img": "data:image\/png;base64,MWFmNGFiM2YyNTUyZTVlODBlZWJmNGYwN2M1NDgxMTc="
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=d0888660d84b6841707a550d938f204e&format=xml
Query parameters
size = big
id = d0888660d84b6841707a550d938f204e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<img>data:image/png;base64,MWFmNGFiM2YyNTUyZTVlODBlZWJmNGYwN2M1NDgxMTc=</img>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=d0888660d84b6841707a550d938f204e&format=txt
Query parameters
size = big
id = d0888660d84b6841707a550d938f204e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_img=data:image/png;base64,MWFmNGFiM2YyNTUyZTVlODBlZWJmNGYwN2M1NDgxMTc=
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/qrcodes/preview?size=big&id=d0888660d84b6841707a550d938f204e&format=plain
Query parameters
size = big
id = d0888660d84b6841707a550d938f204e
format = plain
Response
data:image/png;base64,MWFmNGFiM2YyNTUyZTVlODBlZWJmNGYwN2M1NDgxMTc=
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Optional parameters
parameter | description |
---|---|
downloadBOOLEAN | see i1/qrcodes/preview for details |
return_imageBOOLEAN | see i1/qrcodes/preview for details |
sizeSTRING | see i1/qrcodes/preview for details |
typeSTRING | see i1/qrcodes/preview for details |
Return values
parameter | description |
---|---|
[BINARY DATA] | see i1/qrcodes/preview for details |
img | see i1/qrcodes/preview for details |
/urls/remarketings
/urls/remarketings/add
access: [WRITE]
Add remarketing pixels to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/add?url_id=809d6825933ea1e75377c1cfddb41eb5&ids=7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1
Query parameters
url_id = 809d6825933ea1e75377c1cfddb41eb5
ids = 7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/add?url_id=809d6825933ea1e75377c1cfddb41eb5&ids=7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1&format=xml
Query parameters
url_id = 809d6825933ea1e75377c1cfddb41eb5
ids = 7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>3</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/add?url_id=809d6825933ea1e75377c1cfddb41eb5&ids=7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1&format=txt
Query parameters
url_id = 809d6825933ea1e75377c1cfddb41eb5
ids = 7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/add?url_id=809d6825933ea1e75377c1cfddb41eb5&ids=7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1&format=plain
Query parameters
url_id = 809d6825933ea1e75377c1cfddb41eb5
ids = 7703cb05b44300a1ad10daad48fd5f04,0aac45a2aafa009dd6e021d96c8ee52c,766caa0ed51c9172629a8600b5ff62e1
format = plain
Response
3
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of remarketing pixels to add (maxmimum number of remarketing pixels: 5) |
url_idID | ID of the tracking link to which to add one or more remarketing pixels |
Return values
parameter | description |
---|---|
added | 0 on error, the number of added remarketing pixels otherwise |
/urls/remarketings/clone
access: [WRITE]
Clone the remarketings configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=b0e3d036ebfa27886e066c8538d2d1d2&to_url_id=68c0cbe785e42f96d8308fb414dffb04
Query parameters
from_url_id = b0e3d036ebfa27886e066c8538d2d1d2
to_url_id = 68c0cbe785e42f96d8308fb414dffb04
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=b0e3d036ebfa27886e066c8538d2d1d2&to_url_id=68c0cbe785e42f96d8308fb414dffb04&format=xml
Query parameters
from_url_id = b0e3d036ebfa27886e066c8538d2d1d2
to_url_id = 68c0cbe785e42f96d8308fb414dffb04
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=b0e3d036ebfa27886e066c8538d2d1d2&to_url_id=68c0cbe785e42f96d8308fb414dffb04&format=txt
Query parameters
from_url_id = b0e3d036ebfa27886e066c8538d2d1d2
to_url_id = 68c0cbe785e42f96d8308fb414dffb04
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/clone?from_url_id=b0e3d036ebfa27886e066c8538d2d1d2&to_url_id=68c0cbe785e42f96d8308fb414dffb04&format=plain
Query parameters
from_url_id = b0e3d036ebfa27886e066c8538d2d1d2
to_url_id = 68c0cbe785e42f96d8308fb414dffb04
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the remarketings configuration from |
to_url_idID | ID of the tracking link you want to copy the remarketings configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/remarketings/count
access: [READ]
This method returns the number of remarketing pixels linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/count?url_id=06430d6d2a617a981ad3d3fac35d0482
Query parameters
url_id = 06430d6d2a617a981ad3d3fac35d0482
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 5
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/count?url_id=06430d6d2a617a981ad3d3fac35d0482&format=xml
Query parameters
url_id = 06430d6d2a617a981ad3d3fac35d0482
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>5</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/count?url_id=06430d6d2a617a981ad3d3fac35d0482&format=txt
Query parameters
url_id = 06430d6d2a617a981ad3d3fac35d0482
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=5
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/count?url_id=06430d6d2a617a981ad3d3fac35d0482&format=plain
Query parameters
url_id = 06430d6d2a617a981ad3d3fac35d0482
format = plain
Response
5
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link to check |
Return values
parameter | description |
---|---|
count | the number of linked remakerting pixels |
/urls/remarketings/delete
access: [WRITE]
Delete one or more remarketing pixels linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/delete?url_id=8dc2e4d37bba10f4321692c7eb3fbf15
Query parameters
url_id = 8dc2e4d37bba10f4321692c7eb3fbf15
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/delete?url_id=8dc2e4d37bba10f4321692c7eb3fbf15&format=xml
Query parameters
url_id = 8dc2e4d37bba10f4321692c7eb3fbf15
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/delete?url_id=8dc2e4d37bba10f4321692c7eb3fbf15&format=txt
Query parameters
url_id = 8dc2e4d37bba10f4321692c7eb3fbf15
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/delete?url_id=8dc2e4d37bba10f4321692c7eb3fbf15&format=plain
Query parameters
url_id = 8dc2e4d37bba10f4321692c7eb3fbf15
format = plain
Response
1
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link from which to remove one or more remarketing pixels |
Optional parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of remarketing pixels to remove, if empty all remarketing pixels will be removed |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/remarketings/edit
access: [WRITE]
Edit the list of tracking pixels linked to a tracking link (all previous tracking pixels are removed).
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/edit?url_id=1aa754b8777b49954fa43104fbac2ca2&ids=7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
Query parameters
url_id = 1aa754b8777b49954fa43104fbac2ca2
ids = 7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ids": "7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/edit?url_id=1aa754b8777b49954fa43104fbac2ca2&ids=7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a&format=xml
Query parameters
url_id = 1aa754b8777b49954fa43104fbac2ca2
ids = 7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ids>7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a</ids>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/edit?url_id=1aa754b8777b49954fa43104fbac2ca2&ids=7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a&format=txt
Query parameters
url_id = 1aa754b8777b49954fa43104fbac2ca2
ids = 7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ids=7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/edit?url_id=1aa754b8777b49954fa43104fbac2ca2&ids=7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a&format=plain
Query parameters
url_id = 1aa754b8777b49954fa43104fbac2ca2
ids = 7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
format = plain
Response
7b39071b6385c4ef62989a986c4fcda0,a52dd68bbbc4ec9ce1893d803f3ed605,1d7949362ae086a8ee5813202499fa5f,6c080913232172061bf74c0c5953bc0a
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of remarketing pixels to add (maxmimum number of remarketing pixels: 5) |
url_idID | ID of the tracking link to which to add one or more remarketing pixels |
Return values
parameter | description |
---|---|
ids | comma-separated list of added remarketing pixels |
/urls/remarketings/list
access: [READ]
This method returns a list of remarketing pixels linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=40a36c4efde4ef3cd055e71c0124c036
Query parameters
fields = count,id,name,notes,code_type,code_id
url_id = 40a36c4efde4ef3cd055e71c0124c036
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"id": "9f763405f641d272c023348a8eeaae82",
"name": "remarketing pixel (bing)",
"notes": "",
"code_type": "bing",
"code_id": "1234567890A"
},
{
"id": "bbfb343b1d02681d54e314434acdd9ee",
"name": "remarketing pixel (facebook)",
"notes": "remarketing pixel for FB",
"code_type": "facebook",
"code_id": "A0987654321"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=40a36c4efde4ef3cd055e71c0124c036&format=xml
Query parameters
fields = count,id,name,notes,code_type,code_id
url_id = 40a36c4efde4ef3cd055e71c0124c036
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<id>9f763405f641d272c023348a8eeaae82</id>
<name>remarketing pixel (bing)</name>
<notes></notes>
<code_type>bing</code_type>
<code_id>1234567890A</code_id>
</i0>
<i1>
<id>bbfb343b1d02681d54e314434acdd9ee</id>
<name>remarketing pixel (facebook)</name>
<notes>remarketing pixel for FB</notes>
<code_type>facebook</code_type>
<code_id>A0987654321</code_id>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=40a36c4efde4ef3cd055e71c0124c036&format=txt
Query parameters
fields = count,id,name,notes,code_type,code_id
url_id = 40a36c4efde4ef3cd055e71c0124c036
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_id=9f763405f641d272c023348a8eeaae82
result_data_0_name=remarketing pixel (bing)
result_data_0_notes=
result_data_0_code_type=bing
result_data_0_code_id=1234567890A
result_data_1_id=bbfb343b1d02681d54e314434acdd9ee
result_data_1_name=remarketing pixel (facebook)
result_data_1_notes=remarketing pixel for FB
result_data_1_code_type=facebook
result_data_1_code_id=A0987654321
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/remarketings/list?fields=count,id,name,notes,code_type,code_id&url_id=40a36c4efde4ef3cd055e71c0124c036&format=plain
Query parameters
fields = count,id,name,notes,code_type,code_id
url_id = 40a36c4efde4ef3cd055e71c0124c036
format = plain
Response
2
9f763405f641d272c023348a8eeaae82
remarketing pixel (bing)
bing
1234567890A
bbfb343b1d02681d54e314434acdd9ee
remarketing pixel (facebook)
remarketing pixel for FB
facebook
A0987654321
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, name, notes, code_type, code_id |
url_idID | ID of the liked tracking link |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of remarketing pixels (maxmimum allowed: 100) |
orderbyARRAY | orders remarketing pixels by field, available fields: id, name, notes, code_type, code_id |
searchSTRING | filters remarketing pixels to be extracted by searching them |
sortSTRING | sorts remarketing pixels in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract remarketing pixels from this position |
Return values
parameter | description |
---|---|
data | array containing information on the remarketing pixels, returned information depends on the fields parameter. |
/urls/selfdestruction
/urls/selfdestruction/clone
access: [WRITE]
Clone a self destruction configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=2bc4dd0f79e8d9b5eaa1eb6a53060a2f&to_url_id=bf68fda580b47212d77e093673814fd9
Query parameters
from_url_id = 2bc4dd0f79e8d9b5eaa1eb6a53060a2f
to_url_id = bf68fda580b47212d77e093673814fd9
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=2bc4dd0f79e8d9b5eaa1eb6a53060a2f&to_url_id=bf68fda580b47212d77e093673814fd9&format=xml
Query parameters
from_url_id = 2bc4dd0f79e8d9b5eaa1eb6a53060a2f
to_url_id = bf68fda580b47212d77e093673814fd9
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=2bc4dd0f79e8d9b5eaa1eb6a53060a2f&to_url_id=bf68fda580b47212d77e093673814fd9&format=txt
Query parameters
from_url_id = 2bc4dd0f79e8d9b5eaa1eb6a53060a2f
to_url_id = bf68fda580b47212d77e093673814fd9
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/selfdestruction/clone?from_url_id=2bc4dd0f79e8d9b5eaa1eb6a53060a2f&to_url_id=bf68fda580b47212d77e093673814fd9&format=plain
Query parameters
from_url_id = 2bc4dd0f79e8d9b5eaa1eb6a53060a2f
to_url_id = bf68fda580b47212d77e093673814fd9
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy self destruction configuration from |
to_url_idID | ID of the tracking link you want to copy self destruction configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/selfdestruction/delete
access: [WRITE]
Delete the self destruction configuration of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/selfdestruction/delete?id=8bbe79767032b40ca648de1a3ac694c8
Query parameters
id = 8bbe79767032b40ca648de1a3ac694c8
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/selfdestruction/delete?id=8bbe79767032b40ca648de1a3ac694c8&format=xml
Query parameters
id = 8bbe79767032b40ca648de1a3ac694c8
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/selfdestruction/delete?id=8bbe79767032b40ca648de1a3ac694c8&format=txt
Query parameters
id = 8bbe79767032b40ca648de1a3ac694c8
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/selfdestruction/delete?id=8bbe79767032b40ca648de1a3ac694c8&format=plain
Query parameters
id = 8bbe79767032b40ca648de1a3ac694c8
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a self destruction configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/selfdestruction/edit
access: [WRITE]
Given the ID of a tracking link, sets a self destruction configuration.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/selfdestruction/edit?id=32cb8393403722676e6d1f6fb386f0c1&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100
Query parameters
id = 32cb8393403722676e6d1f6fb386f0c1
time_offset = 1
time_base = years
from_what = creation
condition_var = visits
condition_operand = <=
condition_value = 100
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"time_offset": "1",
"time_base": "years",
"from_what": "creation",
"condition_var": "visits",
"condition_operand": "<=",
"condition_value": "100"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/selfdestruction/edit?id=32cb8393403722676e6d1f6fb386f0c1&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=xml
Query parameters
id = 32cb8393403722676e6d1f6fb386f0c1
time_offset = 1
time_base = years
from_what = creation
condition_var = visits
condition_operand = <=
condition_value = 100
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<time_offset>1</time_offset>
<time_base>years</time_base>
<from_what>creation</from_what>
<condition_var>visits</condition_var>
<condition_operand><[CDATA[&lt;=]]></condition_operand>
<condition_value>100</condition_value>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/selfdestruction/edit?id=32cb8393403722676e6d1f6fb386f0c1&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=txt
Query parameters
id = 32cb8393403722676e6d1f6fb386f0c1
time_offset = 1
time_base = years
from_what = creation
condition_var = visits
condition_operand = <=
condition_value = 100
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_time_offset=1
result_time_base=years
result_from_what=creation
result_condition_var=visits
result_condition_operand=&lt;=
result_condition_value=100
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/selfdestruction/edit?id=32cb8393403722676e6d1f6fb386f0c1&time_offset=1&time_base=years&from_what=creation&condition_var=visits&condition_operand=%3C%3D&condition_value=100&format=plain
Query parameters
id = 32cb8393403722676e6d1f6fb386f0c1
time_offset = 1
time_base = years
from_what = creation
condition_var = visits
condition_operand = <=
condition_value = 100
format = plain
Response
1
years
creation
visits
&lt;=
100
Required parameters
parameter | description |
---|---|
condition_varENUM | the condition to be met in order to delete the tracking link, see notes for a list of available variables |
from_whatENUM | time reference, the event from which the time_offset is evaluated, see notes for a list of available time references |
idID | ID of the tracking link |
time_baseENUM | time base, see notes for a list of available time bases |
time_offsetINTEGER | time offset (integer greater than 0) |
Optional parameters
parameter | description |
---|---|
condition_operandENUM | the operand for the condition_var , see notes for a list of available operands; mandatory if condition_var is different from inanycase |
condition_valueINTEGER | the value to be used with condition_var (integer greater than or equal to 0), mandatory if condition_var is different from inanycase |
from_dtDATETIME/EMPTY | custom date/time, it cannot be in the past, mandatory when from_what = datetime , otherwise it is ignored |
Return values
parameter | description |
---|---|
condition_operand | echo back of the input parameter condition_operand |
condition_value | echo back of the input parameter condition_value |
condition_var | echo back of the input parameter condition_var |
from_dt | echo back of the input parameter from_dt |
from_what | echo back of the input parameter from_what |
id | echo back of the input parameter id |
time_base | echo back of the input parameter time_base |
time_offset | echo back of the input parameter time_offset |
/urls/selfdestruction/info
access: [READ]
Returns information on the self destruction configuration.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/selfdestruction/info?id=6375db8827ea3677fca3170c96cecb7d
Query parameters
id = 6375db8827ea3677fca3170c96cecb7d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "6375db8827ea3677fca3170c96cecb7d",
"time_offset": "1",
"time_base": "years",
"from_what": "creation",
"condition_var": "visits",
"condition_operand": "<=",
"condition_value": "100"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/selfdestruction/info?id=6375db8827ea3677fca3170c96cecb7d&format=xml
Query parameters
id = 6375db8827ea3677fca3170c96cecb7d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>6375db8827ea3677fca3170c96cecb7d</id>
<time_offset>1</time_offset>
<time_base>years</time_base>
<from_what>creation</from_what>
<condition_var>visits</condition_var>
<condition_operand><[CDATA[&lt;=]]></condition_operand>
<condition_value>100</condition_value>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/selfdestruction/info?id=6375db8827ea3677fca3170c96cecb7d&format=txt
Query parameters
id = 6375db8827ea3677fca3170c96cecb7d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=6375db8827ea3677fca3170c96cecb7d
result_time_offset=1
result_time_base=years
result_from_what=creation
result_condition_var=visits
result_condition_operand=&lt;=
result_condition_value=100
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/selfdestruction/info?id=6375db8827ea3677fca3170c96cecb7d&format=plain
Query parameters
id = 6375db8827ea3677fca3170c96cecb7d
format = plain
Response
6375db8827ea3677fca3170c96cecb7d
1
years
creation
visits
&lt;=
100
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
condition_operand | see i1/urls/selfdestruction/edit for details |
condition_value | see i1/urls/selfdestruction/edit for details |
condition_var | see i1/urls/selfdestruction/edit for details |
from_dt | see i1/urls/selfdestruction/edit for details |
from_what | see i1/urls/selfdestruction/edit for details |
id | see i1/urls/selfdestruction/edit for details |
time_base | see i1/urls/selfdestruction/edit for details |
time_offset | see i1/urls/selfdestruction/edit for details |
/urls/shorten
access: [WRITE]
Creates a shorten tracking link for a given destination URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=e132a61d394be2ecf1bed968e03f2960&project_id=5f8ef76d45ef7c1a1ff9a1d9443d3250&long_url=https%3A%2F%2Fwww.joturl.com%2F
Query parameters
alias = jot
domain_id = e132a61d394be2ecf1bed968e03f2960
project_id = 5f8ef76d45ef7c1a1ff9a1d9443d3250
long_url = https://www.joturl.com/
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "0f382ee6bb62a732fb6c836c95d4be8d",
"alias": "jot",
"domain_id": "e132a61d394be2ecf1bed968e03f2960",
"domain_host": "jo.my",
"domain_nickname": "",
"project_id": "5f8ef76d45ef7c1a1ff9a1d9443d3250",
"project_name": "project name",
"short_url": "\/\/jo.my\/jot",
"long_url": "https:\/\/www.joturl.com\/",
"template_type": 1,
"notes": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=e132a61d394be2ecf1bed968e03f2960&project_id=5f8ef76d45ef7c1a1ff9a1d9443d3250&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=xml
Query parameters
alias = jot
domain_id = e132a61d394be2ecf1bed968e03f2960
project_id = 5f8ef76d45ef7c1a1ff9a1d9443d3250
long_url = https://www.joturl.com/
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>0f382ee6bb62a732fb6c836c95d4be8d</id>
<alias>jot</alias>
<domain_id>e132a61d394be2ecf1bed968e03f2960</domain_id>
<domain_host>jo.my</domain_host>
<domain_nickname></domain_nickname>
<project_id>5f8ef76d45ef7c1a1ff9a1d9443d3250</project_id>
<project_name>project name</project_name>
<short_url>//jo.my/jot</short_url>
<long_url>https://www.joturl.com/</long_url>
<template_type>1</template_type>
<notes></notes>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=e132a61d394be2ecf1bed968e03f2960&project_id=5f8ef76d45ef7c1a1ff9a1d9443d3250&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=txt
Query parameters
alias = jot
domain_id = e132a61d394be2ecf1bed968e03f2960
project_id = 5f8ef76d45ef7c1a1ff9a1d9443d3250
long_url = https://www.joturl.com/
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=0f382ee6bb62a732fb6c836c95d4be8d
result_alias=jot
result_domain_id=e132a61d394be2ecf1bed968e03f2960
result_domain_host=jo.my
result_domain_nickname=
result_project_id=5f8ef76d45ef7c1a1ff9a1d9443d3250
result_project_name=project name
result_short_url=//jo.my/jot
result_long_url=https://www.joturl.com/
result_template_type=1
result_notes=
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=e132a61d394be2ecf1bed968e03f2960&project_id=5f8ef76d45ef7c1a1ff9a1d9443d3250&long_url=https%3A%2F%2Fwww.joturl.com%2F&format=plain
Query parameters
alias = jot
domain_id = e132a61d394be2ecf1bed968e03f2960
project_id = 5f8ef76d45ef7c1a1ff9a1d9443d3250
long_url = https://www.joturl.com/
format = plain
Response
//jo.my/jot
Example 5 (json)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=d7461908fe0d2c6255aad38d306565cc&project_id=b94c327da8e73308d42b08b3a609b78e&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=trying+to+shorten+a+URL+whose+alias+was+already+used
Query parameters
alias = jot
domain_id = d7461908fe0d2c6255aad38d306565cc
project_id = b94c327da8e73308d42b08b3a609b78e
long_url = https://www.joturl.com/
notes = trying to shorten a URL whose alias was already used
Response
{
"status": {
"code": 503,
"text": "GENERIC ERROR",
"error": "The chosen alias is not available.",
"rate": 3
},
"result": []
}
Example 6 (xml)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=d7461908fe0d2c6255aad38d306565cc&project_id=b94c327da8e73308d42b08b3a609b78e&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=trying+to+shorten+a+URL+whose+alias+was+already+used&format=xml
Query parameters
alias = jot
domain_id = d7461908fe0d2c6255aad38d306565cc
project_id = b94c327da8e73308d42b08b3a609b78e
long_url = https://www.joturl.com/
notes = trying to shorten a URL whose alias was already used
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>503</code>
<text>GENERIC ERROR</text>
<error>The chosen alias is not available.</error>
<rate>3</rate>
</status>
<result>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=d7461908fe0d2c6255aad38d306565cc&project_id=b94c327da8e73308d42b08b3a609b78e&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=trying+to+shorten+a+URL+whose+alias+was+already+used&format=txt
Query parameters
alias = jot
domain_id = d7461908fe0d2c6255aad38d306565cc
project_id = b94c327da8e73308d42b08b3a609b78e
long_url = https://www.joturl.com/
notes = trying to shorten a URL whose alias was already used
format = txt
Response
status_code=503
status_text=GENERIC ERROR
status_error=The chosen alias is not available.
status_rate=3
result=
Example 8 (plain)
Request
https://joturl.com/a/i1/urls/shorten?alias=jot&domain_id=d7461908fe0d2c6255aad38d306565cc&project_id=b94c327da8e73308d42b08b3a609b78e&long_url=https%3A%2F%2Fwww.joturl.com%2F¬es=trying+to+shorten+a+URL+whose+alias+was+already+used&format=plain
Query parameters
alias = jot
domain_id = d7461908fe0d2c6255aad38d306565cc
project_id = b94c327da8e73308d42b08b3a609b78e
long_url = https://www.joturl.com/
notes = trying to shorten a URL whose alias was already used
format = plain
Response
Example 9 (json)
Request
https://joturl.com/a/i1/urls/shorten?domain_id=73f56cf33a90698e0f9a397a5e4cbc7c&project_id=0e24562818f4588cb297c12e9578a0eb&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D
Query parameters
domain_id = 73f56cf33a90698e0f9a397a5e4cbc7c
project_id = 0e24562818f4588cb297c12e9578a0eb
bulk = 1
info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": [
{
"id": "3f69a02100a49e47df1875c392373c19",
"alias": "alias0",
"domain_id": "f8cdd3d94ab8142982d1b30d4a847223",
"domain_host": "my.custom.domain",
"domain_nickname": "",
"project_id": "180a1f6123485e95023968ffadb8f054",
"project_name": "project name",
"short_url": "\/\/my.custom.domain\/alias0",
"long_url": "https:\/\/www.joturl.com\/?p=0",
"template_type": 1
},
{
"id": "d569d23bda797e57be71a8fa6a1964eb",
"alias": "alias1",
"domain_id": "bf8c1aa238e4449b495b3c57b7ed60d4",
"domain_host": "my.custom.domain",
"domain_nickname": "",
"project_id": "0859282749b9b93ffa7e4fe3f2a88b03",
"project_name": "project name",
"short_url": "\/\/my.custom.domain\/alias1",
"long_url": "https:\/\/www.joturl.com\/?p=1",
"template_type": 1
},
{
"error": "FAILED at 2",
"details": "The chosen alias is not available. (alias1)"
}
]
}
Example 10 (xml)
Request
https://joturl.com/a/i1/urls/shorten?domain_id=73f56cf33a90698e0f9a397a5e4cbc7c&project_id=0e24562818f4588cb297c12e9578a0eb&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=xml
Query parameters
domain_id = 73f56cf33a90698e0f9a397a5e4cbc7c
project_id = 0e24562818f4588cb297c12e9578a0eb
bulk = 1
info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<i0>
<id>3f69a02100a49e47df1875c392373c19</id>
<alias>alias0</alias>
<domain_id>f8cdd3d94ab8142982d1b30d4a847223</domain_id>
<domain_host>my.custom.domain</domain_host>
<domain_nickname></domain_nickname>
<project_id>180a1f6123485e95023968ffadb8f054</project_id>
<project_name>project name</project_name>
<short_url>//my.custom.domain/alias0</short_url>
<long_url>https://www.joturl.com/?p=0</long_url>
<template_type>1</template_type>
</i0>
<i1>
<id>d569d23bda797e57be71a8fa6a1964eb</id>
<alias>alias1</alias>
<domain_id>bf8c1aa238e4449b495b3c57b7ed60d4</domain_id>
<domain_host>my.custom.domain</domain_host>
<domain_nickname></domain_nickname>
<project_id>0859282749b9b93ffa7e4fe3f2a88b03</project_id>
<project_name>project name</project_name>
<short_url>//my.custom.domain/alias1</short_url>
<long_url>https://www.joturl.com/?p=1</long_url>
<template_type>1</template_type>
</i1>
<i2>
<error>FAILED at 2</error>
<details>The chosen alias is not available. (alias1)</details>
</i2>
</result>
</response>
Example 11 (txt)
Request
https://joturl.com/a/i1/urls/shorten?domain_id=73f56cf33a90698e0f9a397a5e4cbc7c&project_id=0e24562818f4588cb297c12e9578a0eb&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=txt
Query parameters
domain_id = 73f56cf33a90698e0f9a397a5e4cbc7c
project_id = 0e24562818f4588cb297c12e9578a0eb
bulk = 1
info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_0_id=3f69a02100a49e47df1875c392373c19
result_0_alias=alias0
result_0_domain_id=f8cdd3d94ab8142982d1b30d4a847223
result_0_domain_host=my.custom.domain
result_0_domain_nickname=
result_0_project_id=180a1f6123485e95023968ffadb8f054
result_0_project_name=project name
result_0_short_url=//my.custom.domain/alias0
result_0_long_url=https://www.joturl.com/?p=0
result_0_template_type=1
result_1_id=d569d23bda797e57be71a8fa6a1964eb
result_1_alias=alias1
result_1_domain_id=bf8c1aa238e4449b495b3c57b7ed60d4
result_1_domain_host=my.custom.domain
result_1_domain_nickname=
result_1_project_id=0859282749b9b93ffa7e4fe3f2a88b03
result_1_project_name=project name
result_1_short_url=//my.custom.domain/alias1
result_1_long_url=https://www.joturl.com/?p=1
result_1_template_type=1
result_2_error=FAILED at 2
result_2_details=The chosen alias is not available. (alias1)
Example 12 (plain)
Request
https://joturl.com/a/i1/urls/shorten?domain_id=73f56cf33a90698e0f9a397a5e4cbc7c&project_id=0e24562818f4588cb297c12e9578a0eb&bulk=1&info=%5B%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D0%22,%22alias%22%3A%22alias0%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D1%22,%22alias%22%3A%22alias1%22%7D,%7B%22url%22%3A%22https%3A%5C%2F%5C%2Fwww.joturl.com%5C%2F%3Fp%3D2%22,%22alias%22%3A%22alias1%22%7D%5D&format=plain
Query parameters
domain_id = 73f56cf33a90698e0f9a397a5e4cbc7c
project_id = 0e24562818f4588cb297c12e9578a0eb
bulk = 1
info = [{"url":"https:\/\/www.joturl.com\/?p=0","alias":"alias0"},{"url":"https:\/\/www.joturl.com\/?p=1","alias":"alias1"},{"url":"https:\/\/www.joturl.com\/?p=2","alias":"alias1"}]
format = plain
Response
//my.custom.domain/alias0
//my.custom.domain/alias1
FAILED at 2
The chosen alias is not available. (alias1)
Optional parameters
parameter | description | max length |
---|---|---|
aliasSTRING | available only when bulk = 0 - alias for the tracking link, if not specified a random and unique alias will be generated. The alias must be at least 3 characters among lower-case letters a-z, numbers 0-9, minus -, underscore _ | 510 |
bulkBOOLEAN | 1 to enable "bulk shorten" mode (default: 0) | |
domain_idID | ID of the domain for the tracking link(s), if not specified the default domain for the user will be used | |
embed_codeHTML | embed code for the JotBars | |
infoJSON | required when bulk = 1 - information for creating tracking links, is a JSON like this [{"url": "destination URL 1", "alias": "alias 1"}, ...] , a maximum of 100 elements are allowed | |
long_urlSTRING | required when bulk = 0 - destination URL for the tracking link | 4000 |
notesSTRING | notes for the tracking link | 255 |
project_idID | ID of the project where the tracking link(s) will be put in, if not specified the default project is used | |
tagsARRAY | comma-separated list of tags for the tracking link | |
video_durationSTRING | if the embed code contains a video, this parameter can be used to specify the video duration |
Return values
parameter | description |
---|---|
alias | alias for the tracking link |
domain_host | domain used to create the tracking link |
domain_id | ID of the domain used to create the tracking link |
domain_nickname | nickname of the short url domain |
id | ID of the created tracking link |
long_url | destination URL for the tracking link |
notes | only returned when bulk = 0 - notes for the tracking link |
project_id | ID of the project where the tracking link was created |
project_name | name of the project where the tracking link was created |
short_url | short URL for the tracking link |
tags | only returned when bulk = 0 - space-separated list of tags associated to the tracking link |
/urls/suggest
access: [READ]
Given a domain, suggests a specific number of aliases.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=7d67975a5bcff394ea4d29dd4de86a81
Query parameters
number_alias = 3
domain_id = 7d67975a5bcff394ea4d29dd4de86a81
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
"5a2",
"b0ff",
"6ca56"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=7d67975a5bcff394ea4d29dd4de86a81&format=xml
Query parameters
number_alias = 3
domain_id = 7d67975a5bcff394ea4d29dd4de86a81
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>5a2</i0>
<i1>b0ff</i1>
<i2>6ca56</i2>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=7d67975a5bcff394ea4d29dd4de86a81&format=txt
Query parameters
number_alias = 3
domain_id = 7d67975a5bcff394ea4d29dd4de86a81
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0=5a2
result_data_1=b0ff
result_data_2=6ca56
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/suggest?number_alias=3&domain_id=7d67975a5bcff394ea4d29dd4de86a81&format=plain
Query parameters
number_alias = 3
domain_id = 7d67975a5bcff394ea4d29dd4de86a81
format = plain
Response
5a2
b0ff
6ca56
Required parameters
parameter | description |
---|---|
domain_idID | ID of the domain where to suggest a new and unique alias |
Optional parameters
parameter | description | max length |
---|---|---|
aliasSTRING | base for the alias to suggest | 510 |
number_aliasSTRING | number of aliases to suggest, default 1, maximum 3 |
Return values
parameter | description |
---|---|
data | suggested unique aliases |
/urls/tags
/urls/tags/add
access: [WRITE]
Add a list of tags to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/add?url_id=f1738be4eb679dd99562299f7deb661d&tags=test,tag,api
Query parameters
url_id = f1738be4eb679dd99562299f7deb661d
tags = test,tag,api
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"added": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/add?url_id=f1738be4eb679dd99562299f7deb661d&tags=test,tag,api&format=xml
Query parameters
url_id = f1738be4eb679dd99562299f7deb661d
tags = test,tag,api
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<added>3</added>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/add?url_id=f1738be4eb679dd99562299f7deb661d&tags=test,tag,api&format=txt
Query parameters
url_id = f1738be4eb679dd99562299f7deb661d
tags = test,tag,api
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_added=3
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/add?url_id=f1738be4eb679dd99562299f7deb661d&tags=test,tag,api&format=plain
Query parameters
url_id = f1738be4eb679dd99562299f7deb661d
tags = test,tag,api
format = plain
Response
3
Required parameters
parameter | description |
---|---|
tagsARRAY | comma-separated list of tags, these tags will be added to the previous tags |
url_idID | ID of the tracking link |
Return values
parameter | description |
---|---|
added | numner of added tags, it could be 0 if all passed tags are already associated with the tracking link |
/urls/tags/clone
access: [WRITE]
Clone tags from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/clone?from_url_id=4cf3eb5f080625b8de2683776abeaf60&to_url_id=4f5e16b794c8e2da7cecff017603422c
Query parameters
from_url_id = 4cf3eb5f080625b8de2683776abeaf60
to_url_id = 4f5e16b794c8e2da7cecff017603422c
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/clone?from_url_id=4cf3eb5f080625b8de2683776abeaf60&to_url_id=4f5e16b794c8e2da7cecff017603422c&format=xml
Query parameters
from_url_id = 4cf3eb5f080625b8de2683776abeaf60
to_url_id = 4f5e16b794c8e2da7cecff017603422c
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/clone?from_url_id=4cf3eb5f080625b8de2683776abeaf60&to_url_id=4f5e16b794c8e2da7cecff017603422c&format=txt
Query parameters
from_url_id = 4cf3eb5f080625b8de2683776abeaf60
to_url_id = 4f5e16b794c8e2da7cecff017603422c
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/clone?from_url_id=4cf3eb5f080625b8de2683776abeaf60&to_url_id=4f5e16b794c8e2da7cecff017603422c&format=plain
Query parameters
from_url_id = 4cf3eb5f080625b8de2683776abeaf60
to_url_id = 4f5e16b794c8e2da7cecff017603422c
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy tags from |
to_url_idID | ID of the tracking link you want to copy tags to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/tags/count
access: [READ]
This method returns the number of tags.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/count?url_id=85a9261b3caf13df4f40ae3dfbdbaabd
Query parameters
url_id = 85a9261b3caf13df4f40ae3dfbdbaabd
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/count?url_id=85a9261b3caf13df4f40ae3dfbdbaabd&format=xml
Query parameters
url_id = 85a9261b3caf13df4f40ae3dfbdbaabd
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/count?url_id=85a9261b3caf13df4f40ae3dfbdbaabd&format=txt
Query parameters
url_id = 85a9261b3caf13df4f40ae3dfbdbaabd
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/count?url_id=85a9261b3caf13df4f40ae3dfbdbaabd&format=plain
Query parameters
url_id = 85a9261b3caf13df4f40ae3dfbdbaabd
format = plain
Response
2
Optional parameters
parameter | description |
---|---|
searchSTRING | filters tags to be extracted by searching them |
url_idID | ID of the tracking link from which to extract the tags |
Return values
parameter | description |
---|---|
count | number of (filtered) tags |
/urls/tags/delete
access: [WRITE]
This method deletes the relationship between a tag and an url. If the tag has no reference with others url, the tag will be deleted. Return 1 if the operation succeeds or 0 otherwise.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/delete?url_id=f240477762ea42719c8c106250c4045f&tag=tag
Query parameters
url_id = f240477762ea42719c8c106250c4045f
tag = tag
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/delete?url_id=f240477762ea42719c8c106250c4045f&tag=tag&format=xml
Query parameters
url_id = f240477762ea42719c8c106250c4045f
tag = tag
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/delete?url_id=f240477762ea42719c8c106250c4045f&tag=tag&format=txt
Query parameters
url_id = f240477762ea42719c8c106250c4045f
tag = tag
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/delete?url_id=f240477762ea42719c8c106250c4045f&tag=tag&format=plain
Query parameters
url_id = f240477762ea42719c8c106250c4045f
tag = tag
format = plain
Response
1
Required parameters
parameter | description |
---|---|
tagSTRING | tag to remove |
url_idID | ID of the tracking link from which to remove a tag |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/tags/edit
access: [WRITE]
Edit tags for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/edit?url_id=56994c96f968e5d81ec0a27f1dd813be&tags=test,tag,api
Query parameters
url_id = 56994c96f968e5d81ec0a27f1dd813be
tags = test,tag,api
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"edited": 3,
"url_id": "56994c96f968e5d81ec0a27f1dd813be",
"tags": "test,tag,api"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/edit?url_id=56994c96f968e5d81ec0a27f1dd813be&tags=test,tag,api&format=xml
Query parameters
url_id = 56994c96f968e5d81ec0a27f1dd813be
tags = test,tag,api
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<edited>3</edited>
<url_id>56994c96f968e5d81ec0a27f1dd813be</url_id>
<tags>test,tag,api</tags>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/edit?url_id=56994c96f968e5d81ec0a27f1dd813be&tags=test,tag,api&format=txt
Query parameters
url_id = 56994c96f968e5d81ec0a27f1dd813be
tags = test,tag,api
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_edited=3
result_url_id=56994c96f968e5d81ec0a27f1dd813be
result_tags=test,tag,api
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/edit?url_id=56994c96f968e5d81ec0a27f1dd813be&tags=test,tag,api&format=plain
Query parameters
url_id = 56994c96f968e5d81ec0a27f1dd813be
tags = test,tag,api
format = plain
Response
3
56994c96f968e5d81ec0a27f1dd813be
test,tag,api
Required parameters
parameter | description |
---|---|
url_idID | ID of the tracking link |
Optional parameters
parameter | description |
---|---|
tagsARRAY | comma-separated list of tags, this list will completely replace previous tags (if empty all tags are removed) |
Return values
parameter | description |
---|---|
added | number of added tags |
deleted | number of deleted tags |
edited | number of operations (add+delete) on tags |
tags | comma-separated list of tags |
url_id | echo back of parameter url_id |
/urls/tags/list
access: [READ]
This method returns a list of tags related to an url, the data returned are specified in a comma separated input called fields.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/tags/list?url_id=03249b1ad62b1d03480a92277bfebedb
Query parameters
url_id = 03249b1ad62b1d03480a92277bfebedb
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2,
"data": [
{
"tag": "tag1"
},
{
"tag": "tag2"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/tags/list?url_id=03249b1ad62b1d03480a92277bfebedb&format=xml
Query parameters
url_id = 03249b1ad62b1d03480a92277bfebedb
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
<data>
<i0>
<tag>tag1</tag>
</i0>
<i1>
<tag>tag2</tag>
</i1>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/tags/list?url_id=03249b1ad62b1d03480a92277bfebedb&format=txt
Query parameters
url_id = 03249b1ad62b1d03480a92277bfebedb
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
result_data_0_tag=tag1
result_data_1_tag=tag2
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/tags/list?url_id=03249b1ad62b1d03480a92277bfebedb&format=plain
Query parameters
url_id = 03249b1ad62b1d03480a92277bfebedb
format = plain
Response
2
tag1
tag2
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of tags (maxmimum allowed: 100) |
searchSTRING | filters tags to be extracted by searching them |
startINTEGER | starts to extract tags from this position |
url_idID | ID of the tracking link from which to extract the tags |
Return values
parameter | description |
---|---|
data | array containing information on tags, returned information depends on the fields parameter. |
/urls/timing
/urls/timing/clone
access: [WRITE]
Clone a timing configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/timing/clone?from_url_id=1ba56e845a5b420a08f35fdae2b33d41&to_url_id=a89232316605b8afc8d4e71ed9da1aa2
Query parameters
from_url_id = 1ba56e845a5b420a08f35fdae2b33d41
to_url_id = a89232316605b8afc8d4e71ed9da1aa2
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/timing/clone?from_url_id=1ba56e845a5b420a08f35fdae2b33d41&to_url_id=a89232316605b8afc8d4e71ed9da1aa2&format=xml
Query parameters
from_url_id = 1ba56e845a5b420a08f35fdae2b33d41
to_url_id = a89232316605b8afc8d4e71ed9da1aa2
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/timing/clone?from_url_id=1ba56e845a5b420a08f35fdae2b33d41&to_url_id=a89232316605b8afc8d4e71ed9da1aa2&format=txt
Query parameters
from_url_id = 1ba56e845a5b420a08f35fdae2b33d41
to_url_id = a89232316605b8afc8d4e71ed9da1aa2
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/timing/clone?from_url_id=1ba56e845a5b420a08f35fdae2b33d41&to_url_id=a89232316605b8afc8d4e71ed9da1aa2&format=plain
Query parameters
from_url_id = 1ba56e845a5b420a08f35fdae2b33d41
to_url_id = a89232316605b8afc8d4e71ed9da1aa2
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy timing configuration from |
to_url_idID | ID of the tracking link you want to copy timing configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/timing/delete
access: [WRITE]
Delete the timing configuration of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/timing/delete?id=daac4752b466a4030f6c9db40900a420
Query parameters
id = daac4752b466a4030f6c9db40900a420
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/timing/delete?id=daac4752b466a4030f6c9db40900a420&format=xml
Query parameters
id = daac4752b466a4030f6c9db40900a420
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/timing/delete?id=daac4752b466a4030f6c9db40900a420&format=txt
Query parameters
id = daac4752b466a4030f6c9db40900a420
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/timing/delete?id=daac4752b466a4030f6c9db40900a420&format=plain
Query parameters
id = daac4752b466a4030f6c9db40900a420
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a timing configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/timing/edit
access: [WRITE]
Given a short URL, defines a validity time range. It is possible to define the start datetime, the expire datetime and the URL to be used after expiration. This method is available only to certain user profiles.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/timing/edit?id=8a71b370bec9c414616061753ee619fc&valid_from=2025-04-11+13%3A18%3A51&valid_to=2026-05-11+13%3A18%3A51&valid_after_url=&delete_after_expiration=1
Query parameters
id = 8a71b370bec9c414616061753ee619fc
valid_from = 2025-04-11 13:18:51
valid_to = 2026-05-11 13:18:51
valid_after_url =
delete_after_expiration = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"valid_from": "2025-04-11 13:18:51",
"valid_to": "2026-05-11 13:18:51",
"valid_after_url": "",
"delete_after_expiration": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/timing/edit?id=8a71b370bec9c414616061753ee619fc&valid_from=2025-04-11+13%3A18%3A51&valid_to=2026-05-11+13%3A18%3A51&valid_after_url=&delete_after_expiration=1&format=xml
Query parameters
id = 8a71b370bec9c414616061753ee619fc
valid_from = 2025-04-11 13:18:51
valid_to = 2026-05-11 13:18:51
valid_after_url =
delete_after_expiration = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<valid_from>2025-04-11 13:18:51</valid_from>
<valid_to>2026-05-11 13:18:51</valid_to>
<valid_after_url></valid_after_url>
<delete_after_expiration>1</delete_after_expiration>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/timing/edit?id=8a71b370bec9c414616061753ee619fc&valid_from=2025-04-11+13%3A18%3A51&valid_to=2026-05-11+13%3A18%3A51&valid_after_url=&delete_after_expiration=1&format=txt
Query parameters
id = 8a71b370bec9c414616061753ee619fc
valid_from = 2025-04-11 13:18:51
valid_to = 2026-05-11 13:18:51
valid_after_url =
delete_after_expiration = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_valid_from=2025-04-11 13:18:51
result_valid_to=2026-05-11 13:18:51
result_valid_after_url=
result_delete_after_expiration=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/timing/edit?id=8a71b370bec9c414616061753ee619fc&valid_from=2025-04-11+13%3A18%3A51&valid_to=2026-05-11+13%3A18%3A51&valid_after_url=&delete_after_expiration=1&format=plain
Query parameters
id = 8a71b370bec9c414616061753ee619fc
valid_from = 2025-04-11 13:18:51
valid_to = 2026-05-11 13:18:51
valid_after_url =
delete_after_expiration = 1
format = plain
Response
2025-04-11 13:18:51
2026-05-11 13:18:51
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Optional parameters
parameter | description | max length |
---|---|---|
delete_after_expirationBOOLEAN | 1 to delete the tracking link after valid_to | |
valid_after_urlURL | URL to be used after valid_to | 4000 |
valid_fromDATETIME/EMPTY | the tracking link is valid from this date/time, before this date/time our engine returns a 404 error if someone tries to navigate to this tracking link; if empty or null it means "valid from now" | |
valid_toDATETIME/EMPTY | the tracking link is valid until this date/time, after this date/time our engine returns a 404 error if delete_after_expiration = 1 otherwise redirects to valid_after_url; if empty or null it means "valid forever" |
Return values
parameter | description |
---|---|
delete_after_expiration | NA |
valid_after_url | NA |
valid_from | NA |
valid_to | NA |
/urls/timing/info
access: [READ]
Returns information on the validity range of a given short URL. This method is available only to certain user profiles.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/timing/info?id=427571759d23ad58687ba4fcde361d9b
Query parameters
id = 427571759d23ad58687ba4fcde361d9b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"valid_from": "2025-04-11 13:18:51",
"valid_to": "2026-05-11 13:18:51",
"valid_after_url": "",
"delete_after_expiration": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/timing/info?id=427571759d23ad58687ba4fcde361d9b&format=xml
Query parameters
id = 427571759d23ad58687ba4fcde361d9b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<valid_from>2025-04-11 13:18:51</valid_from>
<valid_to>2026-05-11 13:18:51</valid_to>
<valid_after_url></valid_after_url>
<delete_after_expiration>1</delete_after_expiration>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/timing/info?id=427571759d23ad58687ba4fcde361d9b&format=txt
Query parameters
id = 427571759d23ad58687ba4fcde361d9b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_valid_from=2025-04-11 13:18:51
result_valid_to=2026-05-11 13:18:51
result_valid_after_url=
result_delete_after_expiration=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/timing/info?id=427571759d23ad58687ba4fcde361d9b&format=plain
Query parameters
id = 427571759d23ad58687ba4fcde361d9b
format = plain
Response
2025-04-11 13:18:51
2026-05-11 13:18:51
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
delete_after_expiration | 1 to delete the tracking link after valid_to |
valid_after_url | URL to be used after valid_to |
valid_from | the tracking link is valid from this date/time, before this date/time our engine returns a 404 error if someone tries to navigate to this tracking link; if empty or null it means "valid from now" |
valid_to | the tracking link is valid until this date/time, after this date/time our engine returns a 404 error if delete_after_expiration = 1 otherwise redirects to valid_after_url; if empty or null it means "valid forever" |
/urls/vcards
/urls/vcards/property
access: [READ]
Returns limits for vCards.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/vcards/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"max_vcard_size": 70000,
"max_vcard_image_size": 30000,
"supported_fields": {
"name": [
"namePrefix",
"firstName",
"middleName",
"lastName",
"nameSuffix"
],
"work": [
"title",
"role",
"organization",
"department",
"workURL"
],
"emails": [
"email",
"workEmail"
],
"phones": [
"homePhone",
"workPhone",
"cellPhone",
"pagerPhone",
"homeFax",
"workFax"
],
"homeAdd": [
"homeAddLabel",
"homeAddStreet",
"homeAddCity",
"homeAddState",
"homeAddPostalCode",
"homeAddCountry"
],
"workAdd": [
"workAddLabel",
"workAddStreet",
"workAddCity",
"workAddState",
"workAddPostalCode",
"workAddCountry"
],
"personal": [
"birthdayDay",
"birthdayMonth",
"birthdayYear",
"anniversaryDay",
"anniversaryMonth",
"anniversaryYear",
"personalURL",
"gender"
],
"images": [
"photo",
"embed_photo",
"embedded_photo",
"logo",
"embed_logo",
"embedded_logo"
],
"socials": [
"linkedin",
"twitter",
"facebook",
"instagram",
"youtube",
"tiktok"
],
"other": [
"note",
"uid"
]
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/vcards/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<max_vcard_size>70000</max_vcard_size>
<max_vcard_image_size>30000</max_vcard_image_size>
<supported_fields>
<name>
<i0>namePrefix</i0>
<i1>firstName</i1>
<i2>middleName</i2>
<i3>lastName</i3>
<i4>nameSuffix</i4>
</name>
<work>
<i0>title</i0>
<i1>role</i1>
<i2>organization</i2>
<i3>department</i3>
<i4>workURL</i4>
</work>
<emails>
<i0>email</i0>
<i1>workEmail</i1>
</emails>
<phones>
<i0>homePhone</i0>
<i1>workPhone</i1>
<i2>cellPhone</i2>
<i3>pagerPhone</i3>
<i4>homeFax</i4>
<i5>workFax</i5>
</phones>
<homeAdd>
<i0>homeAddLabel</i0>
<i1>homeAddStreet</i1>
<i2>homeAddCity</i2>
<i3>homeAddState</i3>
<i4>homeAddPostalCode</i4>
<i5>homeAddCountry</i5>
</homeAdd>
<workAdd>
<i0>workAddLabel</i0>
<i1>workAddStreet</i1>
<i2>workAddCity</i2>
<i3>workAddState</i3>
<i4>workAddPostalCode</i4>
<i5>workAddCountry</i5>
</workAdd>
<personal>
<i0>birthdayDay</i0>
<i1>birthdayMonth</i1>
<i2>birthdayYear</i2>
<i3>anniversaryDay</i3>
<i4>anniversaryMonth</i4>
<i5>anniversaryYear</i5>
<i6>personalURL</i6>
<i7>gender</i7>
</personal>
<images>
<i0>photo</i0>
<i1>embed_photo</i1>
<i2>embedded_photo</i2>
<i3>logo</i3>
<i4>embed_logo</i4>
<i5>embedded_logo</i5>
</images>
<socials>
<i0>linkedin</i0>
<i1>twitter</i1>
<i2>facebook</i2>
<i3>instagram</i3>
<i4>youtube</i4>
<i5>tiktok</i5>
</socials>
<other>
<i0>note</i0>
<i1>uid</i1>
</other>
</supported_fields>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/vcards/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_max_vcard_size=70000
result_max_vcard_image_size=30000
result_supported_fields_name_0=namePrefix
result_supported_fields_name_1=firstName
result_supported_fields_name_2=middleName
result_supported_fields_name_3=lastName
result_supported_fields_name_4=nameSuffix
result_supported_fields_work_0=title
result_supported_fields_work_1=role
result_supported_fields_work_2=organization
result_supported_fields_work_3=department
result_supported_fields_work_4=workURL
result_supported_fields_emails_0=email
result_supported_fields_emails_1=workEmail
result_supported_fields_phones_0=homePhone
result_supported_fields_phones_1=workPhone
result_supported_fields_phones_2=cellPhone
result_supported_fields_phones_3=pagerPhone
result_supported_fields_phones_4=homeFax
result_supported_fields_phones_5=workFax
result_supported_fields_homeAdd_0=homeAddLabel
result_supported_fields_homeAdd_1=homeAddStreet
result_supported_fields_homeAdd_2=homeAddCity
result_supported_fields_homeAdd_3=homeAddState
result_supported_fields_homeAdd_4=homeAddPostalCode
result_supported_fields_homeAdd_5=homeAddCountry
result_supported_fields_workAdd_0=workAddLabel
result_supported_fields_workAdd_1=workAddStreet
result_supported_fields_workAdd_2=workAddCity
result_supported_fields_workAdd_3=workAddState
result_supported_fields_workAdd_4=workAddPostalCode
result_supported_fields_workAdd_5=workAddCountry
result_supported_fields_personal_0=birthdayDay
result_supported_fields_personal_1=birthdayMonth
result_supported_fields_personal_2=birthdayYear
result_supported_fields_personal_3=anniversaryDay
result_supported_fields_personal_4=anniversaryMonth
result_supported_fields_personal_5=anniversaryYear
result_supported_fields_personal_6=personalURL
result_supported_fields_personal_7=gender
result_supported_fields_images_0=photo
result_supported_fields_images_1=embed_photo
result_supported_fields_images_2=embedded_photo
result_supported_fields_images_3=logo
result_supported_fields_images_4=embed_logo
result_supported_fields_images_5=embedded_logo
result_supported_fields_socials_0=linkedin
result_supported_fields_socials_1=twitter
result_supported_fields_socials_2=facebook
result_supported_fields_socials_3=instagram
result_supported_fields_socials_4=youtube
result_supported_fields_socials_5=tiktok
result_supported_fields_other_0=note
result_supported_fields_other_1=uid
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/vcards/property?format=plain
Query parameters
format = plain
Response
70000
30000
namePrefix
firstName
middleName
lastName
nameSuffix
title
role
organization
department
workURL
email
workEmail
homePhone
workPhone
cellPhone
pagerPhone
homeFax
workFax
homeAddLabel
homeAddStreet
homeAddCity
homeAddState
homeAddPostalCode
homeAddCountry
workAddLabel
workAddStreet
workAddCity
workAddState
workAddPostalCode
workAddCountry
birthdayDay
birthdayMonth
birthdayYear
anniversaryDay
anniversaryMonth
anniversaryYear
personalURL
gender
photo
embed_photo
embedded_photo
logo
embed_logo
embedded_logo
linkedin
twitter
facebook
instagram
youtube
tiktok
note
uid
Return values
parameter | description |
---|---|
max_vcard_image_size | maximum number of bytes allowed in vCard images |
max_vcard_size | maximum number of bytes allowed in the vCard |
supported_fields | list of fields supported in the vCard divided by groups |
/urls/watchdogs
/urls/watchdogs/alerts
/urls/watchdogs/alerts/delete
access: [WRITE]
Reset watchdog's alerts for a given array of URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
Query parameters
count = 3
ids = 0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3,
"ids": "0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9&format=xml
Query parameters
count = 3
ids = 0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
<ids>0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9</ids>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9&format=txt
Query parameters
count = 3
ids = 0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
result_ids=0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/delete?count=3&ids=0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9&format=plain
Query parameters
count = 3
ids = 0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
format = plain
Response
3
0801ac68945ea6afdf14738d334a2340,14e41efcc419663991272cc5cb383a3b,e9c389c41998f229331ae3a1e77693d9
Required parameters
parameter | description |
---|---|
idsARRAY_OF_IDS | comma-separated list of ID of the tracking links from which to reset watchdog's alerts |
Return values
parameter | description |
---|---|
count | number of deleted alerts |
ids | echo back of the ids imput parameters |
/urls/watchdogs/alerts/info
access: [READ]
Returns watchdog's alerts for a given short URL.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=f99ce8341d09c75530be8c42fa31a429
Query parameters
id = f99ce8341d09c75530be8c42fa31a429
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": {
"alerts": [
{
"message": "URL redirects to .",
"occurrencies": 56,
"date": {
"from": "2025-04-16 13:18:51",
"to": "2025-05-11 13:18:51"
}
}
],
"browsers": {
"mobile": [
{
"BrowserName": "Openwave Mobile Browser 6.2.3.3.c.1.101",
"Platform": "Unix sun",
"MobileDevice": "Samsung"
},
"[...]",
{
"BrowserName": "DoCoMo 3.0",
"Platform": "--",
"MobileDevice": "--"
}
],
"desktop": [
{
"BrowserName": "Google AdSense",
"Platform": "--"
},
"[...]",
{
"BrowserName": "Shiretoko Firefox 3.5",
"Platform": "Linux"
}
]
},
"long_url": "https:\/\/www.example.com\/product\/124141255",
"last_update": "2025-04-14 13:18:51"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=f99ce8341d09c75530be8c42fa31a429&format=xml
Query parameters
id = f99ce8341d09c75530be8c42fa31a429
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<alerts>
<i0>
<message>URL redirects to .</message>
<occurrencies>56</occurrencies>
<date>
<from>2025-04-16 13:18:51</from>
<to>2025-05-11 13:18:51</to>
</date>
</i0>
</alerts>
<browsers>
<mobile>
<i0>
<BrowserName>Openwave Mobile Browser 6.2.3.3.c.1.101</BrowserName>
<Platform>Unix sun</Platform>
<MobileDevice>Samsung</MobileDevice>
</i0>
<i1>[...]</i1>
<i2>
<BrowserName>DoCoMo 3.0</BrowserName>
<Platform>--</Platform>
<MobileDevice>--</MobileDevice>
</i2>
</mobile>
<desktop>
<i0>
<BrowserName>Google AdSense</BrowserName>
<Platform>--</Platform>
</i0>
<i1>[...]</i1>
<i2>
<BrowserName>Shiretoko Firefox 3.5</BrowserName>
<Platform>Linux</Platform>
</i2>
</desktop>
</browsers>
<long_url>https://www.example.com/product/124141255</long_url>
<last_update>2025-04-14 13:18:51</last_update>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=f99ce8341d09c75530be8c42fa31a429&format=txt
Query parameters
id = f99ce8341d09c75530be8c42fa31a429
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_alerts_0_message=URL redirects to .
result_data_alerts_0_occurrencies=56
result_data_alerts_0_date_from=2025-04-16 13:18:51
result_data_alerts_0_date_to=2025-05-11 13:18:51
result_data_browsers_mobile_0_BrowserName=Openwave Mobile Browser 6.2.3.3.c.1.101
result_data_browsers_mobile_0_Platform=Unix sun
result_data_browsers_mobile_0_MobileDevice=Samsung
result_data_browsers_mobile_1=[...]
result_data_browsers_mobile_2_BrowserName=DoCoMo 3.0
result_data_browsers_mobile_2_Platform=--
result_data_browsers_mobile_2_MobileDevice=--
result_data_browsers_desktop_0_BrowserName=Google AdSense
result_data_browsers_desktop_0_Platform=--
result_data_browsers_desktop_1=[...]
result_data_browsers_desktop_2_BrowserName=Shiretoko Firefox 3.5
result_data_browsers_desktop_2_Platform=Linux
result_data_long_url=https://www.example.com/product/124141255
result_data_last_update=2025-04-14 13:18:51
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/watchdogs/alerts/info?id=f99ce8341d09c75530be8c42fa31a429&format=plain
Query parameters
id = f99ce8341d09c75530be8c42fa31a429
format = plain
Response
URL redirects to .
56
2025-04-16 13:18:51
2025-05-11 13:18:51
Openwave Mobile Browser 6.2.3.3.c.1.101
Unix sun
Samsung
[...]
DoCoMo 3.0
--
--
Google AdSense
--
[...]
Shiretoko Firefox 3.5
Linux
https://www.example.com/product/124141255
2025-04-14 13:18:51
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
data | array containing information for the alerts |
/urls/whatsapps
/urls/whatsapps/clone
access: [WRITE]
Clone the whatsapps configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=6c5194db42afa47af31f3657ddac4ad6&to_url_id=060587fbbad8dda1e4b8d409d5c275b7
Query parameters
from_url_id = 6c5194db42afa47af31f3657ddac4ad6
to_url_id = 060587fbbad8dda1e4b8d409d5c275b7
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=6c5194db42afa47af31f3657ddac4ad6&to_url_id=060587fbbad8dda1e4b8d409d5c275b7&format=xml
Query parameters
from_url_id = 6c5194db42afa47af31f3657ddac4ad6
to_url_id = 060587fbbad8dda1e4b8d409d5c275b7
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=6c5194db42afa47af31f3657ddac4ad6&to_url_id=060587fbbad8dda1e4b8d409d5c275b7&format=txt
Query parameters
from_url_id = 6c5194db42afa47af31f3657ddac4ad6
to_url_id = 060587fbbad8dda1e4b8d409d5c275b7
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/whatsapps/clone?from_url_id=6c5194db42afa47af31f3657ddac4ad6&to_url_id=060587fbbad8dda1e4b8d409d5c275b7&format=plain
Query parameters
from_url_id = 6c5194db42afa47af31f3657ddac4ad6
to_url_id = 060587fbbad8dda1e4b8d409d5c275b7
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy the whatsapps configuration from |
to_url_idID | ID of the tracking link you want to the whatsapps configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/urls/whatsapps/delete
access: [WRITE]
Delete a WhatsUrl configuration for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/whatsapps/delete?url_id=ad36e5914a10fad97d6d91733c10b450
Query parameters
url_id = ad36e5914a10fad97d6d91733c10b450
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/whatsapps/delete?url_id=ad36e5914a10fad97d6d91733c10b450&format=xml
Query parameters
url_id = ad36e5914a10fad97d6d91733c10b450
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/whatsapps/delete?url_id=ad36e5914a10fad97d6d91733c10b450&format=txt
Query parameters
url_id = ad36e5914a10fad97d6d91733c10b450
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/whatsapps/delete?url_id=ad36e5914a10fad97d6d91733c10b450&format=plain
Query parameters
url_id = ad36e5914a10fad97d6d91733c10b450
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link from which to remove a WhatsUrl configuration |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/urls/whatsapps/edit
access: [WRITE]
Set WhatsApp settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/whatsapps/edit?id=e565bd8b764efe7dd5ba86670fabfa3a&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D
Query parameters
id = e565bd8b764efe7dd5ba86670fabfa3a
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/whatsapps/edit?id=e565bd8b764efe7dd5ba86670fabfa3a&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=xml
Query parameters
id = e565bd8b764efe7dd5ba86670fabfa3a
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/whatsapps/edit?id=e565bd8b764efe7dd5ba86670fabfa3a&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=txt
Query parameters
id = e565bd8b764efe7dd5ba86670fabfa3a
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/whatsapps/edit?id=e565bd8b764efe7dd5ba86670fabfa3a&settings=%7B%22whatsapp_phone%22%3A%221234567890123%22,%22whatsapp_message%22%3A%22This+is+a+text+message%22,%22whatsapp_message_html%22%3A%22This+is+a+text+message%22,%22whatsapp_disclaimer%22%3A1%7D&format=plain
Query parameters
id = e565bd8b764efe7dd5ba86670fabfa3a
settings = {"whatsapp_phone":"1234567890123","whatsapp_message":"This is a text message","whatsapp_message_html":"This is a text message","whatsapp_disclaimer":1}
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
settingsJSON | stringified JSON containing the Whatsapp settings |
Return values
parameter | description |
---|---|
enabled | 1 on success, 0 otherwise |
/urls/whatsapps/info
access: [READ]
Get settings for the WhatsApp option.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/whatsapps/info?id=0ce0a396ab2f7261341a7e6886fc7883
Query parameters
id = 0ce0a396ab2f7261341a7e6886fc7883
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"compatible": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/urls/whatsapps/info?id=0ce0a396ab2f7261341a7e6886fc7883&format=xml
Query parameters
id = 0ce0a396ab2f7261341a7e6886fc7883
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<compatible>0</compatible>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/urls/whatsapps/info?id=0ce0a396ab2f7261341a7e6886fc7883&format=txt
Query parameters
id = 0ce0a396ab2f7261341a7e6886fc7883
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_compatible=0
Example 4 (plain)
Request
https://joturl.com/a/i1/urls/whatsapps/info?id=0ce0a396ab2f7261341a7e6886fc7883&format=plain
Query parameters
id = 0ce0a396ab2f7261341a7e6886fc7883
format = plain
Response
0
Required parameters
parameter | description |
---|---|
idID | ID of the tracking link |
Return values
parameter | description |
---|---|
settings | array containing the settings for the WhatsApp option |
/users
/users/2fa
/users/2fa/disable
access: [WRITE]
This method disable the 2-factor authentication for the logged in user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/2fa/disable?code=322384
Query parameters
code = 322384
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/2fa/disable?code=322384&format=xml
Query parameters
code = 322384
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/2fa/disable?code=322384&format=txt
Query parameters
code = 322384
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/2fa/disable?code=322384&format=plain
Query parameters
code = 322384
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
codeSTRING | security code given by the authenticator app or one of the backup codes | 8 |
Return values
parameter | description |
---|---|
disabled | 1 if the 2-factor authentication deactivation was successful, otherwise an error is returned |
/users/2fa/enable
access: [WRITE]
This method enable the 2-factor authentication for the logged in user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/2fa/enable?code=322384
Query parameters
code = 322384
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/2fa/enable?code=322384&format=xml
Query parameters
code = 322384
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/2fa/enable?code=322384&format=txt
Query parameters
code = 322384
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/2fa/enable?code=322384&format=plain
Query parameters
code = 322384
format = plain
Response
1
Required parameters
parameter | description | max length |
---|---|---|
codeSTRING | security code given by the authenticator app | 6 |
Return values
parameter | description |
---|---|
enabled | 1 if the 2-factor authentication activation was successful, otherwise an error is returned |
/users/2fa/info
access: [READ]
This method returns info on the 2-factor authentication status of the logged in user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/2fa/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 0,
"label": "JotUrl - my@email.address",
"secret": "26ea0daa6e0b34c2e75d3411cc531f32",
"uri": "otpauth:\/\/totp\/JotUrl+-+my%40email.address?secret=26ea0daa6e0b34c2e75d3411cc531f32"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/2fa/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>0</enabled>
<label>JotUrl - my@email.address</label>
<secret>26ea0daa6e0b34c2e75d3411cc531f32</secret>
<uri>otpauth://totp/JotUrl+-+my%40email.address?secret=26ea0daa6e0b34c2e75d3411cc531f32</uri>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/2fa/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=0
result_label=JotUrl - my@email.address
result_secret=26ea0daa6e0b34c2e75d3411cc531f32
result_uri=otpauth://totp/JotUrl+-+my%40email.address?secret=26ea0daa6e0b34c2e75d3411cc531f32
Example 4 (plain)
Request
https://joturl.com/a/i1/users/2fa/info?format=plain
Query parameters
format = plain
Response
0
JotUrl - my@email.address
26ea0daa6e0b34c2e75d3411cc531f32
otpauth://totp/JotUrl+-+my%40email.address?secret=26ea0daa6e0b34c2e75d3411cc531f32
Optional parameters
parameter | description | max length |
---|---|---|
codeSTRING | security code given by the authenticator app or one of the backup codes | 8 |
statusBOOLEAN | 1 to request only the status without generating/returning 2FA information (default: 0) |
Return values
parameter | description |
---|---|
backup | [OPTIONAL] returned only if enabled = 0 or if code is passed, backup codes for the 2-factor authentication |
enabled | 1 if the 2-factor authentication is enabled for the logged in user, 0 otherwise |
label | [OPTIONAL] returned only if enabled = 0 or if code is passed, this is the label that will be displayed in the authenticator app |
secret | [OPTIONAL] returned only if enabled = 0 or if code is passed, it is the secret key used by the authenticator app |
uri | [OPTIONAL] returned only if enabled = 0 or if code is passed, it is the provisioning URI to enable 2-factor authentication |
/users/blocked_ips
/users/blocked_ips/add
access: [WRITE]
Add IPs to the block list.
Example 1 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.86.0,8.8.2.0,8.8.86.%2A
Query parameters
ips = 8.8.86.0,8.8.2.0,8.8.86.*
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.86.0,8.8.2.0,8.8.86.%2A&format=xml
Query parameters
ips = 8.8.86.0,8.8.2.0,8.8.86.*
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.86.0,8.8.2.0,8.8.86.%2A&format=txt
Query parameters
ips = 8.8.86.0,8.8.2.0,8.8.86.*
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 4 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/add?ips=8.8.86.0,8.8.2.0,8.8.86.%2A&format=plain
Query parameters
ips = 8.8.86.0,8.8.2.0,8.8.86.*
format = plain
Response
3
Required parameters
parameter | description |
---|---|
ipsARRAY | array of IPs to add to the block list |
Return values
parameter | description |
---|---|
count | total number of added IPs |
/users/blocked_ips/count
access: [READ]
This method returns the number of blocked IPs.
Example 1 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 3
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>3</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=3
Example 4 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/count?format=plain
Query parameters
format = plain
Response
3
Return values
parameter | description |
---|---|
count | total number of blocked IPs |
/users/blocked_ips/delete
access: [WRITE]
Delete one or more blocked IPs.
Example 1 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.64.0,8.8.87.%2A
Query parameters
ips = 8.8.64.0,8.8.87.*
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 2
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.64.0,8.8.87.%2A&format=xml
Query parameters
ips = 8.8.64.0,8.8.87.*
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>2</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.64.0,8.8.87.%2A&format=txt
Query parameters
ips = 8.8.64.0,8.8.87.*
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=2
Example 4 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/delete?ips=8.8.64.0,8.8.87.%2A&format=plain
Query parameters
ips = 8.8.64.0,8.8.87.*
format = plain
Response
2
Required parameters
parameter | description |
---|---|
ipsARRAY | array of blocked IPs to be deleted |
Return values
parameter | description |
---|---|
count | total number of blocked IPs that have been deleted |
/users/blocked_ips/is_blacklisted
access: [WRITE]
This method checks if the IPs in a list are blocked.
Example 1 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0
Query parameters
ids = 8.8.49.0,8.8.101.0,8.8.75.0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ips": {
"8.8.49.0": {
"blacklisted": 1
},
"8.8.101.0": {
"blacklisted": 0
},
"8.8.75.0": {
"blacklisted": 0
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=xml
Query parameters
ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ips>
<8.8.49.0>
<blacklisted>1</blacklisted>
</8.8.49.0>
<8.8.101.0>
<blacklisted>0</blacklisted>
</8.8.101.0>
<8.8.75.0>
<blacklisted>0</blacklisted>
</8.8.75.0>
</ips>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=txt
Query parameters
ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ips_8.8.49.0_blacklisted=1
result_ips_8.8.101.0_blacklisted=0
result_ips_8.8.75.0_blacklisted=0
Example 4 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/is_blacklisted?ids=8.8.49.0,8.8.101.0,8.8.75.0&format=plain
Query parameters
ids = 8.8.49.0,8.8.101.0,8.8.75.0
format = plain
Response
1
0
0
Required parameters
parameter | description |
---|---|
ipsARRAY | array of IPs to be checked |
Return values
parameter | description |
---|---|
ids | JSON object that contains each valid IP in ips with its check result {"[IP1]":{"blacklisted":"[1&#124;0]"},...,"[IPN]":{"blacklisted":"[1&#124;0]"}} |
/users/blocked_ips/list
access: [READ]
This method returns a list of blocked IPs.
Example 1 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count
Query parameters
fields = ip,count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 4,
"data": [
"8.8.220.0",
"8.8.207.0",
"8.8.245.0",
"8.8.212.0",
"8.8.13.*"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=xml
Query parameters
fields = ip,count
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>4</count>
<data>
<i0>8.8.220.0</i0>
<i1>8.8.207.0</i1>
<i2>8.8.245.0</i2>
<i3>8.8.212.0</i3>
<i4>8.8.13.*</i4>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=txt
Query parameters
fields = ip,count
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=4
result_data_0=8.8.220.0
result_data_1=8.8.207.0
result_data_2=8.8.245.0
result_data_3=8.8.212.0
result_data_4=8.8.13.*
Example 4 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/list?fields=ip,count&format=plain
Query parameters
fields = ip,count
format = plain
Response
4
8.8.220.0
8.8.207.0
8.8.245.0
8.8.212.0
8.8.13.*
Example 5 (json)
Request
https://joturl.com/a/i1/users/blocked_ips/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
"8.8.173.40",
"8.8.230.120"
]
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/users/blocked_ips/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>8.8.173.40</i0>
<i1>8.8.230.120</i1>
</data>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/users/blocked_ips/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0=8.8.173.40
result_data_1=8.8.230.120
Example 8 (plain)
Request
https://joturl.com/a/i1/users/blocked_ips/list?format=plain
Query parameters
format = plain
Response
8.8.173.40
8.8.230.120
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: ip, count |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of blocked IPs, returned only if count is passed in fields |
data | array containing a list of blocked IPs |
/users/captcha
access: [WRITE]
This method emits a captcha.
Example 1 (json)
Request
https://joturl.com/a/i1/users/captcha?captcha=1d2003a3
Query parameters
captcha = 1d2003a3
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"captcha": "1d2003a3",
"url": "\/a\/i1\/users\/captcha?captcha=1d2003a3"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/captcha?captcha=1d2003a3&format=xml
Query parameters
captcha = 1d2003a3
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<captcha>1d2003a3</captcha>
<url>/a/i1/users/captcha?captcha=1d2003a3</url>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/captcha?captcha=1d2003a3&format=txt
Query parameters
captcha = 1d2003a3
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_captcha=1d2003a3
result_url=/a/i1/users/captcha?captcha=1d2003a3
Example 4 (plain)
Request
https://joturl.com/a/i1/users/captcha?captcha=1d2003a3&format=plain
Query parameters
captcha = 1d2003a3
format = plain
Response
1d2003a3
/a/i1/users/captcha?captcha=1d2003a3
Optional parameters
parameter | description |
---|---|
captchaSTRING | ID of the captcha, if it is passed this method returns the corresponding captcha image if valid, otherwise returns an invalid parameter error |
Return values
parameter | description |
---|---|
captcha | ID of the captcha |
url | URL of the captcha image |
/users/confirm
access: [WRITE]
This method executes confirm operations.
Example 1 (json)
Request
https://joturl.com/a/i1/users/confirm?info=654cc4048c3e742dbc3609e6d93149fe
Query parameters
info = 654cc4048c3e742dbc3609e6d93149fe
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ok": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/confirm?info=654cc4048c3e742dbc3609e6d93149fe&format=xml
Query parameters
info = 654cc4048c3e742dbc3609e6d93149fe
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ok>1</ok>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/confirm?info=654cc4048c3e742dbc3609e6d93149fe&format=txt
Query parameters
info = 654cc4048c3e742dbc3609e6d93149fe
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/confirm?info=654cc4048c3e742dbc3609e6d93149fe&format=plain
Query parameters
info = 654cc4048c3e742dbc3609e6d93149fe
format = plain
Response
1
Required parameters
parameter | description |
---|---|
infoSTRING | confirm token sent to the user email |
Return values
parameter | description |
---|---|
ok | 1 on success, otherwise a generic error is issued |
/users/forgot
access: [WRITE]
This method manages the "forgot password" procedure.
Example 1 (json)
Request
https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=98dd8146
Query parameters
email = my.email@addess.is.here
code = 12345
captcha = 98dd8146
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"message": "An e-mail with your login credentials has been sent to 'my.email@addess.is.here'."
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=98dd8146&format=xml
Query parameters
email = my.email@addess.is.here
code = 12345
captcha = 98dd8146
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<message>An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.</message>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=98dd8146&format=txt
Query parameters
email = my.email@addess.is.here
code = 12345
captcha = 98dd8146
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_message=An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.
Example 4 (plain)
Request
https://joturl.com/a/i1/users/forgot?email=my.email%40addess.is.here&code=12345&captcha=98dd8146&format=plain
Query parameters
email = my.email@addess.is.here
code = 12345
captcha = 98dd8146
format = plain
Response
An e-mail with your login credentials has been sent to 'my.email@addess.is.here'.
Required parameters
parameter | description | max length |
---|---|---|
captchaSTRING | ID of the captcha, see i1/users/captcha for details | |
codeSTRING | the code present in the captcha image and that the user has transcribed | |
emailSTRING | email address of the user that wants to start the "forgot password" procedure | 255 |
/users/info
access: [READ]
This method returns info about the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"actually_subuser": 0,
"company": "JotUrl",
"default_domain_id": "acd89f605010b8b83b47fcea7f455e77",
"email": "my.email@address.to",
"full_name": "Jon Smith",
"gender": "m",
"inactivity_timeout": 0,
"is_readonly": 0,
"location": "IT",
"login": "my.email@address.to",
"need_to_change_password": 0,
"news_offers_consent": 0,
"phone_number": "+1234567891011",
"registration_time": "2018-06-25 23:18:21",
"short_name": "JS",
"spider_email": "",
"spider_email_frequency": 1,
"stats_permanency_days": 365,
"subuser": 0
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<actually_subuser>0</actually_subuser>
<company>JotUrl</company>
<default_domain_id>acd89f605010b8b83b47fcea7f455e77</default_domain_id>
<email>my.email@address.to</email>
<full_name>Jon Smith</full_name>
<gender>m</gender>
<inactivity_timeout>0</inactivity_timeout>
<is_readonly>0</is_readonly>
<location>IT</location>
<login>my.email@address.to</login>
<need_to_change_password>0</need_to_change_password>
<news_offers_consent>0</news_offers_consent>
<phone_number>+1234567891011</phone_number>
<registration_time>2018-06-25 23:18:21</registration_time>
<short_name>JS</short_name>
<spider_email></spider_email>
<spider_email_frequency>1</spider_email_frequency>
<stats_permanency_days>365</stats_permanency_days>
<subuser>0</subuser>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_actually_subuser=0
result_company=JotUrl
result_default_domain_id=acd89f605010b8b83b47fcea7f455e77
result_email=my.email@address.to
result_full_name=Jon Smith
result_gender=m
result_inactivity_timeout=0
result_is_readonly=0
result_location=IT
result_login=my.email@address.to
result_need_to_change_password=0
result_news_offers_consent=0
result_phone_number=+1234567891011
result_registration_time=2018-06-25 23:18:21
result_short_name=JS
result_spider_email=
result_spider_email_frequency=1
result_stats_permanency_days=365
result_subuser=0
Example 4 (plain)
Request
https://joturl.com/a/i1/users/info?format=plain
Query parameters
format = plain
Response
0
JotUrl
acd89f605010b8b83b47fcea7f455e77
my.email@address.to
Jon Smith
m
0
0
IT
my.email@address.to
0
0
+1234567891011
2018-06-25 23:18:21
JS
1
365
0
Optional parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: actually_subuser, company, default_domain_id, email, full_name, gender, inactivity_timeout, is_readonly, location, login, need_to_change_password, news_offers_consent, phone_number, registration_time, short_name, spider_email, spider_email_frequency, stats_permanency_days, subuser |
Return values
parameter | description |
---|---|
data | information on the user/subuser |
/users/jotbars
/users/jotbars/edit
access: [WRITE]
Set a jotbar option for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/users/jotbars/edit?user_id=d085d4f38a6b4b2f4059ae77bfe59a08&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D
Query parameters
user_id = d085d4f38a6b4b2f4059ae77bfe59a08
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/jotbars/edit?user_id=d085d4f38a6b4b2f4059ae77bfe59a08&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=xml
Query parameters
user_id = d085d4f38a6b4b2f4059ae77bfe59a08
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/jotbars/edit?user_id=d085d4f38a6b4b2f4059ae77bfe59a08&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=txt
Query parameters
user_id = d085d4f38a6b4b2f4059ae77bfe59a08
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/jotbars/edit?user_id=d085d4f38a6b4b2f4059ae77bfe59a08&logo=https%3A%2F%2Fjoturl.com%2Flogo.svg&logo_url=https%3A%2F%2Fjoturl.com%2F&template=right&template_size=big&languages=en,it&default_language=&default_language=en&info=%7B%22en%22%3A%7B%22page_title%22%3A%22English+page+title%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BEN%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BEN%5D+HTML+questions%3C%5C%2Fp%3E%22%7D,%22it%22%3A%7B%22page_title%22%3A%22Titolo+pagina+in+italiano%22,%22description_title%22%3Anull,%22description%22%3A%22%3Cp%3E%5BIT%5D+HTML+description%3C%5C%2Fp%3E%22,%22questions_title%22%3Anull,%22questions%22%3A%22%3Cp%3E%5BIT%5D+HTML+questions%3C%5C%2Fp%3E%22%7D%7D&format=plain
Query parameters
user_id = d085d4f38a6b4b2f4059ae77bfe59a08
logo = https://joturl.com/logo.svg
logo_url = https://joturl.com/
template = right
template_size = big
languages = en,it
default_language = en
info = {"en":{"page_title":"English page title","description_title":null,"description":"<p>[EN] HTML description<\/p>","questions_title":null,"questions":"<p>[EN] HTML questions<\/p>"},"it":{"page_title":"Titolo pagina in italiano","description_title":null,"description":"<p>[IT] HTML description<\/p>","questions_title":null,"questions":"<p>[IT] HTML questions<\/p>"}}
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
default_languageSTRING | set the account-level default language, see i1/users/languages/set for details |
infoJSON | JSON containing page_title, description_title, description, questions_title, questions for each enabled language, see i1/users/languages/set for details |
logoSTRING | it can be: the URL of the logo to be shown; empty or null to disable it |
logo_urlSTRING | when logo has an URL, this is the URL to which the user will be redirect when he/she clicks on the logo |
show_feedbackSTRING | 1 to show feedback, 0 to do not show it |
templateSTRING | position of the jotbar, empty or null to disable the jotbar feature, for available positions see i1/jotbars/property |
template_sizeSTRING | dimension of the jotbar, empty or null to disable the jotbar feature, for available dimensions see i1/jotbars/property |
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/users/jotbars/info
access: [READ]
Get account-level settings for the jotbar.
Example 1 (json)
Request
https://joturl.com/a/i1/users/jotbars/info?user_id=7f373b1b92d9071d46e2dd8a68f01a3a
Query parameters
user_id = 7f373b1b92d9071d46e2dd8a68f01a3a
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"logo": "https:\/\/joturl.com\/logo.svg",
"logo_url": "https:\/\/joturl.com\/",
"template": "right",
"template_size": "big",
"show_feedback": null,
"default_language": "en",
"info": {
"en": {
"page_title": "English page title",
"description_title": null,
"description": "<p>[EN] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[EN] HTML questions<\/p>"
},
"it": {
"page_title": "Titolo pagina in italiano",
"description_title": null,
"description": "<p>[IT] HTML description<\/p>",
"questions_title": null,
"questions": "<p>[IT] HTML questions<\/p>"
}
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/jotbars/info?user_id=7f373b1b92d9071d46e2dd8a68f01a3a&format=xml
Query parameters
user_id = 7f373b1b92d9071d46e2dd8a68f01a3a
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<logo>https://joturl.com/logo.svg</logo>
<logo_url>https://joturl.com/</logo_url>
<template>right</template>
<template_size>big</template_size>
<show_feedback></show_feedback>
<default_language>en</default_language>
<info>
<en>
<page_title>English page title</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[EN] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[EN] HTML questions&lt;/p&gt;]]></questions>
</en>
<it>
<page_title>Titolo pagina in italiano</page_title>
<description_title></description_title>
<description><[CDATA[&lt;p&gt;[IT] HTML description&lt;/p&gt;]]></description>
<questions_title></questions_title>
<questions><[CDATA[&lt;p&gt;[IT] HTML questions&lt;/p&gt;]]></questions>
</it>
</info>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/jotbars/info?user_id=7f373b1b92d9071d46e2dd8a68f01a3a&format=txt
Query parameters
user_id = 7f373b1b92d9071d46e2dd8a68f01a3a
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_logo=https://joturl.com/logo.svg
result_logo_url=https://joturl.com/
result_template=right
result_template_size=big
result_show_feedback=
result_default_language=en
result_info_en_page_title=English page title
result_info_en_description_title=
result_info_en_description=&lt;p&gt;[EN] HTML description&lt;/p&gt;
result_info_en_questions_title=
result_info_en_questions=&lt;p&gt;[EN] HTML questions&lt;/p&gt;
result_info_it_page_title=Titolo pagina in italiano
result_info_it_description_title=
result_info_it_description=&lt;p&gt;[IT] HTML description&lt;/p&gt;
result_info_it_questions_title=
result_info_it_questions=&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Example 4 (plain)
Request
https://joturl.com/a/i1/users/jotbars/info?user_id=7f373b1b92d9071d46e2dd8a68f01a3a&format=plain
Query parameters
user_id = 7f373b1b92d9071d46e2dd8a68f01a3a
format = plain
Response
https://joturl.com/logo.svg
https://joturl.com/
right
big
en
English page title
&lt;p&gt;[EN] HTML description&lt;/p&gt;
&lt;p&gt;[EN] HTML questions&lt;/p&gt;
Titolo pagina in italiano
&lt;p&gt;[IT] HTML description&lt;/p&gt;
&lt;p&gt;[IT] HTML questions&lt;/p&gt;
Return values
parameter | description |
---|---|
info | for each enabled language, it contains page_title, description_title, description, questions_title, questions, see the following notes for details |
user_default_language | account-level default language, see i1/users/languages/list for details |
user_logo | the URL of the logo to be shown or empty or null to disable it |
user_logo_url | when user_logo has an URL, this is the URL to which the user will be redirect when clicks on the logo |
user_show_feedback | 1 to show feedback, 0 to do not show it |
user_template | position of the jotbar, empty or null to disable the jotbar feature, for available positions see i1/jotbars/property |
user_template_size | dimension of the jotbar, empty or null to disable the jotbar feature, for available dimensions see i1/jotbars/property |
/users/languages
/users/languages/list
access: [READ]
This method returns a list of available languages for specific options (e.g., Masking, jotBar) of a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/users/languages/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"languages": [
{
"name": "en",
"label": "English"
},
{
"name": "it",
"label": "Italiano"
},
{
"name": "de",
"label": "Deutsch"
},
{
"name": "fr",
"label": "Française"
},
{
"name": "es",
"label": "Español"
},
{
"name": "jp",
"label": "\u65e5\u672c"
}
],
"selected": [
"en",
"it"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/languages/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<languages>
<i0>
<name>en</name>
<label>English</label>
</i0>
<i1>
<name>it</name>
<label>Italiano</label>
</i1>
<i2>
<name>de</name>
<label>Deutsch</label>
</i2>
<i3>
<name>fr</name>
<label><[CDATA[Fran&ccedil;aise]]></label>
</i3>
<i4>
<name>es</name>
<label><[CDATA[Espa&ntilde;ol]]></label>
</i4>
<i5>
<name>jp</name>
<label>日本</label>
</i5>
</languages>
<selected>
<i0>en</i0>
<i1>it</i1>
</selected>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/languages/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_languages_0_name=en
result_languages_0_label=English
result_languages_1_name=it
result_languages_1_label=Italiano
result_languages_2_name=de
result_languages_2_label=Deutsch
result_languages_3_name=fr
result_languages_3_label=Fran&ccedil;aise
result_languages_4_name=es
result_languages_4_label=Espa&ntilde;ol
result_languages_5_name=jp
result_languages_5_label=日本
result_selected_0=en
result_selected_1=it
Example 4 (plain)
Request
https://joturl.com/a/i1/users/languages/list?format=plain
Query parameters
format = plain
Response
en
English
it
Italiano
de
Deutsch
fr
Fran&ccedil;aise
es
Espa&ntilde;ol
jp
日本
en
it
Return values
parameter | description |
---|---|
languages | array of available languages (name,label) |
selected | array of enabled languages (name) |
/users/languages/set
access: [WRITE]
This method enables a list of languages for the current user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/languages/set?langs=en,it
Query parameters
langs = en,it
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/languages/set?langs=en,it&format=xml
Query parameters
langs = en,it
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/languages/set?langs=en,it&format=txt
Query parameters
langs = en,it
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/languages/set?langs=en,it&format=plain
Query parameters
langs = en,it
format = plain
Response
1
Required parameters
parameter | description |
---|---|
langsARRAY | comma-separated list of languages to enable, each language is identified by its name, see i1/users/languages/list for details |
Return values
parameter | description |
---|---|
updated | 1 in case of success, 0 in case of failure or if there was no change in the list of languages |
/users/login
access: [WRITE]
This method allows a user to login into the private area via credentials or through an external provider.
Example 1 (json)
Request
https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=c5bbb2e
Query parameters
username = username@domain.ext
password = c5bbb2e
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"session_id": "938fdaa4e17479bff9bc83aecace2293"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=c5bbb2e&format=xml
Query parameters
username = username@domain.ext
password = c5bbb2e
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<session_id>938fdaa4e17479bff9bc83aecace2293</session_id>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=c5bbb2e&format=txt
Query parameters
username = username@domain.ext
password = c5bbb2e
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_session_id=938fdaa4e17479bff9bc83aecace2293
Example 4 (plain)
Request
https://joturl.com/a/i1/users/login?username=username%40domain.ext&password=c5bbb2e&format=plain
Query parameters
username = username@domain.ext
password = c5bbb2e
format = plain
Response
938fdaa4e17479bff9bc83aecace2293
Optional parameters
parameter | description | max length |
---|---|---|
captchaSTRING | used when signup = 1 , see i1/users/signup for details | |
codeSTRING | used when signup = 1 , see i1/users/signup for details | |
news_offers_consentBOOLEAN | used when signup = 1 , see i1/users/signup for details | |
passwordSTRING | password to use to log in | 100 |
providerSTRING | alternative login provider, available providers: microsoftgraph, amazon, google, facebook, twitter, windowslive, linkedin | 100 |
redirectURL | redirect URL to be used after logged in, only used if parameter provider is passed | 4000 |
signupBOOLEAN | used when provider is passed, signup = 1 forces the signup from an alternative login when the user is not already registered, signup = 0 has no effect | |
tfa_codeSTRING | 2-factor authentication code if enabled, see i1/users/2fa/info for details | |
tokenSTRING | used when signup = 1 , see i1/users/signup for details | |
tos_pp_consentBOOLEAN | used when signup = 1 , see i1/users/signup for details | |
usernameSTRING | user name to use to log in | 255 |
Return values
parameter | description |
---|---|
datetime | server date and time, to be used to synchronize calls |
device_id | a unique ID that identifies the device from which the login is being made |
session_id | ID of the login session |
/users/logout
access: [WRITE]
This method executes a logout.
Example 1 (json)
Request
https://joturl.com/a/i1/users/logout
Response
{
"status": {
"code": 200,
"text": "OK"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/logout?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/logout?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
Example 4 (plain)
Request
https://joturl.com/a/i1/users/logout?format=plain
Query parameters
format = plain
Response
200
OK
Optional parameters
parameter | description |
---|---|
logout_allBOOLEAN | set to 1 if you want to disconnect from all accounts on all devices |
Return values
parameter | description |
---|---|
old_session_id | ID of the login session that was just destroyed |
redir_url | URL to redirect the user to |
/users/notifications
/users/notifications/count
access: [READ]
This method returns the number of new notifications for the user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/notifications/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 8
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/notifications/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>8</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/notifications/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=8
Example 4 (plain)
Request
https://joturl.com/a/i1/users/notifications/count?format=plain
Query parameters
format = plain
Response
8
Return values
parameter | description |
---|---|
count | number of available notifications |
/users/notifications/list
access: [READ]
This method returns a list of notifications for the user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/notifications/list
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"2020-10-24": [
{
"notification_id": "ad379f9c874aa396e93bb1f5c8ddaa9f",
"datetime": "2020-10-24T18:20:39+02:00",
"read": 0,
"type": 0,
"type_description": "deleted",
"short_url": "jo.my\/joturl",
"who": "User Name (user@email)",
"long_url": {
"old": "",
"new": ""
}
},
{
"notification_id": "70064ce7f70866cf49de74b55a4852da",
"datetime": "2020-10-24T18:16:47+02:00",
"read": 1,
"type": 0,
"type_description": "deleted",
"short_url": "jo.my\/joturl",
"who": "you",
"long_url": {
"old": "",
"new": ""
}
}
],
"2020-10-20": [
{
"notification_id": "5f3d28ad96302dab55f8f3ac36ca324f",
"datetime": "2020-10-20T16:37:32+02:00",
"read": 1,
"type": 1,
"type_description": "long url changed",
"short_url": "jo.my\/joturl",
"who": "you",
"long_url": {
"old": "http:\/\/www.joturl.com\/",
"new": "https:\/\/joturl.com\/"
}
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/notifications/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<2020-10-24>
<i0>
<notification_id>ad379f9c874aa396e93bb1f5c8ddaa9f</notification_id>
<datetime>2020-10-24T18:20:39+02:00</datetime>
<read>0</read>
<type>0</type>
<type_description>deleted</type_description>
<short_url>jo.my/joturl</short_url>
<who>User Name (user@email)</who>
<long_url>
<old></old>
<new></new>
</long_url>
</i0>
<i1>
<notification_id>70064ce7f70866cf49de74b55a4852da</notification_id>
<datetime>2020-10-24T18:16:47+02:00</datetime>
<read>1</read>
<type>0</type>
<type_description>deleted</type_description>
<short_url>jo.my/joturl</short_url>
<who>you</who>
<long_url>
<old></old>
<new></new>
</long_url>
</i1>
</2020-10-24>
<2020-10-20>
<i0>
<notification_id>5f3d28ad96302dab55f8f3ac36ca324f</notification_id>
<datetime>2020-10-20T16:37:32+02:00</datetime>
<read>1</read>
<type>1</type>
<type_description>long url changed</type_description>
<short_url>jo.my/joturl</short_url>
<who>you</who>
<long_url>
<old>http://www.joturl.com/</old>
<new>https://joturl.com/</new>
</long_url>
</i0>
</2020-10-20>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/notifications/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_2020-10-24_0_notification_id=ad379f9c874aa396e93bb1f5c8ddaa9f
result_2020-10-24_0_datetime=2020-10-24T18:20:39+02:00
result_2020-10-24_0_read=0
result_2020-10-24_0_type=0
result_2020-10-24_0_type_description=deleted
result_2020-10-24_0_short_url=jo.my/joturl
result_2020-10-24_0_who=User Name (user@email)
result_2020-10-24_0_long_url_old=
result_2020-10-24_0_long_url_new=
result_2020-10-24_1_notification_id=70064ce7f70866cf49de74b55a4852da
result_2020-10-24_1_datetime=2020-10-24T18:16:47+02:00
result_2020-10-24_1_read=1
result_2020-10-24_1_type=0
result_2020-10-24_1_type_description=deleted
result_2020-10-24_1_short_url=jo.my/joturl
result_2020-10-24_1_who=you
result_2020-10-24_1_long_url_old=
result_2020-10-24_1_long_url_new=
result_2020-10-20_0_notification_id=5f3d28ad96302dab55f8f3ac36ca324f
result_2020-10-20_0_datetime=2020-10-20T16:37:32+02:00
result_2020-10-20_0_read=1
result_2020-10-20_0_type=1
result_2020-10-20_0_type_description=long url changed
result_2020-10-20_0_short_url=jo.my/joturl
result_2020-10-20_0_who=you
result_2020-10-20_0_long_url_old=http://www.joturl.com/
result_2020-10-20_0_long_url_new=https://joturl.com/
Example 4 (plain)
Request
https://joturl.com/a/i1/users/notifications/list?format=plain
Query parameters
format = plain
Response
jo.my/joturl
jo.my/joturl
jo.my/joturl
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of notifications (maxmimum allowed: 100) |
startINTEGER | starts to extract notifications from this position |
Return values
parameter | description |
---|---|
data | array containing information on notifications |
/users/renew
access: [WRITE]
This method executes renew operations.
Example 1 (json)
Request
https://joturl.com/a/i1/users/renew?info=efd1dbca1709b67757a1c8d0ab29be5b
Query parameters
info = efd1dbca1709b67757a1c8d0ab29be5b
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ok": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/renew?info=efd1dbca1709b67757a1c8d0ab29be5b&format=xml
Query parameters
info = efd1dbca1709b67757a1c8d0ab29be5b
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ok>1</ok>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/renew?info=efd1dbca1709b67757a1c8d0ab29be5b&format=txt
Query parameters
info = efd1dbca1709b67757a1c8d0ab29be5b
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/renew?info=efd1dbca1709b67757a1c8d0ab29be5b&format=plain
Query parameters
info = efd1dbca1709b67757a1c8d0ab29be5b
format = plain
Response
1
Required parameters
parameter | description |
---|---|
infoSTRING | token sent to the user email |
/users/reports
/users/reports/get
access: [READ]
This method get the configuration for reports.
Example 1 (json)
Request
https://joturl.com/a/i1/users/reports/get
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"enabled": 1,
"position": "top_left",
"id": "f43dab5c2dbd68e6f5ecf36b7dd0f94e",
"metadata": {
"name": "my logo",
"creation": "2025-05-11 13:18:51",
"width": 400,
"height": 300,
"size": 32442,
"url": "https:\/\/cdn.endpoint\/path\/to\/resource"
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/reports/get?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<enabled>1</enabled>
<position>top_left</position>
<id>f43dab5c2dbd68e6f5ecf36b7dd0f94e</id>
<metadata>
<name>my logo</name>
<creation>2025-05-11 13:18:51</creation>
<width>400</width>
<height>300</height>
<size>32442</size>
<url>https://cdn.endpoint/path/to/resource</url>
</metadata>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/reports/get?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_enabled=1
result_position=top_left
result_id=f43dab5c2dbd68e6f5ecf36b7dd0f94e
result_metadata_name=my logo
result_metadata_creation=2025-05-11 13:18:51
result_metadata_width=400
result_metadata_height=300
result_metadata_size=32442
result_metadata_url=https://cdn.endpoint/path/to/resource
Example 4 (plain)
Request
https://joturl.com/a/i1/users/reports/get?format=plain
Query parameters
format = plain
Response
1
top_left
f43dab5c2dbd68e6f5ecf36b7dd0f94e
my logo
2025-05-11 13:18:51
400
300
32442
https://cdn.endpoint/path/to/resource
Return values
parameter | description |
---|---|
enabled | 1 when custom logo in reports is enabled, 0 otherwise |
id | ID of the CDN resource used as custom logo in reports if enabled = 1 , empty or null if enabled = 0 |
metadata | array containing information on the CDN resource |
position | position of the custom logo if enabled = 1 , empty or null if enabled = 0 |
/users/reports/property
access: [READ]
Returns allowed position for the custom logo in reports.
Example 1 (json)
Request
https://joturl.com/a/i1/users/reports/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"positions": [
"top_left",
"top_center",
"top_right"
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/reports/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<positions>
<i0>top_left</i0>
<i1>top_center</i1>
<i2>top_right</i2>
</positions>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/reports/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_positions_0=top_left
result_positions_1=top_center
result_positions_2=top_right
Example 4 (plain)
Request
https://joturl.com/a/i1/users/reports/property?format=plain
Query parameters
format = plain
Response
top_left
top_center
top_right
Return values
parameter | description |
---|---|
positions | available position for the custom logo in reports |
/users/reports/set
access: [WRITE]
This method sets the configuration for reports.
Example 1 (json)
Request
https://joturl.com/a/i1/users/reports/set?enabled=0
Query parameters
enabled = 0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/reports/set?enabled=0&format=xml
Query parameters
enabled = 0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/reports/set?enabled=0&format=txt
Query parameters
enabled = 0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/reports/set?enabled=0&format=plain
Query parameters
enabled = 0
format = plain
Response
1
Example 5 (json)
Request
https://joturl.com/a/i1/users/reports/set?enabled=1&id=8aa127148f364f18bb6767680f636bbd&position=top_left
Query parameters
enabled = 1
id = 8aa127148f364f18bb6767680f636bbd
position = top_left
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 6 (xml)
Request
https://joturl.com/a/i1/users/reports/set?enabled=1&id=8aa127148f364f18bb6767680f636bbd&position=top_left&format=xml
Query parameters
enabled = 1
id = 8aa127148f364f18bb6767680f636bbd
position = top_left
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 7 (txt)
Request
https://joturl.com/a/i1/users/reports/set?enabled=1&id=8aa127148f364f18bb6767680f636bbd&position=top_left&format=txt
Query parameters
enabled = 1
id = 8aa127148f364f18bb6767680f636bbd
position = top_left
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 8 (plain)
Request
https://joturl.com/a/i1/users/reports/set?enabled=1&id=8aa127148f364f18bb6767680f636bbd&position=top_left&format=plain
Query parameters
enabled = 1
id = 8aa127148f364f18bb6767680f636bbd
position = top_left
format = plain
Response
1
Required parameters
parameter | description |
---|---|
enabledBOOLEAN | 1 to enable the custom logo in reports, 0 to disable it |
Optional parameters
parameter | description |
---|---|
idID | ID of the CDN resource to use as logo |
positionSTRING | position of the logo, see i1/users/reports/property for available position |
Return values
parameter | description |
---|---|
deleted | [OPTIONAL] 1 on success, 0 otherwise, only returned when enabled = 0 |
updated | [OPTIONAL] 1 on success, 0 otherwise, only returned when enabled = 1 |
/users/security
/users/security/info
access: [READ]
This method returns advanced security settings for the logged user. Ony available to admin users.
Example 1 (json)
Request
https://joturl.com/a/i1/users/security/info
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"inactivity_timeout": 15,
"force_change_password_interval": 0,
"do_not_allow_old_passwords": 0,
"warning_on_anomalous_logins": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/security/info?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<inactivity_timeout>15</inactivity_timeout>
<force_change_password_interval>0</force_change_password_interval>
<do_not_allow_old_passwords>0</do_not_allow_old_passwords>
<warning_on_anomalous_logins>1</warning_on_anomalous_logins>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/security/info?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_inactivity_timeout=15
result_force_change_password_interval=0
result_do_not_allow_old_passwords=0
result_warning_on_anomalous_logins=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/security/info?format=plain
Query parameters
format = plain
Response
15
0
0
1
Return values
parameter | description |
---|---|
do_not_allow_old_passwords | number of previous passwords that the user cannot use when changing password; allowed values from 2 to 10 inclusive, 0 means disabled |
force_change_password_interval | the time in months after which the user must change password; allowed values from 2 to 60 inclusive, 0 means disabled |
inactivity_timeout | the time in minutes after which the user is disconnected in the absence of activity; allowed values from 15 to 43200 inclusive, 0 means disabled |
warning_on_anomalous_logins | 1 to send an email in case of access from previously unused devices/IPs, 0 otherwise |
/users/security/set
access: [WRITE]
This method sets advanced security settings for the logged user. Ony available to admin users.
Example 1 (json)
Request
https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1
Query parameters
inactivity_timeout = 15
force_change_password = 0
do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"inactivity_timeout": 15,
"force_change_password": 0,
"do_not_allow_old_passwords": 0,
"warning_on_anomalous_logins": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=xml
Query parameters
inactivity_timeout = 15
force_change_password = 0
do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<inactivity_timeout>15</inactivity_timeout>
<force_change_password>0</force_change_password>
<do_not_allow_old_passwords>0</do_not_allow_old_passwords>
<warning_on_anomalous_logins>1</warning_on_anomalous_logins>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=txt
Query parameters
inactivity_timeout = 15
force_change_password = 0
do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_inactivity_timeout=15
result_force_change_password=0
result_do_not_allow_old_passwords=0
result_warning_on_anomalous_logins=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/security/set?inactivity_timeout=15&force_change_password=0&do_not_allow_old_passwords=0&warning_on_anomalous_logins=1&format=plain
Query parameters
inactivity_timeout = 15
force_change_password = 0
do_not_allow_old_passwords = 0
warning_on_anomalous_logins = 1
format = plain
Response
15
0
0
1
Optional parameters
parameter | description |
---|---|
do_not_allow_old_passwordsINTEGER | number of previous passwords that the user cannot use when changing password; allowed values from 2 to 10 inclusive, 0 means disabled |
force_change_passwordINTEGER | the time in months after which the user must change password; allowed values from 2 to 60 inclusive, 0 means disabled |
inactivity_timeoutINTEGER | the time in minutes after which the user is disconnected in the absence of activity; allowed values from 15 to 43200 inclusive, 0 means disabled |
warning_on_anomalous_loginsSTRING | 1 to send an email in case of access from previously unused devices/IPs, 0 otherwise |
Return values
parameter | description |
---|---|
updated | 1 on success, 0 otherwise |
/users/set
access: [WRITE]
This method set info about the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/set?old_password=b38b271eec77c2ecbeda08880677ee11&new_password=3bfc0db575b7f0b7b74a5b9e4f36e550&confirm_password=3bfc0db575b7f0b7b74a5b9e4f36e550
Query parameters
old_password = b38b271eec77c2ecbeda08880677ee11
new_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
confirm_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"updated": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/set?old_password=b38b271eec77c2ecbeda08880677ee11&new_password=3bfc0db575b7f0b7b74a5b9e4f36e550&confirm_password=3bfc0db575b7f0b7b74a5b9e4f36e550&format=xml
Query parameters
old_password = b38b271eec77c2ecbeda08880677ee11
new_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
confirm_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/set?old_password=b38b271eec77c2ecbeda08880677ee11&new_password=3bfc0db575b7f0b7b74a5b9e4f36e550&confirm_password=3bfc0db575b7f0b7b74a5b9e4f36e550&format=txt
Query parameters
old_password = b38b271eec77c2ecbeda08880677ee11
new_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
confirm_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_updated=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/set?old_password=b38b271eec77c2ecbeda08880677ee11&new_password=3bfc0db575b7f0b7b74a5b9e4f36e550&confirm_password=3bfc0db575b7f0b7b74a5b9e4f36e550&format=plain
Query parameters
old_password = b38b271eec77c2ecbeda08880677ee11
new_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
confirm_password = 3bfc0db575b7f0b7b74a5b9e4f36e550
format = plain
Response
1
Optional parameters
parameter | description |
---|---|
codeSTRING | security code sent by email |
companySTRING | company of the logged user |
default_domain_idSTRING | the default domain for the logged user, this setting will be used as the default setting for endpoints that do not require the domain ID |
full_nameSTRING | full name of the logged user |
genderSTRING | gender of the logged user [m|f] |
locationSTRING | ISO 3166-1 alpha-2 code of the country of the logged user |
news_offers_consentBOOLEAN | 1 if the logged user has authorized the offers by e-mail, 0 otherwise |
phone_numberSTRING | phone number of the logged user |
spider_emailSTRING | comma separated list of emails to which content monitor will send security alerts, if not specified, login email will be used, maximum 10 email addresses are allowed |
spider_email_frequencySTRING | how often the content monitoring will send alerts, see i1/watchdogs/property for a list of available frequencies |
Return values
parameter | description |
---|---|
security_code_required | [OPTIONAL] 1 if the security code is required, it is returned only when an email change is required |
updated | 1 on success, 0 otherwise |
/users/signup
access: [WRITE]
This method executes a signup.
Example 1 (json)
Request
https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=9390c925e048c8b0&confirm=9390c925e048c8b0
Query parameters
name = Jon Smith
email = my.smart@email.address
password = 9390c925e048c8b0
confirm = 9390c925e048c8b0
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"ok": 1,
"need_confirm": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=9390c925e048c8b0&confirm=9390c925e048c8b0&format=xml
Query parameters
name = Jon Smith
email = my.smart@email.address
password = 9390c925e048c8b0
confirm = 9390c925e048c8b0
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<ok>1</ok>
<need_confirm>1</need_confirm>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=9390c925e048c8b0&confirm=9390c925e048c8b0&format=txt
Query parameters
name = Jon Smith
email = my.smart@email.address
password = 9390c925e048c8b0
confirm = 9390c925e048c8b0
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_ok=1
result_need_confirm=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/signup?name=Jon+Smith&email=my.smart%40email.address&password=9390c925e048c8b0&confirm=9390c925e048c8b0&format=plain
Query parameters
name = Jon Smith
email = my.smart@email.address
password = 9390c925e048c8b0
confirm = 9390c925e048c8b0
format = plain
Response
1
1
Required parameters
parameter | description |
---|---|
tos_pp_consentBOOLEAN | 1 if the user has given consent for the terms of service and the privacy policy, 0 otherwise, it must be 1 to be able to sign up |
Optional parameters
parameter | description | max length |
---|---|---|
captchaSTRING | ID of the captcha, see i1/users/captcha for details, optional to token | |
codeSTRING | the code present in the captcha image and that the user has transcribed, optional to token | |
companySTRING | company of the user | 255 |
confirmSTRING | confirmation for the password, must be the same as the password and retrieved from a different input field | 100 |
emailSTRING | email of the user | 255 |
genderSTRING | gender of the user, possible values: [m, f], default: m | 1 |
locationSTRING | 2-digit code of the country (ISO Alpha-2) the user is based on (e.g., US), if not passed our engine tries to retrieve location from the browser | 50 |
nameSTRING | full name of the user | 255 |
news_offers_consentBOOLEAN | 1 if the user has given consent for the news, 0 otherwise | |
passwordSTRING | password for the login | 100 |
tokenSTRING | Google reCAPTCHA token, optional to code and captcha |
Return values
parameter | description |
---|---|
need_confirm | 1 if the user must confirm his/hers email address by clicking on the email that our engine sent |
ok | 1 on success, otherwise a generic error is issued |
/users/stats
/users/stats/details
access: [READ]
This method returns detailed events on the last 30/60/90 days for the logged user.
Example 1 (json)
Request
https://joturl.com/a/i1/users/stats/details
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"aggregate": [
{
"type": "[type 1]",
"label": "[label 1]",
"event": "[generates event?]",
"count": 1955
},
{
"type": "[...]",
"label": "[...]",
"event": "[generates event?]",
"count": "[...]"
},
{
"type": "[type N]",
"label": "[label N]",
"event": "[generates event?]",
"count": 1224
}
],
"by_date": {
"2025-04-11": [
{
"type": "[type 1]",
"label": "[label 1]",
"event": "[generates event?]",
"count": 8735
},
{
"type": "[...]",
"label": "[...]",
"event": "[generates event?]",
"count": "[...]"
},
{
"type": "[type N]",
"label": "[label N]",
"event": "[generates event?]",
"count": 5686
}
],
"[...]": [
{
"type": "[type 1]",
"label": "[label 1]",
"event": "[generates event?]",
"count": 8681
},
{
"type": "[...]",
"label": "[...]",
"event": "[generates event?]",
"count": "[...]"
},
{
"type": "[type N]",
"label": "[label N]",
"event": "[generates event?]",
"count": 7267
}
],
"2025-05-11": [
{
"type": "[type 1]",
"label": "[label 1]",
"event": "[generates event?]",
"count": 7752
},
{
"type": "[...]",
"label": "[...]",
"event": "[generates event?]",
"count": "[...]"
},
{
"type": "[type N]",
"label": "[label N]",
"event": "[generates event?]",
"count": 3611
}
]
}
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/stats/details?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<aggregate>
<i0>
<type>[type 1]</type>
<label>[label 1]</label>
<event>[generates event?]</event>
<count>1955</count>
</i0>
<i1>
<type>[...]</type>
<label>[...]</label>
<event>[generates event?]</event>
<count>[...]</count>
</i1>
<i2>
<type>[type N]</type>
<label>[label N]</label>
<event>[generates event?]</event>
<count>1224</count>
</i2>
</aggregate>
<by_date>
<2025-04-11>
<i0>
<type>[type 1]</type>
<label>[label 1]</label>
<event>[generates event?]</event>
<count>8735</count>
</i0>
<i1>
<type>[...]</type>
<label>[...]</label>
<event>[generates event?]</event>
<count>[...]</count>
</i1>
<i2>
<type>[type N]</type>
<label>[label N]</label>
<event>[generates event?]</event>
<count>5686</count>
</i2>
</2025-04-11>
<[...]>
<i0>
<type>[type 1]</type>
<label>[label 1]</label>
<event>[generates event?]</event>
<count>8681</count>
</i0>
<i1>
<type>[...]</type>
<label>[...]</label>
<event>[generates event?]</event>
<count>[...]</count>
</i1>
<i2>
<type>[type N]</type>
<label>[label N]</label>
<event>[generates event?]</event>
<count>7267</count>
</i2>
</[...]>
<2025-05-11>
<i0>
<type>[type 1]</type>
<label>[label 1]</label>
<event>[generates event?]</event>
<count>7752</count>
</i0>
<i1>
<type>[...]</type>
<label>[...]</label>
<event>[generates event?]</event>
<count>[...]</count>
</i1>
<i2>
<type>[type N]</type>
<label>[label N]</label>
<event>[generates event?]</event>
<count>3611</count>
</i2>
</2025-05-11>
</by_date>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/stats/details?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_aggregate_0_type=[type 1]
result_aggregate_0_label=[label 1]
result_aggregate_0_event=[generates event?]
result_aggregate_0_count=1955
result_aggregate_1_type=[...]
result_aggregate_1_label=[...]
result_aggregate_1_event=[generates event?]
result_aggregate_1_count=[...]
result_aggregate_2_type=[type N]
result_aggregate_2_label=[label N]
result_aggregate_2_event=[generates event?]
result_aggregate_2_count=1224
result_by_date_2025-04-11_0_type=[type 1]
result_by_date_2025-04-11_0_label=[label 1]
result_by_date_2025-04-11_0_event=[generates event?]
result_by_date_2025-04-11_0_count=8735
result_by_date_2025-04-11_1_type=[...]
result_by_date_2025-04-11_1_label=[...]
result_by_date_2025-04-11_1_event=[generates event?]
result_by_date_2025-04-11_1_count=[...]
result_by_date_2025-04-11_2_type=[type N]
result_by_date_2025-04-11_2_label=[label N]
result_by_date_2025-04-11_2_event=[generates event?]
result_by_date_2025-04-11_2_count=5686
result_by_date_[...]_0_type=[type 1]
result_by_date_[...]_0_label=[label 1]
result_by_date_[...]_0_event=[generates event?]
result_by_date_[...]_0_count=8681
result_by_date_[...]_1_type=[...]
result_by_date_[...]_1_label=[...]
result_by_date_[...]_1_event=[generates event?]
result_by_date_[...]_1_count=[...]
result_by_date_[...]_2_type=[type N]
result_by_date_[...]_2_label=[label N]
result_by_date_[...]_2_event=[generates event?]
result_by_date_[...]_2_count=7267
result_by_date_2025-05-11_0_type=[type 1]
result_by_date_2025-05-11_0_label=[label 1]
result_by_date_2025-05-11_0_event=[generates event?]
result_by_date_2025-05-11_0_count=7752
result_by_date_2025-05-11_1_type=[...]
result_by_date_2025-05-11_1_label=[...]
result_by_date_2025-05-11_1_event=[generates event?]
result_by_date_2025-05-11_1_count=[...]
result_by_date_2025-05-11_2_type=[type N]
result_by_date_2025-05-11_2_label=[label N]
result_by_date_2025-05-11_2_event=[generates event?]
result_by_date_2025-05-11_2_count=3611
Example 4 (plain)
Request
https://joturl.com/a/i1/users/stats/details?format=plain
Query parameters
format = plain
Response
[type 1]
[label 1]
[generates event?]
1955
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
1224
[type 1]
[label 1]
[generates event?]
8735
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
5686
[type 1]
[label 1]
[generates event?]
8681
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
7267
[type 1]
[label 1]
[generates event?]
7752
[...]
[...]
[generates event?]
[...]
[type N]
[label N]
[generates event?]
3611
Optional parameters
parameter | description |
---|---|
time_intervalENUM | time interval for information extraction, available values: 30, 60, 90 (default: 30) |
Return values
parameter | description |
---|---|
aggregate | aggregate view by type |
by_date | view by date |
/users/stats/summary
access: [READ]
Account-level summary statistics.
Example 1 (json)
Request
https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
Query parameters
fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"conversions_clicks": "9",
"conversions_clicks_diff_perc": "",
"conversions_clicks_diff_perc14_7": "0",
"conversions_clicks_diff_perc14_7_min_date": "",
"conversions_clicks_diff_perc7": "0",
"conversions_clicks_diff_perc7_min_date": "",
"ctas_conversions": "28",
"ctas_conversions_diff_perc": "",
"ctas_conversions_diff_perc14_7": "0",
"ctas_conversions_diff_perc14_7_min_date": "",
"ctas_conversions_diff_perc7": "2",
"ctas_conversions_diff_perc7_min_date": "2020-10-11",
"qrcodes_clicks": "334",
"qrcodes_clicks_diff_perc": 14,
"qrcodes_clicks_diff_perc14_7": "1",
"qrcodes_clicks_diff_perc14_7_min_date": "2020-10-01",
"qrcodes_clicks_diff_perc7": "15",
"qrcodes_clicks_diff_perc7_min_date": "2020-10-12",
"unique_visits": "940783",
"unique_visits_diff_perc": 1.9565,
"unique_visits_diff_perc14_7": "23",
"unique_visits_diff_perc14_7_min_date": "2020-09-30",
"unique_visits_diff_perc7": "68",
"unique_visits_diff_perc7_min_date": "2020-10-06",
"visits": "943328",
"visits_diff_perc": 4.16,
"visits_diff_perc14_7": "25",
"visits_diff_perc14_7_min_date": "2020-09-30",
"visits_diff_perc7": "129",
"visits_diff_perc7_min_date": "2020-10-06"
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=xml
Query parameters
fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<conversions_clicks>9</conversions_clicks>
<conversions_clicks_diff_perc></conversions_clicks_diff_perc>
<conversions_clicks_diff_perc14_7>0</conversions_clicks_diff_perc14_7>
<conversions_clicks_diff_perc14_7_min_date></conversions_clicks_diff_perc14_7_min_date>
<conversions_clicks_diff_perc7>0</conversions_clicks_diff_perc7>
<conversions_clicks_diff_perc7_min_date></conversions_clicks_diff_perc7_min_date>
<ctas_conversions>28</ctas_conversions>
<ctas_conversions_diff_perc></ctas_conversions_diff_perc>
<ctas_conversions_diff_perc14_7>0</ctas_conversions_diff_perc14_7>
<ctas_conversions_diff_perc14_7_min_date></ctas_conversions_diff_perc14_7_min_date>
<ctas_conversions_diff_perc7>2</ctas_conversions_diff_perc7>
<ctas_conversions_diff_perc7_min_date>2020-10-11</ctas_conversions_diff_perc7_min_date>
<qrcodes_clicks>334</qrcodes_clicks>
<qrcodes_clicks_diff_perc>14</qrcodes_clicks_diff_perc>
<qrcodes_clicks_diff_perc14_7>1</qrcodes_clicks_diff_perc14_7>
<qrcodes_clicks_diff_perc14_7_min_date>2020-10-01</qrcodes_clicks_diff_perc14_7_min_date>
<qrcodes_clicks_diff_perc7>15</qrcodes_clicks_diff_perc7>
<qrcodes_clicks_diff_perc7_min_date>2020-10-12</qrcodes_clicks_diff_perc7_min_date>
<unique_visits>940783</unique_visits>
<unique_visits_diff_perc>1.9565</unique_visits_diff_perc>
<unique_visits_diff_perc14_7>23</unique_visits_diff_perc14_7>
<unique_visits_diff_perc14_7_min_date>2020-09-30</unique_visits_diff_perc14_7_min_date>
<unique_visits_diff_perc7>68</unique_visits_diff_perc7>
<unique_visits_diff_perc7_min_date>2020-10-06</unique_visits_diff_perc7_min_date>
<visits>943328</visits>
<visits_diff_perc>4.16</visits_diff_perc>
<visits_diff_perc14_7>25</visits_diff_perc14_7>
<visits_diff_perc14_7_min_date>2020-09-30</visits_diff_perc14_7_min_date>
<visits_diff_perc7>129</visits_diff_perc7>
<visits_diff_perc7_min_date>2020-10-06</visits_diff_perc7_min_date>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=txt
Query parameters
fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_conversions_clicks=9
result_data_0_conversions_clicks_diff_perc=
result_data_0_conversions_clicks_diff_perc14_7=0
result_data_0_conversions_clicks_diff_perc14_7_min_date=
result_data_0_conversions_clicks_diff_perc7=0
result_data_0_conversions_clicks_diff_perc7_min_date=
result_data_0_ctas_conversions=28
result_data_0_ctas_conversions_diff_perc=
result_data_0_ctas_conversions_diff_perc14_7=0
result_data_0_ctas_conversions_diff_perc14_7_min_date=
result_data_0_ctas_conversions_diff_perc7=2
result_data_0_ctas_conversions_diff_perc7_min_date=2020-10-11
result_data_0_qrcodes_clicks=334
result_data_0_qrcodes_clicks_diff_perc=14
result_data_0_qrcodes_clicks_diff_perc14_7=1
result_data_0_qrcodes_clicks_diff_perc14_7_min_date=2020-10-01
result_data_0_qrcodes_clicks_diff_perc7=15
result_data_0_qrcodes_clicks_diff_perc7_min_date=2020-10-12
result_data_0_unique_visits=940783
result_data_0_unique_visits_diff_perc=1.9565
result_data_0_unique_visits_diff_perc14_7=23
result_data_0_unique_visits_diff_perc14_7_min_date=2020-09-30
result_data_0_unique_visits_diff_perc7=68
result_data_0_unique_visits_diff_perc7_min_date=2020-10-06
result_data_0_visits=943328
result_data_0_visits_diff_perc=4.16
result_data_0_visits_diff_perc14_7=25
result_data_0_visits_diff_perc14_7_min_date=2020-09-30
result_data_0_visits_diff_perc7=129
result_data_0_visits_diff_perc7_min_date=2020-10-06
Example 4 (plain)
Request
https://joturl.com/a/i1/users/stats/summary?fields=conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc&format=plain
Query parameters
fields = conversions_clicks,conversions_clicks_diff_perc,ctas_conversions,ctas_conversions_diff_perc,qrcodes_clicks,qrcodes_clicks_diff_perc,unique_visits,unique_visits_diff_perc,visits,visits_diff_perc
format = plain
Response
9
0
0
28
0
2
2020-10-11
334
14
1
2020-10-01
15
2020-10-12
940783
1.9565
23
2020-09-30
68
2020-10-06
943328
4.16
25
2020-09-30
129
2020-10-06
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma separated list of fields to return, available fields: conversions_clicks, conversions_clicks_diff_perc, ctas_conversions, ctas_conversions_diff_perc, ctas_events, ctas_events_diff_perc, ctas_form_clicks, ctas_form_clicks_diff_perc, ctas_redirect_to_destination_clicks, ctas_redirect_to_destination_clicks_diff_perc, ctas_social_connect_clicks, ctas_social_connect_clicks_diff_perc, events, events_diff_perc, events_last_30days, events_last_30days_diff_perc, external_api_clicks, external_api_clicks_diff_perc, internal_api_clicks, internal_api_clicks_diff_perc, qrcodes_clicks, qrcodes_clicks_diff_perc, unique_visits, unique_visits_diff_perc, visits, visits_diff_perc |
Optional parameters
parameter | description |
---|---|
project_idID | if passed, statistics are filtered by this project ID |
Return values
parameter | description |
---|---|
data | array containing required statistics |
/users/watchdogs
/users/watchdogs/alerts
/users/watchdogs/alerts/count
access: [READ]
This method returns the number of watchdog's alerts, if any.
Example 1 (json)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": "9+"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>9+</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=9+
Example 4 (plain)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/count?format=plain
Query parameters
format = plain
Response
9+
Return values
parameter | description |
---|---|
count | number of alerts if it is less than 10, 9+ otherwise |
/users/watchdogs/alerts/reset_alerts_flag
access: [READ]
This method reset the flag that our engine uses to send emails from the watchdog, by resetting this flag no emails will be sent.
Example 1 (json)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
Example 4 (plain)
Request
https://joturl.com/a/i1/users/watchdogs/alerts/reset_alerts_flag?format=plain
Query parameters
format = plain
Response
1
Return values
parameter | description |
---|---|
count | 1 on success, 0 if the flag was already reset |
/utms
/utms/add
access: [WRITE]
This method adds a new UTM template.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook
Query parameters
name = JotUrl campaign
utm_source = facebook
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"name": "JotUrl campaign",
"utm_source": "facebook",
"added": 1,
"id": "90fe9434f087fdbe99dea115534a5396",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=xml
Query parameters
name = JotUrl campaign
utm_source = facebook
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<name>JotUrl campaign</name>
<utm_source>facebook</utm_source>
<added>1</added>
<id>90fe9434f087fdbe99dea115534a5396</id>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=txt
Query parameters
name = JotUrl campaign
utm_source = facebook
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_name=JotUrl campaign
result_utm_source=facebook
result_added=1
result_id=90fe9434f087fdbe99dea115534a5396
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/add?name=JotUrl+campaign&utm_source=facebook&format=plain
Query parameters
name = JotUrl campaign
utm_source = facebook
format = plain
Response
JotUrl campaign
facebook
1
90fe9434f087fdbe99dea115534a5396
Required parameters
parameter | description | max length |
---|---|---|
nameSTRING | UTM template name | 255 |
utm_sourceSTRING | utm_source parameter | 150 |
Optional parameters
parameter | description | max length |
---|---|---|
utm_campaignSTRING | utm_campaign parameter | 150 |
utm_contentSTRING | utm_content parameter | 150 |
utm_mediumSTRING | utm_medium parameter | 150 |
utm_termSTRING | utm_term parameter | 150 |
Return values
parameter | description |
---|---|
added | 1 on success, 0 otherwise |
id | ID of the UTM template |
name | echo back of the name input parameter |
utm_campaign | echo back of the utm_campaign input parameter |
utm_content | echo back of the utm_content input parameter |
utm_medium | echo back of the utm_medium input parameter |
utm_source | echo back of the utm_source input parameter |
utm_term | echo back of the utm_term input parameter |
/utms/count
access: [READ]
This method returns the number of UTM templates.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/count
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 10
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>10</count>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=10
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/count?format=plain
Query parameters
format = plain
Response
10
Optional parameters
parameter | description |
---|---|
searchSTRING | filters UTM templates to be extracted by searching them |
Return values
parameter | description |
---|---|
count | the number of UTM templates |
/utms/delete
access: [WRITE]
This method deletes a UTM template.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/delete?id=3e3492018b39978f02fab666d7ad3e5d
Query parameters
id = 3e3492018b39978f02fab666d7ad3e5d
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"deleted": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/delete?id=3e3492018b39978f02fab666d7ad3e5d&format=xml
Query parameters
id = 3e3492018b39978f02fab666d7ad3e5d
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/delete?id=3e3492018b39978f02fab666d7ad3e5d&format=txt
Query parameters
id = 3e3492018b39978f02fab666d7ad3e5d
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_deleted=1
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/delete?id=3e3492018b39978f02fab666d7ad3e5d&format=plain
Query parameters
id = 3e3492018b39978f02fab666d7ad3e5d
format = plain
Response
1
Required parameters
parameter | description |
---|---|
idID | ID of the UTM templates to delete |
Optional parameters
parameter | description |
---|---|
confirmBOOLEAN | If 1 this method deletes the UTM template even if it is linked to a tracking link |
Return values
parameter | description |
---|---|
deleted | 1 on success, 0 otherwise |
/utms/edit
access: [WRITE]
This method edits a UTM template.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/edit?id=fd6f38dcbe29c4332c99a15d1771b9b9&name=JotUrl+campaign&utm_source=facebook
Query parameters
id = fd6f38dcbe29c4332c99a15d1771b9b9
name = JotUrl campaign
utm_source = facebook
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"id": "fd6f38dcbe29c4332c99a15d1771b9b9",
"name": "JotUrl campaign",
"utm_source": "facebook",
"updated": 1,
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": ""
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/edit?id=fd6f38dcbe29c4332c99a15d1771b9b9&name=JotUrl+campaign&utm_source=facebook&format=xml
Query parameters
id = fd6f38dcbe29c4332c99a15d1771b9b9
name = JotUrl campaign
utm_source = facebook
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<id>fd6f38dcbe29c4332c99a15d1771b9b9</id>
<name>JotUrl campaign</name>
<utm_source>facebook</utm_source>
<updated>1</updated>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/edit?id=fd6f38dcbe29c4332c99a15d1771b9b9&name=JotUrl+campaign&utm_source=facebook&format=txt
Query parameters
id = fd6f38dcbe29c4332c99a15d1771b9b9
name = JotUrl campaign
utm_source = facebook
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_id=fd6f38dcbe29c4332c99a15d1771b9b9
result_name=JotUrl campaign
result_utm_source=facebook
result_updated=1
result_utm_medium=
result_utm_campaign=
result_utm_term=
result_utm_content=
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/edit?id=fd6f38dcbe29c4332c99a15d1771b9b9&name=JotUrl+campaign&utm_source=facebook&format=plain
Query parameters
id = fd6f38dcbe29c4332c99a15d1771b9b9
name = JotUrl campaign
utm_source = facebook
format = plain
Response
fd6f38dcbe29c4332c99a15d1771b9b9
JotUrl campaign
facebook
1
Required parameters
parameter | description |
---|---|
idID | ID of the UTM template to edit |
Optional parameters
parameter | description | max length |
---|---|---|
nameSTRING | UTM template name | 255 |
utm_campaignSTRING | utm_campaign parameter | 150 |
utm_contentSTRING | utm_content parameter | 150 |
utm_mediumSTRING | utm_medium parameter | 150 |
utm_sourceSTRING | utm_source parameter | 150 |
utm_termSTRING | utm_term parameter | 150 |
Return values
parameter | description |
---|---|
id | echo back of the id input parameter |
name | echo back of the name input parameter |
updated | 1 on success, 0 otherwise |
utm_campaign | echo back of the utm_campaign input parameter |
utm_content | echo back of the utm_content input parameter |
utm_medium | echo back of the utm_medium input parameter |
utm_source | echo back of the utm_source input parameter |
utm_term | echo back of the utm_term input parameter |
/utms/info
access: [READ]
This method returns info about a UTM template.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=e8246815c79467e29492c1f579b21d66
Query parameters
fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = e8246815c79467e29492c1f579b21d66
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"data": [
{
"id": "e8246815c79467e29492c1f579b21d66",
"name": "JotUrl campaign",
"utm_source": "facebook",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": ""
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=e8246815c79467e29492c1f579b21d66&format=xml
Query parameters
fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = e8246815c79467e29492c1f579b21d66
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<data>
<i0>
<id>e8246815c79467e29492c1f579b21d66</id>
<name>JotUrl campaign</name>
<utm_source>facebook</utm_source>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=e8246815c79467e29492c1f579b21d66&format=txt
Query parameters
fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = e8246815c79467e29492c1f579b21d66
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_data_0_id=e8246815c79467e29492c1f579b21d66
result_data_0_name=JotUrl campaign
result_data_0_utm_source=facebook
result_data_0_utm_medium=
result_data_0_utm_campaign=
result_data_0_utm_term=
result_data_0_utm_content=
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/info?fields=id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&gdpr_id=e8246815c79467e29492c1f579b21d66&format=plain
Query parameters
fields = id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
gdpr_id = e8246815c79467e29492c1f579b21d66
format = plain
Response
e8246815c79467e29492c1f579b21d66
JotUrl campaign
facebook
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term |
idID | ID of the UTM template |
Return values
parameter | description |
---|---|
data | array containing information on the UTM templates, returned information depends on the fields input parameter. |
/utms/list
access: [READ]
This method returns a list of UTM templates.
Example 1 (json)
Request
https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
Query parameters
fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"count": 1,
"data": [
{
"id": "2707b7d0eab16e62365cd83074471695",
"name": "JotUrl campaign",
"utm_source": "facebook",
"utm_medium": "",
"utm_campaign": "",
"utm_term": "",
"utm_content": ""
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=xml
Query parameters
fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<count>1</count>
<data>
<i0>
<id>2707b7d0eab16e62365cd83074471695</id>
<name>JotUrl campaign</name>
<utm_source>facebook</utm_source>
<utm_medium></utm_medium>
<utm_campaign></utm_campaign>
<utm_term></utm_term>
<utm_content></utm_content>
</i0>
</data>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=txt
Query parameters
fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_count=1
result_data_0_id=2707b7d0eab16e62365cd83074471695
result_data_0_name=JotUrl campaign
result_data_0_utm_source=facebook
result_data_0_utm_medium=
result_data_0_utm_campaign=
result_data_0_utm_term=
result_data_0_utm_content=
Example 4 (plain)
Request
https://joturl.com/a/i1/utms/list?fields=count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term&format=plain
Query parameters
fields = count,id,name,utm_campaign,utm_content,utm_medium,utm_source,utm_term
format = plain
Response
1
2707b7d0eab16e62365cd83074471695
JotUrl campaign
facebook
Required parameters
parameter | description |
---|---|
fieldsARRAY | comma-separated list of fields to return, available fields: count, id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term |
Optional parameters
parameter | description |
---|---|
lengthINTEGER | extracts this number of UTM templates (maxmimum allowed: 100) |
orderbyARRAY | orders UTM templates by field, available fields: id, name, utm_campaign, utm_content, utm_medium, utm_source, utm_term |
searchSTRING | filters UTM templates to be extracted by searching them |
sortSTRING | sorts UTM templates in ascending (ASC) or descending (DESC) order |
startINTEGER | starts to extract UTM templates from this position |
Return values
parameter | description |
---|---|
count | [OPTIONAL] total number of UTM templates, returned only if count is passed in fields |
data | array containing information on the UTM templates, returned information depends on the fields input parameter. |
/watchdogs
/watchdogs/clone
access: [WRITE]
Clone the qrcodes configuration from a tracking link to another.
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/clone?from_url_id=f6ac5a8ce57ddf04b75c4daa0e514f8c&to_url_id=ddbe15384df49c276fe501d3014c67c6
Query parameters
from_url_id = f6ac5a8ce57ddf04b75c4daa0e514f8c
to_url_id = ddbe15384df49c276fe501d3014c67c6
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"cloned": 1
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/watchdogs/clone?from_url_id=f6ac5a8ce57ddf04b75c4daa0e514f8c&to_url_id=ddbe15384df49c276fe501d3014c67c6&format=xml
Query parameters
from_url_id = f6ac5a8ce57ddf04b75c4daa0e514f8c
to_url_id = ddbe15384df49c276fe501d3014c67c6
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<cloned>1</cloned>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/watchdogs/clone?from_url_id=f6ac5a8ce57ddf04b75c4daa0e514f8c&to_url_id=ddbe15384df49c276fe501d3014c67c6&format=txt
Query parameters
from_url_id = f6ac5a8ce57ddf04b75c4daa0e514f8c
to_url_id = ddbe15384df49c276fe501d3014c67c6
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_cloned=1
Example 4 (plain)
Request
https://joturl.com/a/i1/watchdogs/clone?from_url_id=f6ac5a8ce57ddf04b75c4daa0e514f8c&to_url_id=ddbe15384df49c276fe501d3014c67c6&format=plain
Query parameters
from_url_id = f6ac5a8ce57ddf04b75c4daa0e514f8c
to_url_id = ddbe15384df49c276fe501d3014c67c6
format = plain
Response
1
Required parameters
parameter | description |
---|---|
from_url_idID | ID of the tracking link you want to copy watchdog configuration from |
to_url_idID | ID of the tracking link you want to copy watchdog configuration to |
Return values
parameter | description |
---|---|
cloned | 1 on success, 0 otherwise |
/watchdogs/property
access: [READ]
This method returns a list of properties of the watchdog (content monitoring).
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": "",
"rate": 0
},
"result": {
"watchdogs": [
{
"type": "1D",
"title": "1 check per day",
"limit": 1800
}
],
"spiders": [
{
"id": "DISABLE_ALL",
"title": "Disable all spiders. No check will be performed.",
"short": "Disable ALL",
"params": {
"video": 0,
"time": 0,
"texts": 0,
"threshold": 0
}
},
{
"id": "AUTOMATIC",
"title": "The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.",
"short": "Automatic",
"params": {
"video": 0,
"time": 0,
"texts": 0,
"threshold": 0
}
},
{
"id": "HTML_PING",
"title": "Interrupted and redirected URL check (PING.)",
"short": "PING",
"params": {
"video": 1,
"time": 1,
"texts": 0,
"threshold": 0
}
},
{
"id": "HTML_TITLE_H1",
"title": "Checks for interrupted or redirected URLs and changes in title and\/or h1 tag of the page.",
"short": "TITLE and H1",
"params": {
"video": 1,
"time": 1,
"texts": 0,
"threshold": 0
}
},
{
"id": "HTML_TEXTS",
"title": "Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)",
"short": "TEXT of the PAGE",
"params": {
"video": 1,
"time": 1,
"texts": 1,
"threshold": 0
}
},
{
"id": "HTML_ALL",
"title": "Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)",
"short": "WHOLE PAGE",
"params": {
"video": 1,
"time": 1,
"texts": 1,
"threshold": 0
}
},
{
"id": "HTML_BLOCKS",
"title": "Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.",
"short": "DATA MINING",
"params": {
"video": 1,
"time": 1,
"texts": 0,
"threshold": 1
}
},
{
"id": "HTML_DISABLED",
"title": "Only the video spider will be activated (spider HTML will be disabled.)",
"short": "HTML disabled",
"params": {
"video": 0,
"time": 0,
"texts": 0,
"threshold": 0
}
}
],
"frequencies": [
{
"label": "do_not_send",
"value": ""
},
{
"label": "immediately",
"value": 0
},
{
"label": "day",
"value": 1
},
{
"label": "day",
"value": 3
},
{
"label": "day",
"value": 7
},
{
"label": "day",
"value": 15
},
{
"label": "day",
"value": 30
}
]
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/watchdogs/property?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
<error></error>
<rate>0</rate>
</status>
<result>
<watchdogs>
<i0>
<type>1D</type>
<title>1 check per day</title>
<limit>1800</limit>
</i0>
</watchdogs>
<spiders>
<i0>
<id>DISABLE_ALL</id>
<title>Disable all spiders. No check will be performed.</title>
<short>Disable ALL</short>
<params>
<video>0</video>
<time>0</time>
<texts>0</texts>
<threshold>0</threshold>
</params>
</i0>
<i1>
<id>AUTOMATIC</id>
<title>The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.</title>
<short>Automatic</short>
<params>
<video>0</video>
<time>0</time>
<texts>0</texts>
<threshold>0</threshold>
</params>
</i1>
<i2>
<id>HTML_PING</id>
<title>Interrupted and redirected URL check (PING.)</title>
<short>PING</short>
<params>
<video>1</video>
<time>1</time>
<texts>0</texts>
<threshold>0</threshold>
</params>
</i2>
<i3>
<id>HTML_TITLE_H1</id>
<title>Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.</title>
<short>TITLE and H1</short>
<params>
<video>1</video>
<time>1</time>
<texts>0</texts>
<threshold>0</threshold>
</params>
</i3>
<i4>
<id>HTML_TEXTS</id>
<title>Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)</title>
<short>TEXT of the PAGE</short>
<params>
<video>1</video>
<time>1</time>
<texts>1</texts>
<threshold>0</threshold>
</params>
</i4>
<i5>
<id>HTML_ALL</id>
<title>Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)</title>
<short>WHOLE PAGE</short>
<params>
<video>1</video>
<time>1</time>
<texts>1</texts>
<threshold>0</threshold>
</params>
</i5>
<i6>
<id>HTML_BLOCKS</id>
<title>Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.</title>
<short>DATA MINING</short>
<params>
<video>1</video>
<time>1</time>
<texts>0</texts>
<threshold>1</threshold>
</params>
</i6>
<i7>
<id>HTML_DISABLED</id>
<title>Only the video spider will be activated (spider HTML will be disabled.)</title>
<short>HTML disabled</short>
<params>
<video>0</video>
<time>0</time>
<texts>0</texts>
<threshold>0</threshold>
</params>
</i7>
</spiders>
<frequencies>
<i0>
<label>do_not_send</label>
<value></value>
</i0>
<i1>
<label>immediately</label>
<value>0</value>
</i1>
<i2>
<label>day</label>
<value>1</value>
</i2>
<i3>
<label>day</label>
<value>3</value>
</i3>
<i4>
<label>day</label>
<value>7</value>
</i4>
<i5>
<label>day</label>
<value>15</value>
</i5>
<i6>
<label>day</label>
<value>30</value>
</i6>
</frequencies>
</result>
</response>
Example 3 (txt)
Request
https://joturl.com/a/i1/watchdogs/property?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
status_error=
status_rate=0
result_watchdogs_0_type=1D
result_watchdogs_0_title=1 check per day
result_watchdogs_0_limit=1800
result_spiders_0_id=DISABLE_ALL
result_spiders_0_title=Disable all spiders. No check will be performed.
result_spiders_0_short=Disable ALL
result_spiders_0_params_video=0
result_spiders_0_params_time=0
result_spiders_0_params_texts=0
result_spiders_0_params_threshold=0
result_spiders_1_id=AUTOMATIC
result_spiders_1_title=The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.
result_spiders_1_short=Automatic
result_spiders_1_params_video=0
result_spiders_1_params_time=0
result_spiders_1_params_texts=0
result_spiders_1_params_threshold=0
result_spiders_2_id=HTML_PING
result_spiders_2_title=Interrupted and redirected URL check (PING.)
result_spiders_2_short=PING
result_spiders_2_params_video=1
result_spiders_2_params_time=1
result_spiders_2_params_texts=0
result_spiders_2_params_threshold=0
result_spiders_3_id=HTML_TITLE_H1
result_spiders_3_title=Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.
result_spiders_3_short=TITLE and H1
result_spiders_3_params_video=1
result_spiders_3_params_time=1
result_spiders_3_params_texts=0
result_spiders_3_params_threshold=0
result_spiders_4_id=HTML_TEXTS
result_spiders_4_title=Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)
result_spiders_4_short=TEXT of the PAGE
result_spiders_4_params_video=1
result_spiders_4_params_time=1
result_spiders_4_params_texts=1
result_spiders_4_params_threshold=0
result_spiders_5_id=HTML_ALL
result_spiders_5_title=Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)
result_spiders_5_short=WHOLE PAGE
result_spiders_5_params_video=1
result_spiders_5_params_time=1
result_spiders_5_params_texts=1
result_spiders_5_params_threshold=0
result_spiders_6_id=HTML_BLOCKS
result_spiders_6_title=Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.
result_spiders_6_short=DATA MINING
result_spiders_6_params_video=1
result_spiders_6_params_time=1
result_spiders_6_params_texts=0
result_spiders_6_params_threshold=1
result_spiders_7_id=HTML_DISABLED
result_spiders_7_title=Only the video spider will be activated (spider HTML will be disabled.)
result_spiders_7_short=HTML disabled
result_spiders_7_params_video=0
result_spiders_7_params_time=0
result_spiders_7_params_texts=0
result_spiders_7_params_threshold=0
result_frequencies_0_label=do_not_send
result_frequencies_0_value=
result_frequencies_1_label=immediately
result_frequencies_1_value=0
result_frequencies_2_label=day
result_frequencies_2_value=1
result_frequencies_3_label=day
result_frequencies_3_value=3
result_frequencies_4_label=day
result_frequencies_4_value=7
result_frequencies_5_label=day
result_frequencies_5_value=15
result_frequencies_6_label=day
result_frequencies_6_value=30
Example 4 (plain)
Request
https://joturl.com/a/i1/watchdogs/property?format=plain
Query parameters
format = plain
Response
1D
1 check per day
1800
DISABLE_ALL
Disable all spiders. No check will be performed.
Disable ALL
0
0
0
0
AUTOMATIC
The spider will be automatically selected by the system. In most cases the system will choose the spider PING without any control over videos.
Automatic
0
0
0
0
HTML_PING
Interrupted and redirected URL check (PING.)
PING
1
1
0
0
HTML_TITLE_H1
Checks for interrupted or redirected URLs and changes in title and/or h1 tag of the page.
TITLE and H1
1
1
0
0
HTML_TEXTS
Checks for interrupted or redirected URLs and changes in the texts of the page (exluding numbers and tags.)
TEXT of the PAGE
1
1
1
0
HTML_ALL
Checks for interrupted or redirected URLs and changes in the page (including numbers and tags.)
WHOLE PAGE
1
1
1
0
HTML_BLOCKS
Checks for interrupted or redirected URLs and changes in the blocks of text that are extracted from the page with data mining algorithm.
DATA MINING
1
1
0
1
HTML_DISABLED
Only the video spider will be activated (spider HTML will be disabled.)
HTML disabled
0
0
0
0
do_not_send
immediately
0
day
1
day
3
day
7
day
15
day
30
Return values
parameter | description |
---|---|
frequencies | list of frequencies available to the logged user |
spiders | list of spiders available to the logged user |
watchdogs | list of watchdogs available to the logged user |
API reference (beta)
/ctas
/ctas/add
access: [WRITE]
Add a call to action template for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/add?name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
name = calltoactionname
type = button
brand_id = 1234abcde
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
"name": "name"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/add?format=xml&name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
format = xml
name = calltoactionname
type = button
brand_id = 1234abcde
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>
<name>name</name>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/add?format=plain&name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
format = plain
name = calltoactionname
type = button
brand_id = 1234abcde
Response
65794b5563376a7a354f6c756b42625946636d2f47773d3d
name
Required parameters
parameter | description |
---|---|
name | name of the call to action |
type | type of the call to action, for a complete list of types see the method i1/ctas/property |
Optional parameters
parameter | description |
---|---|
brand_id | ID of the desired brand |
params | parameters of the call to action, for a complete list of parameters see the method i1/ctas/property |
Return values
parameter | description |
---|---|
date | NA |
id | ID of the call to action |
name | name of the call to action |
type | type of the call to action, for a complete list of types see the method i1/ctas/property |
/ctas/edit
access: [WRITE]
Edit a call to action template for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
id = 1234abc
name = calltoactionname
type = button
brand_id = 1234abcde
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
"name": "name"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
id = 1234abc
name = calltoactionname
type = button
brand_id = 1234abcde
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>
<name>name</name>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/edit?id=1234abc&name=calltoactionname&type=button&brand_id=1234abcde
Query parameters
id = 1234abc
name = calltoactionname
type = button
brand_id = 1234abcde
Response
65794b5563376a7a354f6c756b42625946636d2f47773d3d
name
Required parameters
parameter | description |
---|---|
id | ID of the call to action |
Optional parameters
parameter | description |
---|---|
brand_id | ID of the desired brand |
name | name of the call to action |
params | parameters of the call to action, for a complete list of parameters see the method i1/ctas/property |
type | type of the call to action, for a complete list of types see the method i1/ctas/property |
Return values
parameter | description |
---|---|
id | ID of the call to action |
name | name of the call to action |
/ctas/info
access: [READ]
This method returns information specified in a comma separated input called fields about a cta
Example 1 (xml)
Request
https://joturl.com/a/i1/ctas/info?format=xml&id=123456&fields=name,type
Query parameters
format = xml
id = 123456
fields = name,type
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result></result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/ctas/info?format=txt&id=123456&fields=name,type
Query parameters
format = txt
id = 123456
fields = name,type
Response
status_code=200
status_text=OK
result=
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/info?format=plain&id=123456&fields=name,type
Query parameters
format = plain
id = 123456
fields = name,type
Response
Required parameters
parameter | description |
---|---|
fields | comma separated list of CTA fields [id,type,name,brand_id,params,clicks,conversions] |
id | ID of the call to action |
Return values
parameter | description |
---|---|
data | NA |
/ctas/list
access: [READ]
This method returns a list of user's call to action data, specified in a comma separated input called fields.
Example 1 (xml)
Request
https://joturl.com/a/i1/ctas/list?format=xml&fields=name,id
Query parameters
format = xml
fields = name,id
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<item0>
<id>1a2b3c4d123456</id>
<name>conversion name</name>
</item0>
<item1>
<id>1a2b3c4d123456</id>
<name>call to action name</name>
</item1>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/ctas/list?format=txt&fields=name,id
Query parameters
format = txt
fields = name,id
Response
status_code=200
status_text=OK
result_item0_id=1a2b3c4d123456
result_item0_name=conversion name
result_item1_id=1a2b3c4d123456
result_item1_name=call to action name
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/list?format=plain&fields=name,id
Query parameters
format = plain
fields = name,id
Response
1a2b3c4d123456
conversion name
1a2b3c4d123456
call to action name
Required parameters
parameter | description |
---|---|
fields | comma separated list of CTA fields [id,type,name,brand_id,params,clicks,conversions,count,performance]. You can use the special field count to retrieve the number of call to actions |
Optional parameters
parameter | description |
---|---|
length | number of items to be extracted |
orderby | order items by one field [id,type,name,brand_id,params,clicks,conversions,count,performance]. You can use the special field performance to order call to actions by performance. Use sort for ascending or descending order. Default is orderby = id |
search | filter items by searching them |
sort | to be used in conjunction with orderby to select the ascending or descending order [ASC|DESC]. Default is sort = ASC |
start | index from which the list will be extracted |
types | comma separated list of types to be extracted |
Return values
parameter | description |
---|---|
data | NA |
/ctas/preview
access: [READ]
This method returns an html preview of a cta, using custom parameters or using an existing call to action
Example 1 (xml)
Request
https://joturl.com/a/i1/ctas/preview?format=xml&id=123456
Query parameters
format = xml
id = 123456
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result><[CDATA[<html><head>[...]</head><body>[...]</body></html>]]></result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/ctas/preview?format=txt&id=123456
Query parameters
format = txt
id = 123456
Response
status_code=200
status_text=OK
result=[...][...]
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/preview?format=plain&id=123456
Query parameters
format = plain
id = 123456
Response
Optional parameters
parameter | description |
---|---|
id | ID of the call to action |
params | parameters of the call to action, for a complete list of parameters see the method i1/ctas/property |
Return values
parameter | description |
---|---|
html | NA |
/ctas/privatekey
access: [READ]
This method returns the user's private key.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/privatekey
Response
{
"status": {
"code": 200,
"text": "OK",
"error": ""
},
"result": {
"privatekey": "01234567890123456789"
}
}
Return values
parameter | description |
---|---|
privatekey | NA |
/ctas/property
access: [READ]
This method returns a list of property of a call to action with detailed information on them.
Example 1 (json)
Request
https://joturl.com/a/i1/ctas/property
Response
{
"status": {
"code": 200,
"text": "OK",
"error": ""
},
"result": {
"label": "Tipo Call to Action",
"types": {
"appsnip": {
"label": "App Snip"
},
"banner": {
"label": "Banner"
},
"button": {
"label": "Bottone"
},
"form": {
"label": "Form"
},
"socialconnect": {
"label": "Connessione ai Social Network"
},
"textlink": {
"label": "Text Link"
}
}
}
}
Example 2 (json)
Request
https://joturl.com/a/i1/ctas/property?types=form
Query parameters
types = form
Response
{
"status": {
"code": 200,
"text": "OK",
"error": ""
},
"result": {
"label": "Call to Action type",
"types": {
"form": {
"label": "Form",
"base": {
"name": {
"type": "text",
"label": "Template name"
},
"type": {
"type": "text",
"label": "Call to action\u2019s type"
},
"brand_id": {
"type": "text",
"label": "User brand identifier for a call to action"
},
"one_time_code_validity": {
"type": "select",
"label": "Period of validity of the one-time code",
"options": [
{
"value": "10",
"label": "10 minutes"
},
{
"value": "20",
"label": "20 minutes"
},
{
"value": "30",
"label": "30 minutes"
}
]
},
"one_time_code_private_key": {
"type": "label",
"label": "Private key"
}
},
"design": {
"bgcolor": {
"type": "selectcolor",
"label": "Background color",
"mandatory": 1
},
"txtcolor": {
"type": "selectcolor",
"label": "Text color",
"mandatory": 1
},
"btncolor": {
"type": "selectcolor",
"label": "Button color",
"mandatory": 1
},
"lnktxtcolor": {
"type": "selectcolor",
"label": "Link text color",
"mandatory": 1
},
"position": {
"type": "select",
"label": "Position",
"mandatory": 1,
"options": [
{
"value": "bottom-left",
"label": "Bottom left"
},
{
"value": "bottom-right",
"label": "Bottom right"
}
]
},
"shape": {
"type": "select",
"label": "Modules appearance",
"mandatory": 1,
"options": [
{
"value": "social",
"label": "Social"
},
{
"value": "fullwidth",
"label": "Full width"
}
]
}
},
"content": {
"customized_message": {
"type": "text",
"label": "Customized message",
"mandatory": 1
},
"placeholder_text": {
"type": "text",
"label": "Insert a message",
"mandatory": 1
},
"destination_url": {
"type": "text",
"label": "Destination URL",
"mandatory": 1
}
}
}
}
}
}
Optional parameters
parameter | description |
---|---|
types | comma separated list of possible types. If not specified the method returns accepted types, otherwise it returns detailed information on the requested types. Types can be ALL to get detailed information on all types |
Return values
parameter | description |
---|---|
data | NA |
/ctas/snip
access: [READ]
This method returns the actual snip for CTAs
Example 1 (xml)
Request
https://joturl.com/a/i1/ctas/snip?format=xml&id=123456
Query parameters
format = xml
id = 123456
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result><[CDATA[<html><head>[...]</head><body>[...]</body></html>]]></result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/ctas/snip?format=txt&id=123456
Query parameters
format = txt
id = 123456
Response
status_code=200
status_text=OK
result=[...][...]
Example 3 (plain)
Request
https://joturl.com/a/i1/ctas/snip?format=plain&id=123456
Query parameters
format = plain
id = 123456
Response
Optional parameters
parameter | description |
---|---|
id | ID of the call to action |
params | parameters of the call to action, for a complete list of parameters see the method i1/ctas/property |
Return values
parameter | description |
---|---|
html | NA |
/resources
/resources/add
access: [WRITE]
This method allows to upload a resource
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/add?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/add?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/add?format=plain
Query parameters
format = plain
Response
200
OK
Required parameters
parameter | description |
---|---|
context | context of the upload |
input | the name of the form field used to transfer resource's data |
upload_type | Type of the upload. Available types: images,ssl |
Return values
parameter | description |
---|---|
id | NA |
name | name of the resource |
type | type of the resource |
url | complete URL of the resource |
/resources/count
access: [READ]
This method returns number of resources of a specific upload_type in a context
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<count>7048</count>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
result_count=7048
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/count?format=plain
Query parameters
format = plain
Response
7048
Required parameters
parameter | description |
---|---|
context | context of the upload |
upload_type | Type of the upload. Available types: images,ssl |
Return values
parameter | description |
---|---|
count | number of resources |
/resources/delete
access: [WRITE]
This method deletes a resource
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/delete?format=xml&id=1234567890
Query parameters
format = xml
id = 1234567890
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<count>1</count>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/delete?format=txtresource_id=1234567890
Query parameters
format = txtresource_id=1234567890
Response
status_code=200
status_text=OK
result_count=1
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/delete?format=plainresource_id=1234567890
Query parameters
format = plainresource_id=1234567890
Response
1
Required parameters
parameter | description |
---|---|
context | context of the upload |
ids | IDs of the resources to be deleted |
upload_type | Type of the upload. Available types: images,ssl |
Return values
parameter | description |
---|---|
count | number of deleted resources |
/resources/edit
access: [WRITE]
This method allows to edit a resource
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/edit?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/edit?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/edit?format=plain
Query parameters
format = plain
Response
200
OK
Required parameters
parameter | description |
---|---|
context | context of the upload |
id | ID of the resource |
input | the name of the form field used to transfer resource's data |
upload_type | Type of the upload. Available types: images,ssl |
Return values
parameter | description |
---|---|
id | NA |
name | name of the resource |
type | type of the resource |
url | complete URL of the resource |
/resources/info
access: [READ]
This method returns information specified in a comma separated input called fields about a resource
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/info?format=xml&id=123456&fields=name,url
Query parameters
format = xml
id = 123456
fields = name,url
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/info?format=txt&iresource_id=123456&fields=name,url
Query parameters
format = txt
iresource_id = 123456
fields = name,url
Response
status_code=200
status_text=OK
result=
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/info?format=plain&id=123456&fields=name,url
Query parameters
format = plain
id = 123456
fields = name,url
Response
Required parameters
parameter | description |
---|---|
context | context of the upload |
fields | comma separated list of resources fields [id,name,url,type,context,date] |
id | ID of the resource |
upload_type | Type of the upload. Available types: images,ssl |
Return values
parameter | description |
---|---|
data | parameters specified in fields of the resource |
/resources/list
access: [READ]
This method returns a list of resource of a specific upload_type in a context
Example 1 (xml)
Request
https://joturl.com/a/i1/resources/list?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/resources/list?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
Example 3 (plain)
Request
https://joturl.com/a/i1/resources/list?format=plain
Query parameters
format = plain
Response
200
OK
Required parameters
parameter | description |
---|---|
context | context of the upload |
fields | comma separated list of resources fields [id,name,url,type,context,date,count]. You can use the special field count to retrieve the number of resources |
upload_type | Type of the upload. Available types: images,ssl |
Optional parameters
parameter | description |
---|---|
length | number of items to be extracted |
start | index from which the list will be extracted |
Return values
parameter | description |
---|---|
count | number of resources |
data | array (id,name,url,type) of resources |
/urls
/urls/instaurls
/urls/instaurls/edit
access: [WRITE]
Set InstaUrl settings for a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/edit?mp_url_id=12345
Query parameters
mp_url_id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Required parameters
parameter | description |
---|---|
id | NA |
settings | NA |
Return values
parameter | description |
---|---|
enabled | NA |
/urls/instaurls/info
access: [READ]
Get settings for the InstaUrl option.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/info?mp_url_id=12345
Query parameters
mp_url_id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Required parameters
parameter | description |
---|---|
id | NA |
Return values
parameter | description |
---|---|
settings | NA |
/urls/instaurls/preview
access: [READ]
Given parameters, this method returns the HTML of an InstaUrl page.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/preview?mp_url_id=12345
Query parameters
mp_url_id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Optional parameters
parameter | description |
---|---|
settings | NA |
Return values
parameter | description |
---|---|
html | NA |
/urls/instaurls/property
access: [READ]
Returns the list of available properties for the InstaUrl option.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/instaurls/property?mp_url_id=12345
Query parameters
mp_url_id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Return values
parameter | description |
---|---|
avatar | NA |
background | NA |
css | NA |
fonts | NA |
icons | NA |
links | NA |
max_items | NA |
messengers | NA |
social_networks | NA |
themes | NA |
/urls/minipages
/urls/minipages/edit
access: [WRITE]
Set a minipage for a tracking link.
Required parameters
parameter | description |
---|---|
id | NA |
Optional parameters
parameter | description |
---|---|
params | NA |
template | NA |
template_name | NA |
Return values
parameter | description |
---|---|
added | NA |
/urls/minipages/info
access: [READ]
Get the minipage linked to a tracking link.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/minipages/info?id=12345
Query parameters
id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Required parameters
parameter | description |
---|---|
id | NA |
Return values
parameter | description |
---|---|
data | NA |
/urls/minipages/preview
access: [READ]
Given a template and parameters, this method returns the HTML.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/minipages/preview?id=12345
Query parameters
id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Optional parameters
parameter | description |
---|---|
id | NA |
params | NA |
template | NA |
template_name | NA |
Return values
parameter | description |
---|---|
html | NA |
/urls/minipages/property
access: [READ]
Returns the list of available minipage templates and their properties.
Example 1 (json)
Request
https://joturl.com/a/i1/urls/minipages/property?id=12345
Query parameters
id = 12345
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": []
}
Return values
parameter | description |
---|---|
data | NA |
/users
/users/brands
/users/brands/add
access: [WRITE]
Add a user brand for the user logged in.
Example 1 (json)
Request
https://joturl.com/a/i1/users/brands/adduser_brand_name=brandname&url_home=http://www.joturl.com
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
"name": "name"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/brands/add?format=xml&name=brandname&url_home=http://www.joturl.com
Query parameters
format = xml
name = brandname
url_home = http://www.joturl.com
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>
<name>name</name>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/add?format=plain&name=brandname&url_home=http://www.joturl.com
Query parameters
format = plain
name = brandname
url_home = http://www.joturl.com
Response
65794b5563376a7a354f6c756b42625946636d2f47773d3d
name
Required parameters
parameter | description |
---|---|
input | the name of the form field used to transfer brand's logo |
Optional parameters
parameter | description |
---|---|
name | name of the brand |
url_home | URL of the brand's home |
Return values
parameter | description |
---|---|
id | ID of the brand |
name | name of the brand |
url | complete URL of the logo image |
url_home | URL of the brand's home |
/users/brands/count
access: [READ]
This method returns the number of user brand's related to the call to actions
Example 1 (xml)
Request
https://joturl.com/a/i1/users/brands/count?format=xml
Query parameters
format = xml
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<count>447</count>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/users/brands/count?format=txt
Query parameters
format = txt
Response
status_code=200
status_text=OK
result_count=447
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/count?format=plain
Query parameters
format = plain
Response
447
Optional parameters
parameter | description |
---|---|
search | filter items by searching them |
Return values
parameter | description |
---|---|
count | number of brands |
/users/brands/delete
access: [WRITE]
This method deletes a user brand using the ids . Return 1 if the operation succeeds or 0 otherwise
Example 1 (xml)
Request
https://joturl.com/a/i1/users/brands/delete?format=xml&ids=12345abcdef6789,2345abcdef
Query parameters
format = xml
ids = 12345abcdef6789,2345abcdef
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<deleted>1</deleted>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/users/brands/delete?format=txt&ids=12345abcdef6789,2345abcdef
Query parameters
format = txt
ids = 12345abcdef6789,2345abcdef
Response
status_code=200
status_text=OK
result_deleted=1
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/delete?format=plain&ids=12345abcdef6789,2345abcdef
Query parameters
format = plain
ids = 12345abcdef6789,2345abcdef
Response
1
Required parameters
parameter | description |
---|---|
ids | IDs of the brands to be deleted |
Return values
parameter | description |
---|---|
deleted | number of deleted brands |
/users/brands/edit
access: [WRITE]
Edit fields of a user brand.
Example 1 (json)
Request
https://joturl.com/a/i1/users/brands/edit?id=123456a&name=newname
Query parameters
id = 123456a
name = newname
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"id": "65794b5563376a7a354f6c756b42625946636d2f47773d3d",
"name": "name"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/users/brands/edit?format=xml&id=123456a&name=newname
Query parameters
format = xml
id = 123456a
name = newname
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>
<name>name</name>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/edit?format=plain&id=123456a&name=newname
Query parameters
format = plain
id = 123456a
name = newname
Response
65794b5563376a7a354f6c756b42625946636d2f47773d3d
name
Required parameters
parameter | description |
---|---|
id | ID of the brand |
Optional parameters
parameter | description |
---|---|
input | the name of the form field used to transfer brand's logo |
name | name of the brand |
url_home | URL of the brand's home |
Return values
parameter | description |
---|---|
id | ID of the brand |
name | name of the brand |
url_home | URL of the brand's home |
/users/brands/info
access: [READ]
This method returns information specified in a comma separated input called fields about a user brand
Example 1 (xml)
Request
https://joturl.com/a/i1/users/brands/info?format=xml&id=123456&fields=name,url_home
Query parameters
format = xml
id = 123456
fields = name,url_home
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<id>65794b5563376a7a354f6c756b42625946636d2f47773d3d</id>
<name>name</name>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/users/brands/info?format=txt&id=123456&fields=name,url_home
Query parameters
format = txt
id = 123456
fields = name,url_home
Response
status_code=200
status_text=OK
result_id=65794b5563376a7a354f6c756b42625946636d2f47773d3d
result_name=name
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/info?format=plain&id=123456&fields=name,url_home
Query parameters
format = plain
id = 123456
fields = name,url_home
Response
65794b5563376a7a354f6c756b42625946636d2f47773d3d
name
Required parameters
parameter | description |
---|---|
fields | comma separated list of fields [id,name,url_home,url,res_id,res_name,context,type,date,count] |
Optional parameters
parameter | description |
---|---|
id | ID of the brand |
res_id | NA |
Return values
parameter | description |
---|---|
data | required fields (id,name,url_home,url,res_id,res_name,context,type,date) of the brand |
/users/brands/list
access: [READ]
This method returns a list of user's brands data, specified in a comma separated input called fields.
Example 1 (xml)
Request
https://joturl.com/a/i1/users/brands/list?format=xml&fields=name,url_home
Query parameters
format = xml
fields = name,url_home
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<item0>
<id>1a2b3c4d123456</id>
<name>brand name</name>
</item0>
<item1>
<id>1a2b3c4d123456</id>
<name>brand name</name>
</item1>
</result>
</response>
Example 2 (txt)
Request
https://joturl.com/a/i1/users/brands/list?format=txt&fields=name,url_home
Query parameters
format = txt
fields = name,url_home
Response
status_code=200
status_text=OK
result_item0_id=1a2b3c4d123456
result_item0_name=brand name
result_item1_id=1a2b3c4d123456
result_item1_name=brand name
Example 3 (plain)
Request
https://joturl.com/a/i1/users/brands/list?format=plain&fields=name,url_home
Query parameters
format = plain
fields = name,url_home
Response
1a2b3c4d123456
brand name
1a2b3c4d123456
brand name
Required parameters
parameter | description |
---|---|
fields | comma separated list of fields [id,name,url_home,url,res_id,res_name,context,type,date,count]. You can use the special field count to retrieve the number of resources |
Optional parameters
parameter | description |
---|---|
length | number of items to be extracted |
orderby | order items by one field [id,name,url_home,url,res_id,res_name,context,type,date,count]. Use sort for ascending or descending order. Default is orderby = id |
search | filter items by searching them |
sort | to be used in conjunction with orderby to select the ascending or descending order [ASC|DESC]. Default is sort = ASC |
start | index from which the list will be extracted |
Return values
parameter | description |
---|---|
count | number of brands |
data | array (id,name,url_home,url,res_id,res_name,context,type,date) of brands |
/watchdogs
/watchdogs/add
access: [WRITE]
Given a url identifier, set a watchdog for it.
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/add ?&ids=123abcdef&watchdog=1
Query parameters
ids = 123abcdef
watchdog = 1
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"updated": "1"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/watchdogs/add?&ids=123abcdef&watchdog=1
Query parameters
ids = 123abcdef
watchdog = 1
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<updated>1</updated>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/watchdogs/add?&ids=123abcdef&watchdog=1
Query parameters
ids = 123abcdef
watchdog = 1
Response
1
Required parameters
parameter | description |
---|---|
spider_type | NA |
watchdog | NA |
Optional parameters
parameter | description |
---|---|
ids | NA |
project_id | NA |
text | NA |
text_check | NA |
video | NA |
watchdog | NA |
watchdog_set_as_default | NA |
Return values
parameter | description |
---|---|
updated | NA |
/watchdogs/delete
access: [WRITE]
Delete a watchdog related to a given short URL or a given project.
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/delete?id=123abcdef
Query parameters
id = 123abcdef
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"watchdog": "0",
"spider": "128",
"spider_check": "0",
"spider_check_option": "70",
"spider_only_html": "1",
"spider_time": "",
"watchdog_is_default": "0"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/watchdogs/delete?format=xml&id=123abcdef
Query parameters
format = xml
id = 123abcdef
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<watchdog>0</watchdog>
<spider>128</spider>
<spider_check>0</spider_check>
<spider_check_option>70</spider_check_option>
<spider_only_html>1</spider_only_html>
<spider_time></spider_time>
<watchdog_is_default>0</watchdog_is_default>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/watchdogs/delete?format=plain&id=123abcdef
Query parameters
format = plain
id = 123abcdef
Response
0
128
0
70
1
0
Optional parameters
parameter | description |
---|---|
id | NA |
project_id | NA |
Return values
parameter | description |
---|---|
data | NA |
/watchdogs/info
access: [READ]
Returns information on the watchdog related to a given tracking link or a given project.
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/info?id=123abcdef
Query parameters
id = 123abcdef
Response
{
"status": {
"code": 200,
"text": "OK"
},
"result": {
"watchdog": "0",
"spider": "128",
"spider_check": "0",
"spider_check_option": "70",
"spider_only_html": "1",
"spider_time": "",
"watchdog_is_default": "0"
}
}
Example 2 (xml)
Request
https://joturl.com/a/i1/watchdogs/info?format=xml&id=123abcdef
Query parameters
format = xml
id = 123abcdef
Response
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>
<code>200</code>
<text>OK</text>
</status>
<result>
<watchdog>0</watchdog>
<spider>128</spider>
<spider_check>0</spider_check>
<spider_check_option>70</spider_check_option>
<spider_only_html>1</spider_only_html>
<spider_time></spider_time>
<watchdog_is_default>0</watchdog_is_default>
</result>
</response>
Example 3 (plain)
Request
https://joturl.com/a/i1/watchdogs/info?format=plain&id=123abcdef
Query parameters
format = plain
id = 123abcdef
Response
0
128
0
70
1
0
Optional parameters
parameter | description |
---|---|
id | NA |
project_id | NA |
Return values
parameter | description |
---|---|
data | NA |
/watchdogs/stats
access: [READ]
This method returns stats about a watchdog.
Example 1 (json)
Request
https://joturl.com/a/i1/watchdogs/stats
Response
{
"status": {
"code": 200,
"text": "OK",
"error": ""
},
"result": {
"stats": "",
"spiders": ""
}
}
Return values
parameter | description |
---|---|
data | NA |