API Cloud: administrare

Coduri de activare

Codul de activare al fiecărui client.

Rute

GET …/activationslist-activations
GET …/clients/{clientId}/activationget-client-activation
POST …/clients/{clientId}/activation/rollroll-client-activation

Resursa GetIntegratorClientActivationResponse

clientIduuiddoar citire: Id-ul clientului.
clientNamestringdoar citire: Numele clientului.
activationCodestringdoar citire: Codul de activare, cu majuscule, în grupuri de câte 4. La introducere, liniuțele, spațiile și literele mici nu contează.
activationLinkstringdoar citire: Linkul de activare. Codul stă în fragmentul adresei.
registerCountintegerdoar citire: Câte case nedezafectate are clientul.
createdAtUtcdatetimedoar citire: Când a fost creat codul, în UTC.
rolledAtUtcdatetimepoate fi nulldoar citire: Când a fost schimbat codul, în UTC. null până la prima schimbare.

Obiecte folosite aici

GetIntegratorClientActivationResponse

{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "activationCode": "3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "activationLink": "<activation-page>#code=3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "registerCount": 3,
  "createdAtUtc": "2026-08-27T09:14:22.512Z",
  "rolledAtUtc": "string"
}

Rute

GET …/activations

`list-activations`

Clienții cu codul și linkul de activare, paginat. Util în propriul tău flux de înrolare.

Cerere IntegratorClientListQuery
Răspuns GetIntegratorClientActivationResponse
Răspuns PaginatedResponse

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/activations' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns

{
  "page": 1,
  "pageSize": 20,
  "total": 1,
  "items": []
}

GET …/clients/{clientId}/activation

`get-client-activation`

Codul și linkul de activare ale unui client. Dacă clientul nu are cod, citirea îl creează.

Răspuns GetIntegratorClientActivationResponse

GETCerere

curl -X GET 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12/activation' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns — get-client-activation, 200

{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "activationCode": "3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "activationLink": "<activation-page>#code=3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "registerCount": 3,
  "createdAtUtc": "2026-08-27T09:14:22.512Z",
  "rolledAtUtc": null
}

POST …/clients/{clientId}/activation/roll

`roll-client-activation`

Generează un cod nou. Cel vechi nu mai merge imediat; casele activate rămân conectate.

Răspuns GetIntegratorClientActivationResponse

POSTCerere

curl -X POST 'https://cloud-api.fiscallink.ro/api/v2/tenants/YOUR_TENANT_ID/integrator/clients/0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12/activation/roll' \
  -H 'X-Api-Key: fsk_YOUR_API_KEY'

200Răspuns

{
  "clientId": "0f8a1c2e-6b3d-4e7f-9a10-2c4d6e8f0a12",
  "clientName": "Exemplu SRL",
  "activationCode": "3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "activationLink": "<activation-page>#code=3F2A-9C1D-4E5B-8A70-1122-3344-5566-7788",
  "registerCount": 3,
  "createdAtUtc": "2026-08-27T09:14:22.512Z",
  "rolledAtUtc": null
}