{"repo":"jaydenseric/graphql-multipart-request-spec","free":true,"listed":false,"github":"https://github.com/jaydenseric/graphql-multipart-request-spec","clone":"git clone https://github.com/jaydenseric/graphql-multipart-request-spec.git","description":"A spec for GraphQL multipart form requests (file uploads).","language":null,"stars":1053,"topics":["graphql","maintained"],"license":null,"category":"api-integrations-sdks","readme_excerpt":"GraphQL multipart request specification An interoperable multipart form field structure for GraphQL requests, used by various file upload client/server implementations. It’s possible to implement: - Nesting files anywhere within operations (usually in variables ). - Operation batching. - File deduplication. - File upload streams in resolvers. - Aborting file uploads in resolvers. Multipart form field structure An “operations object” is an Apollo GraphQL POST request (or array of requests if batching). An “operations path” is an object-path string to locate a file within an operations object. So operations can be resolved while the files are still uploading, the fields are ordered: 1. operations : A JSON encoded operations object with files replaced with null . 2. map : A JSON encoded map of where files occurred in the operations. For each file, the key is the file multipart form field name and the value is an array of operations paths. 3. File fields: Each file extracted from the operations object with a unique, arbitrary field name. Examples Single file Operations cURL request Request payload File list Operations cURL request Request payload Batching Operations cURL request Request payload Security GraphQL server authentication and security mechanisms are beyond the scope of this specification, which only covers a multipart form field structure for GraphQL requests. Note that a GraphQL multipart request has the Content-Type multipart/form-data ; if a browser making such a re","default_branch":null,"files":null,"tree":[],"storefront":"/r/jaydenseric","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/jaydenseric/graphql-multipart-request-spec/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}