> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Vue d'ensemble de l'API Comments
> Publiez, répondez, récupérez et supprimez des commentaires sur une publication sociale
export const PlansAvailable = ({plans = [], maxPackRequired}) => {
let displayPlans = plans;
if (plans && plans.length === 1) {
const lowerCasePlan = plans[0].toLowerCase();
if (lowerCasePlan === "business") {
displayPlans = ["Launch", "Business", "Enterprise"];
} else if (lowerCasePlan === "premium") {
displayPlans = ["Premium", "Launch", "Business", "Enterprise"];
}
}
return
Available on {displayPlans.length === 1 ? "the " : ""}
{displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "}
{displayPlans.length > 1 ? "plans" : "plan"}.
{maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer">
Max Pack required
}
;
};
Les points de terminaison Comments permettent à vos utilisateurs de publier, répondre, récupérer et supprimer des commentaires sur leurs publications.
Il existe quatre types d'identifiants de commentaires : l'ID de publication Ayrshare, l'ID de publication social, l'ID de commentaire Ayrshare et l'ID de commentaire social.
Chacun de ces identifiants sert à des fins différentes.
## Types d'identifiants de commentaires
### Commentaires avec l'ID de publication Ayrshare
Le flux typique est le suivant : lorsque vous publiez via Ayrshare, vous obtenez l'ID de publication Ayrshare.
Vous pouvez ensuite utiliser cet [ID de publication Ayrshare](/apis/overview#ayrshare-post-id) pour gérer les commentaires sur cette publication.
Plateformes prises en charge : Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter et YouTube.
Par exemple :
Utilisez le point de terminaison [/post](/apis/post/post) pour publier via Ayrshare, ce qui peut envoyer vers plusieurs réseaux sociaux en un seul appel.
Dans le retour se trouve l'[ID de publication Ayrshare](/apis/overview#ayrshare-post-id) de premier niveau.
```json {12} theme={"system"}
{
"status": "success",
"errors": [],
"postIds": [
{
"status": "success",
"id": "106638148652329_591370753547555",
"postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
"platform": "facebook"
}
],
"id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
"refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
"post": "What an amazing day",
"validate": true
}
```
Utilisez le point de terminaison [/comments](/apis/comments/post-comment) pour publier un commentaire avec l'ID de publication Ayrshare.
Le commentaire sera automatiquement publié sur chaque réseau social où la publication d'origine a été publiée.
Par exemple, si vous avez publié sur Facebook et Instagram, le commentaire apparaîtra sur les deux plateformes.
```http theme={"system"}
POST https://api.ayrshare.com/api/comments/:id
```
Utilisez le point de terminaison [/comments](/apis/comments/get-comments) pour obtenir les commentaires de la publication à partir de l'ID de publication Ayrshare.
Cela renverra tous les commentaires de chaque réseau social où la publication a été publiée.
Par exemple, si vous avez publié sur Facebook et Instagram, vous obtiendrez les commentaires des deux plateformes.
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/:id
```
### Commentaires avec un ID de publication social
Parfois, vous pouvez vouloir gérer les commentaires sur une publication qui n'a pas été publiée via Ayrshare.
Dans ce cas, vous pouvez utiliser l'[ID de publication social](/apis/overview#social-post-id), qui est l'ID de publication attribué par le réseau social.
Si la publication a été publiée via Ayrshare, utilisez l'[ID de publication
Ayrshare](/apis/comments/overview#comments-with-ayrshare-post-id).
Par exemple :
Commencez par obtenir les publications Instagram publiées en dehors d'Ayrshare avec le [point de terminaison Get All Post History](/apis/history/history-platform).
Le point de terminaison retourne une liste de publications avec l'`id` social de la publication.
```json {13} theme={"system"}
{
"status": "success",
"posts": [
{
"mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
"permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
"commentsCount": 0,
"created": "2022-05-20T17:26:03Z",
"likeCount": 0,
"mediaProductType": "FEED",
"mediaType": "IMAGE",
"username": "thegoodone",
"id": "17833140557332933", // Instagram Social Post ID
"thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
"post": "The #Mandalorian is on tonight instead of Friday",
"postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
},
]
}
```
L'`id` social de la publication est également renvoyé dans le champ `postIds` du [point de terminaison post](/apis/post/post).
Utilisez l'`id` retourné pour [obtenir tous les commentaires](/apis/comments/get-comments) d'une publication Instagram spécifique en utilisant l'`id` social, `searchPlatformId` défini sur `true` et `platform` défini sur `instagram`.
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true
```
Le JSON retourné à l'étape précédente contiendra un `commentId` pour chaque commentaire, qui est l'[ID de commentaire social](/apis/overview#social-comment-id).
```json {5} theme={"system"}
{
"instagram": [
{
"comment": "What an amazing comment",
"commentId": "17969247335804735", // Social Comment ID
"created": "2024-11-26T11:49:00Z",
"from": {
"id": "103038435208332",
"username": "john_smith"
},
"hidden": false,
"likeCount": 3,
"platform": "instagram",
"postId": "18231730279304333",
"username": "john_smith"
}
]
}
```
### Commentaires avec un ID de commentaire Ayrshare
Gérez les commentaires d'une publication qui ont été publiés via Ayrshare en utilisant l'[ID de commentaire Ayrshare](/apis/overview#ayrshare-comment-id).
L'ID de commentaire Ayrshare est l'ID de commentaire attribué par Ayrshare et se trouve dans le champ `commentId` de la réponse lors de la [publication d'un commentaire](/apis/comments/post-comment).
Il est souvent utilisé pour obtenir des détails sur un commentaire particulier publié via Ayrshare.
### Commentaires avec un ID de commentaire social
Gérez les commentaires d'une publication qui n'ont pas été publiés via Ayrshare en utilisant l'[ID de commentaire social](/apis/overview#social-comment-id).
L'ID de commentaire social est l'ID de commentaire du réseau social, et non l'ID Ayrshare, et se trouve dans le champ `commentId` de la réponse lors de la [récupération des commentaires](/apis/comments/get-comments).
```http theme={"system"}
GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true
```
Il est souvent utilisé pour obtenir des détails sur un commentaire particulier publié en dehors d'Ayrshare, comme les réponses LinkedIn à des commentaires.
## Désactiver les commentaires
Vous pouvez désactiver les commentaires lors de la publication d'un post en utilisant le champ `disableComments` du [point de terminaison /post](/apis/post/post). Les commentaires ne seront désactivés que pour Instagram, LinkedIn et TikTok.
Vous pouvez également activer ou désactiver les commentaires sur une publication déjà publiée en utilisant le point de terminaison [update post](/apis/post/update-post) et le champ `disableComments`.
## Limitations des plateformes
**TikTok — `DELETE /comments` uniquement pour les commentaires que vous avez rédigés.** [`DELETE /comments`](/apis/comments/delete-comments) sur TikTok ne réussit que pour les commentaires rédigés par le compte TikTok authentifié lui-même (vos propres réponses). Toute tentative de suppression d'un commentaire rédigé par un autre utilisateur retourne le code Ayrshare `328`. Pour la modération des commentaires tiers sur vos propres vidéos TikTok, contactez le support pour que nous puissions confirmer ce qui est disponible pour votre type de compte lié.
```
```