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-4Lines changed: 5 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -265,12 +265,11 @@ If possible, APIs SHOULD use resource-based designs with standard HTTP methods r
265
265
266
266
Operation resources MUST have a binding parameter that matches the type of the bound resource. In addition, both actions and functions support overloading, meaning an API definition might contain multiple actions or functions with the same name.
267
267
268
-
For a complete list of standard HTTP operations, see the [Error condition responses](Guidelines-deprecated.md#7102-error-condition-responses).
269
-
268
+
For an additional list of standard HTTP methods, see the [RFC7230](https://www.rfc-editor.org/rfc/rfc9112)).
270
269
271
270
### Error handling
272
271
273
-
Microsoft REST API Guidelines provide guidelines that Microsoft Graph APIs SHOULD follow when returning error condition responses. You can improve API traceability and consistency by using the recommended Microsoft Graph error model and the Microsoft Graph utilities library to provide a standard implementation for your service:
272
+
You can improve API traceability and consistency by using the recommended Microsoft Graph error model and the Microsoft Graph utilities library to provide a standard implementation for your service:
274
273
275
274
```http
276
275
{
@@ -295,7 +294,7 @@ The top-level error code MUST match the HTTP response status code description, c
295
294
"error": {
296
295
"code": "badRequest",
297
296
"message": "Cannot process the request because it is malformed or incorrect.",
298
-
"target": "resource X (Optional)"
297
+
"target": "resource X (Optional)"
299
298
}
300
299
}
301
300
```
@@ -322,6 +321,8 @@ The top-level error code MUST match the HTTP response status code description, c
322
321
|: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.|
323
322
|:ballot_box_with_check:**SHOULD** return a 404 Not Found error if a 403 error would result in information disclosure. |
324
323
324
+
For additional guidance, see [Error condition responses article](Guidelines-deprecated.md#7102-error-condition-responses).
325
+
325
326
For a complete mapping of error codes to HTTP statuses, see
0 commit comments