Version Management

https://jobaffinity.fr/restapi/v1

GET https://jobaffinity.fr/restapi/v1

{
  "_status": "OK",
  "_self": "/restapi/v1",
  "_version": "1.10",
  "_last_version_url": "/restapi/v1",
  "_expiration": null,
  "_changelog": {
    "_self": "/restapi/changelog"
  }
}

import requests
from datetime import datetime

def check_api_version():
    """Checks the API version status"""
    response = requests.get(
        'https://jobaffinity.fr/restapi/v1',
        auth=('login', 'password')
    )

    data = response.json()

    # Check if a new version is available
    if data['_last_version_url'] != data['_self']:
        print(f"⚠️  ALERT: New version available!")
        print(f"   Current URL: {data['_self']}")
        print(f"   New URL: {data['_last_version_url']}")

    # Check expiration
    if data['_expiration']:
        expiration_date = datetime.fromisoformat(data['_expiration'])
        days_remaining = (expiration_date - datetime.now()).days

        print(f"🚨 CRITICAL ALERT: Version expires in {days_remaining} days")
        print(f"   Expiration date: {data['_expiration']}")
        print(f"   See: https://jobaffinity.fr{data['_changelog']['_self']}")

    return data

# Run periodically (e.g., via cron)
check_api_version()

#!/bin/bash

RESPONSE=$(curl -s --basic --user "login:password" \
  "https://jobaffinity.fr/restapi/v1")

EXPIRATION=$(echo "$RESPONSE" | jq -r '._expiration // empty')

if [ ! -z "$EXPIRATION" ]; then
  echo "🚨 ALERT: API version expires on $EXPIRATION"
  echo "Consult the changelog to migrate"
  # Send alert (email, Slack, etc.)
  exit 1
fi

https://jobaffinity.fr/restapi/changelog

import requests

class JobAffinityAPI:
    def __init__(self, auth):
        self.auth = auth
        self.base_url = 'https://jobaffinity.fr/restapi/v1'

    def get_resource(self, url=None):
        """Fetches a resource using provided URLs"""
        if url is None:
            url = self.base_url

        response = requests.get(url, auth=self.auth)
        data = response.json()

        # Automatically ignore unknown fields
        return data

    def check_version_status(self):
        """Checks version status"""
        root = self.get_resource()

        return {
            'current_version': root.get('_version'),
            'is_latest': root.get('_last_version_url') == root.get('_self'),
            'expiration': root.get('_expiration'),
            'changelog_url': root.get('_changelog', {}).get('_self')
        }

# Usage
api = JobAffinityAPI(auth=('login', 'password'))
status = api.check_version_status()

if not status['is_latest']:
    print("⚠️  New version available")

if status['expiration']:
    print(f"🚨 Migration required before {status['expiration']}")