251666feb6
Antet/footer/stil extrase in include-uri comune (_lp_*.html) folosite de landing si de shell-ul paginilor statice (landing_static.html). Butoanele 'Vezi cum functioneaza' si 'Vezi documentatia API' devin link-uri reale; footer-ul si consimtamantul de la inregistrare leaga paginile noi; Contact indica spre romfast.ro/menu/contact.html. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
53 lines
3.1 KiB
HTML
53 lines
3.1 KiB
HTML
{% extends "landing_static.html" %}
|
|
{% block titlu %}Documentație API{% endblock %}
|
|
{% block descriere %}Documentația API ROA AUTOPASS: autentificare, endpoint-uri, exemple de cerere și răspuns.{% endblock %}
|
|
{% block continut %}
|
|
<h1>Documentație API</h1>
|
|
<p class="lp-sub">Conectează softul tău de service direct la ROA AUTOPASS (plan Pro).</p>
|
|
|
|
<h2>Cum funcționează</h2>
|
|
<p>Softul tău trimite prezentările printr-un singur apel HTTP; noi validăm datele, mapăm operațiile pe coduri RAR,
|
|
oprim duplicatele și transmitem la RAR Auto-Pass. Autentificarea se face cu o <strong>cheie API</strong>
|
|
(antetul <code>X-API-Key</code>), generată din contul tău. Credențialele RAR le configurezi o singură dată în cont.</p>
|
|
|
|
<h2>Endpoint-uri principale</h2>
|
|
<table>
|
|
<thead><tr><th>Endpoint</th><th>Ce face</th></tr></thead>
|
|
<tbody>
|
|
<tr><td><code>POST /v1/prezentari</code></td><td>Trimite una sau mai multe prezentări spre declarare</td></tr>
|
|
<tr><td><code>POST /v1/prezentari/valideaza</code></td><td>Dry-run: validare fără trimitere</td></tr>
|
|
<tr><td><code>GET /v1/prezentari/{id}</code></td><td>Starea unei trimiteri</td></tr>
|
|
<tr><td><code>POST /v1/import</code></td><td>Import fișier xlsx/csv prin API</td></tr>
|
|
<tr><td><code>GET /v1/nomenclator</code></td><td>Nomenclatorul de coduri RAR (public)</td></tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
<h2>Exemplu: cerere</h2>
|
|
<pre><code>curl -X POST "{{ base_url }}/v1/prezentari" \
|
|
-H "Content-Type: application/json" \
|
|
-H "X-API-Key: rfak_..." \
|
|
-d '{{ exemplu_json["cerere"] }}'</code></pre>
|
|
<p>Fiecare prestație are fie <code>cod_prestatie</code> (cod RAR din nomenclator), fie
|
|
<code>cod_op_service</code> + <code>denumire</code> — codurile tale interne le mapăm noi pe coduri RAR,
|
|
iar maparea rămâne salvată pentru trimiterile următoare.</p>
|
|
|
|
<h2>Exemplu: răspuns</h2>
|
|
<pre><code>{{ exemplu_json["raspuns"] }}</code></pre>
|
|
<p>Un rezultat per prezentare, în aceeași ordine ca cererea. <code>status</code> poate fi
|
|
<code>queued</code> (în coadă spre RAR) sau, dacă ceva blochează trimiterea,
|
|
<code>needs_mapping</code> / <code>needs_data</code> / <code>error</code> — cu explicația în <code>motiv</code>.</p>
|
|
|
|
<h2>Referință completă</h2>
|
|
<ul>
|
|
<li><a href="/docs" target="_blank" rel="noopener">Swagger UI — /docs</a></li>
|
|
<li><a href="/openapi.json" target="_blank" rel="noopener">Schema OpenAPI — /openapi.json</a></li>
|
|
</ul>
|
|
<p>După autentificare găsești în aplicație, la <strong>Integrare</strong>, exemple gata de copiat pentru
|
|
curl, Python, PHP, C#, Node și Visual FoxPro, plus testarea cheii API și a credențialelor RAR.</p>
|
|
|
|
<div class="lp-card">
|
|
<p style="margin:0;">Nu ai încă un cont? <a href="/#inregistrare">Creează unul gratuit</a> — primești 30 de zile
|
|
de Pro, cu acces API inclus. Întrebări de integrare: <a href="mailto:contact@romfast.ro">contact@romfast.ro</a>.</p>
|
|
</div>
|
|
{% endblock %}
|