Μαζική επαναφορά 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 → μπαίνουν σε ουρά και υποβάλλονται σε επεξεργασία από έναν service worker. - Σύγχρονη απόκριση (δυνατή μόνο εάν παρέχονται 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" } - Το ωφέλιμο φορτίο webhook είναι πανομοιότυπο με την τελική σύγχρονη δομή (συμπεριλαμβανομένων των κωδικών/μηνυμάτων κατάστασης ανά αριθμό). Ερώτηση κατάστασης - GET https://api.multitel.net/v3/bulk_restore_status - Απαιτείται το job_uuid, προαιρετικός αριθμός (μόνο ψηφία). - Η απόκριση αντικατοπτρίζει τη σύνοψη εργασίας με την τρέχουσα κατάσταση ανά αριθμό καθώς και απόπειρες και χρονικές σημάνσεις· το φίλτρο αριθμού επιστρέφει μόνο αυτήν την καταχώριση. - Παράδειγμα: 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. - Η απόκριση αντικατοπτρίζει το ωφέλιμο φορτίο webhook και περιλαμβάνει πλέον το 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, ο πίνακας αποτελεσμάτων θα περιέχει μόνο αυτήν την καταχώριση καθώς και το filtered_number στο ωφέλιμο φορτίο. Εάν θέλετε να δημιουργήσετε τη δική σας λειτουργία ομαδικής επαναφοράς, μπορείτε να χρησιμοποιήσετε το παρακάτω τελικό σημείο api μεμονωμένου αριθμού και να το καλείτε επανειλημμένα, για κάθε αριθμό που επιθυμείτε να επαναφέρετε. curl -u 'USERNAME:PASSWORD' \ -H 'Accept: application/json' \ https://api.multitel.net/v3/restore/447000123456