API:et använder OpenID Connect (OIDC) som autentiseringsprotokoll. Det är en välkänd standard och en delmängd av OAuth 2.0. Det finns många bibliotek som kan vara användbara vid implementering av en klient i de flesta språk.

Så här får du en access-token

Klienten använder ett klient-ID och en hemlighet för att identifiera sig och får en access-token vid lyckad autentisering. Vänligen kontakta Position Green för att få inloggningsuppgifter för användning av API:et.

Hämta en access-token

POST https://login.positiongreen.com/connect/token

Först skickar du en HTTP POST till/connect/token med parametrarna nedan. Där grant_type är "client_credentials" och client_id och client_secret har angetts för din klient. 

Svaret, om statuskoden är 200, innehåller JSON med egenskapen access_token. Detta används i alla förfrågningar med Position Green API. 

Skicka en HTTP POST till /connect/token med följande formulärparametrar för att hämta en access-token.

Parametrar för sökväg

{
    "access_token":"<access token>",
    "expires_in":3600,
    "token_type":"Bearer"
}

Exempel, hämta en access token med användning av curl

Exekvera följande på en rad och ersätt client_secret, client_id och api-url.

curl --location --request POST 
--header "Content-Type: application/x-www-form-urlencoded" 
--data-urlencode "grant_type=client_credentials"
--data-urlencode "client_secret=<client_secret>"
--data-urlencode "client_id=<client_id>"
"<api-url>/connect/token"

Exempel på att få en access token med användning av C#

var client = new HttpClient(); 
client.BaseAddress = new Uri(loginUrl); 

var data = new Dictionary<string, string> 
{
{"client_id", "your-client-id"},
{"client_secret", "your-client-secret" }, 
{"grant_type", "client_credentials"}, 
};
var response = await client.PostAsync( 
"/connect/token", 
new FormUrlEncodedContent(data)); 

var stringResponse = await response.Content.ReadAsStringAsync();

Svar

{
   "access_token": "<access token>",
   "expires_in": 3600,
   "token_type": "Bearer"
}

Alternativt kan du använda client_id och secret i rubriken

articleIstället för att få en access token är det möjligt att skicka klientens id och hemlighet vid åtkomst till alla operationer i Position Green API. För att generera API-autentiseringsuppgifter, se den här artikeln.

Skicka klientens id och hemlighet