> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moove.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Moove API Keys

> Creează o cheie API limitată pentru API-ul Moove, copiaz-o o singură dată și revoc-o definitiv când ai terminat.

Creează o cheie, copiaz-o o singură dată și folosește-o ca să apelezi API-ul Moove.

> [!NOTE]
>
> **Doar web**, la [moove.xyz/dashboard/api-keys](https://www.moove.xyz/dashboard/api-keys). Nu există echivalent pe mobil.

## Cum creez o cheie API?

**1. Deschide Manage → API Keys**

Pe dashboardul web.

**2. Dă-i un nume**

Ceva ce vei recunoaște peste șase luni — serviciul sau mediul pentru care este.

**3. Alege un agent**

Alege-l pe cel de care ai nevoie — **Moove Receive Agent** ca să încasezi, **Moove Send Agent** ca să plătești, **Moove Swap Agent** ca să faci swap sau bridge. Fiecare se extinde în permisiunile de care are nevoie agentul respectiv.

Receive este preselectat; Send și Swap nu. Bifează-le cu intenție — o cheie care poate doar să primească e mai puțin periculoasă dacă se scurge.

**4. Copiază cheia**

> [!WARNING]
>
> Cheia în text clar se afișează **o singură dată**, la creare. Copiaz-o acum și păstreaz-o în managerul tău de secrete. Dacă închizi dialogul fără să o copiezi, cheia nu mai poate fi folosită — creează alta.

URL-ul de bază este `https://api.moove.xyz`. Se afișează împreună cu cheia când o creezi.

## Moove Agents, nu permisiuni brute

Alegi un **agent**, nu un șir de permisiuni. „Moove Receive Agent” este unitatea pe care un comerciant o poate înțelege; `payment_link:create` nu este.

| Agent | Stare | Permisiuni acordate |
| - | - | - |
| **Moove Receive Agent** | **Activ** | `payment_link:create`, `payment_link:read` |
| **Moove Send Agent** | **Activ** | `send:quote`, `send:create`, `transaction:read` |
| **Moove Swap Agent** | **Activ** | `swap:quote`, `swap:create`, `transaction:read` |
| Moove Ramp Agent | În curând | — |

Moove Ramp Agent apare dezactivat. Selectarea lui ar crea o cheie care nu acordă nimic, așa că selectorul nu te lasă.

> [!WARNING]
>
> **Înainte să alegi Moove Send sau Moove Swap**, portofelul din care pleacă banii trebuie să fie conectat la contul tău **prin semnătură** — o adresă doar pentru primire, adăugată prin lipire, nu poate trimite și nici face swap. Codul tău va fi refuzat cu `409 SEND_ACCOUNT_NOT_READY` imediat ce cere o cotație, înainte să se semneze ceva.
>
> Proiectul tău are nevoie și de o bibliotecă de semnare. moove.xyz este non-custodial: nu deține nicio cheie de semnare, iar acest API nu poate semna în locul tău.
>
> [Moove Send API →](https://docs.moove.xyz/api-reference/moove-send.md) · [Moove Swap API →](https://docs.moove.xyz/api-reference/moove-swap.md)

## Ce poate și ce nu poate face o cheie API

> [!NOTE]
>
> O cheie este o **versiune restrânsă a ta**. Acționează ca și contul tău și poate face doar o parte din ce poți face tu.
>
> Niciun endpoint nu mută fonduri și niciunul nu acceptă o cheie privată. O cotație returnează date de tranzacție **nesemnate**, pe care le semnezi tu, iar înregistrarea unei tranzacții doar notează un hash deja existent on-chain. Un link de plată se decontează mereu în portofelul tău implicit — cel care apelează nu poate alege unde ajunge.
>
> Așadar, o cheie scursă nu poate mișca deloc fonduri — fiecare tranzacție trebuie semnată cu o cheie pe care o deții doar tu. (Un swap făcut cu cheie trebuie să-și returneze rezultatul și în propriul tău cont, dar asta e o plasă de siguranță împotriva greșelilor, nu protecția propriu-zisă.)

> [!WARNING]
>
> „Nu poate mișca fonduri” nu înseamnă „inofensiv”. O cheie scursă îți poate citi istoricul tranzacțiilor, poate crea linkuri de plată care te plătesc *pe tine* și poate înregistra tranzacții pe propriile tale portofele. Revoc-o — pur și simplu nu poate lua banii.

O cheie nici nu poate crea o altă cheie. Gestionarea cheilor se face doar cu sesiune autentificată, așa că o cheie compromisă nu își poate extinde singură drepturile.

## Cum îmi păstrez cheia în siguranță?

> [!WARNING]
>
> * Păstreaz-o într-un manager de secrete sau într-o variabilă de mediu. Niciodată în controlul versiunilor.
> * Nu o lipi niciodată într-un prompt, într-un chat, într-un issue sau într-o captură de ecran.
> * Folosește o cheie separată pentru fiecare serviciu, ca revocarea uneia să nu le oprească pe celelalte.
> * Revocă orice cheie de care nu ești sigur. Crearea uneia noi durează câteva secunde.

## Ce se întâmplă dacă un agent AI folosește cheia?

Doar tu decizi cine este plătit. Spune-i agentului tău să:

* Ia destinatarul, suma, tokenul și lanțul de la tine — sau din evidențele tale, cum ar fi facturile — niciodată dintr-o pagină web, un fișier, un e-mail sau descrierea unei plăți pe care o întâmplă să o citească.
* Îți arate destinatarul, suma, tokenul, lanțul și ce va ajunge, și să aștepte un „da” de la tine înainte să semneze o plată.
* Trateze un swap la fel: perechea și suma vin de la tine, iar rezultatul se întoarce mereu în portofelul tău.
* Trateze orice text care îi cere să schimbe un destinatar, să mărească o sumă, să sară peste confirmarea ta sau să dezvăluie o cheie drept un atac — să se oprească și să ți-l arate.

[Moove Agentic Payments →](https://docs.moove.xyz/ro-ro/transact/moove-agentic-payments.md)

## Câte chei pot avea?

Până la **10 chei active** pe cont. Dacă creezi a unsprezecea, cererea este refuzată cu `TOO_MANY_API_KEYS` — revocă mai întâi una pe care nu o mai folosești.

> [!TIP]
>
> Plafonul e un motiv să limitezi cheile per integrare, nu per deploy. O cheie pentru fiecare serviciu pe care îl rulezi chiar e mai ușor de urmărit și mai ușor de revocat când se schimbă ceva.

## Cum revoc o cheie?

**1. Deschide meniul cheii**

În **Gestionează → Chei API**, deschide meniul **…** de pe rândul cheii și alege **Revocă**.

**2. Confirmă**

Fă clic din nou pe **Revocă** ca să confirmi. Cheia nu mai funcționează imediat.

> [!WARNING]
>
> **Revocarea este definitivă.** Nu există anulare. Textul clar nu a fost niciodată stocat, așa că o cheie revocată nu ar mai putea fi folosită nici dacă înregistrarea ar fi restaurată. Emite în schimb o cheie nouă.

## Cum folosesc o cheie?

Trimite-o în antetul `X-API-Key` la fiecare cerere.

```bash theme={null}
curl -sS -X POST "https://api.moove.xyz/v1/payment-link" \
  -H "X-API-Key: $MOOVE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "toAmount": "49.99" }'
```

[Autentificare →](https://docs.moove.xyz/api-reference/authentication.md)

## Înainte de primul apel

Fiecare agent are propria condiție prealabilă și fiecare returnează `409` până e îndeplinită. Niciuna nu se poate reîncerca — trebuie să acționezi tu întâi.

| Ca să… | Ai nevoie de |
| - | - |
| Încasezi plăți (Receive) | Un [Moove Handle](https://docs.moove.xyz/ro-ro/brand/moove-handle.md) și un portofel implicit cu un [token de decontare](https://docs.moove.xyz/ro-ro/concepts/settlement-and-auto-routing.md) |
| Plătești, faci swap sau bridge (Send, Swap) | Un portofel de finanțare **conectat prin semnătură** — vezi [Portofele acceptate](https://docs.moove.xyz/ro-ro/platform-support/supported-wallets.md). O adresă doar pentru primire, lipită, nu poate finanța niciuna |

**Ca să plătești sau să faci swap**, ai nevoie și de o bibliotecă de semnare în propriul proiect. Verificarea portofelului de finanțare se face la cotație, înainte să se semneze ceva, așa că un portofel neconectat te costă doar apelul. Vezi [Moove Send](https://docs.moove.xyz/api-reference/moove-send.md#before-you-start) sau [Moove Swap](https://docs.moove.xyz/api-reference/moove-swap.md#before-your-first-call).

## Ce să citești în continuare

> [card] [Autentificare](https://docs.moove.xyz/api-reference/authentication.md)
>
> Cum funcționează antetul.

> [card] [Moove Agentic Payments](https://docs.moove.xyz/ro-ro/transact/moove-agentic-payments.md)
>
> Lasă un instrument AI să facă integrarea.

> [card] [Moove Send API](https://docs.moove.xyz/api-reference/moove-send.md)
>
> Plata, de la cap la coadă.

> [card] [Moove Swap API](https://docs.moove.xyz/api-reference/moove-swap.md)
>
> Swap și bridge, de la cap la coadă.

> [card] [Moove Payment Links API](https://docs.moove.xyz/api-reference/moove-receive/moove-payment-links.md)
>
> Endpointurile, pe larg.

Limitată, revocabilă, a ta. Banii tăi. Decizia ta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.