{% 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 %}
