Vorlagenkonfiguration aktualisieren

Aktualisieren Sie eine bestehende Vorlagenkonfiguration, mit Unterstützung für die Änderung von Vorlagenname, Typ, Inhalt, Zielländern und Signaturinformationen. Nach der Aktualisierung wechselt der Vorlagenstatus zurück zu „In Prüfung".

Anfrage-URL

PUT https://smsapi.engagelab.com/v1/template-configs/:templateId

Aufruf-Authentifizierung

Bitte lesen Sie Aufruf-Authentifizierung, um zu erfahren, wie Sie API-Anfragen authentifizieren.

Anfragebeispiel

Anfrage-Header

              
              PUT /v1/template-configs/123456789  HTTP/1.1
Content-Type: application/json
Authorization: Basic amlndWFuZ2RldjpkZXZfc2VjcmV0

            

Anfragetext

              
              {
  "template_name": "Order Notification Template",
  "template_type": "utility",
  "template_content": "Your order {order_no} has been shipped and is expected to be delivered by {delivery_time}",
  "country_codes": "CN,US",
  "add_signature": true,
  "sign_id": "987654321",
  "sign_position": 2
}

            

Anfrageparameter

Pfadparameter

Anfragetext-Parameter

Antwortparameter

Erfolgsantwort

Der HTTP-Statuscode ist 200, und der Antworttext enthält die folgenden Felder:

Erfolgsbeispiel

              
              {
  "code": 0,
  "message": "success"
}

            

Fehlerantwort

Der HTTP-Statuscode ist 4xx/5xx, und der Antworttext enthält die folgenden Felder:

Fehlerbeispiel

              
              {
  "code": 400,
  "message": "can not update pending status template"
}

            

Fehlercodes

Häufige Fehlermeldungen:

• invalid templateId: Formatfehler der Vorlagen-ID
• template config not exist: Vorlagenkonfiguration existiert nicht
• can not update pending status template: Vorlage im Status „In Prüfung" kann nicht aktualisiert werden
• there are pending or running plans using current template, can not update: Es gibt ausstehende oder laufende Pläne, die diese Vorlage verwenden, sie kann nicht aktualisiert werden
• sign config not exist: Signaturkonfiguration existiert nicht
• sign status is not approved, can not use: Signaturstatus ist nicht genehmigt und kann nicht verwendet werden

Hinweise

1. Vorlagen im Status „In Prüfung" können nicht aktualisiert werden.
2. Wenn es ausstehende oder laufende Nachrichtenpläne gibt, die diese Vorlage verwenden, kann sie nicht aktualisiert werden.
3. Nach der Aktualisierung wechselt der Vorlagenstatus zurück zu „In Prüfung" (status=1).
4. Wenn eine Signatur hinzugefügt wird, muss die Signatur den Status „genehmigt" haben.
5. Der Vorlageninhalt darf keine verbotenen Zeichen enthalten: 【, 】, 、, 测试, test, [, ]
6. Sowohl die Vorlagen- als auch die Signatur-ID sind Zahlen vom Typ String.

Anhang

Status der Vorlagenkonfiguration (status)

Vorlagentyp (template_type)

Signaturposition (sign_position)