Référence
Conversations
Référence générée depuis le contrat OpenAPI : Conversations.
Les conversations d'une créatrice
GET /public/v1/creators/{creator_id}/conversations · listConversations
Paramètres
| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
creator_id | chemin | string | oui | Identifiant de la créatrice. |
platform | requête | "mym" | "telegram" | "onlyfans" | non | La plateforme de la conversation. (défaut : mym) |
limit | requête | integer | non | Taille de la page. (défaut : 50) |
cursor | requête | string | null | non | Le nextCursor de la page précédente. |
Réponse 200
Page_Conversation_
| Champ | Type | Requis | Description |
|---|---|---|---|
items | Conversation[] | oui | |
nextCursor | string | null | non | À repasser en cursor pour lire la page suivante ; null = dernière page. |
Conversation
| Champ | Type | Requis | Description |
|---|---|---|---|
id | string | oui | Identifiant de la conversation sur sa plateforme (MYM : le chat id). |
platform | "mym" | "telegram" | "onlyfans" | oui | |
fan | Fan | oui | |
lastFanMessageAt | string (date-time) | null | oui | |
lastMessageAt | string (date-time) | null | oui | |
unreadCount | integer | null | non | Messages du fan non lus, quand la plateforme les compte. |
hasPurchased | boolean | null | non |
Fan
| Champ | Type | Requis | Description |
|---|---|---|---|
name | string | null | oui | |
username | string | null | non |
Erreurs possibles
401 · 403 · 404 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations" \
-H "Authorization: Bearer $FANCONVERT_API_KEY"Les messages d'une conversation
GET /public/v1/creators/{creator_id}/conversations/{conversation_id}/messages · listMessages
Paramètres
| Nom | Où | Type | Requis | Description |
|---|---|---|---|---|
creator_id | chemin | string | oui | Identifiant de la créatrice. |
conversation_id | chemin | string | oui | Identifiant de la conversation. |
platform | requête | "mym" | "telegram" | "onlyfans" | non | La plateforme de la conversation. (défaut : mym) |
limit | requête | integer | non | Taille de la page. (défaut : 50) |
cursor | requête | string | null | non | Le nextCursor de la page précédente. |
Réponse 200
Page_Message_
| Champ | Type | Requis | Description |
|---|---|---|---|
items | Message[] | oui | |
nextCursor | string | null | non | À repasser en cursor pour lire la page suivante ; null = dernière page. |
Message
| Champ | Type | Requis | Description |
|---|---|---|---|
id | string | oui | |
direction | "fan" | "creator" | oui | |
text | string | oui | |
sentAt | string (date-time) | null | oui | |
media | MessageMedia[] | oui |
MessageMedia
| Champ | Type | Requis | Description |
|---|---|---|---|
status | "paid" | "pending" | "refused" | "free" | "unknown" | oui | |
priceMinor | integer | null | non | |
currency | string | null | non |
Erreurs possibles
401 · 403 · 404 · 422 · 429 · 503 — Format des erreurs : Erreurs.
Exemple
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/messages" \
-H "Authorization: Bearer $FANCONVERT_API_KEY"Mis à jour le