# API LinkedIn și asistenți AI (MCP)
Tot ceea ce faceți pe paginile LinkedIn poate fi realizat și dintr-un script sau un asistent AI: clienții potențiali, coada de cereri de conectare, regulile ICP (inclusiv ce țări acceptați și cât de mare trebuie să fie rețeaua unui client potențial), căsuța de e-mail, agenții AI și setările dumneavoastră.
Nu există nimic nou de configurat. Se folosește **aceeași cheie API ca pentru restul DM Champ**, deci dacă apelați deja API-ul nostru sau aveți un asistent AI conectat, sunteți gata de utilizare.
## Unde puteți găsi cheia
Setări → Integrări → Cheie API. Dacă nu aveți încă una, faceți clic pe **Generare cheie API**. Pașii compleți se află în [Acces API](api-access.md).
Nu există o cheie LinkedIn separată de creat, rotit sau revocat. Cheia acționează în numele dumneavoastră, cu aceleași permisiuni pe care le aveți în aplicație, așa că tratați-o ca pe o parolă. Revocarea acesteia din Setări întrerupe instantaneu orice script sau asistent conectat.
## Apelarea directă a API-ului
- **URL de bază:** `https://app.sdrpilot.ai/api/v1`
- **Antet:** `X-API-Key: YOUR_API_KEY`
- **Descriere lizibilă de către mașină:** `https://app.sdrpilot.ai/api/v1/docs/openapi.yaml`
(disponibilă și ca `.json`)
Documentul OpenAPI este public și descrie fiecare rută, astfel încât majoritatea instrumentelor API și generatoarelor de cod îl pot importa direct fără o cheie.
`Authorization: Bearer YOUR_API_KEY` funcționează de asemenea. Ceea ce nu puteți face este să trimiteți o cheie greșită și să sperați că va fi acceptată pentru altceva: odată ce o cheie este prezentată, răspunsul se bazează pe acea cheie.
Ce se întâmplă când ceva nu este în regulă:
| Răspuns | Ce înseamnă |
|---|---|
| `401` | Cheia lipsește, este formatată greșit sau nu este acceptată. |
| `403` | Cheia este validă, dar acel cont nu are un spațiu de lucru LinkedIn sau nu are încă permisiunea de acces. |
| `429` | Prea multe încercări respinse într-un minut pentru acea cheie. Încetiniți ritmul. |
| `502` `dmchamp_unreachable` | Nu am putut verifica cheia dumneavoastră în acel moment. Nu este niciodată tratată ca o permisiune de acces. Reîncercați. |
## Conectarea unui asistent AI
Instrumentele LinkedIn se află pe același punct final MCP ca și cele ale DM Champ, cu aceeași cheie API, deci un asistent pe care l-ați conectat deja le va prelua automat. Dacă nu ați conectat încă unul, urmați [Conectare asistenți AI (MCP)](connect-ai-clients.md) și utilizați punctul final listat acolo.
::: master-only
Punctul final este `https://mcp.youraiconnector.com/mcp`, autentificat cu antetul `X-API-Key`, exact așa cum este descris în Conectare asistenți AI (MCP).
:::
Instrumentele LinkedIn au toate prefixul **`linkedin_`**, deci sunt ușor de identificat în lista de instrumente a asistentului tău și ușor de solicitat pe nume („folosește instrumentele LinkedIn pentru a-mi arăta ce este în coadă”). Nu există permisiuni per instrument: un instrument poate face tot ceea ce poți face și tu în aplicație.
## Exemplul 1 — acceptă doar lead-uri din anumite țări
Profilul tău ICP conține regulile pe care lead-urile trebuie să le îndeplinească. Aceasta stabilește o listă permisă formată din Țările de Jos și Belgia. Codurile de țară sunt formate din două litere, cu majuscule.
```bash
curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'
```
Două lucruri de reținut. Corpul cererii reprezintă setul **complet** de reguli, nu o actualizare: o regulă pe care o omiți este dezactivată. Iar răspunsul include un bloc `impact_on_queue` care îți spune câte cereri de conectare deja aflate în coadă nu ar respecta noile reguli, de exemplu `{"examined": 389, "would_withdraw": 155}`.
Salvarea regulilor nu retrage nimic de la sine.
Într-un asistent, ai spune pur și simplu: „Setează-mi ICP-ul să accepte doar Țările de Jos și Belgia și spune-mi ce ar însemna asta pentru coada mea.”
## Exemplul 2 — vezi ce este în coadă
Cereri de conectare care au fost aprobate, dar nu au fost încă trimise:
```bash
curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
-H "X-API-Key: YOUR_API_KEY"
```
Fiecare rând conține numele persoanei, titlul, compania, locația, țara, numărul de conexiuni și urmăritori, precum și scorul. Poți restrânge lista cu `country`, `min_score`, `max_score` și `source` și poți naviga prin ea cu `limit` și `cursor`. Doar cererile aflate în coadă și cele care așteaptă aprobarea apar aici. Cererile deja trimise sunt istoric și nu pot fi modificate.
## Exemplul 3 — retrage pe toată lumea din afara țărilor tale
După modificarea regulilor, verifică din nou coada în raport cu acestea. Fără `apply=true`, aceasta este o previzualizare și nu modifică nimic:
```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
-H "X-API-Key: YOUR_API_KEY"
```
Primești înapoi numărul de persoane examinate, câte ar fi retrase și o defalcare pe regulă, cum ar fi `country` și `network_too_small` (rețeaua lead-ului era mai mică decât minimul tău). Ești mulțumit de rezultat? Rulează din nou cu `?apply=true` și acele cereri vor fi retrase.
```bash
curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
-H "X-API-Key: YOUR_API_KEY"
```
Dacă preferi să retragi un set specific, postează ID-urile în schimb sau un filtru precum `{"filter":{"status":"queued","country":"NG"}}` pentru a elimina tot ce se potrivește. Trimite ID-uri sau un filtru, nu ambele.
## Depanare
- **`401` la fiecare apel** — cheia lipsește sau este greșită. Copiaz-o din nou din Setări → Integrări → Cheie API.
- **`403` deși cheia funcționează în altă parte** — acel cont nu este conectat la un spațiu de lucru LinkedIn sau LinkedIn nu este încă activat pentru acesta.
- **`502 dmchamp_unreachable`** — o problemă temporară la verificarea cheii tale. Nu a fost permis nimic; reîncearcă.
- **O regulă nu se potrivește cu nimic** — codurile de țară trebuie să fie sub formă de două litere cu majuscule (`NL`, nu `Netherlands` sau `nl`), iar codurile de limbă trebuie să fie cu minuscule.
- **Asistentul nu afișează instrumente LinkedIn** — reconectează-l pentru a reîncărca lista de instrumente și verifică dacă folosești aceeași cheie API.
---
## Pașii următori
- [Conectare Asistenți AI (MCP)](connect-ai-clients.md) — configurează Claude, ChatGPT sau Cursor cu cheia ta.
- [Acces API](api-access.md) — generează sau rotește cheia pe care o folosește acesta.