Microsoft Login

GET/api/opendata/microsoft/login

Responses

200Get redirect for microsoft loginOpenDataRedirect

Request

curl --request GET \
  --url https://your-instance.iw-erp.de/api/opendata/microsoft/login

const options = {method: 'GET'};

fetch('https://your-instance.iw-erp.de/api/opendata/microsoft/login', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

response = requests.get(url)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://your-instance.iw-erp.de/api/opendata/microsoft/login');

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Get,
  RequestUri = new Uri("https://your-instance.iw-erp.de/api/opendata/microsoft/login"),
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://your-instance.iw-erp.de/api/opendata/microsoft/login")
  .get()
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart with package:http (no controller in the iw_erp_api package)

import 'package:http/http.dart' as http;

final response = await http.get(
  Uri.parse('https://your-instance.iw-erp.de/api/opendata/microsoft/login'),
  headers: {},
);
print(response.body);

Response 200 application/json

{}

POST/api/opendata/microsoft/login

Request body application/json

dataFormLoginUser3
Show fields (3)
- codestring
  Code of the login form user.
- typestring
  Type of the login form user.
- client_idstring
  Identifier of the client the login form belongs to.

Responses

200Do log in with microsoft codeSession

Show fields (15)

idinteger
Primary key of the session. Internal ID.
sessionidstring
ID of the session.
selectedcustomerCustomerProfile
Customer profile selected in the session.
Show fields (6)
- idinteger
  Primary key of the customer profile. Internal ID.
- slackchannelstring
  Slack channel of the customer profile.
- displaynamestring
  Name shown for the customer profile.
- deletedboolean
  Whether the customer profile is deleted.
- createdstring (date-time)
  Point in time the entity was created.
- updatedstring (date-time)
  Point in time the entity was last updated.
startstring (date-time)
Point in time the session started.
refreshed_startstring (date-time)
Point in time the session was last refreshed.
ipstring
IP address of the client.
validboolean
Whether the session is valid.
is_api_keyboolean
Whether the session was created with an API key.
is_dgboolean
Whether the session is for the DG (member organization) context.
missing2faboolean
Whether two-factor authentication is still missing.
start_in_vpnboolean
Whether the session started in a VPN.
auth_by_credentialsboolean
Whether the session was authenticated with user name and password.
auth_by_googleboolean
Whether the session was authenticated with Google.
auth_by_microsoftboolean
Whether the session was authenticated with Microsoft.
auth_by_cloudflareboolean
Whether the session was authenticated with Cloudflare Access.

Request

curl --request POST \
  --url https://your-instance.iw-erp.de/api/opendata/microsoft/login \
  --header 'content-type: application/json' \
  --data '
{
  "data": {
    "code": "string",
    "type": "string",
    "client_id": "42"
  }
}
'

const options = {
  method: 'POST',
  headers: {'content-type': 'application/json'},
  body: JSON.stringify({data: {code: 'string', type: 'string', client_id: '42'}})
};

fetch('https://your-instance.iw-erp.de/api/opendata/microsoft/login', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

payload = { "data": {
    "code": "string",
    "type": "string",
    "client_id": "42"
  } }
headers = {"content-type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://your-instance.iw-erp.de/api/opendata/microsoft/login', [
  'body' => '{"data":{"code":"string","type":"string","client_id":"42"}}',
  'headers' => [
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Post,
  RequestUri = new Uri("https://your-instance.iw-erp.de/api/opendata/microsoft/login"),
  Content = new StringContent("{\"data\":{\"code\":\"string\",\"type\":\"string\",\"client_id\":\"42\"}}")
  {
    Headers =
    {
      ContentType = new MediaTypeHeaderValue("application/json")
    }
  }
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"data\":{\"code\":\"string\",\"type\":\"string\",\"client_id\":\"42\"}}");
Request request = new Request.Builder()
  .url("https://your-instance.iw-erp.de/api/opendata/microsoft/login")
  .post(body)
  .addHeader("content-type", "application/json")
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

	payload := strings.NewReader("{\"data\":{\"code\":\"string\",\"type\":\"string\",\"client_id\":\"42\"}}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart with package:http (no controller in the iw_erp_api package)

import 'dart:convert';
import 'package:http/http.dart' as http;

final response = await http.post(
  Uri.parse('https://your-instance.iw-erp.de/api/opendata/microsoft/login'),
  headers: {'content-type': 'application/json'},
  body: jsonEncode({
    "data": {
      "code": "string",
      "type": "string",
      "client_id": "42"
    }
  }),
);
print(response.body);

Response 200 application/json

{
  "id": 42,
  "sessionid": "string",
  "selectedcustomer": {
    "id": 42,
    "slackchannel": "string",
    "displayname": "string",
    "deleted": true,
    "created": "2026-10-15T09:30:00+02:00",
    "updated": "2026-10-15T09:30:00+02:00"
  },
  "start": "2026-10-15T09:30:00+02:00",
  "refreshed_start": "2026-10-15T09:30:00+02:00",
  "ip": "string",
  "valid": true,
  "is_api_key": true,
  "is_dg": true,
  "missing2fa": true
}

DELETE/api/opendata/microsoft/login

Responses

200Remove microsoft user connectionSuccess

Show fields (3)

successboolean
messagestring
error_codesarray<integer>

Request

curl --request DELETE \
  --url https://your-instance.iw-erp.de/api/opendata/microsoft/login

const options = {method: 'DELETE'};

fetch('https://your-instance.iw-erp.de/api/opendata/microsoft/login', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

response = requests.delete(url)

print(response.text)

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('DELETE', 'https://your-instance.iw-erp.de/api/opendata/microsoft/login');

echo $response->getBody();

using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
  Method = HttpMethod.Delete,
  RequestUri = new Uri("https://your-instance.iw-erp.de/api/opendata/microsoft/login"),
};
using (var response = await client.SendAsync(request))
{
  response.EnsureSuccessStatusCode();
  var body = await response.Content.ReadAsStringAsync();
  Console.WriteLine(body);
}

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://your-instance.iw-erp.de/api/opendata/microsoft/login")
  .delete(null)
  .build();

Response response = client.newCall(request).execute();

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://your-instance.iw-erp.de/api/opendata/microsoft/login"

	req, _ := http.NewRequest("DELETE", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

Dart with package:http (no controller in the iw_erp_api package)

import 'package:http/http.dart' as http;

final response = await http.delete(
  Uri.parse('https://your-instance.iw-erp.de/api/opendata/microsoft/login'),
  headers: {},
);
print(response.body);

Response 200 application/json

{
  "success": true,
  "message": "string",
  "error_codes": [
    1
  ]
}