Overview
The Xcode Server API Reference is the underlying interface for Xcode Server.
HTTPS Only
Use HTTPS to make all Xcode Server requests.
UTF-8 Encoding
Every string passed to and from the Xcode Server API needs to be UTF-8 encoded.
Error Handling
Errors are returned using standard HTTP error code syntax. Any additional info is included in the body of the response, JSON-formatted:
{
"status": 401,
"message": "Unauthorized: invalid credentials"
}
List of supported error codes:
400: Bad Request
401: Unauthorized
403: Forbidden
404: Not Found
409: Conflict
410: Gone
500: Internal Server Error
501: Not Implemented
502: Bad Gateway
503: Service Unavailable
523: Service is not Enabled
530: Client unsupported.
531: ACL expansion not yet completed.
532: Service maintenance task active
Versioning
The version is set in the header using X-XCSAPIVersion
. If you omit this property, Xcode Server assumes the latest version.
Request Headers
All Xcode Server responses contain the version number of the API that the server supports. The version number is set in the response header using X-XCSAPIVersion
.
Schema
The section contains detailed information about the contents and meaning of the various payload structures used in Xcode Server requests and responses.
Document ID and Revision
Xcode Server stores the data in documents. Each document in CouchDB has at least two properties: _id
and _rev
.
_id
is a unique identifier that makes the document unique._rev
is a value that changes every time the document is modified.
Copyright © 2018 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2016-03-21