Matching No OTP request success
Identification to the operator without user consent
The response is a JSON whose keys are defined below:
| Key | Description | Format |
| family_name | Result of the comparison on the last name | NUMBER |
| gender | Result of the comparison on civility | NUMBER |
| birthdate | Result of the comparison on the date of birth | NUMBER |
| given_name | Result of the comparison on the first name | NUMBER |
| address | Contains all the keys described in the following table | JSON OBJECT |
| Result of the comparison on the email address | NUMBER |
Elements of the “address” key :
| Key | Description | Format |
| country | Result of the comparison on the country | STRING(3) |
| postal_code | Result of the comparison on the postal code | STRING(3) |
| street_address | Result of the comparison on the street | STRING(3) |
| locality | Result of the comparison on the city | STRING(3) |
Response example for « matching_notp » scope:
{
"family_name": 1.0,
"gender": "",
"birthdate": 1.0,
"given_name": 1.0,
"address": {
"country": 1.0,
"postal_code": 0.78,
"street_address": 0.56,
"locality": 0.44
},
"email": 1.0
}
Identification to the operator with user consent
The response is a JSON whose keys are defined below:
| Key | Description | Format |
| status | « success » | STRING |
| operator | Operator | STRING |
| url | URL of the Operator API | STRING |
Response example:
{
"status": "success",
"operator": "Orange",
"url": "https://api.operator /openidconnect/fr"
}
Matching No OTP request error
The response is a JSON whose keys are defined below :
| Key | Description | Format |
| status | « error » | STRING |
| error_type | Error label: details in the following table | STRING |
| error_id | Error code: details in the following table | STRING(2) |
Error code details (error_id key) :
| error_id | error_type | Description |
| 01 | invalid request | The request is not valid |
| 02 | invalid licence key | The license is not valid |
| 04 | invalid scope | Invalid scope |
| 05 | missing or empty parameter (user_infos) for this scope | A parameter is missing for the scope called |
| 06 | bad parameter format (user_infos) is not a valid JSON | The "user_infos" parameter is not a valid json |
| 07 | missing mandatory key in user informations (phone) | The missing "phone" key in the "user_infos" parameter is mandatory for this operator [SFR]. |
| 09 | ineligible phone number | Number not eligible for the solution |
| 10 | invalid phone number | The phone number does not exist |
| 11 | phone number is empty | The phone number is empty |
| 12 | phone check failed | The operator verification did not work |
| 13 | operator [Operator Name] not found | The operator is not found |
| 14 | operator [Operator Name] not authorized for this licence | Your license is not open on this operator |
| 15 | operator [Operator Name] not supported yet | The solution is not yet available on the requested solution |
| 16 | operator [Operator Name] unreachable | Impossible to contact the operator |
| 17 | scope not supported by this operator [Operator Name] yet | This scope is not supported by the operator |
| 30 | invalid or expired token | The token has expired |
Response example :
{
"status": "error",
"error_type": "invalid phone number",
"error_id": "10"
}
Related to