5ea2c4cedb
Verificat contractul RAR AUTOPASS pe endpoint-ul de test si compilat sursa de adevar `docs/api-rar-contract.md`. Corectii majore fata de planurile vechi: - JWT TTL = 30h (nu scurt); worker se re-logheaza, retry neplafonat - b64Image optional; tipPrestatie generat de server (nu se trimite) - anulare/corectie prin API inexistente pentru FINALIZATA - needs_data determinist pe R-ODO/I-ODO; reguli validare exacte (VIN/data/nrInm) Rulat plan-eng-review + plan-design-review, apoi consolidat ambele intr-un singur plan executabil `docs/plans/plan.md` (design ca anexa). Outside voice a prins lost-ack double-submit (P1) -> reconciliere inainte de re-send. Re-push din ROAAUTO scos din v1 (durabilitate = SQLite persistent + restart). - mutat fisierele spec oficiale RAR in docs/ - adaugat raspunsul oficial al programatorilor RAR (api-rar-documentatie-oficiala.md) - sterse plan-eng-review.md + plan-design-review.md (consolidate in plan.md) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
5.2 KiB
Aveti mai jos linkul de Swagger ce descrie fiecare endpoint al mediului de TESTARE.
https://apps.rarom.ro/test-rar-autopass/swagger-ui/index.html
Acest Swagger nu permite autentificarea pentru testare directa, insa aici gasiti API si payload/parametri, modele de date ce pot fi testate prin tooluri specifice (PostMan) cu credentialele pe care vi leam creat:
Am atasat documentatia si un screenshot ca exemplu de login.
Ca sa poata fi integrate in PRODUCTIE, API se modifica astfel :
https://apps.rarom.ro/rar-autopass/swagger-ui/index.html folosind credentialele societatii/reprezentantei societatii.
Inainte de a trece in productie am rugamintea sa reveniti pentru a verifica corectitudinea datelor din mediul de test.
Imaginea odometrului nu mai este obligatorie.
Prezentarile prin API se vor trimite cu status “FINALIZATA”.
-
este necesar intai login https://apps.rarom.ro/test-rar-autopass/public/login apoi folosirea Bearer token in apelul pentru POST Prezentare -
pentru POST Prezentare modelul este urmatorul, spre exemplu, restul de date fiind asociate/generate de server:
{
"b64Image":"UklGRn5FAgBXRUJQVlA4WAoAAAAoAAAA/wMA/wMASUNDUAobAAAAABsKbGNtc.... etc stringul base 64", --OPTIONAL
"dataPrestatie": "2024-07-25",
"nrInmatriculare": "B999GEN",
"obs": "TEST", --OPTIONAL
"odometruFinal": "9999999",
"odometruInitial": null, - se completeaza doar daca se schimba/repara instrumentele care afiseaza nr km
"prestatii": [
{
"codPrestatie": "OE-1",
"idPrezentare": null
},
{
"codPrestatie": "OE-2",
"idPrezentare": null
},
{
Se adauga prestatii in continuare daca este cazul
}
],
"sistemReparat": "null",
"status": "FINALIZATA",
"vin": "XXXXXXXX888888888"
}
Si vom primi ca raspuns:
{
"statusCode": 200,
"message": "Prezentare adaugata cu succes",
"data": {
"id": 59950,
"dataPrestatie": "2024-07-25",
"vin": "XXXXXXXX888888888",
"odometruFinal": 9999999,
"idAgent": 1587,
"tipPrestatie": "GENERIC",
"odometruInitial": null,
"idUser": 22,
"sistemReparat": "null",
"obs": "TEST",
"nrInmatriculare": "B999GEN",
"status": "FINALIZATA",
"prestatii": [
{
"idPrezentare": 599950,
"codPrestatie": "OE-1"
},
{
"idPrezentare": 599950,
"codPrestatie": "OE-2"
}
],
"b64Image":"UklGRn5FAgBXRUJQVlA4WAoAAAAoAAAA/wMA/wMASUNDUAobAAAAABsKbGNtc.... etc stringul base 64"
}
-
Daca se intervine asupra instrumentelor care afiseaza kilometrajul se va introduce odometru initial(indicatia inainte de reparatie/schimbat) si odometru final (indicatia dupa reparatie/ schimbat) -
Codurile de prestatie pot fi interogate prin API pentru a le putea asocia dvs cu operatiunile ce se executa de catre societate.
Testele pentru integrare se vor face NUMAI pe mediul de test:
https://apps.rarom.ro/test-rar-autopass/swagger-ui/index.html
In urma constatarii unor date introduse eronat, API RAR Auto-Pass (atat mediul de test cat si cel de productie) a suferit unele modificari legate de constrangerile campurilor transmise, unele fiind deja existente, iar altele adaptate, dupa cum urmeaza:
Data – nu poate fi mai devreme de 01.12.2024 sau mai tarziu de “astazi”
VIN – 17 caractere, majuscule, fara spatii, caractere speciale sau literele O,I,Q
Imagine odometru, daca este atasata, trebuie sa fie format base64.
Daca in lista de prestatii se regaseste R-ODO SAU I-ODO, campul odometru initial trebuie sa fie deasemenea transmis.
Numarul de inmatriculare – fara spatii sau caractere speciale, max 10 caractere, litere + cifre, majuscule.
Acestea sunt deja aplicate si detalii se regasesc in raspunsul API, in cazul in care nu sunt respectate.
Doar prezentarile cu status SALVATA pot fi anulate, nu si cele cu status FINALIZATA. Raspunsul este : EROARE_STATUS_ANULARE("Eroare la schimbarea statusului prezentarii. Id not found."), de acolo confuzia.
Anularea Prezentarilor se poate face din interfata web atat timp cat acestea sunt inca editabile(SALVATA). Odata marcate ca FINALIZATA , prezentarile nu se mai pot anula.
Scopul API este strict de INSERT prezentari ca si FINALIZATE. Toate celelalte operatiuni CRUD se vor face din web unde este cazul.
Daca s-au introdus date eronate acestea pot fi rectificate de catre Registrul Auto, in urma unei solicitari la suport.autopass@rarom.ro , dar acum nu este cazul fiindca sunteti pe mediul de test.