TI-Store-API-Suite

Authentifizierung

Da die TI Store-APIs mit OAuth 2.0 gesichert sind, müssen Sie beim Senden einer Anforderung ein Zugriffstoken übergeben. Um einen Zugriffstoken zu erhalten, rufen Sie die OAuth-API unter folgender Adresse auf: https://transact.ti.com/v1/oauth/accesstoken.

Für eine erfolgreiche Anforderung ist Folgendes zu beachten:
 

  • Wir verwenden den Client Credentials Flow.
  • Der „Content-Typ“ muss „application/x-www-form-urlencoded“ lauten.
  • Die Anfrage sollte ohne zusätzliche Abfrageparameter an die oben genannte URL gesendet werden.
  • Der Körper der Anforderung muss die Parameter der Anforderung (grant_type, client_id, client_secret) als durch „&“ getrennte Zeichenkette ohne jede weitere Kodierung enthalten.
  • Zum Beispiel: "grant_type=client_credentials&client_id=[CLIENT_ID]&client_secret=[CLIENT_SECRET]"
  • Der Zugriffstoken ist 60 Minuten lang gültig. Überprüfen Sie, ob das Zugriffstoken abgelaufen ist, bevor Sie das Token in anderen APIs verwenden.
  • Das Zugriffstoken (oder Träger-Token) muss im Header aller API-Anfragen übergeben werden.
curl --request POST \ --url https://transact.ti.com/v1/oauth/accesstoken \ --header 'Content-Type: application/x-www-form-urlencoded' \ --data grant_type=client_credentials \ --data client_id=XXXXXXXXXXXXXXXXX \ --data client_secret=XXXXXXXXXXXXXXXXX


Antwort auf eine erfolgreiche Anfrage:

{ "access_token": "MTQ0NjJkZmQ5OTM2NDE1ZTZjNGZmZjI3", "token_type": "bearer", "expires_in": 3599, "scope": "", "application_name": "app_name", "developer.email": "api-portal@list.ti.com", "issued_at": "1582220284531", "client_id": "IwOjYzmalmM2YxOT15MGE3YmNm4DFkyTVk" }


Beispielauthentifizierung für Payload und Header einer Zugriffstoken-Anforderung vom Insomnia-Client:

 


Insomnia Request OAuth2 Einstellungen:

 


Authentifizierungsbeispiel in VB.net (Framework 4.6.1):

Imports System.Net Imports System.IO Imports System.Text Imports Newtonsoft.Json.Linq Private Function GetToken() as string Dim URL As String = "https://transact.ti.com/v1/oauth/accesstoken" Dim ClientID As String = "{myTI API Key}" Dim ClientSecret As String = "{myTI API Secret}" Dim Data As String = $"grant_type=client_credentials&client_id={ClientID }&client_secret={ClientSecret}" Dim request As HttpWebRequest = DirectCast(WebRequest.Create(URL), HttpWebRequest) request.Method = "POST" request.ContentType = "application/x-www-form-urlencoded" Dim byteArray As Byte() = Encoding.UTF8.GetBytes(Data) request.ContentLength = byteArray.Length Dim dataStream As Stream = request.GetRequestStream() dataStream.Write(byteArray, 0, byteArray.Length) dataStream.Close() Dim response As HttpWebResponse = DirectCast(request.GetResponse(), HttpWebResponse) dataStream = response.GetResponseStream() Dim reader As New StreamReader(dataStream) Dim result As String = reader.ReadToEnd() reader.Close() dataStream.Close() response.Close() Dim parsejson As JObject = JObject.Parse(result) return parsejson.SelectToken("access_token").ToString End Function

 

Authentifizierungsbeispiel in C# (Framework 4.6.1):

using System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Threading.Tasks; using System.Windows.Forms; using System.Net.Http; namespace WindowsFormsApp1 { public partial class Form1 : Form { public Form1() { InitializeComponent(); } private void Form1_Load(object sender, EventArgs e) { } private void button1_Click(object sender, EventArgs e) { GetToken(); } static async Task GetToken() { string apiUrl = "https://transact.ti.com/v1/oauth/accesstoken"; // Create the HttpClient using (HttpClient client = new HttpClient()) { // Prepare the data to send var formData = new FormUrlEncodedContent(new[] { new KeyValuePair<string, string>("grant_type", "client_credentials"), new KeyValuePair<string, string>("client_id", "{myTI API Key}"), new KeyValuePair<string, string>("client_secret", "{myTI API Secret}"), // Add more key-value pairs as needed }); // Bereiten Sie die PUT-Anforderung mit (HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Put, apiUrl)) { request.Content = formData vor; try { request.Headers.Add("Accept", "application/json"); // Optional, set the desired response format} } catch (Exception e) { Console.WriteLine(e.Message); } // Send the request and get the response try { HttpResponseMessage response = await client.SendAsync(request); if (response.IsSuccessStatusCode) { string responseBody = await response.Content.ReadAsStringAsync(); Console.WriteLine("Request successful. Antwort: " + responseBody); } else { Console.WriteLine("Request failed. Status code: " + response.StatusCode); } } catch (Exception e) { Console.WriteLine(e.Message); } // Antwort verarbeiten } } } } }