v3 ჯგუფური აღდგენა

ამ API ფუნქციის მიზანია ტელეფონის ნომრების მასობრივად აღდგენა. POST: https://api.multitel.net/v3/bulk_restore - ავთენტიფიკაცია: HTTP basic მომხმარებლის API-ში შესვლის მონაცემებით. - მოთხოვნის სხეული (application/json): { "numbers": [ "15551230111", "15551230112", "15551230113" ], "webhook_url": "https://client.example.com/restore-hook" } - იღებს მხოლოდ ციფრებისგან შემდგარ სტრიქონებს; numbers_text (ახალი ხაზით გამოყოფილი) ასევე მუშაობს. - 10 ნომერი ან ნაკლები → მუშავდება სინქრონულად; 10-ზე მეტი → რიგში დგება და მუშავდება სერვისის ფონური პროცესის მიერ. - სინქრონული პასუხი (შესაძლებელია მხოლოდ თუ მოწოდებულია 10 ნომერი ან ნაკლები): { "job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0", "status": "completed", "total_numbers": 3, "success_count": 1, "failure_count": 2, "webhook_url": "https://client.example.com/restore-hook", "created_at": "2025-10-28 12:31:45", "started_at": "2025-10-28 12:31:45", "completed_at": "2025-10-28 12:31:48", "results": [ { "number": "15551230111", "status": "success", "message": "Number restored", "status_code": 200, "requires_identity_update": 0 }, { "number": "15551230112", "status": "failed", "message": "Error: 'restore failed, please contact support'", "status_code": 500, "requires_identity_update": 0 }, { "number": "15551230113", "status": "success", "message": "Number restored", "status_code": 200, "requires_identity_update": 1, "needs_registration": 1 } ] } თუ გაგზავნილი მონაცემების დამუშავებისას წარმოიქმნება შეცდომები (დროის ამოწურვა, DNS-ში დომენის მისამართი ვერ განისაზღვრება და ა.შ.), შეცდომები დაბრუნდება “results” მასივის შემდეგ: "webhook_error":"Could not resolve host: asidhaiufsd0uf.multitel.net" ან, თუ მოწოდებულია 10-ზე მეტი ნომერი: - რიგში ჩაყენებული (202 Accepted): { "job_uuid": "c5bc4f3a-7b0a-4d5d-9f7e-d3fd87f41a00", "status": "pending", "total_numbers": 25, "webhook_url": "https://client.example.com/restore-hook", "message": "Restore job queued. Results will be POSTed to https://client.example.com/restore-hook" } - ვებჰუკის მონაცემები იდენტურია საბოლოო სინქრონული სტრუქტურისა (თითო ნომრის სტატუსის კოდების/შეტყობინებების ჩათვლით). სტატუსის გამოკითხვა - GET https://api.multitel.net/v3/bulk_restore_status - სავალდებულო job_uuid, არასავალდებულო number (მხოლოდ ციფრები). - პასუხი ასახავს დავალების შეჯამებას მიმდინარე თითო-ნომრიანი მდგომარეობით, მცდელობებითა და დროის ნიშნებით; ნომრის ფილტრი აბრუნებს მხოლოდ იმ ჩანაწერს. - მაგალითი: GET …/bulk_restore_status?job_uuid=8f6c1f0e-23d2-4717-8c8e-1a518e5738f0 - გაფილტრული: GET …/bulk_restore_status?job_uuid=…&number=15551230113 - GET https://api.multitel.net/v3/bulk_restore_status - ავთენტიფიკაცია: იგივე HTTP Basic, რაც სხვა v3 გამოძახებებისთვის. - მოთხოვნის პარამეტრები: - job_uuid (სავალდებულო) – მიღებული POST პასუხიდან. - number (არასავალდებულო) – მხოლოდ ციფრები; ავიწროებს შედეგებს ერთ DID-მდე. - პასუხი ასახავს ვებჰუკის მონაცემებს და ახლა მოიცავს requires_identity_update (1/0) და needs_registration შესაბამის შემთხვევაში. მაგალითი: { "job_uuid": "8f6c1f0e-23d2-4717-8c8e-1a518e5738f0", "status": "processing", "total_numbers": 25, "success_count": 10, "failure_count": 0, "webhook_url": "https://client.example.com/restore-hook", "created_at": "2025-10-28 12:31:45", "started_at": "2025-10-28 12:31:45", "completed_at": null, "results": [ { "number": "15551230111", "status": "success", "message": "Number restored", "status_code": 200, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:47", "requires_identity_update": 0 }, { "number": "15551230112", "status": "failed", "message": "Error: 'restore failed, please contact support'", "status_code": 500, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:46", "requires_identity_update": 0 }, { "number": "15551230113", "status": "success", "message": "Number restored", "status_code": 200, "attempts": 1, "started_at": "2025-03-28 12:31:45", "completed_at": "2025-03-28 12:31:48", "requires_identity_update": 1, "needs_registration": 1 } ] } - number=15551230113-ის შემთხვევაში, results მასივი შეიცავს მხოლოდ იმ ჩანაწერს და filtered_number მონაცემებში. თუ გსურთ შექმნათ თქვენი საკუთარი მასობრივი აღდგენის ფუნქცია, შეგიძლიათ გამოიყენოთ ქვემოთ მოცემული ერთი ნომრის API-ს წვდომის წერტილი და გამოიძახოთ ის განმეორებით, თითოეული ნომრისთვის, რომლის აღდგენაც გსურთ. curl -u 'USERNAME:PASSWORD' \ -H 'Accept: application/json' \ https://api.multitel.net/v3/restore/447000123456