WEBSERVICE COMENTARII v4.0
Serviciul Apropo de comentarii
Comentarii
Management comentarii
GET
Titlu
Comments
Descriere
Listare comentarii per discuţie / Informaţii comentariu după id
Adresa url
/comments/%comment_id$d
Apelare prin
GET
Parametrii URL
Parametru
Valoare
Informaţii
comment_id
opţional
(
type
:
integer
,
default
:
null
)
Headere Custom
Accept
obligatoriu
text/json
text/xml
application/vnd.php.serialized
application/vnd.php.array
Origin
obligatoriu
Cache-Control
opţional
X-Topic-Url
obligatoriu
X-Site-Session
obligatoriu
Parametrii GET
Parametru
Valoare
Informaţii
spam
opţional
-1
0
1
(
type
:
integer
,
default
:
null
)
Specifică valoarea de filtrare după statusul de analiză
approved
opţional
-1
0
1
(
type
:
integer
,
default
:
1
)
Specifică valoarea de filtrare după statusul de aprobare
start
opţional
(
type
:
integer
,
default
:
null
)
Specifică poziţia de la care începe selecţia înregistrărilor
limit
opţional
(
type
:
integer
,
default
:
20
,
maxvalue
:
20
)
Specifică numărul de înregistrări selectate
sort_field
opţional
date
id
(
type
:
string
,
default
:
date
)
Specifică câmpul de sortare la selecţia înregistrărilor
sort_order
opţional
ASC
DESC
(
type
:
string
,
default
:
DESC
)
Specifică ordinea de sortare la selecţia înregistrărilor
POST
Titlu
Comments
Descriere
Adăugare comentariu
Adresa url
/comments
Apelare prin
POST
Headere Custom
Accept
obligatoriu
text/json
text/xml
application/vnd.php.serialized
application/vnd.php.array
Origin
obligatoriu
X-Topic-Url
obligatoriu
X-Site-Session
obligatoriu
Parametrii POST
Parametru
Valoare
Informaţii
email
opţional
(
type
:
string
,
default
:
null
,
maxlength
:
255
)
Specifică o adresă de e-mail a comentatorului pentru acest comentariu
website
opţional
(
type
:
string
,
default
:
null
,
maxlength
:
255
)
Specifică o adresă url a comentatorului pentru acest comentariu
url
opţional
(
type
:
url
,
default
:
null
,
maxlength
:
255
)
Specifică o adresă url (eventual cu ancoră) la care va fi accesibil acest comentariu.
Observatie
: Pentru a genera în mod dinamic un url cu id-ul comentariului inserat se introduce în adresa url expresia
%comment_id$s
care va fi înlocuită în mod automat cu id-ul comentariului din baza de date.
name
obligatoriu
(
type
:
string
,
default
:
null
,
maxlength
:
255
)
Specifică un nume de comentator pentru acest comentariu
date
opţional
(
type
:
datetime
,
default
:
2021-01-18 11:32:06
)
title
opţional
(
type
:
string
,
default
:
null
,
maxlength
:
255
)
Specifică un titlu pentru acest comentariu
message
obligatoriu
(
type
:
string
,
default
:
null
)
Specifică un mesaj pentru acest comentariu
approved
opţional
0
1
(
type
:
integer
,
default
:
null
)
Dacă topicul e creat cu status="moderated" atunci statusul "approved" va fi mereu 0
is_authenticated
opţional
0
1
(
type
:
integer
,
default
:
null
)
Dacă utilizatorul a fost autentificat printr-un mijloc în site atunci statusul "is_authenticated" ar trebui să fie 1
user_type
opţional
(
type
:
string
,
default
:
default
)
Este de regulă folosit drept clasa css pentru containerul ce afişează comentariul
remote_ip
opţional
(
type
:
string
,
default
:
18.215.185.97
,
maxlength
:
15
)
forwarded_ip
opţional
(
type
:
string
,
default
:
0.0.0.0
,
maxlength
:
15
)
user_agent
opţional
(
type
:
string
,
default
:
CCBot/2.0 (https://commoncrawl.org/faq/)
,
maxlength
:
255
)
referrer
opţional
(
type
:
string
,
default
:
null
,
maxlength
:
255
)
PUT
Titlu
Comments
Descriere
Modificare comentariu
Adresa url
/comments/%comment_id$d
Apelare prin
PUT
Parametrii URL
Parametru
Valoare
Informaţii
comment_id
opţional
(
type
:
integer
,
default
:
null
)
Headere Custom
Accept
obligatoriu
text/json
text/xml
application/vnd.php.serialized
application/vnd.php.array
Content-Type
obligatoriu
text/json
text/plain
application/vnd.php.serialized
Origin
obligatoriu
X-Topic-Url
obligatoriu
X-Site-Session
obligatoriu
DELETE
Titlu
Comments
Descriere
Ştergere comentariu
Adresa url
/comments/%comment_id$d
Apelare prin
DELETE
Parametrii URL
Parametru
Valoare
Informaţii
comment_id
obligatoriu
(
type
:
integer
,
default
:
null
)
Headere Custom
Accept
obligatoriu
text/json
text/xml
application/vnd.php.serialized
application/vnd.php.array
Origin
obligatoriu
X-Topic-Url
obligatoriu
X-Site-Session
obligatoriu