# शेष राशि से खरीद `POST /account/api/v1/orders/create` ## प्राधिकरण `Authorization: Bearer YOUR_ARNPROXY_API_KEY` `Accept: application/json` आवश्यक अनुमति: `purchases` `Content-Type: application/json` `Idempotency-Key` · 16–100 अक्षर, अंक, _ या -। एक ही कार्रवाई के लिए मान सहेजकर दोबारा उपयोग करें। ## पैरामीटर | नाम | प्रकार | आवश्यक / सशर्त | डिफ़ॉल्ट | विवरण | |---|---|---|---|---| | `Idempotency-Key` (header) | string | आवश्यक | — | 16–100 अक्षर/अंक/_/-। कार्रवाई और स्थिति में समान मान रखें; अलग बॉडी में पुनः उपयोग न करें। | | `product_id` (body) | integer | आवश्यक | — | products से उत्पाद ID; 1–2147483647। | | `lines` (body) | object[] | आवश्यक | — | एक उत्पाद के 1–20 अलग स्थान। location_id दोहराएँ नहीं; कुल अधिकतम 100000 प्रॉक्सी। | | `lines[].location_id` (body) | integer | आवश्यक | — | चुने उत्पाद कैटलॉग की स्थान ID। | | `lines[].time_id` (body) | integer | आवश्यक | — | उस स्थान पर उपलब्ध अवधि ID। | | `lines[].quantity` (body) | integer | आवश्यक | — | 1–100000; product.minimum_quantity भी लागू। | | `lines[].purpose_id` (body) | integer | आवश्यक | — | वर्तमान उपयोग-उद्देश्य प्रवाह के लिए 201 भेजें। | | `lines[].subpurpose_id` (body) | integer | आवश्यक | — | 201 का सक्रिय उप-उद्देश्य; अन्य के लिए -1। | | `lines[].other_purpose` (body) | string | सशर्त | — | subpurpose_id=-1 पर आवश्यक: 1–30 UTF-8 अक्षर; अन्यथा अनदेखा। | | `currency` (body) | string | आवश्यक | — | उसी कोट का TRY या USD; खाते की मुद्रा से मेल खाना चाहिए। | | `expected_total_minor` (body) | integer | आवश्यक | — | उसी कोट का total_minor पूर्णांक में, दशमलव राशि या पाठ नहीं। 1–999999999999। | | `terms` (body) | boolean | आवश्यक | — | स्पष्ट स्वीकृति के लिए JSON बूलियन true चाहिए, "true" स्ट्रिंग नहीं। | | `promo_code` (body) | string | वैकल्पिक | `""` | वैकल्पिक प्रमोशन, अधिकतम 100 बाइट। कोट और खरीद/नवीनीकरण में समान रखें। | | `auth` (body) | object | वैकल्पिक | — | डिलीवरी प्रमाणीकरण; डिफ़ॉल्ट {"mode":"username_password"}। मुख्य क्रेडेंशियल प्रबंधन की अनुमति नहीं देता। | | `auth.mode` (body) | string | सशर्त | — | auth भेजने पर आवश्यक: username_password या ip। यहाँ उपयोगकर्ता/पासवर्ड न दें। | | `auth.ip` (body) | string | सशर्त | — | IPv4 केवल auth.mode=ip पर आवश्यक; username_password में न दें। | ## अनुरोध का मुख्य भाग YOUR_/FROM_ को संबंधित कैटलॉग, कोट या दायरे के मान से बदलें। उदाहरणों में सहमति false है; वास्तविक कार्रवाई केवल जानबूझकर मंज़ूर करें। ```json { "product_id": "FROM_PRODUCTS", "lines": [ { "location_id": "FROM_CATALOG", "time_id": "FROM_CATALOG", "quantity": 1, "purpose_id": 201, "subpurpose_id": "FROM_CATALOG_CHILDREN" } ], "currency": "FROM_QUOTE", "expected_total_minor": "FROM_QUOTE_TOTAL_MINOR", "promo_code": "", "terms": false } ``` ## अतिरिक्त उपयोग उदाहरण ID और कीमतें उदाहरण मात्र हैं; कैटलॉग और उसी कोट के वास्तविक मान उपयोग करें। JSON ID और expected_total_minor संख्याएँ हों। सुरक्षा के लिए उदाहरणों में terms=false है; वास्तविक भुगतान वाले कार्य के लिए ग्राहक की स्पष्ट सहमति के बाद ही terms=true भेजें। ### एक उत्पाद प्रकार, दो देश एक product_id में अधिकतम 20 अलग location_id हो सकते हैं। हर देश की अलग ऑर्डर प्रविष्टि बनती है; जुड़ा हुआ चेकआउट एक इनवॉइस में संसाधित होता है। मात्रा छूट हर देश की अपनी मात्रा पर लगती है। ```json { "product_id": 5, "lines": [ { "location_id": 10, "time_id": 101, "quantity": 1, "purpose_id": 201, "subpurpose_id": 202 }, { "location_id": 11, "time_id": 102, "quantity": 1, "purpose_id": 201, "subpurpose_id": 202 } ], "currency": "TRY", "expected_total_minor": 2000, "promo_code": "", "terms": false } ``` ### “अन्य” उपयोग उद्देश्य अन्य चुनने पर subpurpose_id=-1 और 1–30 अक्षरों का other_purpose भेजें। दूसरे विकल्पों में other_purpose आवश्यक नहीं है। purpose_id फिर भी 201 रहता है। ```json { "product_id": 5, "lines": [ { "location_id": 10, "time_id": 101, "quantity": 1, "purpose_id": 201, "subpurpose_id": -1, "other_purpose": "Custom purpose" } ], "currency": "TRY", "expected_total_minor": 1000, "promo_code": "", "terms": false } ``` ## अनुरोध उदाहरण ### curl ```curl printf 'Authorization: Bearer %s\n' "$ARNPROXY_API_KEY" | curl --silent --show-error --header @- \ --header 'Accept: application/json' \ --connect-timeout 10 --max-time 30 \ --header 'Idempotency-Key: YOUR_SAVED_OPERATION_KEY' \ --request POST --header 'Content-Type: application/json' \ --data-binary @request.json \ 'https://www.arnproxy.com/account/api/v1/orders/create' ``` ### python ```python import os, requests headers = {"Authorization": "Bearer " + os.environ["ARNPROXY_API_KEY"]} headers["Idempotency-Key"] = "YOUR_SAVED_OPERATION_KEY" import json with open("request.json", encoding="utf-8") as f: payload = json.load(f) response = requests.post( "https://www.arnproxy.com/account/api/v1/orders/create", headers=headers, json=payload, timeout=(10, 30), allow_redirects=False ) print(response.status_code, response.text) # No automatic write retry. ``` ### javascript ```javascript const headers = { Authorization: `Bearer ${process.env.ARNPROXY_API_KEY}` }; headers['Idempotency-Key'] = 'YOUR_SAVED_OPERATION_KEY'; const { readFile } = await import('node:fs/promises'); headers['Content-Type'] = 'application/json'; const body = await readFile('request.json', 'utf8'); const response = await fetch("https://www.arnproxy.com/account/api/v1/orders/create", { method: 'POST', headers, redirect: 'error', signal: AbortSignal.timeout(30000), body }); console.log(response.status, await response.text()); // A write timeout is ambiguous; query its saved operation. ``` ### php ```php true, CURLOPT_HTTPHEADER => $headers, CURLOPT_FOLLOWLOCATION => false, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2, CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 30, CURLOPT_POST => true, CURLOPT_POSTFIELDS => file_get_contents('request.json'), ]); $result = curl_exec($ch); if ($result === false) { // Do not repeat a write; use the original operation key. throw new RuntimeException('Transport result unknown'); } echo curl_getinfo($ch, CURLINFO_HTTP_CODE).PHP_EOL.$result; curl_close($ch); ``` ### go ```go package main import ( "fmt" "io" "net/http" "os" "time" ) func main() { client := &http.Client{Timeout: 30*time.Second, CheckRedirect: func(req *http.Request, via []*http.Request) error { return http.ErrUseLastResponse }} var body io.Reader file, err := os.Open("request.json"); if err != nil { panic(err) } defer file.Close(); body = file req, err := http.NewRequest("POST", "https://www.arnproxy.com/account/api/v1/orders/create", body) if err != nil { panic(err) } req.Header.Set("Authorization", "Bearer "+os.Getenv("ARNPROXY_API_KEY")) req.Header.Set("Idempotency-Key", "YOUR_SAVED_OPERATION_KEY") req.Header.Set("Content-Type", "application/json") res, err := client.Do(req); if err != nil { panic(err) } defer res.Body.Close() data, err := io.ReadAll(res.Body); if err != nil { panic(err) } fmt.Println(res.StatusCode, string(data)) } ``` ### csharp ```csharp using System; using System.IO; using System.Net.Http; using System.Net.Http.Headers; using System.Text; using var handler = new HttpClientHandler { AllowAutoRedirect = false }; using var client = new HttpClient(handler) { Timeout = TimeSpan.FromSeconds(30) }; using var request = new HttpRequestMessage(HttpMethod.Post, "https://www.arnproxy.com/account/api/v1/orders/create"); request.Headers.Authorization = new AuthenticationHeaderValue( "Bearer", Environment.GetEnvironmentVariable("ARNPROXY_API_KEY")); request.Headers.Add("Idempotency-Key", "YOUR_SAVED_OPERATION_KEY"); request.Content = new StringContent( await File.ReadAllTextAsync("request.json"), Encoding.UTF8, "application/json"); using var response = await client.SendAsync(request); Console.WriteLine((int)response.StatusCode); Console.WriteLine(await response.Content.ReadAsStringAsync()); // Never automatically retry an ambiguous write. ``` ### java ```java import java.net.URI; import java.net.http.*; import java.nio.charset.StandardCharsets; import java.nio.file.*; // Inside your application method: var client = HttpClient.newHttpClient(); var request = HttpRequest.newBuilder(URI.create("https://www.arnproxy.com/account/api/v1/orders/create")) .header("Authorization", "Bearer " + System.getenv("ARNPROXY_API_KEY")) .header("Accept", "application/json") .header("Idempotency-Key", System.getenv("ARNPROXY_OPERATION_KEY")) .header("Content-Type", "application/json") .POST(HttpRequest.BodyPublishers.ofString( Files.readString(Path.of("request.json"), StandardCharsets.UTF_8))) .build(); var response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.statusCode()); ``` ## उत्तर · HTTP 201, 200 ```json { "ok": true, "data": { "state": "accepted", "delivery_state_at_acceptance": "queued", "currency": "TRY", "total": "10.00", "total_minor": 1000, "checkout_group_id": null, "orders": [ { "id": 10001, "number": "1000010001", "location_id": 10, "time_id": 101, "quantity": 1, "total": "10.00" } ], "accepted_at": "2030-01-01T12:00:00+00:00", "automatic_renewal": false, "replayed": false }, "meta": { "request_id": "000000000000000000000001", "phase": "public_v1", "source": "arnproxy_records" } } ``` | नाम | प्रकार | सशर्त | विवरण | |---|---|---|---| | `ok` | boolean | — | सफलता संकेत; false पर error.code देखें। | | `data` | object | — | कार्रवाई-विशिष्ट परिणाम; उदाहरण कृत्रिम और समझाने के लिए हैं। | | `data.state` | string | — | रिकॉर्ड/कार्रवाई स्थिति। accepted डिलीवरी नहीं; completed कनेक्शन परीक्षण नहीं। | | `data.delivery_state_at_acceptance` | string | — | delivery state at acceptance का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `data.currency` | string | — | खाते की लेनदेन मुद्रा: TRY या USD। | | `data.total` | string | — | धनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें। | | `data.total_minor` | integer | — | लघुतम मुद्रा इकाई में पूर्णांक: 1000 = 10.00 TRY/USD। | | `data.checkout_group_id` | integer|null | — | checkout group id का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `data.orders` | array | — | orders का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `data.orders[]` | object | — | orders का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `data.orders[].id` | integer | — | संबंधित ARNPROXY रिकॉर्ड ID; आंतरिक प्रदाता ID के बदले इसे लें। | | `data.orders[].number` | string | — | दिखने वाला ऑर्डर नंबर; id माँगने वाले फ़ील्ड में नहीं। | | `data.orders[].location_id` | integer | — | स्थानीय कैटलॉग स्थान या उत्पाद प्रकार ID। | | `data.orders[].time_id` | integer | — | स्थानीय अवधि/GB प्लान ID, दिनों या GB की गिनती नहीं। | | `data.orders[].quantity` | integer | — | चुने या ऑर्डर किए प्रॉक्सी की संख्या। | | `data.orders[].total` | string | — | धनराशि; शुद्धता के लिए लौटाया पाठ/पूर्णांक प्रारूप बनाए रखें। | | `data.accepted_at` | string | — | API के लौटाए प्रारूप में समय; उदाहरण की तारीखें कृत्रिम हैं। | | `data.automatic_renewal` | boolean | — | automatic renewal का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `data.replayed` | boolean | — | उसी कार्रवाई का सहेजा परिणाम लौटा, नए शुल्क/कार्रवाई का प्रमाण नहीं। | | `meta` | object | — | अनुरोध संबद्धता और डेटा-स्रोत मेटाडेटा। | | `meta.request_id` | string | — | इस HTTP अनुरोध की पहचान; कार्रवाई कुंजी या ऑर्डर ID नहीं। | | `meta.phase` | string | — | phase का कार्रवाई-विशिष्ट मान। लौटाया प्रकार बनाए रखें और व्यवहार नोट देखें। | | `meta.source` | string | — | डेटा स्रोत; स्थानीय रिकॉर्ड और लाइव प्रदाता क्वेरी अलग प्रमाण हैं। | ## व्यवहार और महत्वपूर्ण नोट - ID products/catalog से लें। quote पंक्ति में केवल location_id, time_id, quantity। purchase में purpose_id=201 और चुना subpurpose_id भी आवश्यक। - कई देश अलग ऑर्डर और एक बहु-पंक्ति बिल बनाते हैं। छूट देशवार है। accepted डिलीवरी नहीं; order_delivery और order_proxies देखें। - टाइमआउट/5xx लिखने की विफलता का प्रमाण नहीं। मूल Idempotency-Key से स्थिति पूछें। नई कुंजी से न दोहराएँ; GET बदलाव फिर नहीं भेजता। - सामान्य ऑर्डर में ग्राहक से दो विकल्प न चुनवाएँ। catalog.purposes में id=201 खोजें और केवल उसके children दिखाएँ। purchase में purpose_id निश्चित पूर्णांक 201 है और subpurpose_id चुने गए उप-विकल्प की ID है। पुराने एकीकरणों के साथ संगतता के लिए कैटलॉग का पदानुक्रम बना हुआ है। - अन्य चुनने पर subpurpose_id=-1 और 1–30 अक्षरों का other_purpose भेजें। दूसरे विकल्पों में other_purpose आवश्यक नहीं है। purpose_id फिर भी 201 रहता है। - एक product_id में अधिकतम 20 अलग location_id हो सकते हैं। हर देश की अलग ऑर्डर प्रविष्टि बनती है; जुड़ा हुआ चेकआउट एक इनवॉइस में संसाधित होता है। मात्रा छूट हर देश की अपनी मात्रा पर लगती है। प्रमाणीकरण और जाँच निष्पादन से पहले अनुरोध रोक सकते हैं। त्रुटि संदर्भ देखें और सहायता के लिए request_id रखें। कुंजी या पासवर्ड न भेजें। [त्रुटियाँ और सीमाएँ](https://docs.arnproxy.com/hi/api-v1/errors) [उसी कार्रवाई को ट्रैक करें: खरीद स्थिति जाँचें](https://docs.arnproxy.com/hi/api-v1/orders/create/status)