مرجع API v1

كتالوج موثَّق ذاتيًا لواجهة API (عام، دون token).

مثال على الطلب

curl "https://www.superalternance.com/api/v1"

مثال على الرد

{
  "name": "superalternance API partenaires",
  "version": "1",
  "authentication": { "type": "bearer", "description": "…" },
  "endpoints": [ … ]
}

إكمال تلقائي «مهنة أو تكوين» لشريط بحث.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/suggest?q=boul&limit=5"

مثال على الرد

{
  "query": "boul",
  "suggestions": [
    { "kind": "rome", "value": "Boulanger", "secondary": "Métier" },
    { "kind": "formation", "value": "CAP Boulanger", "secondary": "CFA des métiers" }
  ]
}

إكمال تلقائي للأماكن: الأقاليم والمحافظات والبلديات.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/places?q=lyon"

مثال على الرد

{
  "query": "lyon",
  "suggestions": [
    { "kind": "city", "value": "Lyon", "secondary": "69001 · Rhône", "lat": 45.758, "lng": 4.835 }
  ]
}

بحث موحَّد للعروض + التكوينات، قابل للتصفية حسب المكان والمهنة والتكوين والمستوى.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/search?metier=boulanger&lieu=Lyon&type=jobs&limit=5"

مثال على الرد

{
  "filters": { "metier": "boulanger", "resolvedRomeCodes": ["D1102", "D1104"], "lieu": "Lyon", "type": "jobs" },
  "pagination": { "limit": 5, "offset": 0 },
  "totals": { "jobs": 42, "formations": 0 },
  "results": [
    {
      "kind": "job", "id": "…", "title": "Boulanger en alternance",
      "subtitle": "Maison Dupain · Lyon", "city": "Lyon",
      "latitude": 45.75, "longitude": 4.84,
      "labels": ["Apprentissage", "CAP"],
      "url": "https://www.superalternance.com/fr/offres/…"
    }
  ]
}

أحدث عروض التناوب المنشورة، مع تصفية اختيارية حسب المكان.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/jobs/latest?lieu=Bordeaux&limit=10"

مثال على الرد

{
  "filters": { "lieu": "Bordeaux" },
  "total": 10,
  "jobs": [
    { "id": "…", "title": "Développeur web en alternance", "subtitle": "Acme · Bordeaux",
      "city": "Bordeaux", "latitude": 44.84, "longitude": -0.58,
      "labels": ["Apprentissage"], "url": "https://www.superalternance.com/fr/offres/…" }
  ]
}

تفاصيل كاملة لعرض: العقد، صاحب العمل، الموقع، التقديم.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/jobs/abc123"

مثال على الرد

{
  "job": {
    "id": "abc123", "title": "Boulanger en alternance",
    "contractTypes": ["Apprentissage"], "duration": "24 mois",
    "location": { "city": "Lyon", "zipCode": "69003", "region": "Auvergne-Rhône-Alpes" },
    "company": { "name": "Maison Dupain", "siret": "…", "siren": "…" },
    "apply": { "email": null, "url": "…" }
  }
}

تفاصيل كاملة لتكوين: الشهادة، RNCP، الهيئة (CFA)، الوتيرة.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/formations/xyz789"

مثال على الرد

{
  "formation": {
    "id": "xyz789", "title": "CAP Boulanger", "diploma": "CAP",
    "rncpCode": "RNCP…", "targetDiplomaLevel": "3",
    "location": { "city": "Lyon", "region": "Auvergne-Rhône-Alpes" },
    "cfa": { "name": "CFA des métiers", "siret": "…" }
  }
}

ملف صاحب العمل حسب SIRET وقائمة بعروض التناوب المفتوحة الخاصة به.

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/companies/12345678901234"

مثال على الرد

{
  "company": {
    "siret": "12345678901234", "siren": "123456789", "name": "Maison Dupain",
    "size": "10 à 19 salariés", "nafCodes": ["1071C"],
    "location": { "city": "Lyon", "region": "Auvergne-Rhône-Alpes" },
    "openJobsCount": 3, "openJobs": [ … ]
  }
}

إحصائيات مُجمَّعة للمنصة (+ عدادات حسب المهنة).

المعاملات

مثال على الطلب

curl -H "Authorization: Bearer $TOKEN" \
  "https://www.superalternance.com/api/v1/stats?metier=boulanger"

مثال على الرد

{
  "jobs": 17658, "formations": 58596, "cfa": 6923,
  "lastSyncAt": "2026-06-04T21:01:06.369Z",
  "metier": { "name": "boulanger", "jobs": 42, "formations": 120, "diplomas": 8 }
}