Documentația se poate citi și de asistenții AI. Server MCP

Ilustromania.
Intră în aplicație

Recenzii

16 rute, cu exemplu de cerere pentru fiecare.

Adresa de bază: https://app.ilustromania.com/nucleu. Autentificarea, formatul și erorile sunt în Prezentarea API-ului.

GET/v1/reviews

Acces sesiune

Recenziile

Fișierul de recenzii al firmei, cu ciornele de răspuns. Admin sau patron.

Răspuns 200
CâmpTipObligatoriuDetalii
versiunenumberdauna din: 1
citit_lastringda—
canaleobject[]da—
canale[].canalstringdauna din: wolt, bolt, google, glovo, facebook, instagram, tiktok
canale[].nota_medienumberdaîntre 0 și 10
canale[].scalaintegerdaîntre 0 și 9007199254740991
canale[].totalintegerdaîntre 0 și 9007199254740991
canale[].citit_lastringda—
feedbackobject[]da—
feedback[].idstringdanevid
feedback[].canalstringdauna din: wolt, bolt, google, glovo, facebook, instagram, tiktok
feedback[].id_externstringdanevid
feedback[].autorstringdanevid
feedback[].notaintegerdaîntre 1 și 10
feedback[].textstringdanevid
feedback[].primit_lastringda—
feedback[].stare_raspunsstringdauna din: fara_raspuns, ciorna, aprobat, trimis, eroare
feedback[].text_raspunsstringdanevid
feedback[].raspuns_destringdanevid
feedback[].raspuns_lastringda—
socialeobject[]nu—
sociale[].canalstringdauna din: wolt, bolt, google, glovo, facebook, instagram, tiktok
sociale[].starestringdauna din: ok, fara_drept, fara_acces
sociale[].motivstringda—
sociale[].totalintegerdaîntre 0 și 9007199254740991
curl https://app.ilustromania.com/nucleu/v1/reviews \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "versiune": 1,
  "citit_la": "text",
  "canale": [
    {
      "canal": "wolt",
      "nota_medie": 12.5,
      "scala": 1,
      "total": 1,
      "citit_la": "text"
    }
  ],
  "feedback": [
    {
      "id": "text",
      "canal": "wolt",
      "id_extern": "text",
      "autor": "text",
      "nota": 1,
      "text": "text",
      "primit_la": "text",
      "stare_raspuns": "fara_raspuns",
      "text_raspuns": "text",
      "raspuns_de": "text",
      "raspuns_la": "text"
    }
  ],
  "sociale": [
    {
      "canal": "wolt",
      "stare": "ok",
      "motiv": "text",
      "total": 1
    }
  ]
}

PUT/v1/reviews/{id}/ciorna

Acces sesiune

Ciorna de răspuns la recenzie

Scrie ciorna de răspuns a recenziei :id.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
textstringdaîntre 1 și 2000 caractere
aprobabooleannuimplicit false
Răspuns 200
CâmpTipObligatoriuDetalii
idstringdanevid
canalstringdauna din: wolt, bolt, google, glovo, facebook, instagram, tiktok
id_externstringdanevid
autorstringdanevid
notaintegerdaîntre 1 și 10
textstringdanevid
primit_lastringda—
stare_raspunsstringdauna din: fara_raspuns, ciorna, aprobat, trimis, eroare
text_raspunsstringdanevid
raspuns_destringdanevid
raspuns_lastringda—
curl -X PUT https://app.ilustromania.com/nucleu/v1/reviews/{id}/ciorna \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "text",
    "aproba": false
  }'
Răspuns 200 (exemplu din schemă)json
{
  "id": "text",
  "canal": "wolt",
  "id_extern": "text",
  "autor": "text",
  "nota": 1,
  "text": "text",
  "primit_la": "text",
  "stare_raspuns": "fara_raspuns",
  "text_raspuns": "text",
  "raspuns_de": "text",
  "raspuns_la": "text"
}

PUT/v1/reviews/{id}/propunere

Acces sesiune

Hotărârea pe o propunere AI

Aprobă sau respinge propunerea AI de răspuns a recenziei :id.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
starestringdauna din: aprobat, respins
textstringnuîntre 1 și 2000 caractere
Răspuns 200
CâmpTipObligatoriuDetalii
feedback_idstringdanevid
textstringdaîntre 1 și 2000 caractere
de_verificatstringdaîntre 1 și 500 caractere
scris_destringdanevid
scris_lastringda—
starestringdauna din: propus, aprobat, respins
hotarat_lastringda—
curl -X PUT https://app.ilustromania.com/nucleu/v1/reviews/{id}/propunere \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "stare": "aprobat",
    "text": "text"
  }'
Răspuns 200 (exemplu din schemă)json
{
  "feedback_id": "text",
  "text": "text",
  "de_verificat": "text",
  "scris_de": "text",
  "scris_la": "text",
  "stare": "propus",
  "hotarat_la": "text"
}

POST/v1/reviews/{id}/reformuleaza

Acces sesiune

Reformulează ciorna cu AI

Primește textul scris de om și întoarce varianta reformulată, în același ton; nu scrie nimic.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
textstringdaîntre 1 și 2000 caractere
Răspuns 200
CâmpTipObligatoriuDetalii
pornitbooleanda—
textstringnu—
curl -X POST https://app.ilustromania.com/nucleu/v1/reviews/{id}/reformuleaza \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "text"
  }'
Răspuns 200 (exemplu din schemă)json
{
  "pornit": true,
  "text": "text"
}

PUT/v1/reviews/{id}/trimitere

Acces sesiune

Rezultatul trimiterii unui răspuns

Executorul scrie starea trimiterii: in_lucru, trimis sau eroare.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
starestringdauna din: in_lucru, trimis, eroare
eroarestringnuîntre 1 și 500 caractere
Răspuns 200
CâmpTipObligatoriuDetalii
feedback_idstringdanevid
canalstringdanevid
textstringdaîntre 1 și 2000 caractere
starestringdauna din: de_trimis, in_lucru, trimis, eroare, anulat
incercariintegerdaîntre 0 și 9007199254740991
eroarestringdaîntre 1 și 500 caractere
cerut_lastringda—
trimis_lastringda—
curl -X PUT https://app.ilustromania.com/nucleu/v1/reviews/{id}/trimitere \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "stare": "in_lucru",
    "eroare": "text"
  }'
Răspuns 200 (exemplu din schemă)json
{
  "feedback_id": "text",
  "canal": "text",
  "text": "text",
  "stare": "de_trimis",
  "incercari": 1,
  "eroare": "text",
  "cerut_la": "text",
  "trimis_la": "text"
}

GET/v1/reviews/context

Acces sesiune

Contextul pentru AI

Întrebările de context ale firmei, cu răspunsurile folosite la generare.

Răspuns 200
CâmpTipObligatoriuDetalii
versiunenumberdauna din: 1
intrebariobject[]da—
intrebari[].cheiestringda—
intrebari[].intrebarestringdaîntre 1 și 1000 caractere
intrebari[].raspunsstringdaîntre 1 și 2000 caractere
intrebari[].modificat_lastringda—
curl https://app.ilustromania.com/nucleu/v1/reviews/context \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "versiune": 1,
  "intrebari": [
    {
      "cheie": "text",
      "intrebare": "text",
      "raspuns": "text",
      "modificat_la": "text"
    }
  ]
}

PUT/v1/reviews/context/{cheie}

Acces sesiune

Răspunde la o întrebare de context

Scrie răspunsul la întrebarea de context :cheie.

Parametri de cale
NumeTipDescriere
cheiestringvaloarea din cale
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
raspunsstringdaîntre 1 și 2000 caractere
Răspuns 200
CâmpTipObligatoriuDetalii
cheiestringda—
intrebarestringdaîntre 1 și 1000 caractere
raspunsstringdaîntre 1 și 2000 caractere
modificat_lastringda—
curl -X PUT https://app.ilustromania.com/nucleu/v1/reviews/context/{cheie} \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "raspuns": "text"
  }'
Răspuns 200 (exemplu din schemă)json
{
  "cheie": "text",
  "intrebare": "text",
  "raspuns": "text",
  "modificat_la": "text"
}

GET/v1/reviews/generator/stare

Acces sesiune

Starea generatorului AI

Dacă generatorul de propuneri e pornit.

Răspuns 200
CâmpTipObligatoriuDetalii
pornitbooleanda—
curl https://app.ilustromania.com/nucleu/v1/reviews/generator/stare \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "pornit": true
}

GET/v1/reviews/instructiuni

Acces sesiune

Instrucțiunile pentru AI

Instrucțiunile active date AI-ului, folosite în fiecare generare.

Răspuns 200
CâmpTipObligatoriuDetalii
versiunenumberdauna din: 1
instructiuniobject[]da—
instructiuni[].idstringdanevid
instructiuni[].textstringdaîntre 1 și 500 caractere
instructiuni[].creat_lastringda—
curl https://app.ilustromania.com/nucleu/v1/reviews/instructiuni \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "versiune": 1,
  "instructiuni": [
    {
      "id": "text",
      "text": "text",
      "creat_la": "text"
    }
  ]
}

POST/v1/reviews/instructiuni

Acces sesiune

Adaugă o instrucțiune AI

Adaugă o instrucțiune pentru generarea răspunsurilor.

Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
textstringdaîntre 1 și 500 caractere
Răspuns 200
CâmpTipObligatoriuDetalii
idstringdanevid
textstringdaîntre 1 și 500 caractere
creat_lastringda—
curl -X POST https://app.ilustromania.com/nucleu/v1/reviews/instructiuni \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "text"
  }'
Răspuns 200 (exemplu din schemă)json
{
  "id": "text",
  "text": "text",
  "creat_la": "text"
}

DELETE/v1/reviews/instructiuni/{id}

Acces sesiune

Dezactivează o instrucțiune AI

Pune instrucțiunea pe activ = false; rândul rămâne.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Răspuns 200
CâmpTipObligatoriuDetalii
idstringda—
activbooleandauna din: false
curl -X DELETE https://app.ilustromania.com/nucleu/v1/reviews/instructiuni/{id} \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "id": "text",
  "activ": false
}

GET/v1/reviews/propuneri

Acces sesiune

Propunerile AI de răspuns

Propunerile AI de răspuns la recenzii, de aprobat. Admin sau patron; altă firmă 404.

Răspuns 200
CâmpTipObligatoriuDetalii
versiunenumberdauna din: 1
propuneriobject[]da—
propuneri[].feedback_idstringdanevid
propuneri[].textstringdaîntre 1 și 2000 caractere
propuneri[].de_verificatstringdaîntre 1 și 500 caractere
propuneri[].scris_destringdanevid
propuneri[].scris_lastringda—
propuneri[].starestringdauna din: propus, aprobat, respins
propuneri[].hotarat_lastringda—
curl https://app.ilustromania.com/nucleu/v1/reviews/propuneri \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "versiune": 1,
  "propuneri": [
    {
      "feedback_id": "text",
      "text": "text",
      "de_verificat": "text",
      "scris_de": "text",
      "scris_la": "text",
      "stare": "propus",
      "hotarat_la": "text"
    }
  ]
}

POST/v1/reviews/propuneri/{id}/regenereaza

Acces sesiune

Regenerează o propunere AI

Regenerează propunerea cu o instrucțiune, care se salvează implicit; o propunere deja hotărâtă dă 409.

Parametri de cale
NumeTipDescriere
idstringidentificatorul resursei
Corpul cererii (JSON)
CâmpTipObligatoriuDetalii
instructiunestringnuîntre 1 și 500 caractere
tine_mintebooleannuimplicit true
Răspuns 200
CâmpTipObligatoriuDetalii
pornitbooleanda—
regeneratbooleannu—
propunereobjectnu—
propunere.feedback_idstringdanevid
propunere.textstringdaîntre 1 și 2000 caractere
propunere.de_verificatstringdaîntre 1 și 500 caractere
propunere.scris_destringdanevid
propunere.scris_lastringda—
propunere.starestringdauna din: propus, aprobat, respins
propunere.hotarat_lastringda—
curl -X POST https://app.ilustromania.com/nucleu/v1/reviews/propuneri/{id}/regenereaza \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{
    "instructiune": "text",
    "tine_minte": true
  }'
Răspuns 200 (exemplu din schemă)json
{
  "pornit": true,
  "regenerat": true,
  "propunere": {
    "feedback_id": "text",
    "text": "text",
    "de_verificat": "text",
    "scris_de": "text",
    "scris_la": "text",
    "stare": "propus",
    "hotarat_la": "text"
  }
}

POST/v1/reviews/propuneri/genereaza

Acces sesiune

Generează propuneri AI

Generează propuneri pentru recenziile fără răspuns; 503 când sursa lipsește.

Răspuns 200
CâmpTipObligatoriuDetalii
generateintegerdaîntre -9007199254740991 și 9007199254740991
ramaseintegerdaîntre -9007199254740991 și 9007199254740991
pornitbooleannu—
curl -X POST https://app.ilustromania.com/nucleu/v1/reviews/propuneri/genereaza \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{ … }'
Răspuns 200 (exemplu din schemă)json
{
  "generate": 1,
  "ramase": 1,
  "pornit": true
}

POST/v1/reviews/propuneri/genereaza-intern

Acces sesiune

Generare internă de propuneri

Apelul temporizatorului de pe server, cu jeton de serviciu: generează cel mult 10 propuneri „de aprobat”, fără să aprobe sau să trimită.

Răspuns 200
CâmpTipObligatoriuDetalii
generateintegerdaîntre -9007199254740991 și 9007199254740991
ramaseintegerdaîntre -9007199254740991 și 9007199254740991
pornitbooleannu—
curl -X POST https://app.ilustromania.com/nucleu/v1/reviews/propuneri/genereaza-intern \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE" \
  -H "Content-Type: application/json" \
  -d '{ … }'
Răspuns 200 (exemplu din schemă)json
{
  "generate": 1,
  "ramase": 1,
  "pornit": true
}

GET/v1/reviews/trimiteri

Acces sesiune

Coada de trimitere a răspunsurilor

Starea răspunsurilor aprobate de trimis pe canalele cu API (azi doar Google). Citește omul cu drept sau executorul cu jeton de serviciu; nu trimite nimic.

Răspuns 200
CâmpTipObligatoriuDetalii
versiunenumberdauna din: 1
trimiteriobject[]da—
trimiteri[].feedback_idstringdanevid
trimiteri[].canalstringdanevid
trimiteri[].textstringdaîntre 1 și 2000 caractere
trimiteri[].starestringdauna din: de_trimis, in_lucru, trimis, eroare, anulat
trimiteri[].incercariintegerdaîntre 0 și 9007199254740991
trimiteri[].eroarestringdaîntre 1 și 500 caractere
trimiteri[].cerut_lastringda—
trimiteri[].trimis_lastringda—
curl https://app.ilustromania.com/nucleu/v1/reviews/trimiteri \
  -H "Cookie: __Host-sesiune=$JETON_SESIUNE"
Răspuns 200 (exemplu din schemă)json
{
  "versiune": 1,
  "trimiteri": [
    {
      "feedback_id": "text",
      "canal": "text",
      "text": "text",
      "stare": "de_trimis",
      "incercari": 1,
      "eroare": "text",
      "cerut_la": "text",
      "trimis_la": "text"
    }
  ]
}
A fost utilă pagina?
Documentație Ilustromania · ediția 12.11.2026Generată din codul platformei