Ocoya
Développeurs

Publiez sur tout ce qui vous appartient.

Une destination personnalisée est un réseau qu'Ocoya n'a pas besoin de connaître. Donnez-lui une URL et elle reçoit votre publication terminée en JSON, comme une publication part vers Instagram, sauf que l'autre bout est le vôtre.

À quoi ça sert

La destination pour tout le reste.

La plupart de ce que vous publiez va vers un réseau avec un logo. Ceci est pour le reste.

Régler
Votre propre blog

Les articles écrits dans Ocoya arrivent sur votre site ou votre CMS, quelle que soit la technologie.

Le connecter

Une URL, un nom et généralement un en-tête.

Vous possédez les deux bouts, donc pas d'écran de connexion à parcourir. Collez l'adresse, ajoutez l'en-tête qu'attend votre endpoint, et la destination apparaît dans le compositeur à côté de vos autres canaux.

  • Toute URL publique qui accepte un POST
  • Jusqu'à 10 en-têtes, pour une clé d'API ou un jeton
  • Apparaît dans le compositeur comme tout autre canal
NomFacultatif
Mon blog

Comment cette destination est nommée dans votre liste de canaux.

URL de publicationObligatoire
https://example.com/hooks/content

Chaque publication programmée est envoyée ici en POST avec un corps JSON.

URL de suppressionFacultatif
https://example.com/hooks/content/delete

Appelée uniquement quand vous supprimez une publication dans Ocoya. Laissez vide pour garder votre copie.

En-têtesFacultatif
Authorization: Bearer ••••••

Envoyés avec chaque requête, pour un endpoint qui attend une clé d'API ou un jeton.

Connecter la destination
Le contenu envoyé

Un POST, avec juste ce dont un blog a besoin.

Le corps est du JSON : le titre, le texte tel que vous l'avez écrit (Markdown pour un article), une image de couverture et, pour un article, le slug, l'extrait, les tags et les champs SEO quand il en a. Rien d'autre, donc rien à ignorer.

POSTContent-Type: application/json
{
"event": "post.published",
"publishedAt": "2026-11-04T09:00:00.000Z",
"post": {
"id": "cm4x2k9a0001",
"title": "Why your content is not converting",
"caption": "## The three pillars\n\n…",
"image": "https://…/cover.png",
"options": {
"markdownMode": true,
"slug": "why-your-content-is-not-converting",
"excerpt": "…",
"seoTitle": "…",
"seoDescription": "…",
"tags": ["content", "strategy"],
"readingMinutes": 6
}
}
}
Lire la référence du contenu

L'aperçu du compositeur montre ce corps exact avant la programmation, sauf l'id et l'heure.

Votre réponse

Répondez 2xx avec un id et une url.

Ocoya attend la réponse jusqu'à 30 secondes. Une publication compte comme publiée quand vous répondez avec un statut 2xx et un JSON qui contient un id et une url. L'url devient le lien de la publication, et l'id est ce qu'Ocoya renvoie si vous supprimez la publication.

POSTvotre endpoint
200 { "id": "a1b2c3", "url": "https://…" }
Publié
POSTvotre endpoint
200 { }
Échec : ni id ni url. Elle existe peut-être déjà, vérifiez d'abord.
POSTvotre endpoint
400 { "error": "title is missing" }
Échec. Ocoya vous montre le message envoyé par votre endpoint.
POSTvotre endpoint
pas de réponse en 30 s
Échec. Pas de nouvel essai, pour que rien ne soit envoyé deux fois.
24 hessai 1+5 min+30 min+2 h+6 h+12 h{ }503, en attente200 OK
Quand c'est occupé

Un endpoint occupé a une autre chance.

Si votre endpoint répond 429, 502, 503 ou 504, Ocoya attend et réessaie de lui-même : après 5 minutes, puis 30 minutes, 2 heures, 6 heures et 12 heures. Pendant l'attente, la publication reste programmée.

  • Il s'arrête quand une publication partirait avec plus de 24 heures de retard.
  • Les autres erreurs et les délais dépassés ne sont pas réessayés. Un délai dépassé a pu publier, et un second essai pourrait publier en double.
  • L'id de la publication est le même à chaque essai.
Supprimer

Supprimez-le là-bas quand vous le supprimez ici.

Ajoutez une URL de suppression facultative. Quand vous supprimez une publication dans Ocoya, elle envoie là-bas une requête post.deleted avec l'id que votre endpoint vous a donné à la publication. Laissez-la vide et votre copie reste.

À la publication, votre réponse{ "id": "a1b2c3", "url": "https://…" }
Vous supprimez la publication dans Ocoya
La requête vers votre URL de suppression
POST /hooks/content/delete
{
  "event": "post.deleted",
  "id": "a1b2c3",
  "deletedAt": "2026-11-04T10:12:00.000Z",
  "post": { … }
}
Votre copie
Sécurité

C’est votre endpoint, appelé avec soin.

Une destination est une adresse à laquelle Ocoya se connecte depuis son propre réseau, elle est donc traitée comme telle.

192.168.0.12localhostapi.yourshop.comRefuséeAutorisée
  • Les adresses privées et internes sont refusées.
  • La connexion est liée à l'adresse publique résolue par votre hébergeur.
  • Une redirection n'est suivie que si la nouvelle adresse passe le même contrôle, jusqu'à 3 fois.
  • Les valeurs des en-têtes restent sur nos serveurs. Le navigateur ne voit que leurs noms.
Dans le compositeur

Il est dans le compositeur comme tout autre canal.

Votre destination apparaît à côté d'Instagram et de LinkedIn. Choisissez-la, fixez le jour et l'heure, et elle est envoyée à la minute choisie, avec le reste.

  • Programmez-la
  • Voyez-la dans le calendrier
  • Dirigez une campagne de blog vers elle

L'aperçu du compositeur montre d'abord le corps exact de la requête.

Questions

Bon à savoir avant de connecter.

RXAccepter un POST avec un corps JSON et répondre avec un statut 2xx et un JSON qui contient un id et une url. Il doit être joignable depuis Internet, car Ocoya l'appelle depuis ses propres serveurs.

RXAjoutez un en-tête comme Authorization ou X-API-Key dans Options avancées et vérifiez-le dans votre code. Ocoya l'envoie avec chaque requête. Les requêtes ne sont pas signées.

RXS'il répond 429, 502, 503 ou 504, Ocoya réessaie après 5 minutes, 30 minutes, 2 heures, 6 heures et 12 heures, tant que la publication ne serait pas en retard de plus de 24 heures. Les autres erreurs échouent tout de suite et vous montrent le statut et le message de votre endpoint.

RXNon. Ocoya ne se connecte qu'à des adresses publiques. Les adresses privées et internes sont refusées.

RXIl envoie une image, la première image fixe de la publication, sous forme de lien. La vidéo n'est pas envoyée.

Publiez-le là où il doit être.

Connectez une destination en une minute et dirigez votre prochaine campagne vers elle.