Softy API

https://portail.softy.pro/docs
Admin
The Softy API defines a data flow model for integrating and exchanging job offer information,...
Tokens:3,109
Snippets:31
Trust Score:7.7
Update:9 months ago
Show doc for...
Tokens:
Raw
### Basic XML Job Feed Structure

Source: https://portail.softy.pro/docs/index

This is a basic example of the XML structure used for job postings. It includes essential fields like date, title, ID, contract type, and description. The CDATA sections are used to enclose text that may contain special characters.

```xml
<jobs>
  <job>
    <date>
      <![CDATA[ 2025-01-01 10:00:00 ]]> 
    </date>
    <title>
      <![CDATA[ Manager des Ventes - H/F ]]> 
    </title>
    <id>
      <![CDATA[ 123456 ]]> 
    </id>
    <contract_type>
      <![CDATA[ CDI ]]> 
    </contract_type>
    <work_hours>
      <![CDATA[ Temps plein ]]> 
    </work_hours>
    <description>
      <![CDATA[ Voici une description détaillée de l'offre ... ]]> 
    </description>
    <position>
      <![CDATA[ Description du rôle et des responsabilités ... ]]> 
    </position>
    <profile>
      <![CDATA[ Compétences et qualifications recherchées ... ]]> 
    </profile>
    <location>
      <![CDATA[ Paris ]]> 
    </location>
    <postcode>
      <![CDATA[ 75000 ]]> 
    </postcode>
    <department>
      <![CDATA[ Paris ]]> 
    </department>
    <region>
      <![CDATA[ Île-de-France ]]> 
    </region>
    <country>
      <![CDATA[ France ]]> 
    </country>
    <subsidiary>
      <![CDATA[ Filiale Exemple ]]> 
    </subsidiary>
    <url>
      <![CDATA[ https://exempleoffre123.com ]]> 
    </url>
    <salary>
      <![CDATA[ 40k - 50k par an ]]> 
    </salary>
    <salary_type>
      <![CDATA[ fixe ]]> 
    </salary_type>
    <rome>
      <![CDATA[ A1234 ]]> 
    </rome>
    <experience>
      <![CDATA[ Expérience souhaitée ]]> 
    </experience>
    <education>
      <![CDATA[ Bac +2 à Bac +4 ]]> 
    </education>
    <work_time>
      <![CDATA[ Temps plein ]]> 
    </work_time>
    <benefits>
      <![CDATA[ Mutuelle, Tickets restaurant ]]> 
    </benefits>
    <employment_date>
      <![CDATA[ Dès que possible ]]> 
    </employment_date>
    <driving_licence>
      <![CDATA[ Permis non obligatoire ]]> 
    </driving_licence>
    <long>
      <![CDATA[ 48.856613 ]]> 
    </long>
    <lat>
      <![CDATA[ 2.352222 ]]> 
    </lat>
  </job>
</jobs>
```

--------------------------------

### Job Posting API

Source: https://portail.softy.pro/docs/index

This section details the 'job' tag, which is the primary element for representing job postings in the Softy API. It outlines all the available sub-tags and their properties.

```APIDOC
## Jobs - Global Tag

### Description
This tag groups all individual job postings.

### Endpoint
`/websites/portail_softy_pro/jobs`

### Parameters
#### Query Parameters
- **None**

### Request Body
- **jobs** (array) - Contains a list of job objects.

### Response
#### Success Response (200)
- **jobs** (array) - An array of job objects.

#### Response Example
```json
{
  "jobs": [
    {
      "job": { ... } 
    }
  ]
}
```

## Job - Individual Job Posting

### Description
Represents a single job posting. Each 'job' tag corresponds to one offer posted.

### Method
GET (or POST depending on context, but described as a tag within a flux)

### Endpoint
`/websites/portail_softy_pro/jobs/{job_id}` (Conceptual, as it's described as part of a flux)

### Parameters
#### Path Parameters
- **job_id** (string) - Unique identifier for the job posting.

#### Query Parameters
- **None specified**

### Request Body
- **job** (object) - Contains details of a single job posting.

### Response
#### Success Response (200)
- **date** (string) - Publication date (YYYY-MM-DD HH:MM:SS).
- **title** (string) - Job title.
- **id** (string) - Unique job ID.
- **contract_type** (string) - Type of contract (e.g., CDI, CDD, Intérim).
- **work_hours** (string) - Working hours (e.g., Temps plein).
- **description** (string) - Company description.
- **position** (string) - Job position description.
- **profile** (string) - Required candidate profile.
- **location** (string) - City of the job.
- **postcode** (string) - Postal code of the city.
- **department** (string) - Department where the job is located.
- **region** (string) - Region where the job is located.
- **country** (string) - Country where the job is located.
- **subsidiary** (string) - Company subsidiary posting the offer.
- **url** (string) - Link to the job offer.
- **salary** (string) - Proposed salary for the position.
- **salary_type** (string) - Type of salary (fixe, variable, à définir).
- **rome** (string) - ROME code for the job.
- **experience** (string) - Required candidate experience level.
- **education** (string) - Minimum education level required.
- **work_time** (string) - Work schedule (temps plein/partiel).
- **benefits** (string) - Benefits offered by the company.
- **employment_date** (string) - Start date of employment.
- **driving_licence** (string) - Requirement for a driving license.
- **long** (string) - Longitude coordinate.
- **lat** (string) - Latitude coordinate.

#### Request Example (Conceptual XML structure from description)
```xml
<job>
  <date>YYYY-MM-DD HH:MM:SS</date>
  <title>Chef de Projet</title>
  <id>unique_job_id</id>
  <contract_type>CDI</contract_type>
  <work_hours>Temps plein</work_hours>
  <description>...</description>
  <position>...</position>
  <profile>...</profile>
  <location>Dijon</location>
  <postcode>21000</postcode>
  <department>Côte-d\'Or</department>
  <region>Bourgogne-Franche-Comté</region>
  <country>France</country>
  <subsidiary>Free mobile</subsidiary>
  <url>https://exempleoffre.com</url>
  <salary>40k - 50k par an</salary>
  <salary_type>fixe</salary_type>
  <rome>J1307</rome>
  <experience>Débutant accepté</experience>
  <education>Bac +2 à Bac +4</education>
  <work_time>Temps plein</work_time>
  <benefits>Mutuelle, Tickets restaurant</benefits>
  <employment_date>Dès que possible</employment_date>
  <driving_licence>Permis non obligatoire</driving_licence>
  <long>47.29239800</long>
  <lat>5.10099100</lat>
</job>
```

#### Response Example (Conceptual JSON structure)
```json
{
  "date": "2023-10-27 10:00:00",
  "title": "Chef de Projet",
  "id": "unique_job_id_123",
  "contract_type": "CDI",
  "work_hours": "Temps plein",
  "description": "... is an employment agency specialized in business expertise (temp, fixed-term, permanent).",
  "position": "Your missions: read the electrical network diagram, implement...",
  "profile": "You have good DIY skills, communication skills with a team...",
  "location": "Dijon",
  "postcode": "21000",
  "department": "Côte-d'Or",
  "region": "Bourgogne-Franche-Comté",
  "country": "France",
  "subsidiary": "Free mobile",
  "url": "https://exempleoffre.com",
  "salary": "40k - 50k per year",
  "salary_type": "fixe",
  "rome": "J1307",
  "experience": "Beginner accepted",
  "education": "Bac +2 to Bac +4",
  "work_time": "Full-time",
  "benefits": "Health insurance, Meal Vouchers",
  "employment_date": "As soon as possible",
  "driving_licence": "License not required",
  "long": "47.29239800",
  "lat": "5.10099100"
}
```
```
Tokens:
Raw