# Edin: API-ul magazinului > Meniul, prețul coșului, comanda și contul clientului, pentru site-ul de comenzi al unui restaurant. Adresa: https://api.edin.ro. Versiunea 1.0.0. 1. **Cheia magazinului se păstrează numai pe server.** Fiecare cerere are `Authorization: Bearer `. Browserul nu primește cheia: browserul trimite cererile la serverul site-ului, iar serverul site-ului apelează `https://api.edin.ro`. Cheia se citește dintr-o variabilă de mediu, nu se scrie în cod. 2. **Prețul îl calculează serverul.** Site-ul trimite liniile coșului, fără prețuri, la `POST /storefront/quote` și afișează sumele primite. Nu calcula totaluri, reduceri sau TVA pe site. 3. **Banii sunt text zecimal cu monedă**: `{ "amount": "58.50", "currency": "RON" }`. Nu le transforma în numere ca să faci calcule. 4. **O comandă, o `idempotencyKey`.** Generează cheia o dată pe coș și trimite-o la fiecare încercare a `POST /storefront/orders`. O cerere cu aceeași cheie primește aceeași comandă. 5. **IP-ul vizitatorului în `X-Forwarded-For`**, la fiecare cerere: limitele se aplică pe el. 6. **Un `409` la plasare nu se afișează clientului ca eroare.** `error.details.reason` spune ce s-a schimbat, iar `error.details.quote` are prețul actual. Arată noul preț și cere din nou confirmarea. 7. **Ignoră câmpurile necunoscute din răspunsuri.** API-ul se schimbă numai prin adăugare. ## Documentație - [Ghidul și referința, într-un singur fișier](llms-full.txt): pașii comenzii, contul clientului, banii, erorile, limitele și fiecare operație. - [Documentul OpenAPI 3.1](openapi.json): rutele, câmpurile și schemele, generate din codul serverului. - [Skill pentru agenți](SKILL.md): regulile și fluxul, de pus în proiectul site-ului. ## Operațiile - `GET /storefront/locations`: Punctele de lucru ale magazinului - `GET /storefront/menu`: Meniul unui punct de lucru - `GET /storefront/slots`: Intervalele comenzii programate - `POST /storefront/address-check`: Verifică adresa de livrare - `GET /storefront/company`: Caută firma după CUI - `POST /storefront/quote`: Prețul coșului - `POST /storefront/orders`: Plasează comanda - `GET /storefront/orders/{id}`: Pagina comenzii - `POST /storefront/orders/{id}/cancel`: Anulează comanda programată - `GET /storefront/account`: Contul clientului - `PATCH /storefront/account`: Schimbă numele clientului - `DELETE /storefront/account`: Șterge contul - `GET /storefront/account/addresses`: Adresele clientului - `POST /storefront/account/addresses`: Adaugă o adresă - `PUT /storefront/account/addresses/{addressId}`: Modifică o adresă - `DELETE /storefront/account/addresses/{addressId}`: Șterge o adresă - `PUT /storefront/account/billing`: Salvează datele de facturare - `DELETE /storefront/account/billing`: Șterge datele de facturare - `POST /storefront/account/code`: Trimite codul de intrare în cont - `POST /storefront/account/code/verify`: Intră în cont cu codul - `POST /storefront/account/contact/code`: Trimite codul pentru noul telefon sau e-mail - `POST /storefront/account/contact/verify`: Confirmă noul telefon sau e-mail - `PUT /storefront/account/marketing`: Acordul pentru mesajele de marketing - `GET /storefront/account/orders`: Comenzile clientului - `POST /storefront/account/orders/{orderId}/reorder`: Comandă din nou - `POST /storefront/account/sign-out`: Ieși din cont - `POST /storefront/auth/{provider}`: Intră în cont cu o platformă - `GET /storefront/auth/providers`: Platformele de intrare în cont - `POST /storefront/gift-cards`: Cumpără un card cadou - `GET /storefront/gift-cards/{code}`: Soldul unui card cadou - `GET /storefront/gift-cards/offer`: Oferta de carduri cadou