Passer au contenu principal

Stratégie de synchronisation

La méthode recommandée pour synchroniser les freelances Pylote dans votre base :

Synchronisation initiale

Utilisez modifiedTime=0 pour récupérer tous les freelances, puis paginez :

Synchronisation incrémentale

Stockez le timestamp de votre dernière synchronisation, puis récupérez uniquement les profils modifiés depuis :
Les freelances avec status: deleted doivent être supprimés de votre base dans un délai de 30 jours. C’est un engagement contractuel. Les statuts de suppression possibles sont : account_deleted, account_banned, account_excluded, account_invisible.

Pagination

Les réponses sont paginées avec les paramètres page et limit. Chaque réponse inclut un objet infos :
Utilisez limit=1000 pour minimiser le nombre de requêtes. Un sync initial de ~22 000 freelances prend environ 22 pages.

Dédoublonnage

Un même freelance peut être présent sur plusieurs plateformes. Le champ meta.personalEmail (hash SHA-256 de l’email personnel) vous permet de dédoublonner :

URLs trackées (hive.pylote.io)

Les champs basics.url (LinkedIn) et le lien CV dans basics.profiles passent par le proxy hive.pylote.io. Ces URLs :
  • Trackent les consultations pour les stats du freelance
  • Contiennent un watermark (IP de l’appelant encodée en base64)
  • Ne doivent pas être partagées en dehors de votre plateforme
Format :

Récupérer des freelances spécifiques

Si vous avez besoin de re-synchroniser un sous-ensemble de profils (par exemple après un incident), utilisez POST /freelances avec une liste d’IDs :

Fréquence de synchronisation recommandée

Le cache de l’API est rafraîchi toutes les heures. Synchroniser plus souvent que toutes les heures n’apporte pas de données supplémentaires.