@acteo/api 0.4.1 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +20 -0
- package/README.md +40 -11
- package/dist/index.cjs +44 -13
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +76 -24
- package/dist/index.d.ts +76 -24
- package/dist/index.js +44 -14
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,25 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## @acteo/api 0.5.0 (2026-11-03)
|
|
4
|
+
|
|
5
|
+
API-ul trimite acum codurile de eroare din contract. Dacă ai cod care compară `err.cod` cu valorile vechi, schimbă-l după tabelul de mai jos. Clasele de eroare și statusurile HTTP rămân aceleași.
|
|
6
|
+
|
|
7
|
+
| Situație | Cod vechi | Cod nou |
|
|
8
|
+
|---|---|---|
|
|
9
|
+
| Limita zilnică a planului atinsă (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `DAILY_LIMIT_REACHED` |
|
|
10
|
+
| Limita lunară sau plafonul consumului peste plan atins (429) | `COTA_ATINSA` la verificări, `LIMIT_ATINS` la VIN, numere și poze | `PLAN_LIMIT_REACHED` |
|
|
11
|
+
| DGPCI refuză numărul (422) | `NUMAR_RESPINS` | `INVALID_IDENTIFIER` |
|
|
12
|
+
| DGPCI nu răspunde la timp (504) | `TIMEOUT` | `UPSTREAM_TIMEOUT` |
|
|
13
|
+
| Verificarea la DGPCI eșuează (502) | `EROARE_DGPCI` | `UPSTREAM_UNAVAILABLE` |
|
|
14
|
+
| Verificare încheiată cu `status: "error"` | `VERIFICARE_ESUATA` | `INVALID_IDENTIFIER`, `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` |
|
|
15
|
+
|
|
16
|
+
- `CODURI_EROARE` și tipul `CodEroare`: toate codurile pe care le trimite API-ul. `CodEsecVerificare` are motivele unei verificări eșuate.
|
|
17
|
+
- `EroareVerificare.cod` spune de ce a eșuat verificarea. `codSursa` rămâne și arată câmpul refuzat la `INVALID_IDENTIFIER`.
|
|
18
|
+
- Rezultatul `not_found` are `code: "NOT_FOUND"`, iar webhook-ul de rezultat are `code` la eroare și la `not_found`.
|
|
19
|
+
- Pornirea unei verificări sau a unei verificări de număr poate primi `EroareServer` 503 cu `UPSTREAM_BLOCKED` sau `UPSTREAM_CHANGED` când sursa oficială e oprită temporar. Cererea nu se taxează și nu se repetă singură; `retryAfterMs` spune când să revii.
|
|
20
|
+
- `DAILY_LIMIT_REACHED` vine cu `retryAfterMs` până la miezul nopții, ora României. `PLAN_LIMIT_REACHED` nu are `retryAfterMs`, pentru că nu se deblochează la miezul nopții.
|
|
21
|
+
- Un server mai vechi, fără coduri, dă în continuare `COTA_ATINSA` și `VERIFICARE_ESUATA`.
|
|
22
|
+
|
|
3
23
|
## @acteo/api 0.4.1 (2026-10-31)
|
|
4
24
|
|
|
5
25
|
- Documentație: fiecare verificare interoghează sursa oficială. `porneste()` întoarce o verificare în curs, iar rezultatul vine prin `asteapta()`, `rezultat()` sau webhook. `checkedAt` e descris ca momentul verificării. Codul nu se schimbă.
|
package/README.md
CHANGED
|
@@ -116,7 +116,7 @@ const rovinieta = await acteo.auto.rovinieta.verifica({
|
|
|
116
116
|
console.log(rovinieta.status, rovinieta.expiresAt)
|
|
117
117
|
```
|
|
118
118
|
|
|
119
|
-
Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
|
|
119
|
+
Dacă sursa respinge datele (de exemplu, numărul talonului nu corespunde mașinii), primești `EroareVerificare` cu `cod: "INVALID_IDENTIFIER"` și `codSursa: "serie_talon_invalida"`. O reîncercare cu aceleași date nu ajută; corectează întâi câmpul indicat:
|
|
120
120
|
|
|
121
121
|
```ts
|
|
122
122
|
import { EroareVerificare } from "@acteo/api"
|
|
@@ -201,10 +201,20 @@ O verificare consumă din cota planului doar când sursa oficială a răspuns, i
|
|
|
201
201
|
| `valid` | Document valabil | data expirării |
|
|
202
202
|
| `warning` | Expiră curând: RCA în 14 zile, ITP în 30, rovinietă în 7, ARR în 14 | data expirării |
|
|
203
203
|
| `expired` | Expirat sau inexistent, confirmat de sursă | data expirării sau `null` |
|
|
204
|
-
| `not_found` | Sursa nu a găsit vehiculul | `null` |
|
|
204
|
+
| `not_found` | Sursa nu a găsit vehiculul (`code: "NOT_FOUND"`) | `null` |
|
|
205
205
|
| `processing` | Verificarea e încă în curs | nu există |
|
|
206
206
|
|
|
207
|
-
Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare
|
|
207
|
+
Când verificarea se încheie cu eroare, SDK-ul aruncă `EroareVerificare`, iar `cod` spune de ce:
|
|
208
|
+
|
|
209
|
+
| `cod` | Ce s-a întâmplat | Ce faci |
|
|
210
|
+
|---|---|---|
|
|
211
|
+
| `INVALID_IDENTIFIER` | Sursa a refuzat datele trimise; câmpul e în `codSursa` | corectezi câmpul, reîncercarea nu ajută |
|
|
212
|
+
| `UPSTREAM_UNAVAILABLE` | Sursa oficială nu răspunde sau a răspuns cu eroare | reiei mai târziu |
|
|
213
|
+
| `UPSTREAM_TIMEOUT` | Sursa oficială nu a răspuns în timpul maxim | reiei mai târziu |
|
|
214
|
+
| `UPSTREAM_BLOCKED` | Accesul la sursa oficială e restricționat temporar | reiei mai târziu |
|
|
215
|
+
| `UPSTREAM_CHANGED` | Sursa și-a schimbat structura, adaptăm serviciul | reiei mai târziu |
|
|
216
|
+
|
|
217
|
+
Doar `INVALID_IDENTIFIER` se taxează, pentru că sursa a răspuns. Valorile lui `codSursa`:
|
|
208
218
|
|
|
209
219
|
| `codSursa` | Câmpul de corectat |
|
|
210
220
|
|---|---|
|
|
@@ -286,7 +296,7 @@ Decodează o serie de șasiu. Întoarce `marca`, `model`, `anFabricatie`, `sursa
|
|
|
286
296
|
|
|
287
297
|
### `auto.numere.verifica(numar)`
|
|
288
298
|
|
|
289
|
-
Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "
|
|
299
|
+
Verifică la DGPCI un singur număr complet: indicativul județului, cifrele și trei litere (`BV07ABC`, `B123ABC`). Numerele incomplete sau cu `?` și `*` sunt respinse local. Întoarce `numar` (normalizat), `disponibil` și `mesaj` (textul DGPCI, sau `null`). Dacă DGPCI nu acceptă numărul primești `EroareValidare` cu `cod: "INVALID_IDENTIFIER"`. Când verificarea nu poate rula primești `EroareServer` cu `cod` `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`. Niciuna nu se taxează, iar `OCUPAT` se reîncearcă singur după `Retry-After`. Cere un abonament de numere disponibile.
|
|
290
300
|
|
|
291
301
|
### `auto.imagini.obtine({ marca, model, an, unghi?, umbra? })`
|
|
292
302
|
|
|
@@ -392,20 +402,39 @@ Datele cu oră (`trimisLa`, `sedinta.data`, `verificatLa`) devin `Date`. Datele
|
|
|
392
402
|
|
|
393
403
|
Toate erorile moștenesc `ActeoError`, care la rândul ei moștenește `Error`. Fiecare are `_tag`, `message` (în română), plus `status`, `cod`, `hint` și `raspuns` când vin de la API.
|
|
394
404
|
|
|
405
|
+
### Coduri de eroare
|
|
406
|
+
|
|
407
|
+
`cod` are o valoare stabilă, bună de tratat în program. Lista completă e exportată ca `CODURI_EROARE`, iar tipul e `CodEroare`. Primele opt sunt cele din contract:
|
|
408
|
+
|
|
409
|
+
| `cod` | Unde apare | Înseamnă |
|
|
410
|
+
|---|---|---|
|
|
411
|
+
| `UPSTREAM_UNAVAILABLE` | `EroareVerificare`, `EroareServer` 502 | Sursa oficială nu răspunde sau răspunde cu eroare |
|
|
412
|
+
| `UPSTREAM_TIMEOUT` | `EroareVerificare`, `EroareServer` 504 | Sursa oficială nu a răspuns în intervalul maxim |
|
|
413
|
+
| `UPSTREAM_BLOCKED` | `EroareVerificare`, `EroareServer` 503 | Accesul la sursa oficială e restricționat temporar |
|
|
414
|
+
| `UPSTREAM_CHANGED` | `EroareVerificare`, `EroareServer` 503 | Structura sursei s-a modificat, serviciul e în adaptare |
|
|
415
|
+
| `DAILY_LIMIT_REACHED` | `EroareLimita` 429 | Limita zilnică a planului, se resetează la miezul nopții (ora României) |
|
|
416
|
+
| `PLAN_LIMIT_REACHED` | `EroareLimita` 429 | Limita lunară, sau plafonul consumului peste plan |
|
|
417
|
+
| `NOT_FOUND` | `code` pe rezultatul `not_found` | Identificatorul nu există la sursa oficială |
|
|
418
|
+
| `INVALID_IDENTIFIER` | `EroareVerificare`, `EroareValidare` 422 | Sursa oficială a respins identificatorul |
|
|
419
|
+
|
|
420
|
+
Restul țin de un produs: `SOLD_INSUFICIENT`, `PLAFON_NETAXAT`, `OCUPAT`, `INDISPONIBIL`, `VIN_NEDECODAT`, `VIN_INVALID`, `ARR_NECESITA_PLAN`, `LIMIT_ATINS` (numărul de mașini din plan), `VEHICUL_EXISTENT`, `NEGASIT`, `LIMITA_FLOTA_ATINSA`.
|
|
421
|
+
|
|
422
|
+
### Clasele de eroare
|
|
423
|
+
|
|
395
424
|
| Clasă | Când apare | Câmpuri utile |
|
|
396
425
|
|---|---|---|
|
|
397
426
|
| `EroareConfigurare` | Cheie lipsă sau opțiuni invalide | |
|
|
398
|
-
| `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`
|
|
427
|
+
| `EroareValidare` | Date greșite, local sau HTTP 400; 422 când DGPCI refuză numărul (`INVALID_IDENTIFIER`) | `camp`, `acceptate`, `cod` |
|
|
399
428
|
| `EroareAutentificare` | 401: cheie invalidă sau dezactivată | `hint` |
|
|
400
429
|
| `EroarePlanInactiv` | 402: fără abonament activ | `hint` |
|
|
401
430
|
| `EroareInterzis` | 403: `LIMIT_ATINS`, `ARR_NECESITA_PLAN` | `cod`, `limita` |
|
|
402
431
|
| `EroareNegasit` | 404: vehicul inexistent în cont | |
|
|
403
432
|
| `EroareConflict` | 409: `VEHICUL_EXISTENT` | |
|
|
404
|
-
| `EroareLimita` | 429:
|
|
405
|
-
| `EroareServer` | 5xx;
|
|
433
|
+
| `EroareLimita` | 429: cotă (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`), plafon de flotă sau polling prea des | `cod`, `retryAfterMs`, `utilizareZi`, `utilizareLuna` |
|
|
434
|
+
| `EroareServer` | 5xx; sursa oficială (`UPSTREAM_*`), sau `OCUPAT`, `INDISPONIBIL` la numere disponibile | `status`, `cod`, `retryAfterMs` |
|
|
406
435
|
| `EroareRetea` | Fără răspuns sau timeout | `timeout`, `neajunsa` |
|
|
407
436
|
| `EroareRaspunsInvalid` | Răspuns cu formă neașteptată | `raspuns` |
|
|
408
|
-
| `EroareVerificare` | Sursa oficială nu a
|
|
437
|
+
| `EroareVerificare` | Sursa oficială nu a dat un răspuns sau a refuzat datele | `cod`, `codSursa` |
|
|
409
438
|
| `EroareTimeoutVerificare` | `asteapta()` sau `imagini.asteapta()` a depășit `timeoutMs` | |
|
|
410
439
|
| `EroareWebhook` | Cheie greșită sau payload invalid | `cod` |
|
|
411
440
|
|
|
@@ -416,7 +445,7 @@ try {
|
|
|
416
445
|
await acteo.auto.rca.porneste(numar)
|
|
417
446
|
} catch (err) {
|
|
418
447
|
if (err instanceof EroareValidare) return arataUtilizatorului(err.message)
|
|
419
|
-
if (err instanceof EroareLimita && err.cod === "
|
|
448
|
+
if (err instanceof EroareLimita && err.cod === "DAILY_LIMIT_REACHED") return amanaPanaMaine()
|
|
420
449
|
if (err instanceof ActeoError) logger.error(err._tag, err.message, err.hint)
|
|
421
450
|
throw err
|
|
422
451
|
}
|
|
@@ -432,9 +461,9 @@ SDK-ul nu trimite niciodată de două ori o verificare taxată.
|
|
|
432
461
|
|---|---|---|
|
|
433
462
|
| Rețea căzută, timeout | se reîncearcă | nu (cererea poate să fi ajuns) |
|
|
434
463
|
| DNS, conexiune refuzată | se reîncearcă | se reîncearcă (sigur nu a ajuns) |
|
|
435
|
-
| 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (
|
|
464
|
+
| 502, 503, 504 fără `cod` | se reîncearcă | se reîncearcă (cererea nu a ajuns la API) |
|
|
436
465
|
| 503 `OCUPAT` la numere disponibile | | se reîncearcă după `Retry-After` (netaxat) |
|
|
437
|
-
| 502, 503, 504 cu alt `cod` | | nu (netaxat, dar repetarea nu ajută imediat) |
|
|
466
|
+
| 502, 503, 504 cu alt `cod` (`UPSTREAM_*`, `INDISPONIBIL`) | | nu (netaxat, dar repetarea nu ajută imediat) |
|
|
438
467
|
| 500 | se reîncearcă | nu |
|
|
439
468
|
| 429 la polling | se reîncearcă după `Retry-After` | |
|
|
440
469
|
| 429 cotă sau plafon flotă | nu | nu |
|
package/dist/index.cjs
CHANGED
|
@@ -150,6 +150,27 @@ var EroareWebhook = class extends VerificRcaError {
|
|
|
150
150
|
var TipVerificare = effect.Schema.Literal("rca", "itp", "rovinieta", "arr");
|
|
151
151
|
var StatusDocument = effect.Schema.Literal("valid", "warning", "expired", "not_found");
|
|
152
152
|
var DataNullabila = effect.Schema.NullOr(effect.Schema.Date);
|
|
153
|
+
var CODURI_EROARE = [
|
|
154
|
+
"UPSTREAM_UNAVAILABLE",
|
|
155
|
+
"UPSTREAM_TIMEOUT",
|
|
156
|
+
"UPSTREAM_BLOCKED",
|
|
157
|
+
"UPSTREAM_CHANGED",
|
|
158
|
+
"DAILY_LIMIT_REACHED",
|
|
159
|
+
"PLAN_LIMIT_REACHED",
|
|
160
|
+
"NOT_FOUND",
|
|
161
|
+
"INVALID_IDENTIFIER",
|
|
162
|
+
"SOLD_INSUFICIENT",
|
|
163
|
+
"PLAFON_NETAXAT",
|
|
164
|
+
"OCUPAT",
|
|
165
|
+
"INDISPONIBIL",
|
|
166
|
+
"VIN_NEDECODAT",
|
|
167
|
+
"VIN_INVALID",
|
|
168
|
+
"ARR_NECESITA_PLAN",
|
|
169
|
+
"LIMIT_ATINS",
|
|
170
|
+
"VEHICUL_EXISTENT",
|
|
171
|
+
"NEGASIT",
|
|
172
|
+
"LIMITA_FLOTA_ATINSA"
|
|
173
|
+
];
|
|
153
174
|
var RezultatVerificareSchema = effect.Schema.Struct({
|
|
154
175
|
/** Tipul verificarii. */
|
|
155
176
|
tip: TipVerificare,
|
|
@@ -165,6 +186,8 @@ var RezultatVerificareSchema = effect.Schema.Struct({
|
|
|
165
186
|
status: StatusDocument,
|
|
166
187
|
/** Data expirarii documentului, `null` daca nu exista document valabil. */
|
|
167
188
|
expiresAt: DataNullabila,
|
|
189
|
+
/** Doar la `status: "not_found"`: `"NOT_FOUND"`, identificatorul nu exista la sursa oficiala. */
|
|
190
|
+
code: effect.Schema.optional(effect.Schema.String),
|
|
168
191
|
/** ID-ul cererii, prezent doar cand ai trimis `callbackUrl`. Apare si in webhook. */
|
|
169
192
|
requestId: effect.Schema.optional(effect.Schema.String),
|
|
170
193
|
/** Recomandarea API-ului, ex: la RCA cerut doar dupa numar, sa trimiti si VIN-ul. */
|
|
@@ -183,8 +206,10 @@ var EsuataSchema = effect.Schema.Struct({
|
|
|
183
206
|
tip: TipVerificare,
|
|
184
207
|
query: effect.Schema.String,
|
|
185
208
|
status: effect.Schema.Literal("error"),
|
|
209
|
+
/** Motivul. Vezi {@link CodEsecVerificare}. Lipseste doar la serverele mai vechi. */
|
|
210
|
+
code: effect.Schema.optional(effect.Schema.String),
|
|
186
211
|
error: effect.Schema.String,
|
|
187
|
-
/** Doar
|
|
212
|
+
/** Doar la `INVALID_IDENTIFIER`: campul refuzat. Vezi {@link CodRefuzSursa}. */
|
|
188
213
|
cod: effect.Schema.optional(effect.Schema.String),
|
|
189
214
|
hint: effect.Schema.optional(effect.Schema.String)
|
|
190
215
|
});
|
|
@@ -243,7 +268,9 @@ var WebhookRezultatSchema = effect.Schema.Struct({
|
|
|
243
268
|
/** Momentul verificarii, `null` la eroare. */
|
|
244
269
|
checkedAt: DataNullabila,
|
|
245
270
|
/** Mesajul de eroare, doar la `status: "error"`. */
|
|
246
|
-
error: effect.Schema.optional(effect.Schema.String)
|
|
271
|
+
error: effect.Schema.optional(effect.Schema.String),
|
|
272
|
+
/** La `status: "error"`, motivul ({@link CodEsecVerificare}); la `status: "not_found"`, `"NOT_FOUND"`. */
|
|
273
|
+
code: effect.Schema.optional(effect.Schema.String)
|
|
247
274
|
});
|
|
248
275
|
var WebhookDocumentExpiraSchema = effect.Schema.Struct({
|
|
249
276
|
/** Numele evenimentului. */
|
|
@@ -634,7 +661,7 @@ function eroareDinRaspuns(status, headers, body) {
|
|
|
634
661
|
switch (status) {
|
|
635
662
|
case 400:
|
|
636
663
|
return new EroareValidare({ ...comun, ...c?.accepted && { acceptate: c.accepted } });
|
|
637
|
-
// 422: sursa oficiala refuza valoarea trimisa (
|
|
664
|
+
// 422: sursa oficiala refuza valoarea trimisa (INVALID_IDENTIFIER).
|
|
638
665
|
case 422:
|
|
639
666
|
return new EroareValidare(comun);
|
|
640
667
|
case 401:
|
|
@@ -1012,7 +1039,7 @@ var interpreteaza = (raspuns, serieSasiu, sinceImplicit) => decodeaza(RaspunsVer
|
|
|
1012
1039
|
return effect.Effect.fail(
|
|
1013
1040
|
new EroareVerificare({
|
|
1014
1041
|
message: corp.error,
|
|
1015
|
-
cod: "VERIFICARE_ESUATA",
|
|
1042
|
+
cod: corp.code ?? "VERIFICARE_ESUATA",
|
|
1016
1043
|
raspuns: corp,
|
|
1017
1044
|
...corp.cod && { codSursa: corp.cod },
|
|
1018
1045
|
...corp.hint && { hint: corp.hint }
|
|
@@ -1109,7 +1136,7 @@ var sterge = (id) => id.trim() ? trimite({ metoda: "DELETE", cale: `${CALE2}/${e
|
|
|
1109
1136
|
) : effect.Effect.fail(new EroareValidare({ message: "Lipseste ID-ul vehiculului.", camp: "id", cod: "VALIDARE_LOCALA" }));
|
|
1110
1137
|
|
|
1111
1138
|
// src/client.ts
|
|
1112
|
-
var VERSIUNE_SDK = "0.
|
|
1139
|
+
var VERSIUNE_SDK = "0.5.0";
|
|
1113
1140
|
var URL_IMPLICIT = "https://api.acteo.ro";
|
|
1114
1141
|
var URL_IMPLICIT_LEGACY = "https://www.verificrca.ro";
|
|
1115
1142
|
var RETRY_IMPLICIT = { incercari: 3, intarziereInitialaMs: 500, intarziereMaximaMs: 1e4 };
|
|
@@ -1199,7 +1226,7 @@ var ClientVerificari = class {
|
|
|
1199
1226
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1200
1227
|
* @throws {@link EroareAutentificare} cheie API invalida (401).
|
|
1201
1228
|
* @throws {@link EroarePlanInactiv} contul nu are abonament API activ (402).
|
|
1202
|
-
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "
|
|
1229
|
+
* @throws {@link EroareLimita} cota zilnica sau lunara atinsa (429, `cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1203
1230
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1204
1231
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
1205
1232
|
* @throws {@link EroareRetea} fara raspuns sau timeout.
|
|
@@ -1258,7 +1285,7 @@ var ClientVerificari = class {
|
|
|
1258
1285
|
* @param optiuni `intervalMs`, `timeoutMs` si `signal`, ca la {@link ClientVerificari.asteapta}.
|
|
1259
1286
|
* @returns rezultatul final al verificarii.
|
|
1260
1287
|
* @throws {@link EroareValidare} date invalide, local sau HTTP 400.
|
|
1261
|
-
* @throws {@link EroareLimita} cota atinsa (`cod: "
|
|
1288
|
+
* @throws {@link EroareLimita} cota atinsa (`cod: "DAILY_LIMIT_REACHED"` sau `"PLAN_LIMIT_REACHED"`).
|
|
1262
1289
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1263
1290
|
* @throws {@link EroareVerificare} sursa oficiala nu a putut fi interogata sau a
|
|
1264
1291
|
* refuzat datele trimise (`codSursa`, ex: `"serie_talon_invalida"`).
|
|
@@ -1501,8 +1528,9 @@ var ClientDocument = class {
|
|
|
1501
1528
|
* @param optiuni `timeoutMs`, `intervalMs` pentru asteptare si `signal`.
|
|
1502
1529
|
* @returns rezultatul final.
|
|
1503
1530
|
* @throws {@link EroareValidare} identificator invalid, local sau HTTP 400.
|
|
1504
|
-
* @throws {@link EroareLimita} cota
|
|
1505
|
-
* @throws {@link
|
|
1531
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1532
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1533
|
+
* @throws {@link EroareVerificare} sursa oficiala nu a dat un raspuns sau a refuzat datele; motivul e in `cod`.
|
|
1506
1534
|
* @throws {@link EroareTimeoutVerificare} rezultatul nu a venit in `timeoutMs`.
|
|
1507
1535
|
*/
|
|
1508
1536
|
verifica(identificator, optiuni) {
|
|
@@ -1519,6 +1547,8 @@ var ClientDocument = class {
|
|
|
1519
1547
|
* @param identificator ce cere sursa oficiala pentru acest document.
|
|
1520
1548
|
* @param optiuni `callbackUrl` si `signal`.
|
|
1521
1549
|
* @returns rezultatul final sau verificarea in curs.
|
|
1550
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`).
|
|
1551
|
+
* @throws {@link EroareServer} sursa oficiala oprita temporar (`UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`); netaxat.
|
|
1522
1552
|
*/
|
|
1523
1553
|
porneste(identificator, optiuni) {
|
|
1524
1554
|
const cerere = {
|
|
@@ -1598,7 +1628,7 @@ var ClientVin = class {
|
|
|
1598
1628
|
* @returns decodarea, completa, partiala sau doar structura.
|
|
1599
1629
|
* @throws {@link EroareValidare} VIN invalid, local sau HTTP 400.
|
|
1600
1630
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de decodare VIN.
|
|
1601
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1631
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe decodari fara rezultat (`PLAFON_NETAXAT`).
|
|
1602
1632
|
* @example
|
|
1603
1633
|
* const d = await acteo.auto.vin.decodeaza("WVWZZZ1KZBW000000")
|
|
1604
1634
|
* console.log(d.marca, d.model, d.anFabricatie)
|
|
@@ -1622,10 +1652,10 @@ var ClientNumere = class {
|
|
|
1622
1652
|
* @param numar numarul complet: judetul, cifrele si trei litere, ex: `BV07ABC`.
|
|
1623
1653
|
* @param optiuni `signal` pentru anulare.
|
|
1624
1654
|
* @returns verdictul DGPCI.
|
|
1625
|
-
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`
|
|
1655
|
+
* @throws {@link EroareValidare} numar invalid sau incomplet, ori refuzat de DGPCI (`INVALID_IDENTIFIER`).
|
|
1626
1656
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de numere disponibile.
|
|
1627
1657
|
* @throws {@link EroareLimita} cota atinsa.
|
|
1628
|
-
* @throws {@link EroareServer} `
|
|
1658
|
+
* @throws {@link EroareServer} `UPSTREAM_UNAVAILABLE`, `UPSTREAM_TIMEOUT`, `UPSTREAM_BLOCKED`, `UPSTREAM_CHANGED`, `OCUPAT` sau `INDISPONIBIL`; cererea nu s-a taxat.
|
|
1629
1659
|
* @example
|
|
1630
1660
|
* const r = await acteo.auto.numere.verifica("BV07ABC")
|
|
1631
1661
|
* if (r.disponibil) console.log("Numarul e liber")
|
|
@@ -1651,7 +1681,7 @@ var ClientImagini = class {
|
|
|
1651
1681
|
* @returns poza masinii sau poza generica.
|
|
1652
1682
|
* @throws {@link EroareValidare} marca, model, an, unghi sau umbra invalide.
|
|
1653
1683
|
* @throws {@link EroarePlanInactiv} lipseste abonamentul de imagini masini.
|
|
1654
|
-
* @throws {@link EroareLimita} cota atinsa (`
|
|
1684
|
+
* @throws {@link EroareLimita} cota atinsa (`DAILY_LIMIT_REACHED`, `PLAN_LIMIT_REACHED`) sau prea multe poze generice azi (`PLAFON_NETAXAT`).
|
|
1655
1685
|
* @example
|
|
1656
1686
|
* const p = await acteo.auto.imagini.obtine({ marca: "Volkswagen", model: "Golf", an: 2015 })
|
|
1657
1687
|
* if (p.status === "gata") afiseaza(p.url)
|
|
@@ -1748,6 +1778,7 @@ var Acteo = class {
|
|
|
1748
1778
|
|
|
1749
1779
|
exports.Acteo = Acteo;
|
|
1750
1780
|
exports.ActeoError = VerificRcaError;
|
|
1781
|
+
exports.CODURI_EROARE = CODURI_EROARE;
|
|
1751
1782
|
exports.ClientAuto = ClientAuto;
|
|
1752
1783
|
exports.ClientDocument = ClientDocument;
|
|
1753
1784
|
exports.ClientImagini = ClientImagini;
|