Reference
Conversations
Reference generated from the OpenAPI contract: Conversations.
Les conversations d'une créatrice
GET /public/v1/creators/{creator_id}/conversations · listConversations
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
creator_id | path | string | yes | Identifiant de la créatrice. |
platform | query | "mym" | "telegram" | "onlyfans" | no | La plateforme de la conversation. (default : mym) |
limit | query | integer | no | Taille de la page. (default : 50) |
cursor | query | string | null | no | Le nextCursor de la page précédente. |
Response 200
Page_Conversation_
| Field | Type | Required | Description |
|---|---|---|---|
items | Conversation[] | yes | |
nextCursor | string | null | no | À repasser en cursor pour lire la page suivante ; null = dernière page. |
Conversation
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | Identifiant de la conversation sur sa plateforme (MYM : le chat id). |
platform | "mym" | "telegram" | "onlyfans" | yes | |
fan | Fan | yes | |
lastFanMessageAt | string (date-time) | null | yes | |
lastMessageAt | string (date-time) | null | yes | |
unreadCount | integer | null | no | Messages du fan non lus, quand la plateforme les compte. |
hasPurchased | boolean | null | no |
Fan
| Field | Type | Required | Description |
|---|---|---|---|
name | string | null | yes | |
username | string | null | no |
Possible errors
401 · 403 · 404 · 422 · 429 · 503 — Error format: Errors.
Example
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
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
creator_id | path | string | yes | Identifiant de la créatrice. |
conversation_id | path | string | yes | Identifiant de la conversation. |
platform | query | "mym" | "telegram" | "onlyfans" | no | La plateforme de la conversation. (default : mym) |
limit | query | integer | no | Taille de la page. (default : 50) |
cursor | query | string | null | no | Le nextCursor de la page précédente. |
Response 200
Page_Message_
| Field | Type | Required | Description |
|---|---|---|---|
items | Message[] | yes | |
nextCursor | string | null | no | À repasser en cursor pour lire la page suivante ; null = dernière page. |
Message
| Field | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
direction | "fan" | "creator" | yes | |
text | string | yes | |
sentAt | string (date-time) | null | yes | |
media | MessageMedia[] | yes |
MessageMedia
| Field | Type | Required | Description |
|---|---|---|---|
status | "paid" | "pending" | "refused" | "free" | "unknown" | yes | |
priceMinor | integer | null | no | |
currency | string | null | no |
Possible errors
401 · 403 · 404 · 422 · 429 · 503 — Error format: Errors.
Example
curl -X GET "https://app.fanconvert.ai/public/v1/creators/{creator_id}/conversations/{conversation_id}/messages" \
-H "Authorization: Bearer $FANCONVERT_API_KEY"Last updated on