Mon Espace 数据 API：津贴、月度申报与多领

France Travail · 招聘求职

Mon Espace France Travail 是 France Travail（原 Pôle emploi）面向已在公共就业服务登记的 demandeurs d'emploi 的官方申领人自助应用。通过 PEAM 登录——之后可用 PIN 或生物识别解锁——usager 提交月度 actualisation（工时、求职 démarches、病假或培训等特殊情形），查看 ARE、ASS 与 ACEJ 津贴金额，下载数字证明或申请邮寄副本，跟进 trop-perçus 还款与分期，预约本地机构的 conseiller rendez-vous，与顾问收件箱通信，并用手机相机上传证明材料。France Travail 位于巴黎 20 区 Docteur Gley 大街 1 号 Le Cinetic。Android 上这是全国官方的津贴与月度申报客户端，而不是职位板——那个姊妹角色由 Parcours Emploi 承担——它与 GOSI、VssID 等社会保险自助应用同属面向法国的国家津贴钱包。

ARE 津贴台账以 identifiant 作为已登录 usager 的键，携带 allocationMensuelle、montantJournalierNet、topEnCoursDIndemnisationAre 与 dateLimiteIndemnisation，递减启动后还有 allocationJournaliereTauxReduit，剩余权利记在 soldePrevisionnelReliquat。月度申报周期以 moisActualisation 与 actualisationPeriodStart 盖戳；申报工时落成 nbHeuresTravailles 与 salaireBrut；求职步骤保留 identifiantDemarche；特殊情形与 confidenceLevelCode 结束申报。多领以 identifiantTropPercu 债务出现，含 montantRestantDu 与可选的 nombreMensualites 扣款协议；即将到来的机构档期返回 idRdvUsager、dateHeureRdv 与 codeSafirAgence；顾问收件箱角标是 nombreNonLu。

薪酬与工会台账把申报工时对上 ARE 费率与最近一次 datePaiement；个案管理工具把下一次机构档期放在仍为 A_FAIRE 的周期旁边；债务追偿台只有在 montantRestantDu 仍有效时才提议扣款计划；证明打印机按 typeAttestation 拉取数字 PDF，而不再等邮寄。openData Studio 把这套申领人台账变成可调用的开放数据。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

PEAM OpenID 授权
GET /v1/auth/authorize osint
启动 PEAM OpenID 登录，得到随后换取 access_token 的授权码。
认证方式：无需登录的浏览器起步。查询参数为 client_id、redirect_uri（com.poleemploi.poleemploietmoi://）、response_type=code、scope（openid payments declarations profile overpayments）与 state。PEAM 把授权码回跳到应用。
- client_id
- redirect_uri
- response_type
- scope
- state
- code
```
GET /v1/auth/authorize?client_id=<client-id>&redirect_uri=com.poleemploi.poleemploietmoi%3A%2F%2F&response_type=code&scope=openid%20payments%20declarations%20profile%20overpayments&state=<state> HTTP/1.1
Accept: text/html
```
```
HTTP/1.1 302 Found
Location: com.poleemploi.poleemploietmoi://?code=<authorization-code>&state=<state>
```
用授权码换取 access token
POST /v1/auth/exchange osint
用 PEAM 授权码换取后续津贴、月度申报、付款与预约请求使用的 access_token。
认证方式：无需登录。请求体为 GET /v1/auth/authorize 得到的授权码。返回的 access_token 作为后续请求的 Authorization: Bearer。并列路径 /v1/auth/revoke 与 /v1/auth/logout 结束会话。
- grant_type
- code
- redirect_uri
- client_id
- access_token
- token_type
- expires_in
- scope
```
POST /v1/auth/exchange HTTP/1.1
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code&code=<authorization-code>&redirect_uri=com.poleemploi.poleemploietmoi%3A%2F%2F&client_id=<client-id>
```
```
{
  "access_token": "<access_token>",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "openid payments declarations profile overpayments"
}
```
民事状态个人档案
GET /v1/account/civil-status osint
返回已登录 usager 的民事状态记录，供账户抬头使用：identifiant、姓名、dateDeNaissance 与求职者类型。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。
- identifiant
- codeCivilite
- libelleCivilite
- prenom
- nomPatronymique
- nomMarital
- dateDeNaissance
- categorieIndividu
- userTypologyCode
- codeTypologie
```
GET /v1/account/civil-status HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "identifiant": "id-100442",
  "codeCivilite": "1",
  "libelleCivilite": "Madame",
  "prenom": "Camille",
  "nomPatronymique": "Martin",
  "nomMarital": "Dupont",
  "dateDeNaissance": "1990-04-12",
  "categorieIndividu": "1",
  "userTypologyCode": "DE",
  "codeTypologie": "DE"
}
```

受领人津贴状况

GET /v1/allocations/situation openfinance

返回现行 ARE/ASS/ACEJ 津贴状况：月额与日额、剩余权利与递减标志。

认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。

typeAllocation
topEnCoursDIndemnisationAre
statutIndemnisable
codeTypeIndemnisation
allocationMensuelle
allocationBruteJournaliere
allocationJournaliereTauxReduit
montantJournalierNet
dureeTheoriqueDroit
datePremierJourIndemnisable
dateLimiteIndemnisation
dateDecheanceDroitAre
estDroitSoumisDegressivite
dateBasculeTauxReduit
soldePrevisionnelReliquat

GET /v1/allocations/situation HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "typeAllocation": "ARE",
  "topEnCoursDIndemnisationAre": true,
  "statutIndemnisable": "INDEMNISABLE",
  "codeTypeIndemnisation": "ARE",
  "allocationMensuelle": 1260.40,
  "allocationBruteJournaliere": 42.01,
  "allocationJournaliereTauxReduit": 36.12,
  "montantJournalierNet": 38.50,
  "dureeTheoriqueDroit": 730,
  "datePremierJourIndemnisable": "2025-11-03",
  "dateLimiteIndemnisation": "2027-11-02",
  "dateDecheanceDroitAre": "2027-11-02",
  "estDroitSoumisDegressivite": true,
  "dateBasculeTauxReduit": "2026-05-03",
  "soldePrevisionnelReliquat": 18420.00
}

数字津贴证明
GET /v1/allocations/attestations/digital opendata
按 typeAttestation 签发 usager 从证明磁贴下载的数字 PDF。
认证方式： Authorization: Bearer <access_token>。查询参数 typeAttestation 选择 PDF（状况、付款）。并列 POST /v1/allocations/attestations/postal-copy 寄纸质副本。
- typeAttestation
- documentSummaries
- idDocument
- nomFichier
- codeTypeDocument
```
GET /v1/allocations/attestations/digital?typeAttestation=SITUATION HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/pdf
```
```
{
  "typeAttestation": "SITUATION",
  "documentSummaries": [
    {
      "idDocument": "att-8821",
      "nomFichier": "attestation-situation.pdf",
      "codeTypeDocument": "ATT_SIT"
    }
  ]
}
```
月度申报状态
GET /v1/declarations/monthly/status opendata
返回当前月度 actualisation 周期是否仍开放（A_FAIRE）或已 VALIDEE。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。主申报服务维护时由备用后端提供同一状态。
- moisActualisation
- actualisationPeriodStart
- periodEnd
- actuStatut
- dateValidationDeclaration
```
GET /v1/declarations/monthly/status HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "moisActualisation": "2026-09",
  "actualisationPeriodStart": "2026-09-01",
  "periodEnd": "2026-09-30",
  "actuStatut": "A_FAIRE",
  "dateValidationDeclaration": null
}
```
提交月度申报
POST /v1/declarations/monthly/submit opendata
提交月度 actualisation：申报工时与薪资、求职 démarches 与特殊情形，并盖上 dateValidationDeclaration。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。请求体为起草的申报（活动、démarches、特殊情形）。草稿行实时保存在 /v1/declarations/monthly/activities、/v1/declarations/monthly/job-search-steps 与 /v1/declarations/monthly/special-situations。
- moisActualisation
- activites
- nbHeuresTravailles
- nbHeuresTotales
- salaireBrut
- identifiantDemarche
- situationsParticulieres
- confidenceLevelCode
- actuStatut
- dateValidationDeclaration
```
POST /v1/declarations/monthly/submit HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "moisActualisation": "2026-09",
  "activites": [{"nbHeuresTravailles": 24, "nbHeuresTotales": 24, "salaireBrut": 720.00}],
  "identifiantDemarche": "d-9012",
  "situationsParticulieres": [],
  "confidenceLevelCode": "STANDARD"
}
```
```
{
  "moisActualisation": "2026-09",
  "actuStatut": "VALIDEE",
  "dateValidationDeclaration": "2026-10-05T08:12:00Z"
}
```
津贴付款数据
GET /v1/payments/latest openfinance
返回最近一笔津贴付款，拆分为 allocations、aides 与其他付款，并带 datePaiement。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。
- montantPaiement
- montantAllocations
- montantAides
- montantAutresPaiements
- datePaiement
```
GET /v1/payments/latest HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "montantPaiement": 1260.40,
  "montantAllocations": 1260.40,
  "montantAides": 0,
  "montantAutresPaiements": 0,
  "datePaiement": "2026-09-28"
}
```

多领债务

GET /v1/payments/overpayments openfinance

列出 usager 的 trop-perçu 多领债务，含剩余余额与是否允许远程付款。

认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。

tropPercus
identifiantTropPercu
codeTropPercu
montantInitial
montantRestantDu
dateNotif
motif
eligibleAuTelepaiement

GET /v1/payments/overpayments HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "tropPercus": [
    {
      "identifiantTropPercu": "tp-4412",
      "codeTropPercu": "INDUS_ARE",
      "montantInitial": 840.00,
      "montantRestantDu": 560.00,
      "dateNotif": "2026-07-14",
      "motif": "Activite non declaree",
      "eligibleAuTelepaiement": true
    }
  ]
}

多领还款协议
GET /v1/payments/repayment-plans openfinance
返回 trop-perçu 的已签或拟议还款计划，含分期数与首次直接扣款日。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 POST /v1/payments/repayment-plans/proposal 起草分期；协议与授权书 PDF 位于 /v1/payments/repayment-plans/documents。
- accordsRemboursement
- identifiantTropPercu
- nombreMensualites
- datePremierPrelevement
- urlSignature
```
GET /v1/payments/repayment-plans HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "accordsRemboursement": [
    {
      "identifiantTropPercu": "tp-4412",
      "nombreMensualites": 4,
      "datePremierPrelevement": "2026-11-05",
      "urlSignature": "<web-signing-url>"
    }
  ]
}
```

即将到来的用户预约

GET /v1/appointments/upcoming opendata

列出 usager 即将到来的顾问预约，含档期时间、联系方式与机构 SAFIR 代码。

认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 /v1/appointments/available-slots 列出可预约档期；/v1/appointments/contact-methods 列出联系方式。

idRdvUsager
idRdv
dateHeureRdv
typeRdv
modaliteContact
dureeRdv
codeSafirAgence
nomSite
adresse
codePostalAndVille
sujetId
methodeContactId

GET /v1/appointments/upcoming HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json

{
  "rendezVous": [
    {
      "idRdvUsager": "rdv-331",
      "idRdv": "rdv-331",
      "dateHeureRdv": "2026-10-14T09:30:00+02:00",
      "typeRdv": "SUIVI",
      "modaliteContact": "AGENCE",
      "dureeRdv": 30,
      "codeSafirAgence": "75022",
      "nomSite": "Paris 20e - Gley",
      "adresse": "1 avenue du Docteur Gley",
      "codePostalAndVille": "75020 Paris",
      "sujetId": "SUIVI",
      "methodeContactId": "AGENCE"
    }
  ]
}

未读顾问消息
GET /v1/messages/unread opendata
返回顾问收件箱角标（nombreNonLu）以及最近会话预览。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 GET /v1/messages/threads 分页会话；POST /v1/messages/mark-read 清除角标。
- nombreNonLu
- idConversation
- dateEnvoiMessage
- nomFichier
- taillePj
```
GET /v1/messages/unread HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "nombreNonLu": 2,
  "conversations": [
    {
      "idConversation": "c-9081",
      "dateEnvoiMessage": "2026-10-03T14:22:00Z",
      "nomFichier": "convocation.pdf",
      "taillePj": 184320
    }
  ]
}
```
附近 France Travail 机构
GET /v1/agencies/nearby opendata
返回地图/列表选择器用的附近机构，以 SAFIR 代码为键，含地址、地理坐标与开放预约数。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。可选地理查询；并列 /v1/places/resolve 把输入的地点字符串解析为坐标。
- agences
- codeSafir
- nomSite
- adresse
- codePostalAndVille
- telephone
- latitude
- longitude
- distance
- nbRdv
```
GET /v1/agencies/nearby?latitude=48.8648&longitude=2.3984 HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "agences": [
    {
      "codeSafir": "75022",
      "nomSite": "Paris 20e - Gley",
      "adresse": "1 avenue du Docteur Gley",
      "codePostalAndVille": "75020 Paris",
      "telephone": "3949",
      "latitude": 48.8648,
      "longitude": 2.3984,
      "distance": 1.2,
      "nbRdv": 3
    }
  ]
}
```
信箱 courrier 计数
GET /v1/mailbox/count opendata
返回 courrier 信箱角标（nombre）以及未读机构信件预览。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 GET /v1/mailbox/templates 与 GET /v1/mailbox/{id} 分页信箱。
- nombre
- mailSummaries
- mailId
- nomDocument
- dateEmission
- mailIsRead
- codeModele
```
GET /v1/mailbox/count HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "nombre": 4,
  "mailSummaries": [
    {
      "mailId": "c-4412",
      "nomDocument": "Convocation agence.pdf",
      "dateEmission": "2026-10-02T09:14:00Z",
      "mailIsRead": false,
      "codeModele": "CONVOC"
    }
  ]
}
```
用户联系坐标
GET /v1/account/contact-details osint
返回账户界面使用的已登录 usager 联系坐标：emailContact、telephoneContact 与邮箱核验状态。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 POST /v1/account/contact-details/email-verification 启动邮箱确认。
- emailContact
- telephoneContact
- adresseMail
- isEmailValid
- statutValidationEmail
- isUserContactInfoComplete
```
GET /v1/account/contact-details HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "emailContact": "[email protected]",
  "telephoneContact": "0612345678",
  "adresseMail": "[email protected]",
  "isEmailValid": true,
  "statutValidationEmail": "VALIDE",
  "isUserContactInfoComplete": true
}
```
材料提交上下文
GET /v1/documents/deposit-contexts opendata
列出 usager 可用相机扫描仪上传的 GED 提交上下文，以 codeContexteGed 与 codeSituationGed 为键。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。随后 POST /v1/documents/deposits/{id}/conversion 与 /v1/documents/deposits/{id}/confirm 完成相机上传。
- codeContexteGed
- codeSituationGed
- nomDocument
- codeTypeDocument
- nombreDocMax
```
GET /v1/documents/deposit-contexts HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "contextes": [
    {
      "codeContexteGed": "ACTU",
      "codeSituationGed": "ATT_SAL",
      "nomDocument": "Bulletin de salaire",
      "codeTypeDocument": "SALAIRE",
      "nombreDocMax": 4
    }
  ]
}
```
津贴申请 DAL 资格
GET /v1/allocations/requests/eligibility openfinance
返回 usager 是否可提交或续期 demande d'allocation（DAL）：资格代码、周年日期与同意戳。
认证方式： Authorization: Bearer <access_token>，来自 POST /v1/auth/exchange。并列 GET /v1/allocations/requests/tracking 跟踪已提交申请。
- codeEligibiliteDal
- typeEligibilite
- dateAnniversaireDal
- statutConsentement
- dateSaisieConsentement
- questionEligibilite
```
GET /v1/allocations/requests/eligibility HTTP/1.1
Authorization: Bearer <access_token>
Accept: application/json
```
```
{
  "codeEligibiliteDal": "ELIGIBLE",
  "typeEligibilite": "ARE",
  "dateAnniversaireDal": "2026-11-03",
  "statutConsentement": "ACCEPTE",
  "dateSaisieConsentement": "2026-10-01T08:22:00Z",
  "questionEligibilite": true
}
```

数据类别

身份
津贴
月度申报
证明
付款
多领
预约
消息
机构
登录会话
材料
联系方式

数据使用场景与案例

ARE 薪酬对账
薪酬或工会工具读取现行津贴状况（allocationMensuelle、montantJournalierNet、topEnCoursDIndemnisationAre、dateLimiteIndemnisation）与最近一笔付款（montantPaiement、datePaiement），以便把申报工资对上现行 ARE 费率与最近付款。
月度申报审计
个案管理台读取当前申报周期（moisActualisation、actuStatut）与已提交的申报（nbHeuresTravailles、salaireBrut、identifiantDemarche），以便辅导人员告诉 usager 某周期仍为 A_FAIRE 还是已 VALIDEE。
多领扣款协议台
债务追偿控制台列出多领债务（identifiantTropPercu、montantRestantDu、eligibleAuTelepaiement）与还款计划（nombreMensualites、datePremierPrelevement），只有存在有效余额时才提议分期。
顾问档期挨着收件箱
把即将到来的预约（idRdvUsager、dateHeureRdv、codeSafirAgence）与未读消息角标（nombreNonLu）以及附近机构目录（codeSafir、nomSite）相连，以便本地机构把下一次档期放在未读顾问邮件旁边。

常见问题

Mon Espace France Travail 如何认证 API 调用？

GET /v1/auth/authorize 启动 PEAM OpenID 登录（client_id 为应用客户端标识、redirect_uri com.poleemploi.poleemploietmoi://、scope openid payments declarations profile overpayments），授权码回跳到应用。POST /v1/auth/exchange 用授权码换取 access_token，之后的请求以该 access_token 发送 Authorization: Bearer。/v1/auth/revoke 与 /v1/auth/logout 结束会话。

哪些端点暴露 ARE 津贴与月度申报？

GET /v1/allocations/situation 返回 allocationMensuelle、montantJournalierNet、topEnCoursDIndemnisationAre 与 dateLimiteIndemnisation。GET /v1/declarations/monthly/status 返回 moisActualisation 与 actuStatut。POST /v1/declarations/monthly/submit 提交 nbHeuresTravailles、salaireBrut 与 identifiantDemarche。

多领与付款如何表示？

GET /v1/payments/latest 返回 montantPaiement、montantAllocations 与 datePaiement。GET /v1/payments/overpayments 列出 identifiantTropPercu、montantRestantDu 与 eligibleAuTelepaiement。GET /v1/payments/repayment-plans 携带 nombreMensualites 与 datePremierPrelevement。

API 能否看到顾问预约、消息与机构？

可以。GET /v1/appointments/upcoming 返回 idRdvUsager、dateHeureRdv 与 codeSafirAgence。GET /v1/messages/unread 是收件箱角标（nombreNonLu）。GET /v1/agencies/nearby 按 codeSafir 与 nomSite 列出附近机构。GET /v1/allocations/attestations/digital 按 typeAttestation 签发数字证明 PDF。

与 Mon Espace France Travail 相似的应用

Parcours Emploi — Parcours Emploi 是 France Travail 的官方职位板姊妹应用：职位搜索、简历投递与 candidature 跟踪；Mon Espace 则负责月度申报、ARE 与多领。
GOSI — GOSI 是沙特社会保险自助应用：工资证明、SANED 失业保险与津贴 IBAN 更新，与 Mon Espace 同属申领人钱包一类。
VssID — VssID 是越南社会保险的公民应用，覆盖社保手册、BHYT 卡与待遇制度，相当于 France Travail 津贴界面的社会保险对照。
InfoJobs - Job Search — InfoJobs 是 Adevinta 的西班牙招聘板：按省与远程筛选职位、用简历投递并跟踪申请。
Indeed Job Search — Indeed 是全球求职应用：关键词搜索、投递、申请状态与招聘方消息。
Job&Talent: Get work today — Job&Talent 在法国等市场作为私营派遣应用运营，与 Mon Espace 服务的公共就业地理重叠。
Pôle emploi — 旧品牌 Pôle emploi 仍出现在姊妹应用以及当前 France Travail 申领客户端使用的 PEAM 登录上。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Mon Espace 数据 API：津贴、月度申报与多领

应用截图

API 端点一览

PEAM OpenID 授权

用授权码换取 access token

民事状态个人档案

受领人津贴状况

数字津贴证明

月度申报状态

提交月度申报

津贴付款数据

多领债务

多领还款协议

即将到来的用户预约

未读顾问消息

附近 France Travail 机构

信箱 courrier 计数

用户联系坐标

材料提交上下文

津贴申请 DAL 资格

数据类别

数据使用场景与案例

ARE 薪酬对账

月度申报审计

多领扣款协议台

顾问档期挨着收件箱

常见问题

与 Mon Espace France Travail 相似的应用

更多招聘求职类应用

apna - Search Job, Vacancy App

Bumeran

Clickworker

Computrabajo Ofertas de Empleo

相关主题

需要集成这个 App 的数据 API？

Mon Espace 数据 API：津贴、月度申报与多领

应用截图

API 端点一览

PEAM OpenID 授权

用授权码换取 access token

民事状态个人档案

受领人津贴状况

数字津贴证明

月度申报状态

提交月度申报

津贴付款数据

多领债务

多领还款协议

即将到来的用户预约

未读顾问消息

附近 France Travail 机构

信箱 courrier 计数

用户联系坐标

材料提交上下文

津贴申请 DAL 资格

数据类别

数据使用场景与案例

ARE 薪酬对账

月度申报审计

多领扣款协议台

顾问档期挨着收件箱

常见问题

相关应用

与 Mon Espace France Travail 相似的应用

更多招聘求职类应用

apna - Search Job, Vacancy App

Bumeran

Clickworker

Computrabajo Ofertas de Empleo

相关主题

需要集成这个 App 的数据 API？