You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: graph/GuidelinesGraph.md
+5-7Lines changed: 5 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -269,7 +269,7 @@ For an additional list of standard HTTP methods, see the [RFC7230](https://www.r
269
269
270
270
### Error handling
271
271
272
-
To improve API traceability and consistency you MUST use the recommended Microsoft Graph error model and the Microsoft Graph utilities library to provide a standard implementation for your service:
272
+
To improve API traceability and consistency you MUST use the recommended Microsoft Graph error model and the Microsoft Graph utilities library to provide a standard implementation for your service. The value for the "message" name/value pair MUST be a human-readable representation of the error, tailored to provide enough information for the developer to understand the error and take appropriate action. The message is intended only as an aid to developers and should not be exposed to end users.
273
273
274
274
```http
275
275
{
@@ -278,8 +278,7 @@ For an additional list of standard HTTP methods, see the [RFC7230](https://www.r
278
278
"message": "Cannot process the request because a required field is missing.",
279
279
"target": "query",
280
280
"innererror":{
281
-
"code": "requiredFieldMissing",
282
-
"message": "A required field is missing.",
281
+
"code": "requiredFieldMissing"
283
282
}
284
283
}
285
284
```
@@ -304,10 +303,9 @@ The top-level error code MUST match the HTTP response status code description, c
304
303
{
305
304
"error": {
306
305
"code": "badRequest",
307
-
"message": "Cannot process the request because it is malformed or incorrect.",
306
+
"message": "Cannot process the request because a required field is missing.",
308
307
"innererror": {
309
-
"code": "requiredFieldOrParameterMissing",
310
-
"message": "A required field or parameter is missing.",
308
+
"code": "requiredFieldOrParameterMissing"
311
309
}
312
310
}
313
311
}
@@ -320,7 +318,7 @@ The top-level error code MUST match the HTTP response status code description, c
320
318
|:heavy_check_mark:**MUST** return a 429 Too Many Requests error when the client exceeded throttling limits, and a 503 Service Unavailable error when the service overloaded but the client is within throttling limits.|
321
319
|:ballot_box_with_check:**SHOULD** return a 404 Not Found error if a 403 error would result in information disclosure. |
322
320
323
-
For additional guidance, see [Error condition responses article](./articles/errorResponses.md).
321
+
For more detailed guidance, see the article on [Error condition responses](./articles/errorResponses.md).
324
322
325
323
For a complete mapping of error codes to HTTP statuses, see
0 commit comments