> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md).

# Publiceren en depubliceren

Een vacature op de openbare vacaturepagina zetten, er weer afhalen en de publicatiestatus opvragen.

Een nieuwe vacature is nog niet zichtbaar voor de buitenwereld. Door te publiceren zet je hem op de openbare vacaturepagina, zodat kandidaten zich kunnen inschrijven. Met depubliceren haal je hem er weer af.

| Wat                           | Aanroep                                          | Vereist recht             |
| ----------------------------- | ------------------------------------------------ | ------------------------- |
| Publiceren                    | `POST /recruiter/vacancies/{id}/publish`         | Alle vacatures publiceren |
| Depubliceren                  | `POST /recruiter/vacancies/{id}/unpublish`       | Alle vacatures publiceren |
| Status van één vacature       | `GET /recruiter/vacancies/{id}/publish-settings` | Alle vacatures inzien     |
| Status van meerdere vacatures | `POST /recruiter/vacancies/publish-settings`     | Alle vacatures inzien     |

## Publiceren

* **Aanroep:** `POST /recruiter/vacancies/{id}/publish`
* **Vereist recht:** Alle vacatures publiceren
* **Verplicht:** `id` in de URL, het `_id` van de vacature
* **Optioneel:** niets

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f/publish" \
  -H "Authorization: Bearer JOUW_TOKEN"
```

### Wat je terugkrijgt

De code van de openbare vacaturepagina, als tekst tussen aanhalingstekens:

```json
"eyJDb2RlIjoiSzdRMk05WDRUQiIsIkVudiI6InZvb3JiZWVsZHpvcmcifQ=="
```

Met deze code stel je de openbare link samen: `https://mijn.cootje.com/inschrijven/` gevolgd door de code. Op die pagina leest een kandidaat de vacature en schrijft hij zich in.

### Goed om te weten

* De publicatie stopt vanzelf op het moment van `closureDateTime`. Publiceer je de vacature daarna opnieuw, dan krijg je een nieuwe code.
* Een vacature die al gepubliceerd is, kun je niet nog een keer publiceren. De aanroep geeft dan een foutmelding.
* Cootje verstuurt bij het publiceren geen e-mails.
* De gepubliceerde vacature verschijnt ook in de [iFrame](https://docs.cootje.com/cootje-api/recruitment/vacatures/iframe.md) voor je eigen website.

## Depubliceren

* **Aanroep:** `POST /recruiter/vacancies/{id}/unpublish`
* **Vereist recht:** Alle vacatures publiceren
* **Verplicht:** `id` in de URL, het `_id` van de vacature
* **Optioneel:** niets

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f/unpublish" \
  -H "Authorization: Bearer JOUW_TOKEN"
```

### Wat je terugkrijgt

Niets: het antwoord heeft geen inhoud.

### Goed om te weten

* De openbare link werkt niet meer en er komen geen nieuwe inschrijvingen binnen.
* Bestaande inschrijvingen blijven bewaard.
* Publiceer je de vacature later opnieuw, dan krijgt hij dezelfde code en werkt de oude link weer.
* Markeer je een vacature als vervuld met `POST /recruiter/vacancies/{id}/complete`, dan wordt hij ook gedepubliceerd.

## Status van één vacature

* **Aanroep:** `GET /recruiter/vacancies/{id}/publish-settings`
* **Vereist recht:** Alle vacatures inzien
* **Verplicht:** `id` in de URL, het `_id` van de vacature
* **Optioneel:** niets

```bash
curl "https://mijn.cootje.com/api/recruiter/vacancies/c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f/publish-settings" \
  -H "Authorization: Bearer JOUW_TOKEN"
```

### Wat je terugkrijgt

Een lijst, ook al vraag je één vacature op. De lijst bevat één regel voor een vacature die gepubliceerd is of is geweest:

```json
[
  {
    "_id": "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
    "published": 1,
    "code": "eyJDb2RlIjoiSzdRMk05WDRUQiIsIkVudiI6InZvb3JiZWVsZHpvcmcifQ=="
  }
]
```

* `_id` is het kenmerk van de vacature.
* `published` is `1` (gepubliceerd) of `2` (niet gepubliceerd).
* `code` is de code van de openbare vacaturepagina.

Is de vacature nooit gepubliceerd, of is de publicatie verlopen op `closureDateTime`, dan is de lijst leeg:

```json
[]
```

## Status van meerdere vacatures

* **Aanroep:** `POST /recruiter/vacancies/publish-settings`
* **Vereist recht:** Alle vacatures inzien
* **Verplicht:** een lijst met `_id`'s van vacatures als inhoud van het verzoek
* **Optioneel:** niets

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/publish-settings" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
    "a7b8c9d0-2e3f-4a5b-9c6d-7e8f9a0b1c2d"
  ]'
```

### Wat je terugkrijgt

Eén regel per vacature die gepubliceerd is of is geweest. Vacatures zonder publicatie ontbreken in de lijst:

```json
[
  {
    "_id": "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
    "published": 1,
    "code": "eyJDb2RlIjoiSzdRMk05WDRUQiIsIkVudiI6InZvb3JiZWVsZHpvcmcifQ=="
  },
  {
    "_id": "a7b8c9d0-2e3f-4a5b-9c6d-7e8f9a0b1c2d",
    "published": 2,
    "code": "eyJDb2RlIjoiUjNXOEg1TjFaUCIsIkVudiI6InZvb3JiZWVsZHpvcmcifQ=="
  }
]
```

## Antwoorden

| Code  | Betekenis                                                     |
| ----- | ------------------------------------------------------------- |
| `200` | Bij publiceren: de code. Bij status opvragen: de lijst        |
| `204` | De vacature is gedepubliceerd. Het antwoord heeft geen inhoud |
| `401` | Geen geldig token, of het account mist het recht              |

Een `_id` dat niet bestaat, geeft bij publiceren en depubliceren een foutmelding.
