Skip to content

Commit

Permalink
Update OpenAPI 3.0 Specifications (#16)
Browse files Browse the repository at this point in the history
  • Loading branch information
@EtonDoze
EtonDoze authored Dec 21, 2023
2 parents 4ba4c10 + fce6edc commit d8cb008
Show file tree
Hide file tree
Showing 18 changed files with 4,944 additions and 2,188 deletions.
303 changes: 177 additions & 126 deletions openapi/billing_subscriptions_v1.json
View file

Large diffs are not rendered by default.

229 changes: 154 additions & 75 deletions openapi/catalogs_products_v1.json
View file

Large diffs are not rendered by default.

258 changes: 177 additions & 81 deletions openapi/checkout_orders_v1.json
View file

Large diffs are not rendered by default.

356 changes: 256 additions & 100 deletions openapi/checkout_orders_v2.json
View file

Large diffs are not rendered by default.

666 changes: 380 additions & 286 deletions openapi/customer_disputes_v1.json
View file

Large diffs are not rendered by default.

942 changes: 857 additions & 85 deletions openapi/customer_partner_referrals_v1.json
View file

Large diffs are not rendered by default.

219 changes: 150 additions & 69 deletions openapi/customer_partner_referrals_v2.json
View file

Large diffs are not rendered by default.

473 changes: 374 additions & 99 deletions openapi/invoicing_v1.json
View file

Large diffs are not rendered by default.

254 changes: 167 additions & 87 deletions openapi/invoicing_v2.json
View file

Large diffs are not rendered by default.

522 changes: 366 additions & 156 deletions openapi/notifications_webhooks_v1.json
View file

Large diffs are not rendered by default.

397 changes: 253 additions & 144 deletions openapi/payment-experience_web_experience_profiles_v1.json
View file

Large diffs are not rendered by default.

549 changes: 370 additions & 179 deletions openapi/payments_payment_v1.json
View file

Large diffs are not rendered by default.

283 changes: 178 additions & 105 deletions openapi/payments_payment_v2.json
View file

Large diffs are not rendered by default.

771 changes: 558 additions & 213 deletions openapi/payments_payouts_batch_v1.json
View file

Large diffs are not rendered by default.

210 changes: 145 additions & 65 deletions openapi/reporting_transactions_v1.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -427,10 +427,52 @@
}
]
},
"error_link_description": {
"title": "Link Description",
"description": "The request-related [HATEOAS link](/api/rest/responses/#hateoas-links) information.",
"type": "object",
"required": [
"href",
"rel"
],
"properties": {
"href": {
"description": "The complete target URL. To make the related call, combine the method with this [URI Template-formatted](https://tools.ietf.org/html/rfc6570) link. For pre-processing, include the `$`, `(`, and `)` characters. The `href` is the key HATEOAS component that links a completed call with a subsequent call.",
"type": "string",
"minLength": 0,
"maxLength": 20000,
"pattern": "^.*$"
},
"rel": {
"description": "The [link relation type](https://tools.ietf.org/html/rfc5988#section-4), which serves as an ID for a link that unambiguously describes the semantics of the link. See [Link Relations](https://www.iana.org/assignments/link-relations/link-relations.xhtml).",
"type": "string",
"minLength": 0,
"maxLength": 100,
"pattern": "^.*$"
},
"method": {
"description": "The HTTP method required to make the related call.",
"type": "string",
"minLength": 3,
"maxLength": 7,
"pattern": "^[A-Z]*$",
"enum": [
"CONNECT",
"DELETE",
"GET",
"HEAD",
"OPTIONS",
"PATCH",
"POST",
"PUT"
]
}
}
},
"error_400": {
"type": "object",
"title": "400 Error",
"description": "Error response for 400",
"title": "Bad Request Error",
"description": "Request is not well-formed, syntactically incorrect, or violates schema.",
"properties": {
"name": {
"type": "string",
Expand All @@ -444,7 +486,7 @@
"Request is not well-formed, syntactically incorrect, or violates schema."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -454,17 +496,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_401": {
"type": "object",
"title": "401 Error",
"description": "Error response for 401",
"title": "Unauthorized Error",
"description": "Authentication failed due to missing Authorization header, or invalid authentication credentials.",
"properties": {
"name": {
"type": "string",
Expand All @@ -478,7 +524,7 @@
"Authentication failed due to missing authorization header, or invalid authentication credentials."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -488,17 +534,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_403": {
"type": "object",
"title": "403 Error",
"description": "Error response for 403",
"title": "Not Authorized Error",
"description": "The client is not authorized to access this resource, although it may have valid credentials. ",
"properties": {
"name": {
"type": "string",
Expand All @@ -512,7 +562,7 @@
"Authorization failed due to insufficient permissions."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -522,17 +572,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_404": {
"type": "object",
"title": "404 Error",
"description": "Error response for 404",
"title": "Not found Error",
"description": "The server has not found anything matching the request URI. This either means that the URI is incorrect or the resource is not available.",
"properties": {
"name": {
"type": "string",
Expand All @@ -546,7 +600,7 @@
"The specified resource does not exist."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -556,17 +610,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_409": {
"type": "object",
"title": "409 Error",
"description": "Error response for 409",
"title": "Resource Conflict Error",
"description": "The server has detected a conflict while processing this request.",
"properties": {
"name": {
"type": "string",
Expand All @@ -580,7 +638,7 @@
"The server has detected a conflict while processing this request."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -590,17 +648,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_415": {
"type": "object",
"title": "409 Error",
"description": "Error response for 415",
"title": "Unsupported Media Type Error",
"description": "The server does not support the request payload's media type.",
"properties": {
"name": {
"type": "string",
Expand All @@ -614,7 +676,7 @@
"The server does not support the request payload's media type."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -624,17 +686,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_422": {
"type": "object",
"title": "422 Error",
"description": "Error response for 422",
"title": "Unprocessable Entity Error",
"description": "The requested action cannot be performed and may require interaction with APIs or processes outside of the current request. This is distinct from a 500 response in that there are no systemic problems limiting the API from performing the request.",
"properties": {
"name": {
"type": "string",
Expand All @@ -648,7 +714,7 @@
"The requested action could not be performed, semantically incorrect, or failed business validation."
]
},
"issues": {
"details": {
"type": "array",
"items": {
"$ref": "#/components/schemas/error_details"
Expand All @@ -658,17 +724,21 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
}
},
"error_500": {
"type": "object",
"title": "500 Error",
"description": "Error response for 500",
"title": "Internal Server Error",
"description": "This is either a system or application error, and generally indicates that although the client appeared to provide a correct request, something unexpected has gone wrong on the server.",
"properties": {
"name": {
"type": "string",
Expand All @@ -686,26 +756,32 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"enum": [
"https://developer.paypal.com/api/orders/v2/#error-INTERNAL_SERVER_ERROR"
],
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
},
"example": {
"name": "INTERNAL_SERVER_ERROR",
"message": "An internal server error occurred.",
"debug_id": "90957fca61718",
"information_link": "https://developer.paypal.com/api/orders/v2/#error-INTERNAL_SERVER_ERROR"
"links": [
{
"href": "https://developer.paypal.com/api/orders/v2/#error-INTERNAL_SERVER_ERROR",
"rel": "information_link"
}
]
}
},
"error_503": {
"type": "object",
"title": "503 Error",
"description": "Error response for 503",
"title": "Service Unavailable Error",
"description": "The server is temporarily unable to handle the request, for example, because of planned maintenance or downtime.",
"properties": {
"name": {
"type": "string",
Expand All @@ -723,10 +799,14 @@
"type": "string",
"description": "The PayPal internal ID. Used for correlation purposes."
},
"information_link": {
"type": "string",
"description": "The information link, or URI, that shows detailed information about this error for the developer.",
"readOnly": true
"links": {
"description": "An array of request-related [HATEOAS links](https://en.wikipedia.org/wiki/HATEOAS).",
"type": "array",
"minItems": 0,
"maxItems": 10000,
"items": {
"$ref": "#/components/schemas/error_link_description"
}
}
},
"example": {
Expand Down
Loading

0 comments on commit d8cb008

Please sign in to comment.