Salt la conținutul principal
POST
Schimbă codul pe cheia contului

Parametri interogare

locale
enum<string>
implicit:ro

Limba răspunsului: mesajele (title, detail) și etichetele, ro sau en. Codurile sunt aceleași în orice limbă. Are întâietate față de Accept-Language și de limba contului.

Opțiuni disponibile:
ro,
en

Corp

application/x-www-form-urlencoded
grant_type
enum<string>
obligatoriu

Mereu authorization_code.

Opțiuni disponibile:
authorization_code
code
string
obligatoriu

Codul primit pe adresa de întoarcere, în ?code=.

redirect_uri
string
obligatoriu

Exact adresa de întoarcere din cererea de acord.

code_verifier
string
obligatoriu

Verificatorul PKCE pe care l-ai generat înainte de cererea de acord (43–128 caractere).

Required string length: 43 - 128
client_id
string
obligatoriu

Identificatorul public al integratorului (hsrc_…). Se poate trimite și prin HTTP Basic.

client_secret
string
obligatoriu

Secretul integratorului (hsrs_…), doar de pe serverul tău. Se poate trimite și prin HTTP Basic.

Răspuns

Cheia contului, legată de integrator. Păstreaz-o pe server, lângă connection_id.

access_token
string
obligatoriu

Cheia contului, de trimis ca Authorization: Bearer.

token_type
enum<string>
obligatoriu

Mereu Bearer.

Opțiuni disponibile:
Bearer
expires_in
integer
obligatoriu

În câte secunde expiră cheia (365 de zile). Înainte de termen, contul trece din nou prin acord.

scope
string
obligatoriu

Drepturile acordate, separate prin spațiu.

connection_id
integer
obligatoriu

Legătura cu acest cont. Vine în câmpul connection al fiecărui eveniment livrat pe webhook-ul integratorului.