Netim Direct
Updated on 4 October 2023

Open session

Description

POST https://rest.netim.com/1.0/session/

Opens a new API session.

In order to connect the API, you will need to send a request to the API endpoint and create an authorization header with your credentials. More information in the Get Started section

Headers

  • Authorization string

    The Autorization header must start with “Basic” followed by the account’s id and the account’s secret glued together with a colon-space and encoded with base 64.
    Example:”Autorization: Basic TkVUSU06bXlzZWNyZXQ=” (where NETIM:mysecret is used to be base 64 encoded as TkVUSU06bXlzZWNyZXQ=) 

  • Content-type string

    Content type of the request

    Only “application/json” is accepted

  • Accept-Language string

    The Accept-Language header is used for the languages of messages.

    Values : “FR”, “EN”

The session ID must be kept for next function calls.

Common language examples

<?php
    $encodedAuth = base64_encode("$ID:$secret");
 
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, 'https://rest.netim.com/1.0/session/');
 
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    curl_setopt($ch, CURLOPT_POST, 1);
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Accept-Language: EN","Authorization: Basic " . $encodedAuth, "Content-Type: application/json"]);
    curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
    $result = json_decode(curl_exec ($ch), true);
    $status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close ($ch);
 
    $sessionID = $result['access_token'];
 
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 ID = "ID";
		String secret = "secret";
		String auth = ID + ":" + secret;
		byte[] encodedAuth = Base64.getEncoder().encode(auth.getBytes(StandardCharsets.UTF_8));
 
		HttpClient client = HttpClient.newHttpClient();
		HttpRequest request = HttpRequest.newBuilder()
			.uri(URI.create("https://rest.netim.com/1.0/session/"))
			.method("POST", HttpRequest.BodyPublishers.ofString(""))
			.header("Content-Type", "application/json")
			.header("Accept-Language", "EN")
			.header("Authorization", "Basic " + new String(encodedAuth))
			.build();
		HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
 
		String result = response.body().toString();
    }
}
#!/usr/bin/python3
 
import json
import requests
 
url = 'https://rest.netim.com/1.0/session/'
 
ID = "ID"
secret = "secret"
 
headers = {"Accept-Language" : "EN", "Content-Type": "application/json"}
response = requests.post(url, auth=(ID, secret), headers=headers)
res = json.loads(response.text)
 
sessionId = res["access_token"]
curl -X POST https://api.netim.com/rest/1.0/session/ \
-H 'Authorization: Basic TkVUSU06bXlzZWNyZXQ=' \
-H 'Content-type: application/json' \
-H 'Accept-Language: EN'