Primii pași
Autentificare
Cum să creezi o cheie API și să o folosești pentru acces
Toate cererile către CRM API necesită autentificare prin cheie API. Cheia identifică agenția ta și determină la ce date ai acces.
Creează o cheie API
- Autentifică-te pe rentix.md (sau staging.rentix.md pentru testare)
- Deschide Meniul utilizator → [Numele agenției] → Chei API
- Apasă Creează cheie
- Copiază cheia — se afișează o singură dată
Păstrează cheia în siguranță. Oricine are cheia poate gestiona anunțurile agenției tale. Nu comite cheile în git și nu le partaja cu terți.
Folosește cheia în cereri
Transmite cheia în header-ul Authorization pentru fiecare cerere.
const response = await fetch('https://crm.rentix.md/api/v1/agency', {
headers: {
'Authorization': 'ApiKey YOUR_API_KEY'
}
});
const agency = await response.json();
console.log(agency.name); // "Agenția ta"
curl https://crm.rentix.md/api/v1/agency \
-H "Authorization: ApiKey YOUR_API_KEY"
$ch = curl_init('https://crm.rentix.md/api/v1/agency');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: ApiKey YOUR_API_KEY'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$agency = json_decode($response, true);
echo $agency['name']; // "Agenția ta"
Header alternativ
În loc de Authorization, poți folosi X-API-Key:
curl https://crm.rentix.md/api/v1/agency \
-H "X-API-Key: YOUR_API_KEY"
Verifică conexiunea
O cerere către /agency este un mod simplu de a confirma că cheia funcționează.
Răspuns de succes
{
"id": 1,
"name": "Agenția ta",
"status": "active",
"isCrmEnabled": true,
"limits": {
"monthlyListings": { "used": 5, "limit": 1000 }
}
}
Erori de autentificare
| Cod | Eroare | Soluție |
|---|---|---|
| 400 | Multiple authentication methods provided | Folosește fie Authorization, fie X-API-Key, nu ambele |
| 401 | API key is required | Adaugă headerul Authorization: ApiKey YOUR_KEY |
| 401 | Invalid API key | Verifică dacă cheia API este corectă și nu a fost revocată |
| 403 | Agency is suspended | Contactează suportul — contul agenției este suspendat |
| 403 | CRM is not enabled for this agency | Contactează suportul pentru activarea CRM |
Pasul următor
Cheia este gata — creează primul anunț.