Create cron task

Description

POST https://rest.netim.com/1.0/webhosting/{id}/cron-task/

Create a cron task.

• 
  Parameters
• 
  Responses

URL Parameters

• {id}
  Hosting ID.

Headers

• Authorization
  string

  The Autorization header must start with « Bearer  » followed by the session ID.
  Example: »Autorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26″

• Content-type
  string

  Content type of the request

  Only « application/json » is accepted

Body

REQUIRED

• fqdn
  string
  fqdn of the vhost.
• path
  string
  Path of the script to be executed, starting from the vhost’s directory.
• returnMethod
  string
  Logging method (« LOG », « MAIL » or « NONE »).
• returnTarget
  string
  Target of the log.

  When returnMethod is « LOG »: a path of a log file starting from the vhost’s directory.

  When returnMethod is « MAIL »: an email address.

• mm
  string
  Minutes (00-59).
• hh
  string
  Hours (00-23).
• jj
  string
  Day (01-31).
• mmm
  string
  Month (01-12).
• jjj
  string
  Day in the week (1-7).

JSON example

{
    "fqdn":"wordpress.netim.com",
    "path":"/cron.php",
    "returnMethod":"LOG",
    "returnTarget":"/log.txt",
    "mm":"5",
    "hh":"*",
    "jj":"*",
    "mmm":"*",
    "jjj":"*",
}

• 200OK
  The request is processed and the result is returned in the body.

  Body

  Objectapplication/json

  An object of type StructOperationResponse

• 4XX

  Learn more about the possible error codes

Common language examples

• 
  PHP
• 
  JAVA
• 
  PYTHON
• 
  SHELL / CURL

<?php
 
    $ch = curl_init();
 
    $id = "NW1024";
 
    $body = array(
        "fqdn" => "wordpress.netim.com",
        "path" => "/cron.php",
        "returnMethod" => "LOG",
        "returnTarget" => "/log.txt",
        "mm" => "5",
        "hh" => "*",
        "jj" => "*",
        "mmm" => "*",
        "jjj" => "*",
    );
 
    curl_setopt($ch, CURLOPT_URL, "https://rest.netim.com/1.0/webhosting/$id/cron-task/");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer $sessionID", "Content-type: application/json"]);
    curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
    curl_setopt($ch, CURlOPT_POSTFIELDS, json_encode($body));
 
 
    $result = json_decode(curl_exec ($ch), true);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close ($ch);
 

import java.util.Base64;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
public class Example {
 
    public static void main(String args[]) throws Exception {
        String sessionID = "12345678";
 
        String id = "NW1024";
 
        String body = "{"fqdn":"wordpress.netim.com","path":"/cron.php","returnMethod":"LOG","returnTarget":"/log.txt","mm":"5","hh":"*","jj":"*","mmm":"*","jjj":"*",}";
 
 
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://rest.netim.com/1.0/webhosting/" + id + "/cron-task/"))
            .method("POST", HttpRequest.BodyPublishers.ofString(body))
            .header("Content-Type", "application/json")
            .header("Accept-Language", "EN")
            .header("Authorization", "Bearer " + sessionID)
            .build();
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
        String result = response.body().toString();
    }
}

#!/usr/bin/python3
 
import json
import requests
 
 
id = "NW1024"
url = "https://rest.netim.com/1.0/webhosting/" + id + "/cron-task/"
 
sessionId = "1234567"
 
headers = {"Authorization": "Bearer " + sessionId, "Content-Type": "application/json"}
 
 
data = {
    "fqdn":"wordpress.netim.com",
    "path":"/cron.php",
    "returnMethod":"LOG",
    "returnTarget":"/log.txt",
    "mm":"5",
    "hh":"*",
    "jj":"*",
    "mmm":"*",
    "jjj":"*",
}
 
response = requests.post(url, headers=headers, data=json.dumps(data))

curl -X POST https://rest.netim.com/1.0/webhosting/NW1024/cron-task/ 
-H 'Authorization: Bearer b0f13a3c01d9cce2a9a44cd729f81c26=' 
-H 'Content-type: application/json' 
-d '{"fqdn":"wordpress.netim.com","path":"/cron.php","returnMethod":"LOG","returnTarget":"/log.txt","mm":"5","hh":"*","jj":"*","mmm":"*","jjj":"*",}'

Need an API client ?
Speed up your integration by using our API client for REST