Skip to content

Commit 27ee3ea

Browse files
committed
Update GuidelinesGraph.md
1 parent 7b1557f commit 27ee3ea

File tree

1 file changed

+5
-4
lines changed

1 file changed

+5
-4
lines changed

graph/GuidelinesGraph.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -265,12 +265,11 @@ If possible, APIs SHOULD use resource-based designs with standard HTTP methods r
265265

266266
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.
267267

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)).
270269

271270
### Error handling
272271

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:
274273

275274
```http
276275
{
@@ -295,7 +294,7 @@ The top-level error code MUST match the HTTP response status code description, c
295294
"error": {
296295
"code": "badRequest",
297296
"message": "Cannot process the request because it is malformed or incorrect.",
298-
"target": "resource X (Optional)"
297+
"target": "resource X (Optional)"
299298
}
300299
}
301300
```
@@ -322,6 +321,8 @@ The top-level error code MUST match the HTTP response status code description, c
322321
| :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.|
323322
| :ballot_box_with_check: **SHOULD** return a 404 Not Found error if a 403 error would result in information disclosure. |
324323

324+
For additional guidance, see [Error condition responses article](Guidelines-deprecated.md#7102-error-condition-responses).
325+
325326
For a complete mapping of error codes to HTTP statuses, see
326327
[rfc7231 (ietf.org)](https://datatracker.ietf.org/doc/html/rfc7231#section-6).
327328

0 commit comments

Comments
 (0)